Skip to content

docs: Claude Code env variables reference + new vars audit#565

Draft
davila7 wants to merge 2 commits intomainfrom
claude/find-new-env-variables-n2aHn
Draft

docs: Claude Code env variables reference + new vars audit#565
davila7 wants to merge 2 commits intomainfrom
claude/find-new-env-variables-n2aHn

Conversation

@davila7
Copy link
Copy Markdown
Owner

@davila7 davila7 commented May 5, 2026

Summary

Adds docs/guides/claude-code-env-variables.md — a complete reference of every environment variable Claude Code supports (synced from code.claude.com/docs/en/env-vars on 2026-05-05).

The guide also audits this repository: it compares the official list (~138 vars) against every reference inside cli-tool/, dashboard/, docs/, api/, and scripts/, and flags 110+ env vars that are new / not yet covered by any component, setting, or doc here.

What's "new" (highlights)

  • Microsoft Foundry / Azure provider: ANTHROPIC_FOUNDRY_API_KEY, ANTHROPIC_FOUNDRY_BASE_URL, ANTHROPIC_FOUNDRY_RESOURCE, CLAUDE_CODE_SKIP_FOUNDRY_AUTH
  • Fast mode (Opus 4.6): CLAUDE_CODE_DISABLE_FAST_MODE
  • 1M context: CLAUDE_CODE_DISABLE_1M_CONTEXT
  • Adaptive thinking / effort tiers: CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING, CLAUDE_CODE_EFFORT_LEVEL, MAX_THINKING_TOKENS, CLAUDE_CODE_DISABLE_THINKING
  • Agent teams (experimental): CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS, CLAUDE_CODE_TEAM_NAME
  • Custom model picker: ANTHROPIC_DEFAULT_*_NAME/_DESCRIPTION/_SUPPORTED_CAPABILITIES, ANTHROPIC_CUSTOM_MODEL_OPTION*, CLAUDE_CODE_SUBAGENT_MODEL
  • Plugin system: CLAUDE_CODE_PLUGIN_CACHE_DIR, CLAUDE_CODE_PLUGIN_SEED_DIR, CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE, CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL, CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH, CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS, CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS
  • OAuth via Claude.ai: CLAUDE_CODE_OAUTH_TOKEN, CLAUDE_CODE_OAUTH_REFRESH_TOKEN, CLAUDE_CODE_OAUTH_SCOPES
  • mTLS / cert store: CLAUDE_CODE_CERT_STORE, CLAUDE_CODE_CLIENT_CERT, CLAUDE_CODE_CLIENT_KEY, CLAUDE_CODE_CLIENT_KEY_PASSPHRASE, CLAUDE_CODE_PROXY_RESOLVES_HOSTS
  • File checkpointing / rewind: CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING
  • Cloud sessions: CLAUDE_CODE_REMOTE_SESSION_ID, CCR_FORCE_BUNDLE

Inconsistencies found in existing components

  • ANTHROPIC_FOUNDRY_AUTH_TOKEN (used in components) → official is ANTHROPIC_FOUNDRY_API_KEY
  • ANTHROPIC_ATTRIBUTION (used in components) → official is CLAUDE_CODE_ATTRIBUTION_HEADER
  • ANTHROPIC_SMALL_FAST_MODEL is deprecated → use ANTHROPIC_DEFAULT_HAIKU_MODEL
  • ANTHROPIC_TOOLS is referenced but does not exist in the official docs

Test plan

  • All variable names cross-checked against the official docs page
  • Codebase grep confirms which variables are already referenced
  • (Follow-up) Add new cli-tool/components/settings/environment/* presets covering the highest-value new toggles (fast mode, 1M context, plugin cache, mTLS, agent teams, OAuth)
  • (Follow-up) Fix the four inconsistent variable names listed above

https://claude.ai/code/session_01UZ9YzQ6WdT9xNCEWnecRyQ


Generated by Claude Code


Summary by cubic

Adds a complete Claude Code environment variable reference and a repo-wide audit. Fixes audit false positives and narrows inconsistencies to one misnamed var.

  • Area: website (docs/)
  • Added docs/guides/claude-code-env-variables.md (synced 2026-05-05) covering ~138 vars; flags 110+ not referenced
  • Recount: 24 vars already referenced (was 26); removed false positives ANTHROPIC_TOOLS and ANTHROPIC_ATTRIBUTION
  • Inconsistency: fix ANTHROPIC_FOUNDRY_AUTH_TOKENANTHROPIC_FOUNDRY_API_KEY; deprecates ANTHROPIC_SMALL_FAST_MODEL
  • No new components; catalog (docs/components.json) does not need regeneration; no new env vars or secrets required

Written for commit 620a554. Summary will update on new commits.

Documents all ~138 environment variables from the official Claude Code
docs (code.claude.com/docs/en/env-vars), compares them against what is
already referenced in this repo, and flags 110+ new variables not yet
covered. Highlights variables tied to recent features: Microsoft Foundry,
fast mode, 1M context, adaptive thinking, agent teams, the plugin
system, OAuth, mTLS, and file checkpointing.

Also flags inconsistencies in existing component env names:
- ANTHROPIC_FOUNDRY_AUTH_TOKEN -> ANTHROPIC_FOUNDRY_API_KEY
- ANTHROPIC_ATTRIBUTION -> CLAUDE_CODE_ATTRIBUTION_HEADER
- ANTHROPIC_SMALL_FAST_MODEL is deprecated

https://claude.ai/code/session_01UZ9YzQ6WdT9xNCEWnecRyQ
@vercel
Copy link
Copy Markdown

vercel Bot commented May 5, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
aitmpl-dashboard Ready Ready Preview, Comment May 5, 2026 2:51pm
claude-code-templates Ready Ready Preview, Comment May 5, 2026 2:51pm

ANTHROPIC_TOOLS and ANTHROPIC_ATTRIBUTION were caught by the regex but
are not env vars:
- ANTHROPIC_TOOLS is instructor.Mode.ANTHROPIC_TOOLS (Python instructor library enum)
- ANTHROPIC_ATTRIBUTION is a markdown filename in cli-tool/README.md

Recount: 24 already-referenced env vars (was 26).

ANTHROPIC_FOUNDRY_AUTH_TOKEN is a real but incorrectly-named env var
reference at cli-tool/components/skills/development/claude-api/php/claude-api.md:48
- correct name is ANTHROPIC_FOUNDRY_API_KEY.

https://claude.ai/code/session_01UZ9YzQ6WdT9xNCEWnecRyQ
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants