環境変数

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.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
HooksSkillsPluginsSettingsMemory
スクリプト実行用の --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 パイプラインや自動化スクリプトにおいて、不要なオーバーヘッドを削減し、起動速度の向上と実行の安定性を確保できます。

関連ドキュメント