settings.json

awsCredentialExport

型string記述場所どの設定ファイルでも可

AWS 認証情報を JSON 形式({'Credentials': {'AccessKeyId': ..., 'SecretAccessKey': ..., 'SessionToken': ...}} の形)で出力するコマンド。出力は黙って取得される。.aws ディレクトリを変更できず、認証情報を直接返す必要がある場合に使う。See https://code.claude.com/docs/en/amazon-bedrock#advanced-credential-configuration

既定値: 未設定であり、Claude Code は環境にある AWS 認証情報チェーンを使用する。

記述例

{
  "awsCredentialExport": "/bin/generate_aws_grant.sh"
}

使い方・用途

  • .aws ディレクトリを変更できない環境で、Bedrock 用の AWS 認証情報をコマンドから直接受け渡したい場合に使う。
  • Amazon Bedrock アカウントが、デフォルトの認証情報プロバイダチェーンが解決する認証情報と異なるクロスアカウント認証情報を要求する場合に使う。
  • クロスアカウントアクセスで、ambient AWS 認証情報が解決されても認証が失敗する問題を解決するために使う。
英語原文(公式ドキュメントより)

Command that outputs AWS credentials as JSON (in the form {"Credentials": {"AccessKeyId": ..., "SecretAccessKey": ..., "SessionToken": ...}}). The output is captured silently. Use when you cannot modify the .aws directory and must return credentials directly. See https://code.claude.com/docs/en/amazon-bedrock#advanced-credential-configuration

関連する変更履歴

v2.1.206(1件)

Changed
制限されたネットワーク環境での Bedrock 利用時、起動時に数分間ハングする問題を修正しました
英語原文を表示
Bedrock: fixed a multi-minute startup hang when using an awsCredentialExport helper on networks with restricted egress

変更後

セキュリティの厳しいエンタープライズ環境でも、待ち時間なしで作業を開始できます。

v2.1.181(1件)

Fixed
AWS認証情報の更新頻度が過剰になる問題を修正し、aws configure export-credentials の出力形式に対応
英語原文を表示
Fixed AWS awsCredentialExport credentials with a short remaining lifetime causing credential refreshes every minute, and now accepts the JSON shape from aws configure export-credentials

変更後

AWS環境での認証プロセスが安定し、標準的なAWS CLIツールとの連携がよりスムーズになります。

v2.1.176(1件)

Improved
Amazon Bedrock の認証情報キャッシュの改善:awsCredentialExport による認証情報が、固定の1時間ではなく Expiration(有効期限)までキャッシュされるようになりました
英語原文を表示
Improved Bedrock credential caching: credentials from awsCredentialExport are now cached until their Expiration instead of a fixed 1 hour

変更後

不要な認証コマンドの実行が減り、セッション開始やレジューム時の待ち時間が短縮されます。

関連ドキュメント

v2.1.141(1件)

Changed
Bedrock環境で、既存の認証情報があってもawsCredentialExportを常に実行するように変更し、クロスアカウントアクセスに対応。
英語原文を表示
Bedrock: awsCredentialExport now always runs when configured instead of being skipped when ambient AWS credentials resolve, fixing auth for cross-account access

変更後

複数のAWSアカウントを使い分けて開発・運用している組織において、認証の切り替えがスムーズかつ確実になります。

関連ドキュメント

v1.0.53(1件)

Added
Add helper script settings for AWS token refresh: awsAuthRefresh (for foreground operations like aws sso login) and awsCredentialExport (for background operation with STS-like response).