# Set the API key
export CODEBUDDY_API_KEY="your-api-key"

# Set the proxy server
export HTTP_PROXY="http://proxy.example.com:8080"
export HTTPS_PROXY="https://proxy.example.com:8080"

# Set the proxy bypass list
export NO_PROXY="localhost,127.0.0.1,.internal.example.com"

# Set custom request headers (separate multiple headers with \\n)
export CODEBUDDY_CUSTOM_HEADERS="X-Custom-Header: value1\\nX-Another-Header: value2"

# Start CodeBuddy
codebuddy

# Use a custom API endpoint
export CODEBUDDY_API_KEY="your-api-key"
export CODEBUDDY_BASE_URL="https://api.example.com/v1"
codebuddy --model your-model-name

# Endpoints and keys
export CODEBUDDY_BASE_URL="https://api.deepseek.com"
export CODEBUDDY_API_KEY="<your-deepseek-api-key>"

# Default model for the main Agent
export CODEBUDDY_MODEL="deepseek-v4-pro"

# Large model for complex reasoning
export CODEBUDDY_BIG_SLOW_MODEL="deepseek-v4-pro"

# Small model for background or lightweight tasks
export CODEBUDDY_SMALL_FAST_MODEL="deepseek-v4-flash"

# Unified coverage of all subagents at the Ops level.
# If not set, the system continues to use single-call mode, per-subagent settings, and built-in product orchestration.
export CODEBUDDY_CODE_SUBAGENT_MODEL="deepseek-v4-flash"

# You can explicitly specify the main model at startup by using --model.
codebuddy --model deepseek-v4-pro

# Set the China edition environment identifier
export CODEBUDDY_INTERNET_ENVIRONMENT=internal

# Set the API key
export CODEBUDDY_API_KEY="your-api-key"

# Start CodeBuddy
codebuddy

# Enable automatic memory
export CODEBUDDY_DISABLE_AUTO_MEMORY="0"

# Enable extended thinking
export MAX_THINKING_TOKENS="10000"

# Run in non-interactive mode
codebuddy -p -y "Your query"

# Enable debug mode
export CODEBUDDY_DEBUG="1"

# Enable startup performance analysis
export CODEBUDDY_STARTUP_PROFILE="1"

# Start CodeBuddy
codebuddy

{
  "env": {
    "CODEBUDDY_API_KEY": "your-api-key",
    "HTTPS_PROXY": "https://proxy.example.com:8080",
    "MAX_THINKING_TOKENS": "10000",
    "CODEBUDDY_DISABLE_AUTO_MEMORY": "0"
  }
}

Shell output
  ├─→ OutputSpiller (streams the complete output to disk)
  └─→ TruncateBuffer (retains head + tail in memory, approximately 30 KB)
                          ↓
                  When truncation is detected, a placeholder is generated (approximately 2 KB preview + file path).
                          ↓
                  When the model receives a placeholder, it can read the complete file on demand through the Read tool.

~/.codebuddy/projects/{projectDir}/
  └── {sessionId}/
      ├── tool-results/                          ← Tool results for the main session
      │   ├── {callId}.txt
      │   └── ...
      └── subagents/                             ← Subagent data
          ├── agent-{agentId}.jsonl              ← Subagent conversation history
          └── agent-{agentId}/
              └── tool-results/                  ← Tool results for the subagent
                  ├── {callId}.txt
                  └── ...