5分钟上手OpenCodexmacOS/Linux/Windows安装、启动与配置保姆级教程【免费下载链接】opencodexUniversal provider proxy for OpenAI Codex Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code项目地址: https://gitcode.com/gh_mirrors/ope/opencodexOpenCodex 是一款免费开源的通用 LLM 代理provider proxy只需两条命令就能让 OpenAI Codex 与 Claude Code 跑起 Claude、Gemini、Grok、DeepSeek、Ollama 等任意大模型。本教程面向新手带你完成 macOS / Linux / Windows 三大平台下的安装、启动与首次模型配置全程不超过 5 分钟。如上图所示OpenCodex 的核心思路很简单Codex 只会说 Responses API而 OpenCodex 把它翻译成各家模型供应商的原生协议流式输出、工具调用、推理 token、图片全部双向兼容一个本地端点即可接入 40 家 Provider。安装前检查3 分钟准备工作开始之前确认你的电脑满足以下 3 个条件准备项要求说明Node.js≥ 18 版本OpenCodex 的 Bun 运行时会随npm install自动捆绑无需单独安装OpenAI CodexCLI、App 或 SDK 任一OpenCodex 要接入的客户端模型账号或 API Key任意一家如 Anthropic、xAI、Kimi、Ollama Cloud、OpenRouter或任意 OpenAI 兼容端点三大平台均原生支持Windows 也不需要 WSL操作系统支持状态后台服务管理方式macOSarm64 / x64✅ 完整支持launchdLinuxx64 / arm64✅ 完整支持systemd用户级Windowsx64✅ 完整支持Task SchedulermacOS / Linux一行命令完成安装打开终端执行npm install -g bitkyc08/opencodex安装完成后验证命令可用ocx与opencodex两个命令名都可用ocx --version 仓库中还提供了官方安装脚本 scripts/install.sh它会先检查 Node 版本再执行安装适合想一键完成的用户。遇到 bundled Bun runtime is missing 报错怎么办说明 npm 拦截了 Bun 的安装脚本允许脚本后重装即可注意务必带上包名npm install -g --allow-scriptsbun bitkyc08/opencodexWindowsPowerShell 安装步骤在 PowerShell 中执行同一条 npm 命令即可npm install -g bitkyc08/opencodex ocx --version仓库内同样附带了 scripts/install.ps1 一键脚本。若提示ocx不在 PATH 中把 npm 全局 bin 目录加入 PATH 后重新打开 PowerShell 即可。想从源码安装最新版三大平台通用流程macOS / Linuxgit clone https://gitcode.com/gh_mirrors/ope/opencodex cd opencodex bun install bun run src/cli/index.ts start启动代理ocx start 最快上手方式ocx start # 前台启动代理 仪表盘运行在 localhost:10100启动时 OpenCodex 会自动完成三件事写入 PID 防止重复启动、自动发现并同步模型目录到 Codex、在http://localhost:10100开始监听。如果端口被占用它会自动换一个空闲端口并同步更新 Codex 的配置无需手动干预。验证是否运行正常ocx status # 查看代理状态 ocx health # 检查健康状态希望开机自启、后台常驻安装为系统服务即可launchd / systemd / Task Scheduler 自动适配ocx service install启动后打开http://localhost:10100就是上图中这个 Web 仪表盘——Provider、模型、子代理、日志全部可视化管理随时可用ocx gui重新打开。Web 仪表盘连接第一个 Provider配置 Provider 完全在网页里完成不用手写配置文件在仪表盘点击Add Provider或运行ocx gui进入页面从 40 内置 Provider 中选择或输入自定义的 OpenAI 兼容端点粘贴 API KeyAnthropic、xAI、Kimi 也支持 OAuth 登录免填 Key模型会从 Provider 的/v1/models端点自动发现新 Provider 立即可用无需重启。添加完成后Provider 页面会展示所有账号的登录状态与配额信息如 5 小时配额进度条也可以运行交互式向导ocx init它会依次引导你选择 Provider、填写 Key、设定默认模型与端口并自动把代理注入 Codex 配置写入~/.opencodex/config.json。第一次使用provider/model 路由语法配置好之后在 Codex 中直接用provider/model格式指定任意模型codex -m anthropic/claude-opus-5 解释这个堆栈报错 codex -m google/gemini-3-pro 为 auth.ts 写单元测试 codex -m ollama/llama3 重构这个函数省略provider/前缀时OpenCodex 会路由到默认 Provider或按模型名自动匹配如claude-*走 Anthropic、gpt-*走 OpenAI。路由模型还会直接出现在 Codex App 的模型选择器里和原生模型一样可选常用 ocx 命令一览表命令作用ocx init交互式初始化写入配置、接入 Codexocx start [--port 10100]前台启动代理ocx stop停止并恢复原生 Codex 配置零残留ocx service [install\|uninstall]安装/卸载后台服务ocx gui打开 Web 仪表盘ocx provider ...管理 Provider增删改查ocx login xai\|anthropic\|kimiOAuth 登录免填 API Keyocx status/ocx doctor/ocx health查看运行状态与诊断ocx update更新 OpenCodex干净卸载零残留退出用ocx stop或ocx restore会剥离 OpenCodex 注入的每一行配置把 Codex 完整还原为原生状态——无残留配置、无僵尸进程。彻底卸载时ocx uninstall # 停止代理、移除服务/shim、恢复原生 Codex、清理 ~/.opencodex npm uninstall -g bitkyc08/opencodex延伸阅读与项目资料资料路径项目总览英文README.md项目总览简体中文readme/README.zh-CN.md官方安装文档docs-site/src/content/docs/getting-started/installation.md快速上手指南docs-site/src/content/docs/getting-started/quickstart.mdCLI 入口源码src/cli/index.ts包信息版本与命令package.json⚠️小提示OpenCodex 是独立的社区维护项目与 OpenAI、Anthropic 无隶属关系。部分供应商尤其 Anthropic可能对经第三方代理路由流量的账号采取限制措施接入前请先确认其服务条款风险自负。至此你已经拥有了一条任意 LLM × Codex / Claude Code的完整链路——加一个 Provider、换一个模型名工作流完全不变只有大脑换了。【免费下载链接】opencodexUniversal provider proxy for OpenAI Codex Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code项目地址: https://gitcode.com/gh_mirrors/ope/opencodex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考