ProxyPilot Logo

ProxyPilot

MIT License Go Version Follow on 𝕏 Star this repo

Stop juggling API keys. ProxyPilot is a powerful local API proxy that lets you use your existing Claude Code, Codex, Gemini, Kiro, and Qwen subscriptions with any AI coding tool – no separate API keys required.

Built in Go, it handles OAuth authentication, token management, and API translation automatically. One server to route them all.

--- > [!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 →](docs/claude-code-local-proxy.md) - [Cursor IDE Setup →](docs/cursor-ide.md) --- ## Features - 🎯 **8 Auth Providers** - Claude, Codex (OpenAI), Gemini, Gemini CLI, Kiro (AWS), Qwen, 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 - 🎨 **Desktop App** - Native Windows control center with system tray - 📡 **60+ Management APIs** - Full control via REST endpoints --- ## Supported Providers | Provider | Auth Method | Models | |----------|-------------|--------| | Claude (Anthropic) | OAuth2 / API Key | Claude Opus 4.5, Sonnet 4.5, Haiku 4.5 | | Codex (OpenAI) | OAuth2 / API Key | GPT-5.2, GPT-5.2 Codex | | Gemini | OAuth2 / API Key | Gemini 3 Pro, Gemini 3 Flash | | Gemini CLI | OAuth2 | Cloud Code Assist models | | Kiro | OAuth2 + AWS SSO | AWS CodeWhisperer | | Qwen | OAuth2 | Qwen models | | MiniMax | API Key | MiniMax M2, M2.1 models | | Zhipu AI | API Key | GLM-4.5, GLM-4.6, GLM-4.7 | | Custom | API Key | Any OpenAI-compatible endpoint | --- ## Installation ### Download Pre-built Release (Recommended) 1. Go to the [**Releases**](https://github.com/Finesssee/ProxyPilot/releases) page 2. Download the latest binary for your platform 3. Run `./proxypilot` ### Build from Source ```bash git clone https://github.com/Finesssee/ProxyPilot.git cd ProxyPilot go build -o proxypilot ./cmd/server ./proxypilot ``` --- ## Usage ### First Launch 1. Copy config: `cp config.example.yaml config.yaml` 2. Run: `./proxypilot` 3. Server starts on `http://localhost:8317` 4. Open dashboard: `http://localhost:8317/proxypilot.html` ### Authentication Run OAuth login for your provider: ```bash ./proxypilot --claude-login # Claude ./proxypilot --codex-login # OpenAI/Codex ./proxypilot --login # Gemini ./proxypilot --kiro-login # Kiro/AWS ``` Your browser opens automatically. Tokens are stored and auto-refreshed. ### Configure Your Tools **Claude Code** (`~/.claude/settings.json`): ```json { "env": { "ANTHROPIC_BASE_URL": "http://127.0.0.1:8317", "ANTHROPIC_AUTH_TOKEN": "your-api-key" } } ``` **Codex CLI** (`~/.codex/config.toml`): ```toml [openai] api_base_url = "http://127.0.0.1:8317" ``` **Factory Droid** (`~/.factory/settings.json`): ```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. --- ## CLI Tools | Binary | Description | |--------|-------------| | `proxypilot` | Main API proxy server | | `proxypilotui` | Desktop control center (Windows) | | `cliproxytray` | System tray application (Windows) | | `proxypilotpack` | Build and packaging tool | --- ## Tool Integrations Works with these AI coding tools: - **Claude Code** - Auto-configure via settings.json - **Codex CLI** - Auto-configure via config.toml - **Factory Droid** - Auto-configure via settings.json - **Cursor IDE** - Manual endpoint configuration - **Continue** - Manual endpoint configuration --- ## Requirements - macOS, Linux, or Windows - Go 1.24+ (for building from source) --- ## Author ProxyPilot is developed and maintained by [@Finesssee](https://github.com/Finesssee). Some contributors shown in the git history are from upstream [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI) merges. Direct contributors to ProxyPilot will be listed here as the project grows. --- ## Credits ProxyPilot builds upon excellent work from the open-source community: - **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** - The original unified proxy server that inspired this project - **[VibeProxy](https://github.com/automazeio/vibeproxy)** - Native macOS menu bar app showcasing clean proxy UX Long-context features are inspired by research from the AI community: - **[Factory.ai](https://factory.ai/news/evaluating-compression)** - Context compression techniques for long-running coding agents - **[Anthropic](https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents)** - Effective harnesses for long-running agents Special thanks to these teams for sharing their work and insights. --- ## License MIT License - see [LICENSE](LICENSE) for details. --- ## Support - **Report Issues**: [GitHub Issues](https://github.com/Finesssee/ProxyPilot/issues) --- ## Disclaimer This project is for educational and interoperability research purposes. It interacts with various APIs to provide compatibility layers. - **Use at your own risk.** Authors are not responsible for account suspensions or service interruptions. - **Not affiliated** with Google, OpenAI, Anthropic, Amazon, or any other provider. - Users must comply with the Terms of Service of connected platforms.