# OpenCodex

通过一个本地代理，让 Codex、Claude Code、Claude Desktop 和 Grok Build 运行在 Claude、Gemini、DeepSeek、Ollama 等 40 多个模型提供商上。

> 这是 OpenNavo 上 OpenCodex 页面的 Markdown 版本，内容与网页相同： https://opennavo.com/zh/apps/opencodex

- **最新版本**: `2.96.0`
- **开发者**: lidge-jun
- **主页**: https://opencodex.me/
- **分类**: [AI 工具](https://opennavo.com/zh/categories/ai), [开发工具](https://opennavo.com/zh/categories/developer-tools)
- **安装**: `brew install --cask opencodex`
- **近 30 天安装**: 16
- **Homebrew**: 可以安装，应用会自行更新
- **下载地址**: https://github.com/lidge-jun/opencodex/releases/download/v2.96.0/OpenCodex-2.96.0-macos.dmg
- **SHA-256**: `1d1d4339ae7be2ffc5c941018167ba9d3f57beaf544ffb4266f64c54cd1eb0b5`

SHA-256 只用来核对下载的文件是否完整，不代表安全认证。

## 安装与卸载内容

```json
[
  {
    "declaration": {
      "uninstall": [
        {
          "launchctl": [
            "com.opencodex.proxy",
            "OpenCodex"
          ],
          "quit": "com.opencodex.desktop"
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "app": [
        "OpenCodex.app"
      ],
      "target": "/Applications/OpenCodex.app"
    },
    "phase": "install",
    "sources": [
      "OpenCodex.app"
    ],
    "target": "/Applications/OpenCodex.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/.opencodex",
            "~/.opencodex-desktop",
            "~/Library/Application Scripts/com.opencodex.desktop.widget",
            "~/Library/Application Support/com.opencodex.desktop",
            "~/Library/Caches/com.opencodex.desktop",
            "~/Library/Containers/com.opencodex.desktop.widget",
            "~/Library/LaunchAgents/OpenCodex.plist",
            "~/Library/Preferences/com.opencodex.desktop.plist",
            "~/Library/Saved Application State/com.opencodex.desktop.savedState",
            "~/Library/WebKit/com.opencodex.desktop"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 介绍

OpenCodex 是一个本地代理，把 OpenAI Codex 的 Responses API 转换成你所选模型提供商使用的线上格式。流式输出、工具调用、推理令牌和图片都会双向转换，因此 Codex CLI、Codex 应用、Codex SDK、Claude Code、Claude Desktop 和 Grok Build 都能直接使用 Claude、Gemini、Grok、GLM、DeepSeek、Kimi、Qwen、Ollama 或任何兼容 OpenAI 的端点，无需修改客户端。

主要功能：

- 五种适配器（Anthropic Messages、Google Gemini、Azure、OpenAI Responses 直通、兼容 OpenAI 的 Chat Completions），内置 40 多个提供商。
- 用于 Codex 认证的 ChatGPT 账号池：可添加多个账号，查看各自的配额窗口，由代理决定哪次请求用哪个账号。
- 仪表盘，集中显示提供商、OAuth 状态、模型选择和带缓存令牌计数的实时请求日志。
- 非 OpenAI 模型可通过运行在你的 ChatGPT 登录之上的 sidecar 获得联网搜索和图像理解能力。
- `ocx stop` 会把 Codex 恢复成原来的配置。首选端口被占用时，`ocx start` 会停止并报出占用端口的进程，而不是再开一个代理。

适用人群：已经在用 Codex 或 Claude Code，并希望把它们指向别的模型、比较不同提供商，或把流量分摊到多个账号的开发者。

授权与账号：OpenCodex 是采用 MIT 许可证的独立社区项目，与 OpenAI、Anthropic 及其他提供商均无关联。你需要接入自己的提供商账号或 API 密钥。部分提供商限制通过第三方代理转发流量的账号，接入前请先查看其服务条款。

系统要求：Homebrew cask 需要 macOS 13 或更高版本，同时提供 Apple Silicon 与 Intel Mac 的构建。

## 系统要求

- macOS 13 起 · 应用版本: 2.96.0 · Intel · https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · 核查于 2026-11-02
  - https://github.com/lidge-jun/opencodex/releases/download/v2.96.0/OpenCodex-2.96.0-macos.dmg
  - SHA-256: `1d1d4339ae7be2ffc5c941018167ba9d3f57beaf544ffb4266f64c54cd1eb0b5`
- macOS 13 起 · 应用版本: 2.96.0 · Apple 芯片 · https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · 核查于 2026-11-02
  - https://github.com/lidge-jun/opencodex/releases/download/v2.96.0/OpenCodex-2.96.0-macos.dmg
  - SHA-256: `1d1d4339ae7be2ffc5c941018167ba9d3f57beaf544ffb4266f64c54cd1eb0b5`

## OpenCodex 的安全事实

这里只列可以核验的事实，并注明来源和日期，不是安全认证。要检查你下载的文件，可以用 OpenNavo 在本机扫描。

- https://github.com/lidge-jun/opencodex · 是否开源: 是 — https://github.com/lidge-jun/opencodex · 核查于 2026-10-30

## 卸载

- `brew uninstall --cask opencodex`

普通卸载会删除应用本身，设置和缓存会保留。

### 卸载时还会处理

- 后台服务（launchctl）: `com.opencodex.proxy` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · 以上条目来自 Homebrew 定义，核查于 2026-11-02；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 后台服务（launchctl）: `OpenCodex` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · 以上条目来自 Homebrew 定义，核查于 2026-11-02；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

### 深度清理（可选）

- `brew uninstall --zap --cask opencodex`

`--zap` 还会删除 Homebrew 定义里列出的设置、缓存等文件，其中可能有其他应用共用的数据，删除后无法恢复；它也不保证没有任何残留。请先备份需要保留的数据；如要保留设置和缓存，请不要加 `--zap`。

普通卸载会删除应用本身，设置和缓存会保留。

- 文件和文件夹: `~/.opencodex` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · 以上条目来自 Homebrew 定义，核查于 2026-11-02；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/.opencodex-desktop` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · 以上条目来自 Homebrew 定义，核查于 2026-11-02；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Application Scripts/com.opencodex.desktop.widget` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · 以上条目来自 Homebrew 定义，核查于 2026-11-02；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Application Support/com.opencodex.desktop` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · 以上条目来自 Homebrew 定义，核查于 2026-11-02；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Caches/com.opencodex.desktop` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · 以上条目来自 Homebrew 定义，核查于 2026-11-02；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Containers/com.opencodex.desktop.widget` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · 以上条目来自 Homebrew 定义，核查于 2026-11-02；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/LaunchAgents/OpenCodex.plist` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · 以上条目来自 Homebrew 定义，核查于 2026-11-02；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Preferences/com.opencodex.desktop.plist` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · 以上条目来自 Homebrew 定义，核查于 2026-11-02；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Saved Application State/com.opencodex.desktop.savedState` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · 以上条目来自 Homebrew 定义，核查于 2026-11-02；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/WebKit/com.opencodex.desktop` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · 以上条目来自 Homebrew 定义，核查于 2026-11-02；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

## 最新版本说明

### 2.96.0 (2026-11-01)

OpenCodex 2.96.0 于 2026-11-01 发布，为已存储的 Codex 队列新增了需主动启用的 MCP 工具。

OpenCodex 2.96.0 于 2026-11-01 发布，为已存储的 Codex 队列新增了需主动启用的 MCP 工具。

**新功能**

- 为已存储的 Codex 队列提供需主动启用的 MCP 工具。
- 分片 NDJSON 字节改为增量计数。

**问题修复**

- 直接选择托管工具时排除 Meta。
- 启动同步期间会遵循禁用和关闭操作。
- 限制 CN PNG 栅格尺寸。
- 为角色建议 `--apply` 保留服务器下发的批次。
- 从原生直通中移除被拒绝的推理开关。
- 在规范 ChatGPT 转发目标处移除 `safety_identifier`。
- 支持 Ultra 配额窗口并显示订阅名称。
- 按账户隔离资源池安装标识。

## 资料与来源

- https://opennavo.com/zh/apps/opencodex
- https://opennavo.com/zh/apps/opencodex/versions
- https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · 核查于 2026-11-02
- https://formulae.brew.sh/cask/opencodex
- https://github.com/lidge-jun/opencodex · 核查于 2026-10-30