claude-code/.env.example

# =============================================================================
# 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=