Claude Code - Environment Variables (Updated April 13, 2026 - v2.1.104)

cc-env-settings.md

Claude Code — Environment Variables & settings.json Options

Source: claude-code-internals plugin v2.5.0 reference files (binary-verified through v2.1.104).

Environment Variables

Authentication & API

Variable	Default	Description
ANTHROPIC_API_KEY	—	Anthropic API auth token
ANTHROPIC_CUSTOM_MODEL_OPTION	—	Custom model ID for non-standard routing
ANTHROPIC_CUSTOM_MODEL_OPTION_NAME	model ID	Display name in model picker
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION	"Custom model ()"	Picker description
ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES	—	Comma-sep capabilities (thinking, effort, interleaved_thinking, adaptive_thinking, max_effort)
ANTHROPIC_DEFAULT_OPUS_MODEL / _SUPPORTED_CAPABILITIES	—	Override default Opus + caps
ANTHROPIC_DEFAULT_SONNET_MODEL / _SUPPORTED_CAPABILITIES	—	Override default Sonnet + caps
ANTHROPIC_DEFAULT_HAIKU_MODEL / _SUPPORTED_CAPABILITIES	—	Override default Haiku + caps
CLAUDE_CODE_OAUTH_TOKEN	—	OAuth refresh token

Provider Selection

Variable	Description
CLAUDE_CODE_USE_BEDROCK	Route via AWS Bedrock
CLAUDE_CODE_USE_VERTEX	Route via Google Vertex AI
CLAUDE_CODE_USE_FOUNDRY	Route via Anthropic Foundry
CLAUDE_CODE_USE_MANTLE	Route via Mantle (v2.1.94)
CLAUDE_CODE_USE_ANTHROPIC_AWS	Anthropic-managed AWS endpoints
CLAUDE_CODE_SKIP_BEDROCK_AUTH	Skip Bedrock auth refresh (debug)
CLAUDE_CODE_SKIP_MANTLE_AUTH	Skip Mantle auth refresh (debug)
CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH	Deprecated; see SKIP_BEDROCK_AUTH

Bedrock / Mantle Credentials

Variable	Default	Description
ANTHROPIC_BEDROCK_MANTLE_API_KEY	—	Mantle backend API key
ANTHROPIC_BEDROCK_MANTLE_BASE_URL	from AWS_REGION	Override Mantle URL
AWS_BEARER_TOKEN_BEDROCK	—	Bedrock auth token

Certificates & TLS

Variable	Default	Description
CLAUDE_CODE_CERT_STORE	bundled	"bundled", "system", or comma-sep list (v2.1.101)
NODE_EXTRA_CA_CERTS	—	Extra CA cert paths

Effort & Context

Variable	Default	Description
CLAUDE_CODE_EFFORT_LEVEL	—	low / medium / high / max / auto
CLAUDE_CODE_MAX_CONTEXT_TOKENS	—	Override context window (v2.1.98)
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY	10	Max concurrent tool calls
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS	—	Token limit for Read
CLAUDE_CODE_AUTO_COMPACT_WINDOW	—	Compaction token threshold
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE	—	Override compact % (v2.1.101)

Session Resume

Variable	Default	Description
CLAUDE_CODE_RESUME_THRESHOLD_MINUTES	70	Idle mins before resume prompt
CLAUDE_CODE_RESUME_TOKEN_THRESHOLD	100000	Min tokens to offer resume
CLAUDE_CODE_RESUME_INTERRUPTED_TURN	—	Auto-resume mid-turn (v2.1.101)

Memory

Variable	Description
CLAUDE_CODE_DISABLE_AUTO_MEMORY	Disable auto-memory extraction
CLAUDE_CODE_REMOTE_MEMORY_DIR	Shared/remote memory dir path

Simple / Bare Mode

Variable	Description
CLAUDE_CODE_SIMPLE	Bare mode (minimal prompt, tools = Bash/Read/Edit)
CLAUDE_SIMPLE	Alias for above

Script Mode & Security

