项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 18302
使用教程
环境要求
- 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
上一篇:codex-runway
下一篇:all-api-hub
同类项目推荐
Trae-Proxy
开源
把 OpenAI 请求灵活转发到任意后端,模型路由随心配。
An intelligent API proxy tool designed to intercept and redirect OpenAI API requests···
awesome-kubeflow
开源
一站式找到 Kubeflow 生态的优质工具和教程,少走弯路。
A curated list of awesome projects and resources related to Kubeflow (a CNCF incubat···
NeumAI
开源
一键搭建大规模向量数据管道,让 RAG 应用数据实时同步
Neum AI is a best-in-class framework to manage the creation and synchronization of v···
gemini-cli-openai
开源
让 OpenAI 客户端不改代码直接调用 Gemini
Expose Gemini CLI endpoints as OpenAI API with Cloudflare Workers
ai-gate
开源
一个应用搞定所有AI聊天,免密钥免切换
Why juggle 6 AI tools? AI Gate does it. No API keys. A single gateway to ChatGPT, Ge···
smg
开源
一套 API 接所有推理引擎,还能按缓存智能路由
Engine-agnostic LLM gateway in Rust. Full OpenAI & Anthropic API compatibility acros···
Nubase
开源
把 AI 写的代码变成能跑的真应用,一站式后端服务
Turn AI-written code into real apps. Nubase is an open-source, AI-native backend pla···
ChatMock
开源
用 Codex 引擎替换 OpenAI API,一行配置即享新能力
OpenAI & Ollama compatible API powered by Codex
gpu-hot
开源
打开网页,实时盯紧每一块 NVIDIA GPU 的状态
Real-time NVIDIA GPU dashboard
