CLAUDE_AI_AUTHORIZE_URL

Updated October 13, 2026 by Alex Sorokoletov

CLAUDE_AI_AUTHORIZE_URL is a Claude Code environment variable: Authorization URL endpoint. Present since v2.1.69 or earlier and still present in v2.1.294. It is not in the official reference.

Status	Present in v2.1.294
Added	Present since v2.1.69 or earlier
Category	Authentication
Official docs	Not listed

How to set it

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

export CLAUDE_AI_AUTHORIZE_URL=<value>
claude

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

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

Release notes that mention it

83 Undocumented Claude Code Environment Variables (v2.1.19)

Related variables

CLAUDE_CODE_CUSTOM_OAUTH_URL: Custom OAuth endpoint URL.
ANTHROPIC_API_KEY: Primary API key for Claude API.
ANTHROPIC_AUTH_TOKEN: Alternative bearer token; takes priority over API key.
CLAUDE_BG_AUTH_SNAPSHOT_PATH: Path for snapshotting background session auth credentials to disk.
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_CERT_STORE: Controls which certificate authority store Claude Code uses for TLS verification.
CLAUDE_CODE_CLIENT_CERT: Path to client certificate for mTLS.

Frequently asked questions

What does CLAUDE_AI_AUTHORIZE_URL do?

Authorization URL endpoint

Which Claude Code version has CLAUDE_AI_AUTHORIZE_URL?

Present since v2.1.69 or earlier and still present in v2.1.294.

How do I set CLAUDE_AI_AUTHORIZE_URL?

Export it before starting Claude Code (export CLAUDE_AI_AUTHORIZE_URL=value), or add it to the "env" object in ~/.claude/settings.json to apply it to every session.

All variables, searchable: Claude Code environment variables.