Variable	Description
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB	Scrub sensitive env from subprocesses
CLAUDE_CODE_SCRIPT_CAPS	JSON limiting per-cmd Bash calls, e.g. {"curl":3} (v2.1.98)
CLAUDE_CODE_SANDBOXED	Mark session sandboxed/trusted (v2.1.94)
CLAUDE_CODE_PERFORCE_MODE	Perforce/Helix workspace mode (v2.1.98)

Remote / Cloud / Coordinator

Variable	Description
CLAUDE_CODE_REMOTE	Running in CCR container
CLAUDE_CODE_COORDINATOR_MODE	Agent coordinator mode
CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX	Prefix for auto session names (default: hostname)
CCR_UPSTREAM_PROXY_ENABLED	CCR upstream proxy

Plugins & Skills

Variable	Description
CLAUDE_CODE_PLUGIN_SEED_DIR	Read-only plugin seed dir (enterprise)
CLAUDE_CODE_PLUGIN_USE_ZIP_CACHE	Store plugins as .zip (headless/container)
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE	Keep marketplace on load failure
CLAUDE_CODE_CUSTOM_OAUTH_URL	Custom OAuth URL (allowlist-validated)
CLAUDE_CODE_DISABLE_CLAUDE_API_SKILL	Disable built-in claude-api skill
CLAUDE_CODE_DISABLE_POLICY_SKILLS	Disable enterprise policy skills

MCP

Variable	Default	Description
CLAUDE_CODE_MCP_ALLOWLIST_ENV	true (local-agent)	Env-var allowlisting for MCP (v2.1.94)

UI

Variable	Description
CLAUDE_CODE_NO_FLICKER	Disable alt-screen (ANSI mode)
CLAUDE_CODE_DISABLE_MOUSE	Disable mouse capture
CLAUDE_CODE_DISABLE_MOUSE_CLICKS	Disable click/drag, keep wheel
CLAUDE_CODE_GLOB_HIDDEN	Include hidden files in glob (default: off)
CLAUDE_CODE_GLOB_NO_IGNORE	Bypass .gitignore in glob
CLAUDE_CODE_SHELL_PREFIX	Custom shell prompt prefix

Debug / Test

Variable	Description
CLAUDE_CODE_SIMULATE_PROXY_USAGE	Simulate proxy network (v2.1.92)
CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK	Skip fast-mode org eligibility (v2.1.92)
CLAUDE_CODE_AGENT_COST_STEER	Cost hint for agent spawn
CLAUDE_CODE_UNATTENDED_RETRY	Unattended retry (5min backoff, 6h cap)
CLAUDE_CODE_TEAM_ONBOARDING	"banner" or "step" (v2.1.94)
CLAUDE_CODE_EXECPATH	Binary path (auto-injected)
CLAUDE_CODE_ENTRYPOINT	Entrypoint type (local-agent, remote…)
CLAUDE_CODE_REMOTE_SETTINGS_PATH	Path to remote settings file

Streaming

Variable	Default	Description
CLAUDE_STREAM_IDLE_TIMEOUT_MS	90000	Stream idle timeout before fallback
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK	—	Never fall back to non-streaming

Fast Mode / Cron / Experimental

Variable	Description
CLAUDE_CODE_DISABLE_FAST_MODE	Hard-disable fast mode
CLAUDE_CODE_DISABLE_CRON	Disable scheduled triggers
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS	Experimental agent teams
CLAUDE_CODE_BRIEF	Brief-mode permission (Kairos)
CLAUDE_CODE_ENABLE_CFC	CFC feature

Removed / Deprecated

Variable	Status
CLAUDE_CODE_REPL / CLAUDE_REPL_MODE	removed v2.1.97
CLAUDE_CODE_SAVE_HOOK_ADDITIONAL_CONTEXT	removed v2.1.97
CLAUDE_CODE_DISABLE_COMMAND_INJECTION_CHECK	removed v2.1.90
CLAUDE_CODE_MCP_INSTR_DELTA	removed v2.1.91