CLIProxyAPI

module

v7.2.27 Latest Latest Go to latest Published: Jun 21, 2026 License: MIT

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/router-for-me/CLIProxyAPI

Links

Open Source Insights

README ¶

CLI Proxy API

English | 中文 | 日本語

A proxy server that provides OpenAI/Gemini/Claude/Codex/Grok compatible API interfaces for CLI.

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

So you can use local or multi-account CLI access with OpenAI(include Responses)/Gemini/Claude-compatible clients and SDKs.

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 AICodeMirror for sponsoring this project! AICodeMirror provides official high-stability relay services for Claude Code / Codex / Gemini, with enterprise-grade concurrency, fast invoicing, and 24/7 dedicated technical support. Claude Code / Codex / Gemini official channels at 38% / 2% / 9% of original price, with extra discounts on top-ups! AICodeMirror offers special benefits for CLIProxyAPI users: register via this link to enjoy 20% off your first top-up, and enterprise customers can get up to 25% off!

Huge thanks to BmoPlus for sponsoring this project! BmoPlus is a highly reliable AI account provider built strictly for heavy AI users and developers. They offer rock-solid, ready-to-use accounts and official top-up services for ChatGPT Plus / ChatGPT Pro (Full Warranty) / Claude Pro / Super Grok / Gemini Pro. By registering and ordering through BmoPlus - Premium AI Accounts & Top-ups, users can unlock the mind-blowing rate of 10% of the official GPT subscription price (90% OFF)!

Thanks to VisionCoder for supporting this project. VisionCoder Developer Platform is a reliable and efficient API relay service provider, offering access to mainstream AI models such as Claude Code, Codex, and Gemini. It helps developers and teams integrate AI capabilities more easily and improve productivity. Additionally, VisionCoder now offers retail channels for Claude Max 200 and GPT Pro 200 premium accounts, providing users with instant access to top-tier AI computing power and features.

Thanks to APIKEY.FUN for sponsoring this project! APIKEY.FUN is a professional enterprise-grade AI relay platform dedicated to providing stable, efficient, and low-cost AI model API access for enterprises and individual developers. The platform supports popular mainstream models such as Claude, OpenAI, and Gemini, with prices as low as 7% of the official price. Register through this project's exclusive link to enjoy a special permanent 5% top-up discount.

RunAPI is an efficient and stable API platform—an alternative to OpenRouter. A single API Key gives you access to 150+ leading models, including OpenAI, Claude, Gemini, DeepSeek, Grok, and more, at prices as low as 10% of the original (up to 90% off), with exceptional stability. It's seamlessly compatible with tools like Claude Code, OpenClaw, and others. RunAPI offers an exclusive perk for CPA users: register and contact an administrator to claim ¥7 in free credit.

Thanks to Unity2.ai for sponsoring this project! Unity2.ai is a high-performance AI model API relay platform for individual developers, teams, and enterprises. It has long served leading domestic enterprises, handles more than 30 billion token calls per day, and supports high concurrency at the 5000 RPM level. It supports balance billing, first top-up bonuses, bundled subscriptions, enterprise invoicing, and dedicated integration support. Register through this link to receive a $2 balance, then join the official group to get another $10 balance, for up to $12 in free credit.

Cat API is an AI model aggregation platform built for individual developers and teams, integrating leading large language models into a single simple, stable, and easy-to-use entry point. It provides an API fully compatible with OpenAI, Claude, and Gemini that plugs seamlessly into mainstream AI IDEs and coding tools such as Claude Code, Cursor, Windsurf, Cline, Roo Code, Continue, Codex, and Trae, and features dedicated CN2 high-speed routing for low-latency, highly reliable access. Sign up to claim 1$ in free credits.

Overview

OpenAI/Gemini/Claude/Grok compatible API endpoints for CLI models
OpenAI Codex support (GPT models) via OAuth login
Claude Code support via OAuth login
Grok Build support via OAuth login
Streaming, non-streaming, and WebSocket responses where supported
Function calling/tools support
Multimodal input support (text and images)
Multiple accounts with round-robin load balancing (Gemini, OpenAI, Claude, Grok)
Simple CLI authentication flows (Gemini, OpenAI, Claude, Grok)
Generative Language API Key support
AI Studio Build multi-account load balancing
Claude Code multi-account load balancing
OpenAI Codex multi-account load balancing
Grok Build multi-account load balancing
OpenAI-compatible upstream providers via config (e.g., OpenRouter)
Reusable Go SDK for embedding the proxy (see docs/sdk-usage.md)

