Files
ProxyPilot/README.md
T
Finessse 60582b647e docs: update README for MiniMax and Zhipu AI providers
- Update provider count from 7 to 8
- Add MiniMax to supported providers table
- Add Zhipu AI to supported providers table
2025-12-28 20:51:30 +07:00

7.1 KiB
Raw Blame History

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:


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

  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. 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:

./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):

{
  "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

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


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.