caigee-cmd/cli2api

Self-hosted OpenAI-compatible API for Qoder CLI login,workbuddy, with SQLite multi-account routing

CLI2API – 自分のログインセッションをローカル OpenAI 互換 API に変換

概要 – CLI2API は、OpenAI 互換 API のチャット補完、响应、Anthropic 风格端点をローカルで公開できる自托管网关です。Qoder、WorkBuddy、Trae、および（実験的に）Devin 和 Command Code 等服务已有的认证，并将 OpenAI 风格的请求路由到这些后端。

为什么重要 – 许多开发者在这些中国市场的 AI 平台上有个人账户，但缺乏标准的 OpenAI 兼容端点来接入现有工具（例如 VS Code 扩展、LangChain、CLI 客户端）。CLI2API 弥合了这一差距，而无需将您的凭据暴露到公共互联网。

核心功能

OpenAI 兼容端点 – 支持 chat/completions、responses、Anthropic messages、模型列表、流式响应和函数工具调用。
多账户调度 – 自动账户选择、会话粘性、并发限制、冷却和故障转移。
Web 控制台 – 管理账户、模型、客户端 API 密钥、代理设置，查看使用配额和请求日志。
Docker 优先部署 – 持久化账户数据，可选的主机端更新器用于就地升级/回滚。
提供商适配器 –
- Qoder（国际版和国内版）– 每个账户作为隔离的 Node 进程运行。
- WorkBuddy、Trae、Devin、Command Code – 作为网关进程内的 Go 适配器运行。

快速开始（Linux/macOS/Windows 带 Docker）

# 克隆并进入仓库
git clone https://github.com/caigee-cmd/cli2api.git
cd cli2api

# 启动堆栈（Linux/macOS）– 在 Windows 上使用 scripts\start.ps1
./scripts/start.sh

注意第一行日志中打印的管理员密钥。
在浏览器中打开 http://127.0.0.1:3010，使用管理员密钥登录，并在账户下添加您的提供商账户。
在API 密钥下创建客户端 API 密钥，在访问下选择您想要的模型，然后测试连接。
将任何 OpenAI 兼容客户端指向：
- Base URL: http://127.0.0.1:3010/v1
- API Key: 您刚创建的客户端密钥
- 模型 ID 列在访问页面或通过 /v1/models 获取。

完整的部署说明、环境变量和高级选项在 deploy/README.md 中。

工作原理

Go 网关接收每个 HTTP 请求，执行认证，记录调用，并决定使用哪个上游账户。
对于 Qoder，每个账户在自己的 Node 进程中运行，并带有专用的 HOME 目录，确保隔离。
对于其他提供商，网关直接调用 Go 编写的适配器，避免每次请求生成完整 CLI 的开销。
架构图（见 README）显示了流程：客户端 → Go 网关 → 每账户运行时 → 上游 AI 服务。

何时使用 CLI2API

您在 Qoder、WorkBuddy、Trae 等上有个人账户，并希望使用仅理解 OpenAI API 的工具。
您需要一个本地端点（例如，用于开发、离线测试或隐私），不会将您的凭据暴露到互联网。
您想要一个单一的 Web UI 来监控使用情况、轮换密钥并在多个提供商账户之间切换。

限制与注意事项

不是公共服务 – 它仅使用您自己的上游账户转发请求；它不提供任何额外配额。
兼容层是无状态的；它不在服务器端存储对话历史，也不支持超出通用 OpenAI 函数调用格式的提供商特定工具。
图像生成取决于上游模型；WorkBuddy 和 Trae 目前不支持图像。
跨提供商的模型切换受系统切换、账户权限和区域限制的影响。
该项目仍在等待对 Qoder/WorkBuddy/Trae 以及实验性的 Devin/Command Code 集成的真实账户进行完整验证。
默认情况下，API 仅监听 127.0.0.1:3010。公开暴露需要额外的网络加固。

安全说明

保持管理员密钥机密 – 它可以修改账户和系统设置。
客户端密钥应像普通 API 令牌一样对待；它们仅授予对 /v1/* 端点的访问权限。
请求日志默认省略提示和响应正文，但您可以根据需要启用它们。
遵循 SECURITY.md 中的指南报告漏洞。

社区与贡献

中文讨论在 LINUX DO 论坛（链接在 README 中）。
问题和功能请求通过 GitHub Issues 处理。
贡献遵循标准的 fork-branch-PR 工作流；详情请参阅 CONTRIBUTING.md。

许可证

MIT – 您可以使用、修改和分发该软件，但在使用您自己的账户时必须遵守上游 AI 平台的条款。

TL;DR – CLI2API 为您自己的 Qoder/WorkBuddy/Trae（以及实验性的 Devin/Command Code）账户提供了一个本地托管的、OpenAI 兼容的 API 前端，并通过基于 Docker 的堆栈和 Web 控制台进行管理。