CLAUDE_LOCAL_OAUTH_APPS_BASE

Updated October 13, 2026 by Alex Sorokoletov

CLAUDE_LOCAL_OAUTH_APPS_BASE is a Claude Code environment variable: Overrides the base URL for the local OAuth applications registry. Together with CLAUDE_LOCAL_OAUTH_API_BASE, this completes a two-part override for the OAuth flow: one for token operations, one for app registration and discovery. 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_APPS_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_APPS_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_API_BASE: Overrides the base URL for local OAuth API operations.
• CLAUDE_LOCAL_OAUTH_CONSOLE_BASE: Overrides the base URL for the OAuth console interface.
• 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.