{"name":"gcpAuthRefresh","slug":"gcpauthrefresh","family":"setting","title":"Settings keys","noun":"settings key","description":"Refresh [Google Cloud credentials](\/docs\/en\/google-vertex-ai.md#advanced-credential-configuration) 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.72","released_at":"2026-03-09 23:29:16","spans":1}},"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.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.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"},{"version":"2.1.261","anchor":"gcp-credential-check-becomes-tri-state-and-honors-anthropic","heading":"GCP credential check becomes tri-state and honors ANTHROPIC_GOOGLE_CLOUD_PROJECT","line":"GCP credential checks now distinguish timeout from failure and honor a new project env var fallback.","released_at":"2026-09-04 17:49:34","reason":"found in this entry's text"},{"version":"2.1.248","anchor":"memory-api-endpoint-and-token-environment-variables","heading":"Memory API endpoint and token environment variables","line":"Two environment variables can point Claude Code at a memory service with a token.","released_at":"2026-08-27 20:35:36","reason":"found in this entry's text"},{"version":"2.1.235","anchor":"managed-settings-policy-helper-can-be-armed-from-remote","heading":"Managed-settings policy helper can be \"armed from remote\"","line":"Managed-settings policy helpers can now be armed from a remote source, reported as a distinct settings tier and fingerprinted per OS","released_at":"2026-08-18 18:24:10","reason":"found in this entry's text"}],"entries_total":12,"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":"changelog","title":"Claude Code changelog","documented":false},{"source":"claude-code","path":"errors","title":"Error reference","documented":false},{"source":"claude-code","path":"google-vertex-ai","title":"Claude Code on Google Cloud's Agent Platform","documented":false},{"source":"claude-docs","path":"government\/deploy-claude-code\/configure","title":"Connect Claude Code to Claude for Government","documented":false}],"docs_total":6,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/gcpauthrefresh","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}