Claude Codeセットアップ

Claude CodeからSalesBrain APIを使うための最低限の手順です。

このページはセットアップ専用です。設定後の使い方は 求人全文検索ガイド と 事業概要文検索ガイド を確認してください。

必要なもの

APIキーはClaude Codeのチャット、Slack、メール、Notion、Google Docs、GitHubなどに直接貼らないでください。

セットアップ方法

1. Claude Codeを起動できる状態にする

Claude Codeを未インストールの場合は、Claude Code公式セットアップ を確認してください。

macOS / Linuxでは、次の方法でインストールできます。

npm install -g @anthropic-ai/claude-code

インストール後、ターミナルで起動します。

claude

2. SalesBrain APIキーを環境変数に設定する

Claude Codeを起動する前に、同じターミナルで設定します。

export SALESBRAIN_API_KEY="管理者から受け取ったAPIキー"
export SALESBRAIN_API_BASE_URL="https://api-dev.salesbrain.jp/rest/v1"

キーが設定されているか確認する場合も、キー本体は表示しないでください。

test -n "$SALESBRAIN_API_KEY" && echo "APIキー設定済み"

3. 接続確認をする

SalesBrain APIは X-API-Key ヘッダーで認証します。まずはマスターデータで接続確認します。

curl -s "$SALESBRAIN_API_BASE_URL/master/media" \
  -H "X-API-Key: $SALESBRAIN_API_KEY"

媒体一覧が返れば接続できています。

4. Claude Codeに伝える

Claude Codeには、APIキーの値ではなく環境変数名だけを伝えます。

SalesBrain APIを使います。
APIキーは環境変数 SALESBRAIN_API_KEY に設定済みです。
APIキーの値は表示しないでください。
認証は X-API-Key ヘッダーで行ってください。
まず /master/media で接続確認してください。
検索は最初に limit 5 で試してください。
リクエスト項目は https://docs.salesbrain.co.jp/openapi.yaml を正として確認してください。

よく使う場合はSkill化する

SalesBrain APIを何度も使う場合は、Claude Codeに専用のSkillを作らせると便利です。

SkillにはAPIキー本体を書かないでください。Skillに書くのは、SALESBRAIN_API_KEY という環境変数名だけです。

Claude Codeに次のように依頼します。

SalesBrain APIを使うためのSkillを作成してください。

前提:
- APIキーは環境変数 SALESBRAIN_API_KEY に設定済み
- APIキーの値は表示しない
- APIのBase URLは https://api-dev.salesbrain.jp/rest/v1
- 認証は X-API-Key ヘッダーで行う
- API仕様の参照ソースは https://docs.salesbrain.co.jp/openapi.yaml
- 人が確認する場合は https://docs.salesbrain.co.jp/api/ も使える

Skillに入れてほしいこと:
- 最初に /master/media で接続確認する
- 企業検索は /corporates/search を使う
- 求人検索は /jobs/search を使う
- 求人全文検索では jobDescriptionPartialMatchOr / And / Not を使う
- 事業概要文検索では summaryPartialMatchOr / And / Not を使う
- 検索結果の descriptionSnippet は抜粋として扱う
- 全文確認が必要なときだけ GET /jobs/{jobId}/detail を使う
- 検索は最初に limit 5 で試す
- リクエスト項目・レスポンス項目は OpenAPI YAML を正とする
- 400が返ったら OpenAPI YAML の項目名と一致しているか確認する
- APIキー本体をチャット、ログ、ファイルに出さない

必ず守ること

次に読む

設定が終わったら、求人全文検索ガイド と 事業概要文検索ガイド で検索の頼み方を確認してください。

困ったとき

解決しない場合は support@salesbrain.co.jp までお問い合わせください。

このページ内