CLAUDE_LOCAL_OAUTH_CONSOLE_BASE

Updated October 13, 2026 by Alex Sorokoletov

CLAUDE_LOCAL_OAUTH_CONSOLE_BASE is a Claude Code environment variable: Overrides the base URL for the OAuth console interface. This is the third piece of the local OAuth override triptych: CLAUDE_LOCAL_OAUTH_API_BASE handles token exchanges, CLAUDE_LOCAL_OAUTH_APPS_BASE handles app registration, and now CLAUDE_LOCAL_OAUTH_CONSOLE_BASE handles the console/management UI. Added in v2.1.86 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_CONSOLE_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_CONSOLE_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 Version Tracker: Undocumented Env Vars, Feature Gates & Models

Related variables

• CLAUDE_LOCAL_OAUTH_API_BASE: Overrides the base URL for local OAuth API operations.
• CLAUDE_LOCAL_OAUTH_APPS_BASE: Overrides the base URL for the local OAuth applications registry.
• 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.
• CLAUDE_CODE_OAUTH_SCOPES: OAuth scopes for refresh token.
• CLAUDE_CODE_OAUTH_TOKEN: Pre-configured OAuth access token.
• CLAUDE_CODE_OAUTH_TOKEN_FILE_DESCRIPTOR: File descriptor to read OAuth token from.

Frequently asked questions

All variables, searchable: Claude Code environment variables.