Getting Started

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

Management API

see MANAGEMENT_API.md

Usage Statistics

Since v6.10.0, CLIProxyAPI and CPAMC no longer ship built-in usage statistics. If you need usage statistics, use:

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.

CPA-Manager-Plus

Full CLIProxyAPI management center with request-level monitoring and cost estimates. CPA-Manager tracks collected requests by account, model, channel, latency, status, and token usage; estimates cost with editable model prices and one-click LiteLLM price sync; persists events in SQLite; and provides Codex account-pool operations with batch inspection, quota detection, unhealthy account discovery, cleanup suggestions, and one-click execution for day-to-day multi-account maintenance.

SDK Docs

Usage: docs/sdk-usage.md
Advanced (executors & translators): docs/sdk-advanced.md
Access: docs/sdk-access.md
Watcher: docs/sdk-watcher.md
Custom Provider Example: examples/custom-provider

Contributing

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

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

Who is with us?

Those projects are based on CLIProxyAPI:

vibeproxy

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

Subtitle Translator

A cross-platform desktop and web app to translate and validate SRT subtitles using your existing LLM subscriptions (Gemini, ChatGPT, Claude, etc.) via CLIProxyAPI - no API keys needed.

CCS (Claude Code Switch)

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

Quotio

Native macOS menu bar app that unifies Claude, Gemini, OpenAI, 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.

ProxyPilot

Windows-native CLIProxyAPI fork with TUI, system tray, and multi-provider OAuth for AI coding tools - no API keys needed.

Claude Proxy VSCode

VSCode extension for quick switching between Claude Code models, featuring integrated CLIProxyAPI as its backend with automatic background lifecycle management.

ZeroLimit

Windows desktop app built with Tauri + React for monitoring AI coding assistant quotas via CLIProxyAPI. Track usage across Gemini, Claude, OpenAI Codex, and Antigravity accounts with real-time dashboard, system tray integration, and one-click proxy control - no API keys needed.

CPA-XXX Panel

A lightweight web admin panel for CLIProxyAPI with health checks, resource monitoring, real-time logs, auto-update, request statistics and pricing display. Supports one-click installation and systemd service.

CLIProxyAPI Tray

A Windows tray application implemented using PowerShell scripts, without relying on any third-party libraries. The main features include: automatic creation of shortcuts, silent running, password management, channel switching (Main / Plus), and automatic downloading and updating.

霖君

霖君 is a cross-platform desktop application for managing AI programming assistants, supporting macOS, Windows, and Linux systems. Unified management of Claude Code, Gemini, OpenAI Codex, and other AI coding tools, with local proxy for multi-account quota tracking and one-click configuration.

CLIProxyAPI Dashboard

A modern web-based management dashboard for CLIProxyAPI built with Next.js, React, and PostgreSQL. Features real-time log streaming, structured configuration editing, API key management, OAuth provider integration for Claude/Gemini/Codex, usage analytics, container management, and config sync with OpenCode via companion plugin - no manual YAML editing needed.

All API Hub

Browser extension for one-stop management of New API-compatible relay site accounts, featuring balance and usage dashboards, auto check-in, one-click key export to common apps, in-page API availability testing, and channel/model sync and redirection. It integrates with CLIProxyAPI through the Management API for one-click provider import and config sync.

Shadow AI

Shadow AI is an AI assistant tool designed specifically for restricted environments. It provides a stealthy operation mode without windows or traces, and enables cross-device AI Q&A interaction and control via the local area network ( LAN). Essentially, it is an automated collaboration layer of "screen/audio capture + AI inference + low-friction delivery", helping users to immersively use AI assistants across applications on controlled devices or in restricted environments.

ProxyPal

Cross-platform desktop app (macOS, Windows, Linux) wrapping CLIProxyAPI with a native GUI. Connects Claude, ChatGPT, Gemini, GitHub Copilot, and custom OpenAI-compatible endpoints with usage analytics, request monitoring, and auto-configuration for popular coding tools - no API keys needed.

CLIProxyAPI Quota Inspector

Ready-to-use cross-platform quota inspector for CLIProxyAPI, supporting per-account codex 5h/7d quota windows, plan-based sorting, status coloring, and multi-account summary analytics.

CLIProxy Pool Watch

Native macOS SwiftUI app for monitoring ChatGPT/Codex account quotas in CLIProxyAPI pools. Displays account availability, Plus-base capacity, 5-hour and weekly quota bars, plan weights, and restore forecasts through the Management API.

