claude-code-gateway

Minimal Claude Code multi-provider gateway. Zero format conversion, just smart routing.

Installation

npx claude-code-gateway

Configuration

Create ~/.claude/claude-gateway.json:

{
  "providers": [
    {
      "name": "kimi",
      "baseUrl": "https://api.moonshot.cn/v1",
      "apiKey": "${KIMI_API_KEY}",
      "models": [
        { "id": "kimi-k2.6", "alias": "claude-kimi-k2.6", "name": "Kimi K2.6" }
      ]
    }
  ]
}

Or use your existing ~/.claude/custom-providers.json.

Usage

Start the gateway:

npx claude-code-gateway --port 3456

Configure Claude Code:

export ANTHROPIC_BASE_URL=http://localhost:3456
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

Switch models in Claude Code:

• Via picker: /model → select "Kimi K2.6"
• Direct: /model kimi,kimi-k2.6

Features

• Zero format conversion: Providers must natively support Anthropic Messages API
• Dual routing: provider,model syntax or alias discovery
• Model aggregation: /v1/models with claude-* aliases for Claude Code discovery
• SSE streaming: Direct pipe, zero latency overhead
• Environment variables: ${ENV_VAR} syntax in config