What
A new gcpAuthRefresh setting that automatically refreshes GCP/Vertex AI credentials when they expire, similar to the existing awsAuthRefresh for AWS.
Usage: Add to settings or ~/.claude.json:
{
"gcpAuthRefresh": "gcloud auth application-default login"
}Details
- Automatically detects expired GCP credentials ("Could not load the default credentials", "Could not refresh access token",
invalid_grant) - Runs the configured refresh command before making API calls
- Times out after 3 minutes with a warning
- Validates credentials before running refresh (skips if still valid)
- Works with Vertex AI authentication (checks
CLAUDE_CODE_USE_VERTEX) - Respects the new
CLAUDE_CODE_SKIP_VERTEX_AUTHenvironment variable
Evidence
New settings schema field and credential checker (search for "gcpAuthRefresh", "Could not load the default credentials")
Strings lifted out of the shipped bundle, so the claim above can be checked against them.