opencodex

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

开源 🏷️定价信息待确认 ✅ 目前可打开 对话助手 🍴 复刻 1453 🐛 待处理 170 👀 关注 26
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 18302
维护状态 活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

opencodex 项目界面预览图
图片来源:项目官网

项目数据

分类对话助手
开发团队lidge-jun
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态✅ 目前可打开
是否开源是
开源协议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 星标★ 18302
上线时间2026-06-18 00:00:00
代码更新2026-11-09
仓库体积323.6 MB
本站数据更新2026-11-09
维护状态活跃
收录时间2026-08-09
浏览次数6

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 18302

使用教程

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

环境要求

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

安装与启动步骤

  1. 1安装 opencodex

    通过 npm 全局安装 opencodex,安装过程会自动附带 Bun 运行时,无需另外安装。

    npm install -g @bitkyc08/opencodex
  2. 2启动代理服务

    执行 ocx start 启动代理和 Web 仪表盘,默认监听本机 10100 端口。

    ocx start
  3. 3打开仪表盘配置

    在浏览器访问该地址,在 Web 仪表盘中添加提供商、选择模型、管理账号。

  4. 4后台常驻运行

    若不想一直占用终端,用 ocx service 把服务注册为后台服务运行。

    ocx service
  5. 5再次打开仪表盘

    服务已在后台时,用 ocx gui 随时重新打开配置面板。

    ocx gui
  6. 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···

★ 197 2026-08-09
awesome-kubeflow 开源

一站式找到 Kubeflow 生态的优质工具和教程,少走弯路。

A curated list of awesome projects and resources related to Kubeflow (a CNCF incubat···

★ 232 2026-08-09
NeumAI 开源

一键搭建大规模向量数据管道,让 RAG 应用数据实时同步

Neum AI is a best-in-class framework to manage the creation and synchronization of v···

★ 868 2026-08-09
gemini-cli-openai 开源

让 OpenAI 客户端不改代码直接调用 Gemini

Expose Gemini CLI endpoints as OpenAI API with Cloudflare Workers

★ 894 2026-09-16
ai-gate 开源

一个应用搞定所有AI聊天,免密钥免切换

Why juggle 6 AI tools? AI Gate does it. No API keys. A single gateway to ChatGPT, Ge···

★ 222 2026-08-09
smg 开源

一套 API 接所有推理引擎,还能按缓存智能路由

Engine-agnostic LLM gateway in Rust. Full OpenAI & Anthropic API compatibility acros···

★ 703 2026-10-25
Nubase 开源

把 AI 写的代码变成能跑的真应用,一站式后端服务

Turn AI-written code into real apps. Nubase is an open-source, AI-native backend pla···

★ 620 2026-08-09
ChatMock 开源

用 Codex 引擎替换 OpenAI API,一行配置即享新能力

OpenAI & Ollama compatible API powered by Codex

★ 1565 2026-08-09
gpu-hot 开源

打开网页,实时盯紧每一块 NVIDIA GPU 的状态

Real-time NVIDIA GPU dashboard

★ 1643 2026-08-09