Panopticon

Multi-agent orchestration for AI coding assistants. Runs CLIProxyAPI as a local sidecar so its agents can drive GPT models through a ChatGPT subscription, pointing Claude Code at an Anthropic-compatible endpoint with no OpenAI API key required.

Tunnel Agent

Windows desktop UI that manages CLIProxyAPI and Perplexity WebUI Scraper from a single interface, inspired by Quotio and VibeProxy. Connect OAuth providers (Claude, Gemini, Codex, Kimi, Antigravity), custom API keys, and Perplexity session accounts, then point any coding agent at the local endpoint.

Quotio Desktop

Cross-platform (Tauri) port of Quotio for Windows, macOS and Linux. Manages a pool of AI accounts (Codex, Claude Code, GitHub Copilot, Gemini, Antigravity, Kiro, Cursor, Trae, GLM) through CLIProxyAPI, with per-account 5-hour/weekly quota bars, Codex rate-limit reset credits with one-click reset, smart scheduling, usage statistics, and multi-instance Codex — no API keys needed.

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

More choices

Those projects are ports of CLIProxyAPI or inspired by it:

9Router

A Next.js implementation inspired by CLIProxyAPI, easy to install and use, built from scratch with format translation (OpenAI/Claude/Gemini/Ollama), combo system with auto-fallback, multi-account management with exponential backoff, a Next.js web dashboard, and support for CLI tools (Cursor, Claude Code, Cline, RooCode) - no API keys needed.

OmniRoute

Never stop coding. Smart routing to FREE & low-cost AI models with automatic fallback.

OmniRoute is an AI gateway for multi-provider LLMs: an OpenAI-compatible endpoint with smart routing, load balancing, retries, and fallbacks. Add policies, rate limits, caching, and observability for reliable, cost-aware inference.

Playful Proxy API Panel (PPAP)

A public CLIProxyAPI-compatible fork and bundled management panel. It keeps upstream-style usage while restoring built-in usage statistics, adding cache hit rate, first-byte latency, TPS tracking, and Docker-oriented self-hosted installation docs.

Codex Switch

This is a tool built with Tauri 2 + Vue 3 for managing multiple OpenAI Codex desktop accounts. Switch between saved ChatGPT/Codex certification profiles, check 5-hour and weekly quota usage in real time, verify token health, view active account details, and import or save auth.json files without manual copying.

[!NOTE]
If you have developed a port of CLIProxyAPI or a project inspired by it, please open a PR to add it to this list.

