claude-code-proxy/config.yaml.example

# LLM Proxy Configuration Example
# This file demonstrates all available configuration options
# Copy this file to config.yaml and customize as needed

# Server configuration
server:
  # Port to listen on (default: 3001)
  port: 3001
  
  # Timeout configurations
  timeouts:
    # Maximum duration for reading the entire request, including the body
    read: 10m
    
    # Maximum duration before timing out writes of the response
    write: 10m
    
    # Maximum amount of time to wait for the next request when keep-alives are enabled
    idle: 10m

# Provider configurations
providers:
  # Anthropic Claude configuration
  anthropic:
    # Base URL for Anthropic API (can be changed for custom endpoints)
    base_url: "https://api.anthropic.com"

    # Maximum number of retries for failed requests
    max_retries: 3

  # OpenAI configuration
  openai:
    # API key for OpenAI
    # Can also be set via OPENAI_API_KEY environment variable
    # api_key: "..."

    # Base URL for OpenAI API (can be changed for custom endpoints)
    # Can also be set via OPENAI_BASE_URL environment variable
    # base_url: "https://api.openai.com"

    # Allow clients to provide their own API key via header
    # Can also be set via OPENAI_ALLOW_CLIENT_API_KEY environment variable
    allow_client_api_key: false

    # Header name for client-provided API key (default: x-openai-api-key)
    # Can also be set via OPENAI_CLIENT_API_KEY_HEADER environment variable
    client_api_key_header: "x-openai-api-key"

# CORS Configuration
# Controls Cross-Origin Resource Sharing for the web UI
cors:
  # Allowed origins (use ["*"] for all origins - not recommended for production)
  # Can also be set via CORS_ALLOWED_ORIGINS environment variable (comma-separated)
  allowed_origins:
    - "*"

  # Allowed HTTP methods
  # Can also be set via CORS_ALLOWED_METHODS environment variable (comma-separated)
  allowed_methods:
    - "GET"
    - "POST"
    - "PUT"
    - "DELETE"
    - "OPTIONS"

  # Allowed headers (use ["*"] for all headers)
  # Can also be set via CORS_ALLOWED_HEADERS environment variable (comma-separated)
  allowed_headers:
    - "*"

# Storage configuration
storage:
  # SQLite database path for storing request history
  db_path: "requests.db"
  
  # Directory for storing request files (if needed in future)
  # requests_dir: "./requests"

# Subagent Configuration (Optional)
# Enable this feature if you want to route specific Claude Code agents to different LLM providers
# For subagent setup instructions, see: https://docs.anthropic.com/en/docs/claude-code/sub-agents
subagents:
  # Enable subagent routing (default: false)
  enable: false
  
  # Maps subagent types to specific models
  # Only used when enable: true
  mappings:
    # Code review specialist (example)
    # code-reviewer: "gpt-4o"
    
    # Data analysis expert (example)
    # data-analyst: "o3"
    
    # Documentation writer (example)
    # doc-writer: "gpt-3.5-turbo"

# Environment variable overrides:
# The following environment variables will override the YAML configuration:
#
# Server:
#   PORT                            - Server port
#   READ_TIMEOUT                    - Read timeout duration
#   WRITE_TIMEOUT                   - Write timeout duration
#   IDLE_TIMEOUT                    - Idle timeout duration
#
# Anthropic:
#   ANTHROPIC_FORWARD_URL           - Anthropic base URL
#   ANTHROPIC_VERSION               - Anthropic API version
#   ANTHROPIC_MAX_RETRIES           - Maximum retries for Anthropic requests
#
# OpenAI:
#   OPENAI_API_KEY                  - OpenAI API key
#   OPENAI_BASE_URL                 - OpenAI base URL
#   OPENAI_ALLOW_CLIENT_API_KEY     - Allow client-provided API keys (true/false)
#   OPENAI_CLIENT_API_KEY_HEADER    - Header name for client API key
#
# Storage:
#   DB_PATH                         - Database file path
#
# CORS:
#   CORS_ALLOWED_ORIGINS            - Comma-separated allowed origins
#   CORS_ALLOWED_METHODS            - Comma-separated allowed methods
#   CORS_ALLOWED_HEADERS            - Comma-separated allowed headers
#
# Subagents:
#   SUBAGENT_MAPPINGS               - Comma-separated subagent:model pairs
#                                     Example: "code-reviewer:claude-3-5-sonnet"