CLI2API

把你自己的登录态，变成一个本机 OpenAI 兼容 API

接入 Qoder（国际版 / 国内版）、WorkBuddy（国际版 / 国内版）、Trae 国内版 Work，以及实验性的 Devin。

用 Docker 部署，在 Web 控制台管理账号，再通过兼容 API 接入客户端。

_{English · 问题反馈 · LINUX DO}

功能

• 兼容接口：Chat Completions、Responses、Anthropic Messages 和模型列表，支持流式回复与函数工具调用。
• 多账号调度：自动选号、会话粘性、并发限制、冷却与故障切换。
• 统一控制台：管理账号、模型、客户端密钥、代理设置，查看额度和请求日志。
• Docker 运维：持久化账号数据；可选安装宿主机更新器，在控制台下载更新、确认升级和回滚。

Qoder 国内版、WorkBuddy、Trae 的适配代码已实现，真账号验收仍未完成；Devin 为实验性接入，不承诺生产可用。托管更新的真实升级 / 回滚验收也尚未完成。

快速开始

需要 Docker 和一个你自己控制的上游账号。macOS / Windows 使用 Docker Desktop；Windows 需使用 Linux containers。

git clone https://github.com/caigee-cmd/cli2api.git
cd cli2api
./scripts/start.sh        # Windows 用 scripts\start.ps1

1. 保存首次启动日志中打印的管理员密钥。
2. 打开 http://127.0.0.1:3010，用管理员密钥登录，在 Accounts 添加账号。
3. 在 API keys 创建客户端密钥，在 Access 选择模型并测试。

Docker Compose 是支持的安装与托管更新路径；源码运行用于开发。详细步骤见 部署说明。

接入客户端

在支持 OpenAI 兼容 API 的客户端中填写：

Base URL: http://127.0.0.1:3010/v1
API Key:  <在 API keys 页面创建的客户端密钥>

模型 ID 从 Access 页面或 /v1/models 获取。默认自动选择账号，同一对话优先复用原账号。固定账号、自定义会话标识及 curl / PowerShell 示例见 部署说明。

工作方式

Go 网关统一鉴权、调度和记录请求。Qoder 每个账号使用独立 Node 进程与 HOME；WorkBuddy、Trae、Devin 使用 Go 进程内适配器，不为每次请求启动完整 CLI。

控制台

账号、模型、接入和日志都在同一个 Web 控制台里管理：就绪状态和额度一目了然，Access 页可以直接复制 Base URL 并做一次快速验证。

使用限制

• 只连接你自己的账号，不提供账号、额度或官方 API 服务。
• 兼容接口不等于完整复刻官方 API。Messages / Responses 为无状态适配，不保存服务端会话，也不执行上游专属工具。
• 图片能力取决于上游和模型；WorkBuddy / Trae 不支持图片，文件输入会明确拒绝。具体范围见 部署说明。
• 跨上游同名模型调度受系统开关、账号权限和地域约束；不是任意账号之间都能切换。
• 上游协议变化可能影响兼容性；请求日志默认不保存提示词或回复正文。

文档

• 部署与运维：启动步骤、环境变量、接口、托管更新
• 变更记录

安全

默认只向本机开放 127.0.0.1:3010，不要直接暴露到公网。管理员密钥可操作控制台；客户端密钥仅用于 /v1/*。请妥善保管密钥、账号导出文件和数据库备份，发现问题按 SECURITY.md 私下报告。

社区与贡献

中文讨论见 LINUX DO。缺陷和功能请求请走 GitHub Issue；文档改进与 Pull Request 见 CONTRIBUTING.md。

许可证

MIT。使用上游账号时，请遵守对应平台的服务条款。