License

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

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
cmd
fetch_antigravity_models command Command fetch_antigravity_models connects to the Antigravity API using the stored auth credentials and saves the dynamically fetched model list to a JSON file for inspection or offline use.	Command fetch_antigravity_models connects to the Antigravity API using the stored auth credentials and saves the dynamically fetched model list to a JSON file for inspection or offline use.
fetch_codex_models command Command fetch_codex_models connects to the Codex API using stored auth credentials and saves the dynamically fetched Codex client model catalog to a JSON file for inspection or offline use.	Command fetch_codex_models connects to the Codex API using stored auth credentials and saves the dynamically fetched Codex client model catalog to a JSON file for inspection or offline use.
server command Package main provides the entry point for the CLI Proxy API server.	Package main provides the entry point for the CLI Proxy API server.
examples
custom-provider command Package main demonstrates how to create a custom AI provider executor and integrate it with the CLI Proxy API server.	Package main demonstrates how to create a custom AI provider executor and integrate it with the CLI Proxy API server.
http-request command Package main demonstrates how to use coreauth.Manager.HttpRequest/NewHttpRequest to execute arbitrary HTTP requests with provider credentials injected.	Package main demonstrates how to use coreauth.Manager.HttpRequest/NewHttpRequest to execute arbitrary HTTP requests with provider credentials injected.
translator command
internal
access
access/config_access
api Package api provides the HTTP API server implementation for the CLI Proxy API.	Package api provides the HTTP API server implementation for the CLI Proxy API.
api/handlers/management Package management provides the management API handlers and middleware for configuring the server and managing auth files.	Package management provides the management API handlers and middleware for configuring the server and managing auth files.
api/middleware Package middleware provides HTTP middleware components for the CLI Proxy API server.	Package middleware provides HTTP middleware components for the CLI Proxy API server.
auth Package auth provides authentication functionality for various AI service providers.	Package auth provides authentication functionality for various AI service providers.
auth/antigravity Package antigravity provides OAuth2 authentication functionality for the Antigravity provider.	Package antigravity provides OAuth2 authentication functionality for the Antigravity provider.
auth/claude Package claude provides OAuth2 authentication functionality for Anthropic's Claude API.	Package claude provides OAuth2 authentication functionality for Anthropic's Claude API.
auth/codex Package codex provides authentication and token management for OpenAI's Codex API.	Package codex provides authentication and token management for OpenAI's Codex API.
auth/empty Package empty provides a no-operation token storage implementation.	Package empty provides a no-operation token storage implementation.
auth/kimi Package kimi provides authentication and token management for Kimi (Moonshot AI) API.	Package kimi provides authentication and token management for Kimi (Moonshot AI) API.
auth/vertex Package vertex provides token storage for Google Vertex AI Gemini via service account credentials.	Package vertex provides token storage for Google Vertex AI Gemini via service account credentials.
auth/xai Package xai provides OAuth2 authentication helpers for xAI Grok.	Package xai provides OAuth2 authentication helpers for xAI Grok.
browser Package browser provides cross-platform functionality for opening URLs in the default web browser.	Package browser provides cross-platform functionality for opening URLs in the default web browser.
buildinfo Package buildinfo exposes compile-time metadata shared across the server.	Package buildinfo exposes compile-time metadata shared across the server.
cache
cmd Package cmd provides command-line interface functionality for the CLI Proxy API server.	Package cmd provides command-line interface functionality for the CLI Proxy API server.
config Package config provides configuration management for the CLI Proxy API server.	Package config provides configuration management for the CLI Proxy API server.
constant Package constant defines provider name constants used throughout the CLI Proxy API.	Package constant defines provider name constants used throughout the CLI Proxy API.
home
htmlsanitize
httpfetch
interfaces Package interfaces defines the core interfaces and shared structures for the CLI Proxy API server.	Package interfaces defines the core interfaces and shared structures for the CLI Proxy API server.
logging Package logging provides Gin middleware for HTTP request logging and panic recovery.	Package logging provides Gin middleware for HTTP request logging and panic recovery.
managementasset
misc Package misc provides miscellaneous utility functions for the CLI Proxy API server.	Package misc provides miscellaneous utility functions for the CLI Proxy API server.
pluginhost
pluginstore
redisqueue
registry Package registry provides model definitions and lookup helpers for various AI providers.	Package registry provides model definitions and lookup helpers for various AI providers.
runtime/executor Package executor provides runtime execution capabilities for various AI service providers.	Package executor provides runtime execution capabilities for various AI service providers.
runtime/executor/helps
safemode
signature Claude thinking signature validation.	Claude thinking signature validation.
store
thinking Package thinking provides unified thinking configuration processing.	Package thinking provides unified thinking configuration processing.
thinking/provider/antigravity Package antigravity implements thinking configuration for Antigravity API format.	Package antigravity implements thinking configuration for Antigravity API format.
thinking/provider/claude Package claude implements thinking configuration scaffolding for Claude models.	Package claude implements thinking configuration scaffolding for Claude models.
thinking/provider/codex Package codex implements thinking configuration for Codex (OpenAI Responses API) models.	Package codex implements thinking configuration for Codex (OpenAI Responses API) models.
thinking/provider/gemini Package gemini implements thinking configuration for Gemini models.	Package gemini implements thinking configuration for Gemini models.
thinking/provider/kimi Package kimi implements thinking configuration for Kimi (Moonshot AI) models.	Package kimi implements thinking configuration for Kimi (Moonshot AI) models.
thinking/provider/openai Package openai implements thinking configuration for OpenAI/Codex models.	Package openai implements thinking configuration for OpenAI/Codex models.
thinking/provider/xai Package xai implements thinking configuration for xAI Grok Responses API models.	Package xai implements thinking configuration for xAI Grok Responses API models.
translator
translator/antigravity/claude Package claude provides request translation functionality for Claude Code API compatibility.	Package claude provides request translation functionality for Claude Code API compatibility.
translator/antigravity/gemini Package gemini provides request translation functionality for Antigravity to Gemini API compatibility.	Package gemini provides request translation functionality for Antigravity to Gemini API compatibility.
translator/antigravity/openai/chat-completions Package openai provides request translation functionality for OpenAI to Antigravity API compatibility.	Package openai provides request translation functionality for OpenAI to Antigravity API compatibility.
translator/antigravity/openai/responses
translator/claude/gemini Package gemini provides request translation functionality for Gemini to Claude Code API compatibility.	Package gemini provides request translation functionality for Gemini to Claude Code API compatibility.
translator/claude/openai/chat-completions Package openai provides request translation functionality for OpenAI to Claude Code API compatibility.	Package openai provides request translation functionality for OpenAI to Claude Code API compatibility.
translator/claude/openai/responses
translator/codex/claude Package claude provides request translation functionality for Claude Code API compatibility.	Package claude provides request translation functionality for Claude Code API compatibility.
translator/codex/gemini Package gemini provides request translation functionality for Codex to Gemini API compatibility.	Package gemini provides request translation functionality for Codex to Gemini API compatibility.
translator/codex/openai/chat-completions Package openai provides utilities to translate OpenAI Chat Completions request JSON into OpenAI Responses API request JSON using gjson/sjson.	Package openai provides utilities to translate OpenAI Chat Completions request JSON into OpenAI Responses API request JSON using gjson/sjson.
translator/codex/openai/responses
translator/common
translator/gemini/claude Package claude provides request translation functionality for Claude API.	Package claude provides request translation functionality for Claude API.
translator/gemini/common
translator/gemini/gemini Package gemini provides in-provider request normalization for Gemini API.	Package gemini provides in-provider request normalization for Gemini API.
translator/gemini/openai/chat-completions Package openai provides request translation functionality for OpenAI to Gemini API compatibility.	Package openai provides request translation functionality for OpenAI to Gemini API compatibility.
translator/gemini/openai/responses
translator/openai/claude Package claude provides request translation functionality for Anthropic to OpenAI API.	Package claude provides request translation functionality for Anthropic to OpenAI API.
translator/openai/gemini Package gemini provides request translation functionality for Gemini to OpenAI API.	Package gemini provides request translation functionality for Gemini to OpenAI API.
translator/openai/openai/chat-completions Package openai provides request translation functionality for OpenAI to OpenAI API compatibility.	Package openai provides request translation functionality for OpenAI to OpenAI API compatibility.
translator/openai/openai/responses
translator/translator Package translator provides request and response translation functionality between different AI API formats.	Package translator provides request and response translation functionality between different AI API formats.
tui Package tui provides a terminal-based management interface for CLIProxyAPI.	Package tui provides a terminal-based management interface for CLIProxyAPI.
util Package util provides utility functions for the CLI Proxy API server.	Package util provides utility functions for the CLI Proxy API server.
watcher clients.go implements watcher client lifecycle logic and persistence helpers.	clients.go implements watcher client lifecycle logic and persistence helpers.
watcher/diff auth_diff.go computes human-readable diffs for auth file field changes.	auth_diff.go computes human-readable diffs for auth file field changes.
watcher/synthesizer Package synthesizer provides auth synthesis strategies for the watcher package.	Package synthesizer provides auth synthesis strategies for the watcher package.
wsrelay
sdk
access
api Package api exposes helpers for embedding CLIProxyAPI.	Package api exposes helpers for embedding CLIProxyAPI.
api/handlers Package handlers provides core API handler functionality for the CLI Proxy API server.	Package handlers provides core API handler functionality for the CLI Proxy API server.
api/handlers/claude Package claude provides HTTP handlers for Claude API code-related functionality.	Package claude provides HTTP handlers for Claude API code-related functionality.
api/handlers/gemini Package gemini provides HTTP handlers for Gemini API endpoints.	Package gemini provides HTTP handlers for Gemini API endpoints.
api/handlers/openai Package openai provides HTTP handlers for OpenAI API endpoints.	Package openai provides HTTP handlers for OpenAI API endpoints.
auth
cliproxy Package cliproxy provides the core service implementation for the CLI Proxy API.	Package cliproxy provides the core service implementation for the CLI Proxy API.
cliproxy/auth
cliproxy/executor
cliproxy/pipeline
cliproxy/usage
config Package config provides the public SDK configuration API.	Package config provides the public SDK configuration API.
logging Package logging re-exports request logging primitives for SDK consumers.	Package logging re-exports request logging primitives for SDK consumers.
pluginabi
pluginapi Package pluginapi defines host-side plugin capability schemas and adapters.	Package pluginapi defines host-side plugin capability schemas and adapters.
proxyutil
translator Package translator provides types and functions for converting chat requests and responses between different schemas.	Package translator provides types and functions for converting chat requests and responses between different schemas.
translator/builtin Package builtin exposes the built-in translator registrations for SDK users.	Package builtin exposes the built-in translator registrations for SDK users.