opencodex

简介

opencodex（lidge-jun/opencodex，npm 包名 @bitkyc08/opencodex，CLI 命令 ocx）是一款通用模型中转代理（Universal Provider Proxy）：它把 OpenAI Codex 的 Responses API 翻译成各厂商自己的协议——流式输出、工具调用、推理 token、图片，双向转换。

一句话概括：让 Codex / Claude Code / Claude Desktop / Grok Build 都能跑任何大模型（Claude、Gemini、Grok、GLM、DeepSeek、Kimi、Qwen、Ollama…）。

核心功能

• 任意模型接入 Codex 系列客户端：40+ 内置 Provider（OpenAI、Anthropic、Google Gemini、xAI、Kimi、Azure OpenAI、Ollama、DeepSeek、Groq、OpenRouter、Together、Fireworks、Cerebras、Mistral、Hugging Face、NVIDIA NIM、MiniMax、通义、硅基流动等），或任意 OpenAI 兼容端点。
• ChatGPT 账号池管理：可添加多个 ChatGPT/Codex 账号，在面板里刷新 5 小时 / 每周 / 30 天配额；新会话自动路由到余量最充足的健康账号，已有会话保持”线程亲和”不跳号（配额重评估、故障切换、401/403/429 恢复时可重绑定）。
• Combos 组合模型：一个虚拟模型 ID，在不同 Provider 间做故障转移或加权轮询。
• 子代理换模型：在 Codex 的 sub-agent 选择器里路由模型，支持 v1/v2 界面控制与回退链。
• 免 API Key 登录：xAI、Anthropic、Kimi 支持 OAuth；也可转发 codex login、直接粘贴 Key、或引用 ${ENV_VAR} 环境变量。
• Web 搜索 & 视觉侧车：非 OpenAI 模型也能通过你的 ChatGPT 登录态获得真实联网搜索和图片理解能力。
• 可视化面板：localhost:10100 上查看 Provider、OAuth 状态、模型选择，以及带缓存 token 统计的实时请求日志。
• 干净退出零残留：ocx stop 会把 Codex 配置恢复原样；进程内所有长期状态都有内存上限（默认 256 MiB 预算），无无限增长的 Map/Set。

快速使用

安装与启动（人用）

npm install -g @bitkyc08/opencodex   # 需 Node 18+，Bun 运行时会自动随包捆绑
ocx start                            # 启动代理 + 面板，默认 localhost:10100

之后打开 http://localhost:10100 在网页面板里配置：添加 Provider、选模型、管理账号。ocx gui 可随时重新打开面板，ocx service 以后台服务方式运行。

Agent 用法

npm install -g @bitkyc08/opencodex
ocx start     # 或 ocx service
ocx init      # 交互式初始化：写入 ~/.opencodex/config.json 并接好 Codex

先启动代理再执行其他命令：ocx provider add、ocx combo set 等无头命令需要连接运行中的代理。ocx status / ocx doctor / ocx health 可查看运行状态。Agent 安装请阅读仓库里的 AGENTS_INSTALL.md。

模型路由

用 provider/model 语法指定任意已配置的 Provider 和模型：

codex -m "anthropic/claude-opus-5" "Explain this stack trace"
codex -m "google/gemini-3-pro" "Write unit tests for auth.ts"
codex -m "ollama/llama3" "Refactor this function"

省略 provider/ 前缀则使用默认 Provider，或按模型名模式自动匹配。

从源码安装（最新 dev 版，Bun canary）

macOS / Linux：

curl -fsSL https://bun.sh/install | bash && ~/.bun/bin/bun upgrade --canary
git clone https://github.com/lidge-jun/opencodex.git
cd opencodex && ~/.bun/bin/bun install
~/.bun/bin/bun run src/cli/index.ts start

Windows（PowerShell）：

irm bun.sh/install.ps1 | iex; bun upgrade --canary
git clone https://github.com/lidge-jun/opencodex.git
cd opencodex; bun install
bun run src/cli/index.ts start

平台支持

常用 CLI 命令

ocx start       # 启动代理与面板（localhost:10100）
ocx service     # 后台运行
ocx stop        # 停止并恢复 Codex 原始配置
ocx init        # 交互式初始化配置
ocx gui         # 重新打开面板
ocx status      # 查看运行状态
ocx doctor      # 诊断检查
ocx health      # 健康检查

文档与地址

• GitHub 仓库：https://github.com/lidge-jun/opencodex
• 完整文档：https://opencodex.me/
• npm 包：https://www.npmjs.com/package/@bitkyc08/opencodex
• 安装文档：https://opencodex.me/getting-started/installation/

注：本文档根据 opencodex README 整理，截至 2026-08-19。