lidge-jun/opencodex

项目介绍

opencodex 是一个运行在本地的 AI 编程工具与模型提供商之间的网关。它接受 OpenAI Responses、Chat Completions 和 Anthropic Messages 三种请求格式，转换成目标提供商的原生协议，并在客户端、模型和提供商都支持时传递流式输出、工具调用、推理内容和图片。内置提供方包括 OpenAI、Anthropic、Gemini、xAI、Kimi、DeepSeek、Groq、OpenRouter、Ollama，以及任何 OpenAI 兼容端点。

主要接入对象是 Codex、Claude Code、Claude Desktop 和 Grok Build：这些工具保留自己的界面，但可以让选定的模型来驱动。OpenCode、Cline、Kilo、Qoder 等客户端通过托管配置或自定义 base URL 接入。端口 10100 上的 Web 面板负责管理提供商账号、模型选择和请求日志。

快速使用

CLI 安装需要 Node.js 18+。全局安装并启动代理：

npm install -g --allow-scripts=bun @bitkyc08/opencodex
ocx start

安装脚本会捆绑 Bun 运行时。之后打开 http://localhost:10100，在面板中添加提供商并选择模型。Claude Code 用户运行 ocx claude；Codex 用户在 Connect 页面打开开关或运行 ocx init。其他工具可将 base URL 设为 http://localhost:10100/v1（OpenAI 兼容）或 http://localhost:10100（Anthropic 风格）。各工具的接入路径和协议见客户端支持页。

macOS、Windows 和 Linux 桌面版可从最新发布获取，已捆绑代理，不需要 Node 或 Bun。

路由与进阶功能

用 provider/model 指定目标，例如 codex -m "anthropic/claude-opus-5" 或 ollama/llama3。Combo 用一个虚拟模型 ID 在多个提供商之间做故障转移或加权轮询。ChatGPT 账号池可以把 Codex 请求分散到多个登录账号，并按配额自动切换。

使用约束

• CLI 需要 Node 18+；从源码构建需要 Bun 在 PATH 中。
• 代理默认绑定 127.0.0.1。绑定到其他网卡时必须设置 OPENCODEX_API_AUTH_TOKEN，客户端需通过 x-opencodex-api-key 携带。
• Windows 桌面版正在推进 Authenticode 签名；未签名的发布可能触发 SmartScreen，需要一次性选择“仍要运行”。每个发布文件旁有 .sha256 可供校验。
• 部分提供商会限制或封禁经由第三方代理的流量，Anthropic 尤其如此。启用前请核对各提供商的服务条款。项目声明与 OpenAI、Anthropic 无关联。
• 匿名每日用量统计会在用户看到提示且未拒绝后上报；可通过 ocx telemetry disable、OCX_TELEMETRY=0 或 DO_NOT_TRACK=1 关闭。
• 许可证：MIT。

HotRepo 点评

2026-11-13，该项目在 TypeScript 日榜记录到 55 个新增 Star，当日最好名次为 17，总 Star 数为 18,468、Fork 数为 1,469。这只是一个快照而非趋势，但说明当天它在 TypeScript 仓库中活跃度靠前。从 README 的覆盖面看——协议转换、40+ 提供商、Combo、子代理路由、账号池和桌面应用——它面向的是已经在用多个编程 Agent、希望有一个本地路由层的开发者，而不是要替换某个客户端。