English | Chinese

This is the Plus version of CLIProxyAPI, adding support for third-party providers on top of the mainline project.

Recommended companion tools / related forks:

• Patch-22 (recommended): a tiny apply_patch safety net binary/script for when a model tries to run apply_patch as a shell command: github.com/jeffnash/patch-22.
• Letta Code (jeffnash fork): github.com/jeffnash/letta-code is wired up to route main model calls through a hosted jeffnash/CLIProxyAPI instance.
• Letta (jeffnash fork): github.com/jeffnash/letta includes scripts to deploy the Letta server to Railway and pairs well with this proxy.

All third-party provider support is maintained by community contributors; CLIProxyAPI does not provide technical support. Please contact the corresponding community maintainer if you need assistance.

It now also supports OpenAI Codex (GPT models) and Claude Code via OAuth.

The Plus release stays in lockstep with the mainline features.

This project is sponsored by Z.ai, supporting us with their GLM CODING PLAN.

GLM CODING PLAN is a subscription service designed for AI coding, starting at just $3/month. It provides access to their flagship GLM-4.7 model across 10+ popular AI coding tools (Claude Code, Cline, Roo Code, etc.), offering developers top-tier, fast, and stable coding experiences.

Get 10% OFF GLM CODING PLAN：https://z.ai/subscribe?ic=8JVLJQFSKB

	Thanks to PackyCode for sponsoring this project! PackyCode is a reliable and efficient API relay service provider, offering relay services for Claude Code, Codex, Gemini, and more. PackyCode provides special discounts for our software users: register using this link and enter the "cliproxyapi" promo code during recharge to get 10% off.
	Thanks to Cubence for sponsoring this project! Cubence is a reliable and efficient API relay service provider, offering relay services for Claude Code, Codex, Gemini, and more. Cubence provides special discounts for our software users: register using this link and enter the "CLIPROXYAPI" promo code during recharge to get 10% off.

This fork is primarily optimized for:

• Using OAuth/subscription logins (Codex / Claude Code / Gemini / Copilot / etc.) behind an OpenAI-compatible base URL
• Hosting your own personal instance (especially on Railway) so you can call it from anywhere

Key docs:

• End-user Railway deployment: docs/RAILWAY_GUIDE.md
• Railway scripts reference (includes Copilot config flags like COPILOT_FORCE_AGENT_CALL): scripts/README_RAILWAY.md
• SDK usage (embed the proxy in Go): docs/sdk-usage.md
• SDK advanced: docs/sdk-advanced.md
• SDK access/auth: docs/sdk-access.md
• Credential watching: docs/sdk-watcher.md

Provider & config matrix (fork-specific):

Copilot requests are tagged with X-Initiator: user or X-Initiator: agent. The proxy detects agent calls by default by looking for tool/agent activity in the payload (this is why tool calls in the request can flip it to agent). In many Copilot setups, user calls count against monthly quota while agent calls do not.

You can override the default initiator detection:

• COPILOT_AGENT_INITIATOR_PERSIST / copilot-api-key[].agent-initiator-persist (default true)
  • What it’s for: this is the “normal” agentic behavior — once a workflow/conversation is in an agent loop, keep follow-up requests marked as X-Initiator: agent.
  • Behavior: if prompt_cache_key is present, once an agent-ish request is seen for that cache key, subsequent requests with the same cache key will keep using X-Initiator: agent.
• COPILOT_FORCE_AGENT_CALL / copilot-api-key[].force-agent-call (default false)
  • What it’s for: a hacky quota optimization — mark everything as agent to try to reduce user-quota usage.
  • Behavior: always set X-Initiator: agent for Copilot requests, regardless of payload.
  • Warning: use at your own risk — forcing agent classification may violate provider expectations/ToS, break accounting, or cause requests to be rejected.

If you want the baseline upstream documentation/behavior, start here: https://github.com/luispater/CLIProxyAPI/blob/main/README.md

If you want more details (and exact env vars), see docs/RAILWAY_GUIDE.md and scripts/README_RAILWAY.md.

Note: this fork’s docs intentionally focus on fork-specific behavior; the upstream README is the best reference for the baseline project.

Hosted instance goals:

• Log in locally once, then transfer credentials via scripts/auth_bundle.sh (AUTH_BUNDLE) to your host.
• Point your clients/tools at your hosted base URL and keep using the same API key.

• OpenAI-compatible API endpoints for chat + tools (plus provider routing)
• OAuth/cookie login flows for multiple providers and multi-account load balancing
• Streaming + non-streaming responses, multimodal inputs (where supported)
• Compatibility targets: OpenAI-compatible clients/SDKs (including Responses-style clients) + coding CLIs

CLIProxyAPI Guides: https://help.router-for.me/

see MANAGEMENT_API.md

Those projects are based on CLIProxyAPI:

Native macOS menu bar app to use your Claude Code & ChatGPT subscriptions with AI coding tools - no API keys needed

Browser-based tool to translate SRT subtitles using your Gemini subscription via CLIProxyAPI with automatic validation/error correction - no API keys needed

• Added GitHub Copilot support (OAuth login), provided by em4go
• Added Kiro (AWS CodeWhisperer) support (OAuth login), provided by fuko2935, Ravens2121

CLI wrapper for instant switching between multiple Claude accounts and alternative models (Gemini, Codex, Antigravity) via CLIProxyAPI OAuth - no API keys needed

Native macOS GUI for managing CLIProxyAPI: configure providers, model mappings, and endpoints via OAuth - no API keys needed.

This project is sponsored by Z.ai, supporting us with their GLM CODING PLAN.

GLM CODING PLAN is a subscription service designed for AI coding, starting at just $3/month. It provides access to their flagship GLM-4.7 model across 10+ popular AI coding tools (Claude Code, Cline, Roo Code, etc.), offering developers top-tier, fast, and stable coding experiences.

Get 10% OFF GLM CODING PLAN：https://z.ai/subscribe?ic=8JVLJQFSKB

	Thanks to PackyCode for sponsoring this project! PackyCode is a reliable and efficient API relay service provider, offering relay services for Claude Code, Codex, Gemini, and more. PackyCode provides special discounts for our software users: register using this link and enter the "cliproxyapi" promo code during recharge to get 10% off.
	Thanks to Cubence for sponsoring this project! Cubence is a reliable and efficient API relay service provider, offering relay services for Claude Code, Codex, Gemini, and more. Cubence provides special discounts for our software users: register using this link and enter the "CLIPROXYAPI" promo code during recharge to get 10% off.

Those projects are based on CLIProxyAPI:

Native macOS menu bar app to use your Claude Code & ChatGPT subscriptions with AI coding tools - no API keys needed

Browser-based tool to translate SRT subtitles using your Gemini subscription via CLIProxyAPI with automatic validation/error correction - no API keys needed

CLI wrapper for instant switching between multiple Claude accounts and alternative models (Gemini, Codex, Antigravity) via CLIProxyAPI OAuth - no API keys needed

Native macOS GUI for managing CLIProxyAPI: configure providers, model mappings, and endpoints via OAuth - no API keys needed.

Native macOS menu bar app that unifies Claude, Gemini, OpenAI, Qwen, and Antigravity subscriptions with real-time quota tracking and smart auto-failover for AI coding tools like Claude Code, OpenCode, and Droid - no API keys needed.

All third-party provider support is maintained by community contributors; CLIProxyAPI does not provide technical support. Please contact the corresponding community maintainer if you need assistance.

If you need to submit any non-third-party provider changes, please open them against the mainline repository.

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.