OpenCodex Skill：让 Codex 和 Claude Code 自由切换任意大模型的本地代理

OpenCodex Skill：让 Codex 和 Claude Code 自由切换任意大模型的本地代理

它不是一个模型，而是一个模型路由层。只需两条命令，就能让 OpenAI Codex、Claude Code、Claude Desktop、Grok Build 无缝接入 Claude、GPT-5.6 Sol、Gemini、Grok、DeepSeek、Kimi、Qwen、Ollama 等 40+ 大模型，无需改工作流，换脑不换手。

OpenCodex 的核心定位是打破编码 Agent 的模型锁定。它以轻量级本地代理的方式运行，监听在 localhost:10100，通过翻译 Codex 的 Responses API 与目标 LLM 提供商之间的协议差异，实现双向流式传输、工具调用（tool calls）、推理 token、图像等所有能力的透明转发。

认可度：GitHub trending 榜单常客，2026 年 9 月月增长约 +4,700+ stars（30 天趋势），在 reporank 月度 AI 开源榜单中稳居前列，是当月增长最快速的 Agent 工具类项目之一。

GitHub 链接：https://github.com/lidge-jun/opencodex

原作者：lidge-jun（GitHub username），Node.js/Bun 技术栈开发者，项目同步发布 npm 包 @bitkyc08/opencodex。

功能与原则

OpenCodex 解决了编码 Agent 领域一个普遍痛点：一旦选定某个 Agent 工作流，就被绑定在它原生支持的模型上。开发者想试试 Kimi K3 的性价比，或者想用 GPT-5.6 Sol 的推理能力，就必须放弃现有的 Codex 会话和习惯。

它的设计原则是最小侵入：不改任何 Agent 客户端代码，不引入新的 CLI 概念，只在本地加一层协议翻译代理。用户继续用 /code、继续用 Codex 的文件编辑和 terminal 集成，只是背后驱动它的”大脑”可以随时切换。

核心能力

• 多模型支持：内置 40+ 提供商配置，涵盖 Claude 系列、GPT 系列、Gemini、Grok、GLM、DeepSeek、Kimi、Qwen、Ollama 及所有 OpenAI 兼容端点
• 双向协议翻译：Responses API ↔ 各厂商原生 API，双向支持 streaming、tool calls、reasoning tokens、图像输入
• ChatGPT 账号池管理：在 dashboard 中添加多个 ChatGPT/Codex 账号，自动刷新 5h/周/月配额；新会话自动路由到用量最低的健康账号，支持轮询和”先耗尽”策略
• 会话亲和性：长时间 SSH/tmux 或手机连入的会话会保持原有账号绑定，不会中途跳账号；仅在配额重评估、故障转移或 401/403/429 时触发重绑定
• 零成本试用：npm 安装，本地运行，无须申请任何 API key 即可开始

使用方法

安装只需两条命令（Node.js 18+）：

npm install -g @bitkyc08/opencodex
ocx start

启动后访问 http://localhost:10100 的 Web Dashboard 配置提供商和模型。也可以用 ocx service 将其作为后台守护进程运行。添加提供商的方式有两种：在 Dashboard 可视化界面点选，或用 ocx provider add 命令行添加。

对于 Codex CLI 用户，配置代理后只需：

export OPENAI_BASE_URL=http://localhost:10100/v1
export OPENAI_API_KEY=anything  # OpenCodex 忽略此字段
codex  # 正常启动即可

Claude Code 用户同理，只需将 API 端点指向 localhost:10100。

使用场景与人群

目标用户：
– 已在生产环境使用 Codex 或 Claude Code，但希望自由选择性价比最优模型的开发者
– 需要在团队内共享多个模型账号、避免个人额度耗尽的中小团队
– 想尝试新模型（Kimi K3、GPT-5.6 Sol 等）但不想中断现有 Agent 工作流的探索者

典型场景：
– 用 Claude Opus 处理复杂架构设计，再用 Kimi K3 做批量代码补全，对比成本和输出质量
– 团队共用企业 API 密钥，通过账号池管理避免单账号触发限流
– 在不同项目间快速切换模型评估，不必为每个模型重新配置 Agent 环境

输入与输出案例

案例一：切换模型

Input：在 Claude Code 中执行 /code，实现一个支持并发写入的 Redis 缓存层
↓
OpenCodex 路由到 Kimi K3（成本优先模式）
Output：[完整代码，附中文注释]

案例二：账号池自动故障转移

Input：用尽当前 ChatGPT 账号的周配额
↓
OpenCodex 自动检测到 429 错误，将请求无缝迁移到账号池中下一个健康账号
Output：会话不中断，Agent 继续工作，开发者无感知

安装与延伸

完整文档（含多语言 README）访问：https://opencodex.me/

作为 Agent 生态中模型路由层的代表性 Skill，OpenCodex 体现了”工具可组合”的核心思想——它不替代编码 Agent，而是扩展了 Agent 的选择边界，让开发者真正掌控自己的 AI 工作流。

GitHub: https://github.com/lidge-jun/opencodex