settings.json

apiKeyHelper

認証情報を出力するスクリプトへのパスを指定します。

使い方・用途

  • 外部のパスワードマネージャーや Vault から、動的に変化する API キーやトークンを自動取得したい場合に使用します。
  • CI/CD パイプラインなどの非対話的な環境で、ブラウザログインなしに認証を済ませたい場合に役立ちます。
  • 認証情報が失効した際(デフォルト 5 分後)にスクリプトを再実行し、シームレスに更新できます。
英語原文(公式ドキュメントより)

Path to a script that outputs authentication values. See https://code.claude.com/docs/en/settings#available-settings

関連ドキュメント

関連する変更履歴

v2.1.208(1件)

Fixed
apiKeyHelper スクリプトの失敗が一般的な 401 エラーの影に隠れてしまう問題を修正した。10回の無言のリトライを待たず、3回以内の試行でスクリプト自体のエラーが表示されるようになった。
英語原文を表示
Fixed apiKeyHelper script failures being hidden behind a generic 401 after ~10 silent retries; the script's own error is now shown within 3 attempts

変更前

API キーを取得する外部スクリプトが失敗しても、CLI が何度もサイレントリトライを繰り返した後に最終的に「401 Unauthorized」とだけ表示され、原因の特定が難しかった。

変更後

リトライ回数が削減され、スクリプトが出力した具体的なエラーメッセージが早期にユーザーに提示されるようになった。これにより、設定ミスや認証の有効期限切れにすぐ気づける。

ユーザーへの恩恵

API キー取得スクリプトが壊れた際に、ネットワークエラーなのかスクリプトのバグなのかを悩む必要がなくなります。

関連ドキュメント

v2.1.141(1件)

Fixed
Settings
デスクトップ版やサードパーティプロバイダーで、ホスト側のmanaged-settingsから認証情報を誤って引き継いでしまう問題を修正。
英語原文を表示
Fixed desktop and third-party provider sessions incorrectly inheriting apiKeyHelper/ANTHROPIC_AUTH_TOKEN from host managed-settings

変更前

共有設定(managed-settings)に記載されたapiKeyHelperやトークンが、本来それらを使用すべきでない環境(デスクトップアプリ等)でも適用されてしまうことがありました。

変更後

各実行環境に応じた認証情報の優先順位と継承ルールが厳密化され、不適切なクレデンシャルの混入が防止されます。

ユーザーへの恩恵

意図しないAPIキーの利用や認証エラーを防ぎ、セキュアで一貫した認証体験が得られます。

関連ドキュメント

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

Fixed
Settings
Amazon BedrockのSigV4認証において、ANTHROPIC_AUTH_TOKEN 等でAuthorizationヘッダーが設定されていると403エラーになる問題を修正
英語原文を表示
Fixed Bedrock SigV4 authentication failing with 403 when ANTHROPIC_AUTH_TOKEN, apiKeyHelper, or ANTHROPIC_CUSTOM_HEADERS set an Authorization header

変更前

Bedrock環境で利用する際、無関係な認証用環境変数が残っていると、AWS側の認証と干渉して接続に失敗することがありました。

変更後

Bedrock固有の署名付きヘッダーの生成が他の認証設定と干渉しないよう改善されました。

ユーザーへの恩恵

AWS Bedrockを利用した開発環境のセットアップにおける不透明な認証エラーが解消されます。

関連ドキュメント

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

関連ドキュメント

v2.1.77(1件)

Changed
API キー取得ヘルパーが 10 秒以上かかる場合に通知を表示し、メインループがブロックされないよう改善しました
英語原文を表示
Show a notice when apiKeyHelper takes longer than 10s, preventing it from blocking the main loop

関連ドキュメント

v1.0.37(1件)

v0.2.74(1件)

Added
Added support for refreshing dynamically generated API keys (via apiKeyHelper), with a 5 minute TTL

関連ドキュメント