# ============================================================================= # Claude Code CLI — Environment Variables # ============================================================================= # Copy this file to .env and fill in the values you need. # All variables are optional unless noted otherwise. # ============================================================================= # ── Authentication ─────────────────────────────────────────────────────────── # Your Anthropic API key (required for direct API access) ANTHROPIC_API_KEY= # Custom API base URL (default: https://api.anthropic.com) # ANTHROPIC_BASE_URL= # ── Model Selection ────────────────────────────────────────────────────────── # Override the default model # ANTHROPIC_MODEL= # Override the small/fast model used internally # ANTHROPIC_SMALL_FAST_MODEL= # Custom model overrides (name + description are optional display labels) # ANTHROPIC_DEFAULT_OPUS_MODEL= # ANTHROPIC_DEFAULT_OPUS_MODEL_NAME= # ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION= # ANTHROPIC_DEFAULT_SONNET_MODEL= # ANTHROPIC_DEFAULT_SONNET_MODEL_NAME= # ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION= # ANTHROPIC_DEFAULT_HAIKU_MODEL= # ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME= # ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION= # Custom model option (shown alongside built-in models) # ANTHROPIC_CUSTOM_MODEL_OPTION= # ANTHROPIC_CUSTOM_MODEL_OPTION_NAME= # ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION= # Model for sub-agents / teammates # CLAUDE_CODE_SUBAGENT_MODEL= # ── Alternative Providers ──────────────────────────────────────────────────── # Use AWS Bedrock instead of direct Anthropic API # CLAUDE_CODE_USE_BEDROCK=true # ANTHROPIC_BEDROCK_BASE_URL= # AWS_BEARER_TOKEN_BEDROCK= # CLAUDE_CODE_SKIP_BEDROCK_AUTH=false # Use Google Vertex AI # CLAUDE_CODE_USE_VERTEX=true # ── Shell & Environment ───────────────────────────────────────────────────── # Override shell used for BashTool (default: auto-detected) # CLAUDE_CODE_SHELL=/bin/bash # Prefix prepended to every shell command # CLAUDE_CODE_SHELL_PREFIX= # Override temp directory # CLAUDE_CODE_TMPDIR= # ── Performance & Limits ───────────────────────────────────────────────────── # Maximum output tokens per response # CLAUDE_CODE_MAX_OUTPUT_TOKENS= # Maximum tokens when reading files # CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS= # Idle timeout (minutes) before session ends (default: 75) # CLAUDE_CODE_IDLE_THRESHOLD_MINUTES=75 # Idle token threshold (default: 100000) # CLAUDE_CODE_IDLE_TOKEN_THRESHOLD=100000 # Node.js options (e.g. heap size) # NODE_OPTIONS=--max-old-space-size=8192 # ── Features & Modes ──────────────────────────────────────────────────────── # Enable simplified/worker mode # CLAUDE_CODE_SIMPLE=true # Enable coordinator (multi-agent) mode # CLAUDE_CODE_COORDINATOR_MODE=true # Enable proactive mode # CLAUDE_CODE_PROACTIVE=true # Enable experimental agent teams # CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=true # Enable task management # CLAUDE_CODE_ENABLE_TASKS=true # Enable prompt suggestions # CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=true # ── Accessibility & UX ────────────────────────────────────────────────────── # Enable accessibility mode # CLAUDE_CODE_ACCESSIBILITY=true # Disable terminal title updates # CLAUDE_CODE_DISABLE_TERMINAL_TITLE=true # Disable virtual scrolling # CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL=true # Streamlined output (less verbose) # CLAUDE_CODE_STREAMLINED_OUTPUT=true # Disable syntax highlighting # CLAUDE_CODE_SYNTAX_HIGHLIGHT=false # ── Remote / Bridge ───────────────────────────────────────────────────────── # Enable remote execution mode # CLAUDE_CODE_REMOTE=true # Remote session ID # CLAUDE_CODE_REMOTE_SESSION_ID= # Environment kind (e.g. bridge) # CLAUDE_CODE_ENVIRONMENT_KIND= # OAuth tokens for bridge # CLAUDE_CODE_OAUTH_REFRESH_TOKEN= # CLAUDE_CODE_OAUTH_SCOPES= # ── Debugging ──────────────────────────────────────────────────────────────── # Debug log level (error, warn, info, debug, trace) # CLAUDE_CODE_DEBUG_LOG_LEVEL=info # Debug logs directory # CLAUDE_CODE_DEBUG_LOGS_DIR= # Enable startup profiling # CLAUDE_CODE_PROFILE_STARTUP=true # General debug flag # DEBUG=true # ── Privacy & Telemetry ───────────────────────────────────────────────────── # Disable telemetry # DISABLE_TELEMETRY=true # Disable non-essential network traffic # CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=true # ── Proxy & Network ───────────────────────────────────────────────────────── # HTTPS proxy # HTTPS_PROXY= # Custom SSL certificate # SSL_CERT_FILE= # Unix socket for Anthropic API # ANTHROPIC_UNIX_SOCKET=