settings.json

awsAuthRefresh

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

AWS 認証情報の有効期限が切れているか利用できない場合に実行するコマンド。その出力はユーザーに表示されるが、対話的な入力はサポートされない。設定すると、/login の「Claude Platform on AWS · refresh credentials」オプションの動作にも使われる。See https://code.claude.com/docs/en/amazon-bedrock#advanced-credential-configuration

既定値: 未設定であり、Claude Code は AWS 認証情報を自動的に更新しない。

記述例

{
  "awsAuthRefresh": "aws sso login --profile myprofile"
}

使い方・用途

  • AWS SSO の認証情報がセッション途中で期限切れになった際にログインコマンドを自動で再実行し、リクエストを再試行して失敗を防ぎたい場合
  • 企業の ID プロバイダ経由のブラウザベース SSO フローで、CLI が表示する URL やコードを使ってブラウザ側で認証を完結させたい場合
  • 認証情報や SSO キャッシュなど .aws ディレクトリを更新するコマンドを、Claude Code が認証エラーを検知したときだけ実行したい場合
英語原文(公式ドキュメントより)

Command to run when AWS credentials are expired or unavailable; its output is shown to the user but interactive input is not supported. Also drives the "Claude Platform on AWS · refresh credentials" option in /login when configured. See https://code.claude.com/docs/en/amazon-bedrock#advanced-credential-configuration

関連ドキュメント

関連する変更履歴

v2.1.301(1件)

Fixed
プロバイダーが Bedrock でないにもかかわらず、application-inference-profile を名前に含むモデルへ切り替えると awsAuthRefresh コマンドが実行され、モデル切り替えフックが遅延する問題を修正した。
英語原文を表示
Fixed switching to a model whose name contains application-inference-profile running your awsAuthRefresh command and delaying model-switch hooks when the provider is not Bedrock

関連ドキュメント

v2.1.288(1件)

Fixed
別の Claude Code プロセスがサインイン中にノート PC がスリープから復帰した際、gcpAuthRefresh/awsAuthRefresh のブラウザサインイン画面がもう一つ開く問題を修正した
英語原文を表示
Fixed a second gcpAuthRefresh/awsAuthRefresh browser sign-in opening when a laptop wakes from sleep while another Claude Code process is signing in

v2.1.286(1件)

Fixed
gcpAuthRefresh や awsAuthRefresh の認証情報が期限切れになったとき、複数の Claude Code プロセスや IDE 拡張機能がそれぞれログイン用ブラウザを開いてしまう問題を修正した
英語原文を表示
Fixed several Claude Code processes and IDE extensions each opening a login browser when gcpAuthRefresh or awsAuthRefresh credentials expire

関連ドキュメント

v2.1.281(1件)

Fixed
Claude Code の終了時やリフレッシュのタイムアウト時に、gcpAuthRefresh/awsAuthRefresh のログインプロセスが動き続け(Windows では localhost のコールバックポートを保持し続け)る問題を修正した
英語原文を表示
Fixed gcpAuthRefresh/awsAuthRefresh login processes being left running (and holding their localhost callback port on Windows) when Claude Code exits or the refresh times out

関連ドキュメント

v2.1.239(1件)

Fixed
SSO プロファイルと awsAuthRefresh を使って Bedrock を利用する際、HTTPS プロキシ環境下で Claude Code が起動時にハングする問題を修正した。認証情報の事前チェックが HTTPS_PROXY を尊重するようになった
英語原文を表示
Fixed Claude Code hanging at startup behind an HTTPS proxy when using Bedrock with an SSO profile and awsAuthRefresh — the credential pre-check now honors HTTPS_PROXY

関連ドキュメント

v2.1.198(1件)

Fixed
AWS STSトークンの期限切れ時に「Please run /login」という不適切なエラーで停止する問題を修正。awsAuthRefresh が自動的に実行されるようになります。
英語原文を表示
Fixed Claude Platform on AWS and Mantle sessions dead-ending with "Please run /login" when the STS token expires — awsAuthRefresh now runs automatically

変更後

認証プロセスの管理コストが削減され、長時間稼働するエージェントがより使いやすくなります。

関連ドキュメント

v2.1.186(1件)

Added
awsAuthRefresh が設定されている場合、/login に「Claude Platform on AWS - 認証情報の更新」オプションが表示されるようになりました。
英語原文を表示
Added "Claude Platform on AWS - refresh credentials" option to /login when awsAuthRefresh is configured

変更後

AWS環境でClaude Codeを利用する開発者が、認証の手間を最小限に抑えつつ、セキュアなアクセスを維持できるようになります。

関連ドキュメント

v2.0.24(1件)

Changed
Bedrock: Display awsAuthRefresh output when auth is required

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).

関連ドキュメント