settings.json

awsAuthRefresh

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

AWS 認証を更新するスクリプトへのパスを指定します。

記述例

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

使い方・用途

  • AWS SSO などのブラウザベースの認証フローを自動開始し、ローカルの認証ファイルやキャッシュを更新したい場合に最適です。
  • 認証エラーを検知した際にスクリプトを自動実行し、シームレスにセッションを継続できます。
英語原文(公式ドキュメントより)

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

関連ドキュメント

関連する変更履歴

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

変更前

ノート PC がスリープから復帰したとき、別の Claude Code プロセスが gcpAuthRefresh/awsAuthRefresh によるブラウザサインインを実行中だと、覚えていなくても二つ目のサインインが開き、余分なブラウザタブと OAuth コールバックの競合が起きていた

変更後

スリープ解除時に別プロセスがサインイン中でもブラウザのサインインが再び開かれず、重複した認証フローが発生しなくなる

ユーザーへの恩恵

複数の Claude Code プロセスが動作していても、余分なブラウザサインインを開かずに済むようになる

関連ドキュメント

v2.1.286(1件)

Fixed
Settings
複数の Claude Code プロセスや IDE 拡張が同時に動作している場合に、gcpAuthRefresh や awsAuthRefresh の認証情報が期限切れになると、それぞれがブラウザでログインページを開いていた問題を修正
英語原文を表示
Fixed several Claude Code processes and IDE extensions each opening a login browser when gcpAuthRefresh or awsAuthRefresh credentials expire

変更前

gcpAuthRefresh または awsAuthRefresh の認証情報が期限切れになったとき、複数の Claude Code プロセスや IDE 拡張が動作していても、期限切れを検知した1つのプロセスだけがブラウザでログインページを開く。

変更後

gcpAuthRefresh または awsAuthRefresh の認証情報が期限切れになったとき、複数の Claude Code プロセスや IDE 拡張がそれぞれブラウザでログインページを開くようになった。

ユーザーへの恩恵

複数プロセスや IDE 拡張を使っていても、期限切れ時にブラウザのログインが1回だけ開くようになり、再認証が乱発しなくなる。

関連ドキュメント

v2.1.281(1件)

Fixed
Claude Code の終了時や認証更新のタイムアウト時に、gcpAuthRefresh / awsAuthRefresh のログインプロセスが動作したまま残留し、Windows 上ではローカルホストのコールバックポートを保持し続ける問題を修正した。
英語原文を表示
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

変更前

Claude Code の終了時や認証更新がタイムアウトした際に、gcpAuthRefresh / awsAuthRefresh のログインプロセスが動作し続け、Windows 上ではローカルホストのコールバックポートを保持したまま残留していた。

変更後

Claude Code の終了時や認証更新がタイムアウトした際に、gcpAuthRefresh / awsAuthRefresh のログイン処理がクリーンアップされ、Windows 上でローカルホストのコールバックポートを保持したまま残らなくなった。

ユーザーへの恩恵

不要なプロセスやポートの占有がなくなり、Windows での OAuth 認証や MCP サーバーへのサインインが安定して行えるようになる。

関連ドキュメント

v2.1.239(1件)

Fixed
HTTPS プロキシ環境下で AWS SSO プロファイルと awsAuthRefresh を組み合わせて Bedrock を使用する際、起動時の認証情報事前チェックが 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

変更前

HTTPS プロキシの背後から AWS SSO と awsAuthRefresh を設定して Bedrock を利用しようとすると、起動時の資格情報事前チェックプロセスがプロキシを無視して直接接続を試みていました。このため接続が確立できず、起動時に CLI がフリーズしていました。

変更後

起動時の事前チェック処理がシステムに設定された HTTPS_PROXY 環境変数を正しく参照し、プロキシ経由で認証トークンの解決を行うようになります。ハングアップすることなく正常に起動します。

ユーザーへの恩恵

プロキシ環境下でも起動時フリーズに阻まれることなく、AWS SSO 連携を安定して利用できます。

関連ドキュメント

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 Platformを利用している際、認証情報の有効期限が切れた場合に、既存のログインフローから直接更新することができませんでした。

変更後

ログインメニューに認証情報の更新オプションが統合され、AWS SSOやIDプロバイダーを介した再認証がスムーズに行えるようになりました。

ユーザーへの恩恵

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

関連ドキュメント