CLIProxyAPI|面向 AI 命令行工具的开源代理网关,统一接口、免 Key 登录、多账号负载均衡
1. 项目基础概述
CLIProxyAPI 是一款基于 Go 语言开发的开源 AI 代理服务器,遵循宽松的 MIT 开源协议,主打为各类 AI 命令行(CLI)工具、代码助手提供统一接口转换能力。项目聚焦解决多类 AI CLI 工具协议不兼容、API Key 管理繁琐、多账号调度困难、跨工具适配成本高等痛点,可将 OpenAI Codex、Claude Code、Gemini CLI、通义千问 Qwen Code 等主流代码类 AI 工具,统一封装为兼容 OpenAI 标准格式的 API 接口,让各类客户端、SDK、IDE 插件无需改造即可批量接入。
该项目支持 OAuth 网页账号登录,无需单独申请 API Key,完美盘活个人已订阅的 AI 会员账号,同时内置多账号轮询、故障切换、配置热重载等能力,是 CLI 场景下轻量化 API 中转、接口统一的优质开源方案,广泛受到开发者、AI 工具爱好者的使用与推荐。
2. 核心功能与核心亮点
全平台接口统一适配
核心能力为协议转换,把 Claude、Gemini、OpenAI、通义千问等不同厂商的 CLI 工具接口,统一转为行业通用的 OpenAI 兼容接口(如
/v1/chat/completions)。一次配置即可对接所有支持该标准的程序,彻底告别多工具单独适配的繁琐操作,同时兼容流式响应、非流式响应、WebSocket 传输,也支持函数调用、工具调用与图文多模态输入,适配复杂开发场景。OAuth 免密钥登录,复用现有订阅
区别于传统 API 中转工具,它支持主流 AI 平台网页端 OAuth 授权登录,无需手动维护 API Key,直接绑定已有的会员订阅账号即可使用,最大化利用现有订阅资源,降低使用成本,目前已全面适配 OpenAI Codex、Claude Code、Gemini 等热门代码 AI 工具。
多账号智能调度与负载均衡
内置轮询负载均衡策略,支持批量添加多个平台、多个个人账号。当单账号触发配额耗尽、访问限流、网络异常等问题时,系统会自动切换至备用账号,实现故障转移,保障服务持续稳定运行。适合高频率调用、多人共用接口的场景。
灵活配置与无感知运维
支持配置文件热重载,修改账号信息、路由规则、模型映射等配置后,无需重启服务即可生效,大幅降低运维难度。同时提供完善的用量统计、数据导出功能,可直观查看请求量、Token 消耗等数据,方便账号管理与使用溯源。
丰富扩展性与二次开发能力
项目提供可复用的 Go SDK,支持将代理能力嵌入自研应用、插件中;同时兼容 OpenRouter 等第三方上游接口,也有社区增强版 CLIProxyAPIPlus,拓展支持 GitHub Copilot、GitLab Duo、Cursor 等更多主流 AI 工具,生态完善。
3. 部署方式(低门槛,全场景适配)
CLIProxyAPI 主打轻量化部署,适配个人本地、私有服务器等环境,主流部署方案如下:
Docker 部署(新手首选):提供现成镜像,一条命令即可完成搭建,配置简单、开箱即用,适合个人测试、本地中转使用。
Docker Compose 部署:标准化容器编排,方便长期运维、日志管理与权限配置,适合小型团队、稳定对外提供接口的场景。
源码编译部署:支持拉取源码手动编译,适合有二次开发、深度定制需求的技术开发者。
同时项目还支持 Railway、Termux 等多环境部署,使用场景不受限制。
4. 主流适用场景
开发者日常提效:统一管理 Codex、Claude Code、Gemini CLI 等多款代码 AI 工具,一套接口对接 IDE、终端脚本,提升编程与调试效率。
AI CLI 工具统一中转:搭建私有代理服务,解决部分网络访问问题,整合多平台账号,替代零散的第三方中转服务。
个人 / 团队订阅复用:依托 OAuth 登录能力,直接使用网页订阅账号,无需额外购买 API 服务,多人共享账号并借助负载均衡分流压力。
二次开发与集成:利用官方 Go SDK,将接口代理能力嵌入自研工具、内部系统、SaaS 应用中,快速搭建 AI 能力底座。
多模型路由测试:通过模型映射、路由规则,快速切换不同大模型服务,用于模型对比、功能测试等研发工作。
5. 补充说明与总结
CLIProxyAPI 定位轻量化、专注 CLI 场景,和此前介绍的 Sub2API 形成差异化:它更偏向命令行、代码类 AI 工具的接口整合,主打免 API Key、极简运维;而 Sub2API 偏向全品类账号聚合、计费分发与商用场景。
如果你常年使用各类 AI 命令行工具、被多接口适配、密钥管理问题困扰,或是想低成本复用现有 AI 订阅搭建私有中转服务,CLIProxyAPI 是兼顾易用性与实用性的优质开源选择。项目社区活跃,文档支持多语言,新手也能快速上手部署使用。
