環境変数

ANTHROPIC_API_KEY

リクエストに使用される Anthropic API キーを設定します(サブスクリプション認証より優先)。

使い方・用途

  • 個人のサブスクリプションではなく、特定のプロジェクトや組織に紐付いた API コンソールのキーを使用して直接アクセスしたい場合に使用します。
  • --bare フラグを使用した CI/CD パイプラインなどの自動化スクリプトにおいて、高速な起動と認証のために必須の設定となります。
英語原文(公式ドキュメントより)

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.277(1件)

Fixed
Settings
~/.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

変更前

~/.claude.json に customApiKeyResponses の不正な値があると、ANTHROPIC_API_KEY を使うユーザーは対話セッションの起動時にハングするかエラーが表示され、セッションを開始できなかった。

変更後

対話セッションの起動時に、~/.claude.json 内の不正な customApiKeyResponses の値もスキップして読み込みを続行し、ハングせずに起動が完了する。

ユーザーへの恩恵

ANTHROPIC_API_KEY ユーザーは、~/.claude.json に customApiKeyResponses の不正な値があっても対話セッションをハングやエラーなしで起動できるようになる。

関連ドキュメント

v2.1.248(1件)

Fixed
Authentication
/login で推奨されるコンソールログインが、使用できないマシン（ANTHROPIC_API_KEY または API キーヘルパーが設定されている場合など）で OAuth エラーで失敗し、サインイン URL を表示する前に終了していた問題を修正しました。代わりに 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

変更前

/login で推奨されるコンソールログインが、使用できないマシンで OAuth エラーで失敗し、サインイン URL を表示する前に終了していました。

変更後

代わりに API キーでのログインにフォールバックするようになり、使用できない環境でもログインプロセスが完了します。

ユーザーへの恩恵

使用できない環境でも適切なログイン方法が選択され、ログインプロセスが確実に完了するようになります。

関連ドキュメント

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

変更前

Anthropic 以外のクラウドプロバイダーを使用している環境でも、CI 環境下では不要な Anthropic API キーの存在チェックが走り、実行が阻止されていました。

変更後

認証方法を正しく検知し、API キーを必要としないプロバイダー構成でも正常に非対話実行が可能になります。

ユーザーへの恩恵

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

関連ドキュメント

v2.1.139(1件)

Changed
Permissions
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

変更前

Claude.aiログインとAPIキー(Console)の設定が混在している場合、一部の機能がどちらの権限で動作しているか曖昧になることがありました。

変更後

明示的にAPIキー( Console認証等)が設定されている場合は、それに基づく動作に限定され、意図しない課金や動作の混乱を防ぎます。

ユーザーへの恩恵

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

関連ドキュメント

v2.1.81(1件)

Added
HooksMemoryPluginsSettingsSkills
スクリプト実行用の --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

変更前

非インタラクティブモード(-p)でスクリプトを実行する際も、通常のセッションと同様にフックの実行やプラグインの同期、メモリの読み込みが行われていました。

変更後

--bare フラグを使用することで、純粋にモデルの推論のみを高速に実行できるようになります。このモードでは OAuth 認証等がバイパスされるため、API キーの設定が必須となります。

ユーザーへの恩恵

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

関連ドキュメント