{"name":"awsAuthRefresh","slug":"awsauthrefresh","family":"setting","title":"Settings keys","noun":"settings key","description":"Refresh expired [Bedrock credentials](\/docs\/en\/amazon-bedrock.md#advanced-credential-configuration) in `.aws` with your own command","description_source":"docs","described_by":{"doc":"claude-code\/settings-reference","title":"All settings"},"presence":{"first_seen":"2.1.138","removed_in":"2.1.284","in_current_build":false,"newest_mined":"2.1.309","builds":126,"mined_builds":150,"first_cited":{"version":"2.1.286","released_at":"2026-09-30 17:14:38","spans":2}},"aliases":[],"entries":[{"version":"2.1.304","anchor":"settings-helpers-apikeyhelper-etc-are-not-run-in-pinned-o","heading":"Credential helper commands no longer run in some kinds of Claude Code process","line":"apiKeyHelper, awsAuthRefresh and three other helper settings are skipped in processes pinned to the stored login and in tool-server daemons","released_at":"2026-10-19 19:47:15","reason":"found in this entry's text"},{"version":"2.1.304","anchor":"otelheadershelper-trust-check-extended","heading":"otelHeadersHelper and awsAuthRefresh now match project settings in one more case","line":"The check that ties an otelHeadersHelper or awsAuthRefresh command to project settings now passes in one more case","released_at":"2026-10-19 19:47:15","reason":"found in this entry's text, named in this entry"},{"version":"2.1.300","anchor":"aws-auth-refresh-refused-when-a-guard-is-set","heading":"AWS sign-in refresh command can now be skipped in some situations","line":"Claude Code now skips your AWS auth refresh command in certain situations, reports it as failed and logs a reason","released_at":"2026-10-14 14:27:26","reason":"found in this entry's text, named in this entry"},{"version":"2.1.286","anchor":"claude-code-config-probe-env-var-makes-awsauthrefreshgcpaut","heading":"New CLAUDE_CODE_CONFIG_PROBE variable stops cloud credential refresh commands","line":"With CLAUDE_CODE_CONFIG_PROBE set, Claude Code skips the awsAuthRefresh and gcpAuthRefresh commands instead of running them","released_at":"2026-09-30 17:14:38","reason":"found in this entry's text, named in this entry"},{"version":"2.1.286","anchor":"awsgcp-auth-refresh-reports-okfailedinterrupted-and-expos","heading":"Cancelling an AWS or Google Cloud credential refresh no longer shows an error","line":"Credential refresh commands now end as succeeded, failed or interrupted, and an interrupted one closes quietly without printing an error","released_at":"2026-09-30 17:14:38","reason":"found in this entry's text, named in this entry"},{"version":"2.1.286","anchor":"cross-process-lock-for-gcpaws-auth-refresh-commands","heading":"Only one Claude Code window at a time runs your cloud sign-in refresh command","line":"When several Claude Code processes need `gcpAuthRefresh` or `awsAuthRefresh` at once, only one runs it and the others wait or take over","released_at":"2026-09-30 17:14:38","reason":"found in this entry's text, named in this entry"},{"version":"2.1.286","anchor":"auth-refresh-rewritten-with-single-flight-lockfile-waiters","heading":"AWS and Google Cloud credential refresh runs once at a time and respects Stop","line":"Credential refresh commands set in `awsAuthRefresh` and `gcpAuthRefresh` are now shared by everyone waiting, and stopping is noted by the wait","released_at":"2026-09-30 17:14:38","reason":"found in this entry's text, named in this entry"},{"version":"2.1.284","anchor":"bedrock-accessibility-probe-cache-is-keyed-on-aws-credential","heading":"Bedrock model access check is redone when you switch AWS credentials","line":"Claude Code's saved check that a Bedrock model is reachable is now tied to your AWS profile, keys, role and credential settings","released_at":"2026-09-28 17:11:59","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"settings-merge-gains-a-credential-helper-filter-that-is-iner","heading":"Settings merge gains a credential-helper filter that is inert in this build","line":"A filter that could strip credential helper settings from settings files is built in but does nothing yet","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"awsgcp-auth-refresh-commands-run-under-a-new-process-superv","heading":"AWS\/GCP auth refresh commands run under a new process supervisor that kills the whole process tree on timeout, abort or shutdown","line":"awsAuthRefresh and gcpAuthRefresh commands now stop together with everything they started on timeout, cancel or shutdown","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text, named in this entry"}],"entries_total":20,"docs":[{"source":"claude-code","path":"settings-reference","title":"All settings","documented":true},{"source":"claude-code","path":"settings","title":"Claude Code settings","documented":true},{"source":"claude-code","path":"amazon-bedrock","title":"Claude Code on Amazon Bedrock","documented":false},{"source":"claude-code","path":"changelog","title":"Claude Code changelog","documented":false},{"source":"claude-code","path":"claude-platform-on-aws","title":"Claude Code on Claude Platform on AWS","documented":false},{"source":"claude-code","path":"errors","title":"Error reference","documented":false},{"source":"claude-code","path":"permissions","title":"Configure permissions","documented":false},{"source":"claude-docs","path":"government\/deploy-claude-code\/configure","title":"Connect Claude Code to Claude for Government","documented":false}],"docs_total":8,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/awsauthrefresh","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}