環境変数

ANTHROPIC_API_KEY

X-Api-Key ヘッダーとして送信される API キーである。設定すると、ログイン済みであっても Claude Pro、Max、Team、Enterprise のサブスクリプションの代わりにこのキーが使用される。非対話モード (-p) では、キーが存在すれば常に使用される。対話モードでは、サブスクリプションを上書きする前にキーの使用を 1 回承認するよう求められる。代わりにサブスクリプションを使うには、unset ANTHROPIC_API_KEY を実行する。

使い方・用途

  • 組織のゲートウェイが API キー認証を要求している場合に、Claude Code から x-api-key ヘッダーでキーを送信して接続する。
  • CI や GitHub Actions などの非対話環境で、サブスクリプションに依存せず API キーで Claude Code を認証する。
  • 古い API キーがシェルプロファイルに残っているせいでサブスクリプション認証が使えないトラブルを、unset で解消する。
英語原文(公式ドキュメントより)

API key sent as X-Api-Key header. When set, this key is used instead of your Claude Pro, Max, Team, or Enterprise subscription even if you are logged in. In non-interactive mode (-p), the key is always used when present. In interactive mode, you are prompted to approve the key once before it overrides your subscription. To use your subscription instead, run unset ANTHROPIC_API_KEY

関連する変更履歴

v2.1.304(1件)

Fixed
起動時に ANTHROPIC_API_KEY を承認した場合や /config で「Use custom API key」を切り替えた場合に、毎時のチェックまで組織ポリシーが更新されない問題を修正した。
英語原文を表示
Fixed the organization policy not refreshing until the hourly check after approving an ANTHROPIC_API_KEY at startup or switching "Use custom API key" in /config

v2.1.277(1件)

Fixed
~/.claude.json に不正な customApiKeyResponses 値が含まれていると、ANTHROPIC_API_KEY ユーザー向けに対話的な起動がハングしたりエラーを表示したりする問題を修正した
英語原文を表示
Fixed interactive start-up hanging or showing an error for ANTHROPIC_API_KEY users when ~/.claude.json holds a malformed customApiKeyResponses value

関連ドキュメント

v2.1.248(1件)

Fixed
/login で推奨される Console サインインが、サインイン URL を表示する前に OAuth エラーで失敗する問題を修正した(たとえば ANTHROPIC_API_KEY や API キーヘルパーが設定されているマシンでは使用できない)。現在は API キーによるサインインへフォールバックする
英語原文を表示
Fixed the recommended Console sign-in in /login failing with an OAuth error before showing a sign-in URL on machines where it can't be used (for example when ANTHROPIC_API_KEY or an API key helper is set); it now falls back to the API-key sign-in

v2.1.163(1件)

Fixed
Amazon Bedrock、Google Vertex AI、Microsoft Foundry 利用時に CI=true かつ Anthropic API キー未設定だと claude -p が失敗する問題を修正
英語原文を表示
Fixed claude -p failing with "ANTHROPIC_API_KEY required" on Bedrock/Vertex/Foundry when CI=true and no Anthropic API key is set

変更後

エンタープライズ向けの LLM 基盤を使用している開発者が、CI 環境で Claude Code をより柔軟に活用できるようになります。

関連ドキュメント

v2.1.139(1件)

Changed
APIキー等が設定されている場合、Remote Controlや通知設定等の一部機能を無効化するよう変更(APIキーを優先するため)。
英語原文を表示
Remote Control, /schedule, claude.ai MCP connectors, and notification preferences are now disabled when ANTHROPIC_API_KEY / apiKeyHelper / ANTHROPIC_AUTH_TOKEN is set, even if a Claude.ai login also exists. Unset the API key to use these features

変更後

認証方式による機能の挙動が明確になり、セキュアで予測可能な利用環境が保証されます。

関連ドキュメント

v2.1.81(1件)

Added
スクリプト実行用の --bare フラグを追加しました。フック、LSP、プラグイン同期、スキルディレクトリの走査をスキップし、自動メモリ機能も完全に無効化されます。
英語原文を表示
Added --bare flag for scripted -p calls — skips hooks, LSP, plugin sync, and skill directory walks; requires ANTHROPIC_API_KEY or an apiKeyHelper via --settings (OAuth and keychain auth disabled); auto-memory fully disabled

変更後

CI/CD パイプラインや自動化スクリプトにおいて、不要なオーバーヘッドを削減し、起動速度の向上と実行の安定性を確保できます。