CLAUDE_LOCAL_OAUTH_API_BASE

Updated October 13, 2026 by Alex Sorokoletov

CLAUDE_LOCAL_OAUTH_API_BASE is a Claude Code environment variable: Overrides the base URL for local OAuth API operations. This extends the auth customization story started by CLAUDE_AI_ORIGIN in v2.1.84, giving operators finer control over where OAuth token exchanges happen — separate from the main AI endpoint. Added in v2.1.85 and still present in v2.1.294. It is not in the official reference.

How to set it

For one session, export it in the shell that starts Claude Code:

export CLAUDE_LOCAL_OAUTH_API_BASE=<value>
claude

To apply it to every session, add it to the env object of a settings file:

// ~/.claude/settings.json
{
  "env": {
    "CLAUDE_LOCAL_OAUTH_API_BASE": "<value>"
  }
}

Release notes that mention it

• Claude Code v2.1.87 — 2 New Environment Variables: OAuth Console and Trusted Devices
• Claude Code v2.1.86 — 2 New Environment Variables: Trusted Devices and the Final OAuth Override
• Claude Code v2.1.85 — 6 New Environment Variables: MCP Server Config and a 7 MB Diet
• Claude Code Version Tracker: Undocumented Env Vars, Feature Gates & Models

Related variables

• CLAUDE_LOCAL_OAUTH_APPS_BASE: Overrides the base URL for the local OAuth applications registry.
• CLAUDE_LOCAL_OAUTH_CONSOLE_BASE: Overrides the base URL for the OAuth console interface.
• ANTHROPIC_API_KEY: Primary API key for Claude API.
• CLAUDE_CODE_API_KEY_FILE_DESCRIPTOR: File descriptor to read API key from.
• CLAUDE_CODE_API_KEY_HELPER_TTL_MS: Cache TTL for API key helper.
• CLAUDE_CODE_CUSTOM_OAUTH_URL: Custom OAuth endpoint URL.
• CLAUDE_CODE_OAUTH_CLIENT_ID: Custom OAuth client ID.
• CLAUDE_CODE_OAUTH_REFRESH_TOKEN: OAuth refresh token.

Frequently asked questions

All variables, searchable: Claude Code environment variables.