Claude Code API 設定は、キーを貼る作業ではなく、どの認証ルートを有効にするかを決める作業です。ログイン、ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN と ANTHROPIC_BASE_URL のゲートウェイ、apiKeyHelper、Bedrock、Vertex、Foundry を先に分けます。
順序はルート、設定範囲、モデル、確認です。/status、/config、/model を見る前に、現在の設定が正しいとは判断しないでください。
| 目的 | 設定場所 | 最初の確認 |
|---|---|---|
| 通常の対話利用 | サブスクログインと user/project settings | /status |
| 直接 API キー | ローカル shell の ANTHROPIC_API_KEY | env と /status |
| 互換ゲートウェイ | ANTHROPIC_AUTH_TOKEN と ANTHROPIC_BASE_URL | host、モデル名、信頼境界 |
| Bedrock / Vertex / Foundry | provider credentials と route variables | provider、region、model |
先に有効ルートを決める
Claude Code は同じ CLI でも、サブスクログイン、直接 API キー、ゲートウェイ、クラウド provider のどれかで動きます。サブスクログインは人がターミナルで使う通常ルートです。API キーは CI、SDK、無人実行、Console での利用記録が必要な場面です。
インストールが未完了なら Claude Code インストール を先に確認します。API キーで課金先が変わるか知りたい場合は API key とサブスク課金 に分けます。
認証優先度を確認する
公式ドキュメントを2026年4月21日に確認した時点では、優先度は cloud provider credentials、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY、apiKeyHelper、OAuth token、/login の順です。古い環境変数が新しい settings より強いことがあります。
bashtest -n "$ANTHROPIC_API_KEY" && echo "ANTHROPIC_API_KEY is set" test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set" printenv ANTHROPIC_BASE_URL
settings.json の範囲を分ける
~/.claude/settings.json は個人デフォルト、.claude/settings.json は共有プロジェクト設定、.claude/settings.local.json はローカル上書きです。共有ファイルに API キーや bearer token を入れないでください。
| 範囲 | 用途 | 避けること |
|---|---|---|
| user settings | 個人の標準動作 | team policy |
| project settings | 権限、共有ルール | secrets |
| local project settings | 個人端末の上書き | commit する値 |
| shell / CI | credentials と route flags | 誰も追えない共有既定値 |
API キーとゲートウェイ
直接 Anthropic API なら ANTHROPIC_API_KEY を使います。
bashexport ANTHROPIC_API_KEY="$YOUR_ANTHROPIC_API_KEY" claude /status
ゲートウェイなら token と base URL を一緒に扱います。
bashexport ANTHROPIC_AUTH_TOKEN="$YOUR_GATEWAY_TOKEN" export ANTHROPIC_BASE_URL="https://gateway.example.com" claude /status
ゲートウェイは direct Anthropic API と同じではありません。API 形状、version/beta headers、モデル名、ログ、データ境界を確認します。選定自体は Claude gateway に分けます。
モデルと provider route
モデル優先度は /model、--model、ANTHROPIC_MODEL、settings の model です。Bedrock は CLAUDE_CODE_USE_BEDROCK=1 と AWS_REGION、Vertex は CLAUDE_CODE_USE_VERTEX=1 と GCP 側の資格情報が中心です。
確認手順
Claude Code 内で次を確認します。
text/status /config /model
shell では秘密値を出さず、変数の有無だけ確認します。違うルートが表示されたら、優先度の高い env var から外してください。
安全と次の分岐
本物の key、token、private URL、cloud credentials を commit しないでください。git diff -- .claude/settings.json .claude/settings.local.json で共有設定に秘密が混ざっていないか確認します。
関連する判断は、インストール、API key と課金、Claude API key free tier、usage limit に分けて確認します。
よくある質問
Claude Code に API キーは必須ですか？
必須ではありません。通常の対話利用はサブスクログインで足ります。API キーは API ルートを明示したい時に使います。
ANTHROPIC_AUTH_TOKEN は何ですか？
Bearer token です。多くの場合 ANTHROPIC_BASE_URL と組み合わせて互換ゲートウェイを使うための値です。
設定が有効かどうかは何で確認しますか？
/status、/config、/model を見て、shell では変数の有無だけを確認します。