ANTHROPIC_AUTH_TOKEN

Updated by

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.

StatusPresent in v2.1.318
CategoryAuthentication
Official docsListed

How to set it

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

export ANTHROPIC_AUTH_TOKEN=<value>
claude

To 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.