CLIProxyAPI
把多家 CLI 模型账号接入统一兼容 API,供现有开发工具调用。
- Star 数
- ★ 56k
- 最近更新
- 今天
- License
- MIT
- 主语言
- Go
- FA 评分
- 41/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code · OpenAI API · Claude API
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 高 · 需要较重的基础设施
- 开始前需要
- 典型场景
- 需要让现有 OpenAI 兼容客户端调用 Codex OAuth 账号的开发者,可将其指向本地代理。
- 不适合
- 只接受托管云服务的团队
- 需要无需配置、即开即用的 API 客户端
- 源码审查
- 41/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
CLIProxyAPI 是一个面向 CLI 模型的代理服务器,可向客户端提供 OpenAI、Gemini、Claude、Codex 和 Grok 兼容接口。它通过 OAuth 登录支持 OpenAI Codex、Claude Code 和 Grok Build,也支持 Gemini 相关 API 与生成式语言 API 密钥。用户可配置多个账号,并在 Gemini、OpenAI、Claude 和 Grok 账号之间进行轮询负载均衡。服务支持流式、非流式及在相应渠道支持时的 WebSocket 响应,也提供函数调用和文本、图像输入支持。项目还提供可嵌入代理的 Go SDK;README 未给出具体部署命令或运行环境要求。
启动代理服务后,用户通过 CLI 登录 Gemini、OpenAI、Claude 或 Grok 账号,或配置生成式语言 API 密钥及兼容 OpenAI 的上游服务。客户端向代理发送 OpenAI(包括 Responses)、Gemini(包括 Interactions)或 Claude 兼容请求,代理将请求路由到对应渠道和可用账号。配置多个账号时,Gemini、OpenAI、Claude 和 Grok 支持轮询负载均衡。代理返回流式或非流式结果,并在渠道支持时提供 WebSocket 响应;函数调用以及文本和图像输入也受支持。开发者可以参考 SDK 使用文档和自定义 Provider 示例,将代理嵌入 Go 程序。
- 需要让现有 OpenAI 兼容客户端调用 Codex OAuth 账号的开发者,可将其指向本地代理。
- 使用 Claude Code 的团队,可通过 OAuth 接入多个 Claude 账号并启用负载均衡。
- 需要在一个服务入口下切换 Gemini、OpenAI、Claude 与 Grok CLI 账号的开发者,可配置多账号路由。
- 想将 AI Studio Build 多账号请求纳入负载均衡的用户,可使用项目列出的 AI Studio Build 支持。
- 构建 Go 应用的开发者,可用 Go SDK 嵌入代理,并通过自定义 Provider 示例扩展接入方式。
如何安装或部署这个 Agent?
README 未提供安装命令、发行包下载步骤、必需运行时版本或完整配置示例,因此无法据此给出可复制的安装流程。它说明 CLIProxyAPI 可作为代理服务器运行,并提供用于嵌入的 Go SDK;首次运行所需命令及凭据配置步骤未在所给材料中说明。
如何使用这个 Agent?
README 将 CLI 身份验证流程列为 Gemini、OpenAI、Claude 和 Grok 的支持功能,并说明 Codex、Claude Code、Grok Build 可通过 OAuth 登录。它没有给出实际登录命令、服务启动命令、监听地址、客户端配置样例或可复制的 API 请求,因此无法从所给材料提供首个可运行调用。配置完成后,支持的客户端可使用 OpenAI(含 Responses)、Gemini(含 Interactions)或 Claude 兼容接口访问代理。
这个 Agent 有哪些优点和局限?
- 在同一代理服务中提供 OpenAI、Gemini、Claude、Codex 和 Grok 兼容接口。
- 支持 Codex、Claude Code 和 Grok Build 的 OAuth 登录,并列出多账号负载均衡。
- 提供 Go SDK、自定义 Provider 示例,以及流式、非流式和渠道支持时的 WebSocket 响应。
- 所给 README 没有提供安装命令、运行时版本、启动步骤或完整配置样例,首次部署细节不足。
- 功能依赖可访问的提供方渠道及其账号、OAuth 或 API 密钥;模型可用性会因渠道而异。
- 代理需要作为服务运行,并处理客户端请求与上游连接;材料没有说明离线使用方式或凭据安全细节。
这个 Agent 与同类方案有什么区别?
README 推荐 EasyCLIProxyAPI 作为带图形配置界面、自动更新、系统托盘集成和一键启停的桌面客户端;本项目本身则是代理服务。README 也列出 9Router 等受 CLIProxyAPI 启发或移植的项目,但未提供可直接比较的性能或功能评测。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| CLIProxyAPI 当前 | 41 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 56k | 今天 | Go | Codex · Claude Code · OpenAI API · Claude API |
| Maestro-Flow | 52 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 567 | 5 天前 | TypeScript | Codex · Claude Code · Claude API |
| Cyrus | 50 · 缺口较多 | 命令行工具免费版 + 付费版 | ★ 859 | 今天 | TypeScript | Codex · Claude Code · Claude API |
| multi 多模型评审 | 41 · 缺口较多 | — | ★ 23 | 11 天前 | Shell | Codex · Claude Code · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
材料显示这是连接多家模型服务的代理,涉及 OAuth、API 密钥、认证文件和上游请求;SDK 文档说明管理端点默认需要 secret-key,远程访问还需显式开启,但未说明凭据加密、日志脱敏、最小权限部署或完整数据流,因此仅给部分分。文档提到优雅关闭,但没有配置回滚机制。依赖版本列在 go.mod 中,未见安全审计或更新策略;来源和维护信息也不够清晰。
README、SDK 文档和模块文件提供了一些互相支持的功能描述,但 SDK 示例使用 /v6 模块路径,而 go.mod 声明 /v8;README 也没有提供失败场景的具体诊断或恢复指引。依赖清单具体,但材料没有显示可用性或兼容性保障。
README 明确面向 CLI 客户端、SDK 集成和多账户场景,列出多种协议、提供商与流式、工具调用、多模态能力,适用场景较明确。材料未充分界定各提供商能力差异、支持边界或部署环境要求,因此未给满分。
README 按概览、入门、管理 API、SDK 和贡献说明组织内容,SDK 文档含安装命令、代码示例及中英文版本。安装入口部分指向外部指南,示例与 go.mod 的主版本路径不一致;已知限制有限,未提供变更日志或明确维护责任。MIT 许可文本存在,但版权日期写作“2025-2005.9”,降低了清晰度。
代理把多种 CLI 账户和模型接口统一到兼容 API,并提供可嵌入 Go SDK,能减少客户端适配工作。文档展示了可直接参考的集成方式,但收益、运行成本和赞助服务影响没有由材料充分量化。
功能清单和 SDK 示例能追溯部分具体能力;README、SDK 文档、go.mod 和许可证可交叉核对,但模块版本冲突削弱了相互印证。README 中的模型能力、可用性及商业服务宣传主要是断言,材料没有给出独立佐证,也未始终区分事实与宣传性描述。
- SDK 文档示例标注 /v6,但 go.mod 声明 /v8;使用前应核对与目标修订匹配的导入路径和安装说明。
- 代理会处理凭据并向模型上游发送请求;材料未说明凭据保护、请求日志脱敏和完整数据流,部署前应核实相关配置与行为。
- README 中的模型版本、渠道可用性和赞助服务价格等内容未在提供的材料中得到独立佐证。