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

Fixed
デスクトップ版やサードパーティプロバイダーで、ホスト側の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
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
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
スクリプト実行用の --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

関連ドキュメント