ProxyPilot
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:
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
- 🎨 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 (separate quota) |
| Kiro | OAuth2 + AWS SSO | AWS CodeWhisperer |
| Amazon Q CLI | Import from CLI | Amazon Q Developer |
| Qwen | OAuth2 | Qwen models |
| Antigravity | OAuth2 | Gemini via Antigravity (separate quota) |
| 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)
- Go to the Releases page
- Download the latest binary for your platform
- 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
- Copy config:
cp config.example.yaml config.yaml - Run:
./proxypilot - Server starts on
http://localhost:8317 - Open dashboard:
http://localhost:8317/proxypilot.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 (Google OAuth)
./proxypilot --kiro-aws-login # Kiro (AWS Builder ID)
./proxypilot --qwen-login # Qwen
./proxypilot --antigravity-login # Antigravity
# Import providers (from existing CLI tools)
./proxypilot --amazonq-import # Amazon Q CLI (run 'q login' first)
./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.
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.
CLI Tools
| Binary | Description |
|---|---|
proxypilot |
Main API proxy server |
proxypilotui |
Desktop control center (Windows) |
cliproxytray |
System tray application (Windows) |
proxypilotpack |
Build and packaging tool |
ppswitch |
Config switcher for AI CLI agents |
ppswitch - Config Switcher
ppswitch is a lightweight CLI tool that switches AI coding agents between proxy mode (through ProxyPilot) and native mode (direct API access). Think of it like nvm for Node versions, but for AI agent configurations.
Install
# Via bun (recommended)
bun install -g ppswitch
# Via npm
npm install -g ppswitch
# Via Go
go install github.com/Finesssee/ProxyPilot/cmd/ppswitch@latest
Usage
ppswitch # Show status of all agents
ppswitch <agent> # Show status of specific agent
ppswitch <agent> <mode> # Switch agent to mode
Supported Agents
| Agent | CLI Tool | Config Location |
|---|---|---|
claude |
Claude Code | ~/.claude/settings.json |
gemini |
Gemini CLI | ~/.gemini/settings.json |
codex |
Codex CLI | ~/.codex/config.toml |
opencode |
OpenCode | ~/.opencode/config.json |
droid |
Factory Droid | ~/.factory/settings.json |
cursor |
Cursor IDE | ~/.cursor/config.json |
kilo |
Kilo Code* | VS Code settings |
roocode |
RooCode* | VS Code settings |
*VS Code extensions require manual configuration
Modes
| Mode | Description |
|---|---|
proxy |
Route through ProxyPilot (http://127.0.0.1:8317) |
native |
Use direct API access (restore original config) |
Examples
# Check all agent statuses
ppswitch
# Switch Claude to use ProxyPilot
ppswitch claude proxy
# Switch Gemini back to native API
ppswitch gemini native
# Check Claude's current mode
ppswitch claude
How It Works
When switching to proxy mode:
- Backs up current config to
<config>.native.json - Updates config to point to
http://127.0.0.1:8317
When switching to native mode:
- Restores config from
<config>.native.jsonbackup - Removes backup file after successful restore
This preserves your original API keys and settings while allowing quick toggling between ProxyPilot and direct access.
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. Some contributors shown in the git history are from upstream 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 - The original unified proxy server that inspired this project
- VibeProxy - Native macOS menu bar app showcasing clean proxy UX
Long-context features are inspired by research from the AI community:
- Factory.ai - Context compression techniques for long-running coding agents
- Anthropic - Effective harnesses for long-running agents
Special thanks to these teams for sharing their work and insights.
License
MIT License - see LICENSE for details.
Support
- Report Issues: GitHub 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.