opencodex：本地 AI 模型网关

项目简介

opencodex 是一个轻量的本地网关，位于你的编码工具与模型提供商之间。它接受 Responses、Chat Completions 和 Anthropic Messages API，并把每个请求翻译成上游提供商所使用的协议；在客户端、模型与提供商支持的情况下，同时携带流式输出、工具调用、推理内容和图片。

你可以用 Claude、Gemini、Grok、GLM、DeepSeek、Kimi、Qwen、Ollama 等提供商，驱动 Codex、Claude Code、Claude Desktop、Grok Build，以及 OpenCode、Pi、Qoder、WorkBuddy、Kilo、Cline、T3 Code 等通过托管配置接入的工具。

主要功能

• 多协议转换：接收 Responses、Chat Completions、Anthropic Messages 三种 API 形式，转发到上游实际协议。
• 多提供商支持：内置 40+ 提供商，也可添加任意 OpenAI 兼容端点。
• Web 仪表盘：在浏览器里添加提供商、选择模型、管理账号，无需手写配置。
• ChatGPT 账号池：为 Codex 认证添加多个 ChatGPT / Codex 账号，在仪表盘刷新 5 小时 / 每周 / 30 天配额；配额路由下新会话走用量最低的健康账号，已存在的 Codex 线程通常保持对发起账号的亲和，长时间 SSH、tmux 或移动端会话不会中途跳号。
• 客户端接入：仪表盘 Connect 页可一键接入 Codex、Claude Code、Claude Desktop、Grok Build 等；其他工具可自行设置 base URL。
• 桌面应用（beta）：与 CLI 共用同一套代理与仪表盘，带托盘和内置 ocx；macOS 14+ 还附带 WidgetKit 扩展，显示代理状态、当日用量与提供商配额。

安装与使用

命令行安装

npm install -g @bitkyc08/opencodex
ocx start

需要 Node 18+，Bun 运行时会自动打包。启动后代理与仪表盘位于 http://localhost:10100，打开即可完成配置。用 ocx service 让它后台常驻，用 ocx gui 随时重新打开仪表盘。

接入已有工具

桌面应用

从最新 Release 页面按平台下载安装包：macOS 13+ 用 .dmg（通用构建，Developer ID 签名并公证），Windows x64 用 .msi，Linux x86_64 用 .AppImage 或 .deb。每个文件在发布页都附带对应的 .sha256。

注意事项

• 桌面应用目前为 beta 状态，托盘功能在 Linux 上需要支持 AppIndicator 的桌面环境。
• Windows .msi 的代码签名尚在推进中，未签名版本首次运行 SmartScreen 会提示一次，选择「更多信息 → 仍要运行」即可。
• 切换 Claude Desktop 的网关配置后，需要完全退出并重新打开应用才会生效。
• 使用 Grok Build 时，添加提供商后需重启代理（启用 Codex 自启动时可执行 ocx ensure）以刷新模型列表。
• 项目以 MIT 许可证开源。

本作品整理自 GitHub 开源项目 lidge-jun/opencodex，原作者 @lidge-jun，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。