ProxyPilot

[!TIP] 📣 Latest models supported: Claude Opus 4.5 / Sonnet 4.5 with extended thinking, GPT-5.2 / GPT-5.2 Codex, Gemini 3 Pro/Flash, and Kiro (AWS CodeWhisperer)! 🚀

Setup Guides:

• Claude Code Setup →
• Cursor IDE Setup →

Features

• 🎯 10 Auth Providers - Claude, Codex (OpenAI), Gemini, Gemini CLI, Kiro (AWS), Amazon Q CLI, Qwen, Antigravity, MiniMax, Zhipu AI
• 🔄 Universal API Translation - Auto-converts between OpenAI, Anthropic, and Gemini formats
• 🔧 Tool Calling Repair - Fixes tool/function call mismatches between providers automatically
• 🧠 Extended Thinking - Full support for Claude and Gemini thinking models
• 🔐 OAuth Integration - Browser-based login with automatic token refresh
• 👥 Multi-Account Support - Round-robin distribution with automatic failover
• ⚡ Quota Auto-Switch - Automatically switches to backup project/model when quota exceeded
• 📊 Usage Statistics - Track requests, tokens, and errors per provider/model
• 🧩 Context Compression - LLM-based summarization for long sessions (Factory.ai research)
• 🤖 Agentic Harness - Guided workflow for coding agents (Anthropic research)
• 💾 Session Memory - Persistent storage across conversation turns
• 🎨 System Tray - Native Windows tray app for quick access
• 🔄 Auto-Updates - Background update checking with one-click install
• ⏪ Rollback Support - Automatic crash detection with version recovery
• 📡 60+ Management APIs - Full control via REST endpoints

Supported Providers

Account risk warning: Claude/Anthropic OAuth, Google/Gemini OAuth, Gemini CLI OAuth, and Antigravity OAuth are unofficial compatibility paths. Providers may treat proxy, automation, shared-token, or third-party OAuth traffic as a policy violation or abnormal usage. Using these login flows can risk quota loss, account restriction, or account suspension. Prefer official API-key or officially supported developer access for important accounts.

Installation

Download Pre-built Release (Recommended)

1. Go to the Releases page
2. Download the latest binary for your platform
3. Run ./proxypilot

Build from Source

git clone https://github.com/Finesssee/ProxyPilot.git
cd ProxyPilot
go build -o proxypilot ./cmd/server
./proxypilot

Usage

First Launch

1. Packaged installs create config.yaml automatically on first start when config.example.yaml is bundled next to the executable.
2. If you're running from source, copy config: cp config.example.yaml config.yaml
3. Run: ./proxypilot
4. Server starts on http://localhost:8317
5. Open dashboard: http://localhost:8317/management.html

Authentication

Run OAuth login for your provider:

# OAuth providers (opens browser)
./proxypilot --claude-login        # Claude
./proxypilot --codex-login         # OpenAI/Codex
./proxypilot --login               # Gemini
./proxypilot --kiro-login          # Kiro (AWS Builder ID)
./proxypilot --kiro-aws-login      # Kiro (AWS Builder ID device code)
./proxypilot --qwen-login          # Qwen
./proxypilot --antigravity-login   # Antigravity

# Import providers (from existing CLI tools)
./proxypilot --kiro-import         # Kiro IDE token

# API key providers (prompts for key)
./proxypilot --minimax-login       # MiniMax API key
./proxypilot --zhipu-login         # Zhipu AI API key

OAuth tokens are stored locally and auto-refreshed before expiry.

High-risk OAuth providers: --claude-login, --login / Gemini, Gemini CLI OAuth, and --antigravity-login may violate provider expectations or trigger anti-abuse/account-protection systems. Do not use production, billing-critical, school/work, or irreplaceable personal accounts with these flows unless you accept the account-risk tradeoff. Prefer official API keys where available.

Kiro Google/GitHub OAuth is not currently supported because AWS Cognito rejects third-party localhost callbacks. Use AWS Builder ID (--kiro-login / --kiro-aws-login) or import from the official Kiro IDE.

Security Defaults (Auth + CORS)

• Proxy requests require API keys by default. To allow unauthenticated access (not recommended), set allow-unauthenticated: true in config.yaml.
• CORS is enabled for non-management endpoints by default (wildcard *). Management endpoints do not emit CORS headers unless you explicitly allow origins under cors.management-allow-origins.

Example:

allow-unauthenticated: false
cors:
  allow-origins:
    - "http://localhost:5173"
  management-allow-origins:
    - "http://localhost:5173"

Configure Your Tools

Claude Code (~/.claude/settings.json):

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:8317",
    "ANTHROPIC_AUTH_TOKEN": "your-api-key"
  }
}

Codex CLI (~/.codex/config.toml):

[openai]
api_base_url = "http://127.0.0.1:8317"

Factory Droid (~/.factory/settings.json):

{
  "customModels": [{
    "name": "ProxyPilot",
    "baseUrl": "http://127.0.0.1:8317"
  }]
}

API Endpoints

POST /v1/chat/completions     # OpenAI Chat Completions
POST /v1/responses            # OpenAI Responses API
POST /v1/messages             # Anthropic Messages API
GET  /v1/models               # List available models
GET  /healthz                 # Health check

All endpoints auto-translate between formats based on the target provider.

Caching

ProxyPilot includes two caching layers to reduce latency and token usage.

Response Cache

Caches full API responses for identical requests. Useful for repeated queries during development.

Config (config.yaml):

response-cache:
  enabled: true           # Default: false
  max-size: 1000          # Max entries (default: 1000)
  max-bytes: 0            # Optional total cache size cap in bytes
  ttl-seconds: 300        # Cache TTL (default: 300 = 5 min)
  exclude-models:         # Models to skip (supports wildcards)
    - "*-thinking"
    - "o1-*"

Prompt Cache

Synthetic prompt caching for providers without native support. Tracks repeated system prompts and estimates token savings.

Config (config.yaml):

prompt-cache:
  enabled: true           # Default: false
  max-size: 500           # Max entries (default: 500)
  max-bytes: 0            # Optional total cache size cap in bytes
  ttl-seconds: 1800       # Cache TTL (default: 1800 = 30 min)

Cache Management API

Lightweight Profile

For low‑memory or high‑throughput setups, you can disable heavier features:

commercial-mode: true
usage-statistics-enabled: false
usage-sample-rate: 0.25
metrics-enabled: false
request-history-enabled: false
request-history-sample-rate: 0.25
agentic-harness-enabled: false
prompt-budget-enabled: false
request-log: false
response-cache:
  enabled: false
prompt-cache:
  enabled: false

Ecosystem

CPA Usage Keeper

Standalone persistence and visualization service for CLIProxyAPI, with periodic data sync, SQLite storage, aggregate APIs, and a built-in dashboard for usage and statistics.

[!NOTE] If you developed a project based on CLIProxyAPI, please open a PR to add it to this list.

Auto-Updates

ProxyPilot includes a built-in auto-update system that checks for new releases and allows one-c