Skip to content

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

Draft
davila7 wants to merge 1 commit intomainfrom
claude/find-new-env-variables-n2aHn
Draft

docs: Claude Code env variables reference + new vars audit#565
davila7 wants to merge 1 commit 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 full Claude Code environment variable reference and a repo-wide audit to surface gaps. Improves configuration clarity and flags 110+ uncovered vars plus a few naming inconsistencies.

  • Area: website (docs/)
  • Added docs/guides/claude-code-env-variables.md (synced 2026-05-05) covering ~138 vars, including new provider and feature toggles
  • Audit: 110+ vars not referenced; fixes needed for ANTHROPIC_FOUNDRY_AUTH_TOKENANTHROPIC_FOUNDRY_API_KEY, ANTHROPIC_ATTRIBUTIONCLAUDE_CODE_ATTRIBUTION_HEADER, and deprecates ANTHROPIC_SMALL_FAST_MODEL
  • No new components; catalog (docs/components.json) does not need regeneration
  • No new env vars or secrets required; follow-ups suggested to add presets and correct names

Written for commit 92f50cf. 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:10am
claude-code-templates Ready Ready Preview, Comment May 5, 2026 2:10am

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