CLIProxyAPI — What is it?

CLIProxyAPI is an open-source proxy server that provides OpenAI/Gemini/Claude/Codex compatible API interfaces for CLI, enabling seamless integration of various AI models into command-line applications.

⭐ 35,896 Stars 🍴 5,970 Forks Go Author: router-for-me
Source: README View on GitHub →

Why it matters

CLIProxyAPI is gaining attention due to its ability to integrate multiple AI models like OpenAI Codex, Claude Code, and Gemini into a single API, simplifying the process of using these models in command-line applications. Its support for OAuth and multi-account load balancing, along with its extensive documentation and SDK, make it a compelling choice for developers looking to leverage AI in their CLI tools.

Source: README, Overview

Core Features

OpenAI/Gemini/Claude/Codex compatibility

CLIProxyAPI acts as a proxy server, providing a unified API interface for various AI models, allowing developers to interact with multiple AI services using a single endpoint.

Source: README, Overview
OAuth support

The project supports OAuth for OpenAI Codex and Claude Code, enabling secure and scalable access to these services.

Source: README, Overview
Multi-account load balancing

CLIProxyAPI supports round-robin load balancing across multiple accounts for Gemini, OpenAI, Claude, and Codex, ensuring efficient utilization of resources and high availability.

Source: README, Overview
Amp CLI and IDE extensions support

The project includes integrated support for Amp CLI and IDE extensions, allowing users to leverage their Google/ChatGPT/Claude OAuth subscriptions with Amp's coding tools.

Source: README, Overview

Architecture

The architecture of CLIProxyAPI is modular, with clear separation of concerns. It uses a proxy server design pattern to route requests to the appropriate AI service based on the requested model. Key technical decisions include the use of OAuth for authentication, WebSocket for real-time communication, and a Go SDK for embedding the proxy into other applications.

Source: Code tree + dependency files

Project Knowledge Graph

Knowledge graph: project (center) + core features (inner hexagons) + key dependencies (outer chips) gin-gonic/gin gorilla/websocketgorilla/websoc… minio/minio-go/v7minio/minio-go… sirupsen/logrus OpenAI/Gemini/Claude/Codex compatibilityOpenAI/Gemini/Claud… OAuth support Multi-account load balancingMulti-account load… Amp CLI and IDE extensions supportAmp CLI and IDE ext… CLIProxyAPI Project Core feature Key dependency

Center: project; inner ring: core feature modules; outer ring: key dependencies. Auto-generated from core_features and tech_stack.key_deps.

Tech Stack

LanguageGoFrameworkGin, Gorilla WebSocket, Minio, Logrus
gin-gonic/gingorilla/websocketminio/minio-go/v7sirupsen/logrus
Docker
Source: Dependency files + code tree

Quick Start

1. Clone the repository: `git clone https://github.com/router-for-me/CLIProxyAPI.git` 2. Navigate to the project directory: `cd CLIProxyAPI` 3. Build the Docker image: `docker build -t cliproxyapi .` 4. Run the Docker container: `docker run -p 8080:8080 cliproxyapi`
Source: README Installation/Quick Start

Use Cases

CLIProxyAPI is suitable for developers who need to integrate AI capabilities into their command-line tools. It is useful in scenarios such as building AI-powered command-line applications, creating automation scripts that interact with AI services, and developing tools for managing and monitoring AI resources.

Source: README

Strengths & Limitations

Strengths

  • Strength 1: Comprehensive support for multiple AI models
  • Strength 2: Robust OAuth and multi-account support
  • Strength 3: Extensive documentation and SDK

Limitations

  • Limitation 1: Unknown license may pose legal concerns
  • Limitation 2: Lack of detailed performance metrics
Source: Synthesis of README, code structure and dependencies

Latest Release

v7.0.4 (2026-05-12): Improved unauthorized error handling for refresh and auto-refresh.

Source: GitHub Releases

Verdict

CLIProxyAPI is a valuable tool for developers looking to integrate AI models into their command-line applications. Its comprehensive support for various AI services, robust OAuth and multi-account features, and extensive documentation make it a compelling choice for those seeking to leverage AI in their CLI tools. It is particularly well-suited for teams or individuals developing automation scripts or AI-powered command-line applications.

Source: Synthesis
Transparency Notice
This page is auto-generated by AI (a large language model) from the following public materials: GitHub README, code tree, dependency files and release notes. Analyzed at: 2026-05-24 12:45. Quality score: 85/100.

Data sources: README, GitHub API, dependency files