ANTHROPIC_AUTH_TOKEN
Updated by Alex Sorokoletov
ANTHROPIC_AUTH_TOKEN is a Claude Code environment variable: Alternative bearer token; takes priority over API key. Its release history is not tracked here. It is listed in the official reference.
| Status | Present in v2.1.318 |
|---|---|
| Category | Authentication |
| Official docs | Listed |
How to set it
For one session, export it in the shell that starts Claude Code:
export ANTHROPIC_AUTH_TOKEN=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "<value>"
}
}Release notes that mention it
Related variables
CLAUDE_CODE_MCP_SERVE_AUTH_TOKEN: Set the bearer token used to authenticate the MCP serve process; without it it fell back to reading auth from stdout.ANTHROPIC_API_KEY: Primary API key for Claude API.CLAUDE_BG_AUTH_SNAPSHOT_PATH: Path for snapshotting background session auth credentials to disk.CLAUDE_BG_CLAIM_AUTH: Held the claim authentication token for a background spare session's claim gate, used as a fallback when the socket tokens file supplied none; read until v2.1.309.CLAUDE_BG_PTY_AUTH: Carries the authentication token for the background PTY host's data gate; it is consumed and removed at startup, and the socket tokens file takes precedence.CLAUDE_BG_RV_AUTH: Carries the authentication token for the background rendezvous socket server; it is consumed and removed at startup, and the socket tokens file takes precedence.CLAUDE_CODE_ARTIFACTS_API_TOKEN: Auth token for the artifacts service.CLAUDE_CODE_AUTH_FAIL_EXIT_MS: In a remote child, the number of milliseconds authentication may stay unrecovered before the process exits; defaults to 600000, and a value of 0 or less disables the exit.
Frequently asked questions
What does ANTHROPIC_AUTH_TOKEN do?
Alternative bearer token; takes priority over API key
Which Claude Code version has ANTHROPIC_AUTH_TOKEN?
Its release history is not tracked here.
How do I set ANTHROPIC_AUTH_TOKEN?
Export it before starting Claude Code (export ANTHROPIC_AUTH_TOKEN=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.