opencodex

一个网关，让 Codex 和 Claude Code 用上任意大模型

opencodex 是一个通用的 AI 网关代理，专为 OpenAI Codex 和 Claude Code 设计。它解决了开发者被锁定在单一模型提供商的问题，让你能通过 Codex CLI、桌面应用、SDK 以及 Claude Code 使用任意 LLM，包括 Claude、Gemini、Grok、DeepSeek 和本地 Ollama 模型。核心能力是提供统一的 API 兼容层，无缝转发请求并转换协议，使现有工具链无需改动即可接入新模型。项目用 TypeScript 编写，配置灵活，支持多模型路由和负载均衡，帮助团队降低 API 成本、提升模型选择自由度。目前星标 8704，属于成长中的热门工具，尤其适合多模型策略的开发者。

开源 unknown 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 15929

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类对话助手

开发团队lidge-jun

所属国家

官网地址https://opencodex.me

GitHubhttps://github.com/lidge-jun/opencodex

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ai-gateway,ai-tools,anthropic,chatgpt,claude,claude-code,codex,codex-cli,deepseek,developer-tools,gemini,grok,kiro,llm,llm-proxy,ollama,openai,openrouter,proxy,typescript

GitHub 星标★ 15929

30天Star增速

HF 下载量

上线时间2026-06-18 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数5

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

Node.js 18 或更高版本（Bun 运行时会自动一并安装）
已安装 npm，可访问 npm 官方源
本机 10100 端口未被占用（代理与仪表盘均在该端口）
需要为所接入的模型厂商准备对应的 API Key

安装与启动步骤

1安装 opencodex

通过 npm 全局安装 opencodex，安装过程会自动附带 Bun 运行时，无需另外安装。
```
npm install -g @bitkyc08/opencodex
```
2启动代理服务

执行 ocx start 启动代理和 Web 仪表盘，默认监听本机 10100 端口。
```
ocx start
```
3打开仪表盘配置

在浏览器访问该地址，在 Web 仪表盘中添加提供商、选择模型、管理账号。
4后台常驻运行

若不想一直占用终端，用 ocx service 把服务注册为后台服务运行。
```
ocx service
```
5再次打开仪表盘

服务已在后台时，用 ocx gui 随时重新打开配置面板。
```
ocx gui
```
6卸载与还原

先执行 ocx uninstall 停止服务并还原原生 Codex，再卸载 npm 全局包。
```
ocx uninstall
npm uninstall -g @bitkyc08/opencodex
```

如何确认成功

浏览器打开 http://localhost:10100，能正常加载仪表盘页面即表示代理启动成功。

常见问题

Q：必须自己安装 Bun 吗？

A：不需要。npm 安装过程中会自带 Bun 运行时，只要本机 Node 版本在 18 以上即可。

Q：一定要一直开着终端窗口吗？

A：不必。改用 ocx service 让它在后台运行，之后用 ocx gui 打开仪表盘即可。

Q：如何接入任意厂商的模型？

A：在仪表盘里添加提供商，内置 40 多个常见厂商，也支持任何 OpenAI 兼容端点。

Q：卸载后会残留改动吗？

A：ocx uninstall 会停止服务、移除 service/shim 并还原原生 Codex 并清理状态，之后再用 npm 卸载即可。

注意事项

仪表盘默认地址为 http://localhost:10100，若被占用需先释放端口
新会话可按配额自动路由到用量最低的健康账号，已有 Codex 线程通常保持账号亲和
遇到 401/403 或 429 时可能触发重新绑定账号，属预期行为
配置文件与状态都在本地，接入模型前请准备好各厂商 API Key

核心亮点

协议转换开箱即用，无需修改现有 Codex/Claude Code 配置
支持本地模型（Ollama），兼顾数据隐私和成本控制
多模型路由与切换灵活，可针对不同任务选择最优模型

不足之处

文档/社区待观察
代理层可能引入额外延迟，影响实时交互体验

适用场景

在 Codex CLI 中使用 DeepSeek 或本地模型替代默认 GPT
团队统一管理多模型 API 密钥，按项目分配用量
将 Claude Code 接入 Gemini 或 Grok 以对比模型效果

替代项目

LiteLLM、OpenRouter、one-api

项目介绍

opencodex 是基础设施领域的开源项目，由 lidge-jun 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（15,929）位列前 3%，在基础设施分类的 1,130 个项目里位列前 5%。

近 44 天，它的 GitHub 星标从 8,704 增加到 15,929，净增 7,225。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。从国内网络环境看，可直接访问。

它主要面向的使用场景是：在CodexCLI中使用DeepSeek或本地模型替代默认GPT。同类可对比的替代方案包括 LiteLLM、OpenRouter、one-api。

上一篇：codex-runway

下一篇：all-api-hub