# OpenCodex

Run Codex, Claude Code, Claude Desktop and Grok Build on Claude, Gemini, DeepSeek, Ollama or 40+ other model providers through one local proxy.

> This is the Markdown version of the OpenCodex page on OpenNavo, with the same facts as the web page: https://opennavo.com/apps/opencodex

- **Latest version**: `2.96.0`
- **Developer**: lidge-jun
- **Homepage**: https://opencodex.me/
- **Categories**: [AI Tools](https://opennavo.com/categories/ai), [Developer Tools](https://opennavo.com/categories/developer-tools)
- **Install**: `brew install --cask opencodex`
- **30-day installs**: 16
- **Homebrew**: Available; the app updates itself
- **Download URL**: https://github.com/lidge-jun/opencodex/releases/download/v2.96.0/OpenCodex-2.96.0-macos.dmg
- **SHA-256**: `1d1d4339ae7be2ffc5c941018167ba9d3f57beaf544ffb4266f64c54cd1eb0b5`

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```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"
  }
]
```

## About

OpenCodex is a local proxy that translates OpenAI Codex's Responses API into whatever wire format your model provider speaks. Streaming, tool calls, reasoning tokens and images are converted in both directions, so Codex CLI, the Codex app, the Codex SDK, Claude Code, Claude Desktop and Grok Build can use Claude, Gemini, Grok, GLM, DeepSeek, Kimi, Qwen, Ollama or any other OpenAI-compatible endpoint without patching the client.

What you get:

- Five adapters (Anthropic Messages, Google Gemini, Azure, OpenAI Responses passthrough, OpenAI-compatible Chat Completions) and more than 40 built-in providers.
- A ChatGPT account pool for Codex auth: add accounts, read each quota window and let the proxy choose which account serves a request.
- A dashboard with providers, OAuth status, model selection and a live request log that counts cache tokens.
- Web search and image understanding for non-OpenAI models through a sidecar that runs over your ChatGPT login.
- `ocx stop` puts Codex back into its original configuration. If the preferred port is taken, `ocx start` stops and names the process holding it instead of opening a second proxy.

Who it is for: developers who already run Codex or Claude Code and want to point them at a different model, compare providers, or split traffic across several accounts.

Licence and accounts: OpenCodex is an independent community project under the MIT licence and is not affiliated with OpenAI, Anthropic or any other provider. You connect your own provider accounts or API keys. Some providers restrict accounts that route traffic through third-party proxies, so check their terms first.

Requirements: the Homebrew cask needs macOS 13 or later and ships builds for Apple Silicon and Intel Macs.

## System requirements

- macOS 13 or later · Version: 2.96.0 · Intel · https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · Checked 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 or later · Version: 2.96.0 · Apple silicon · https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · Checked 2026-11-02
  - https://github.com/lidge-jun/opencodex/releases/download/v2.96.0/OpenCodex-2.96.0-macos.dmg
  - SHA-256: `1d1d4339ae7be2ffc5c941018167ba9d3f57beaf544ffb4266f64c54cd1eb0b5`

## OpenCodex security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

- https://github.com/lidge-jun/opencodex · Open source: Yes — https://github.com/lidge-jun/opencodex · Checked 2026-10-30

## Uninstall

- `brew uninstall --cask opencodex`

A regular uninstall removes the app and keeps its settings and caches.

### Uninstalling also removes

- Background services (launchctl): `com.opencodex.proxy` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · These entries come from the Homebrew definition, checked 2026-11-02. They say what it declares, not what is on your Mac.
- Background services (launchctl): `OpenCodex` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · These entries come from the Homebrew definition, checked 2026-11-02. They say what it declares, not what is on your Mac.

### Deep clean (optional)

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

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/.opencodex` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · These entries come from the Homebrew definition, checked 2026-11-02. They say what it declares, not what is on your Mac.
- Files and folders: `~/.opencodex-desktop` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · These entries come from the Homebrew definition, checked 2026-11-02. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Application Scripts/com.opencodex.desktop.widget` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · These entries come from the Homebrew definition, checked 2026-11-02. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Application Support/com.opencodex.desktop` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · These entries come from the Homebrew definition, checked 2026-11-02. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Caches/com.opencodex.desktop` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · These entries come from the Homebrew definition, checked 2026-11-02. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Containers/com.opencodex.desktop.widget` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · These entries come from the Homebrew definition, checked 2026-11-02. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/LaunchAgents/OpenCodex.plist` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · These entries come from the Homebrew definition, checked 2026-11-02. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/com.opencodex.desktop.plist` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · These entries come from the Homebrew definition, checked 2026-11-02. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Saved Application State/com.opencodex.desktop.savedState` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · These entries come from the Homebrew definition, checked 2026-11-02. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/WebKit/com.opencodex.desktop` — https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencodex.rb · These entries come from the Homebrew definition, checked 2026-11-02. They say what it declares, not what is on your Mac.

## Latest release notes

### 2.96.0 (2026-11-01)

OpenCodex 2.96.0 adds opt-in MCP tools for stored Codex queues.

OpenCodex 2.96.0 was released on 2026-11-01 and adds opt-in MCP tools for stored Codex queues.

**New features**

- Opt-in MCP tools for stored Codex queues.
- Fragmented NDJSON bytes are counted incrementally.

**Bug fixes**

- Meta is excluded for direct hosted tool choices.
- Disable and shutdown are honored during startup sync.
- CN PNG raster dimensions are bounded.
- The server-issued batch is preserved for role suggestion `--apply`.
- The rejected reasoning toggle is stripped from native passthrough.
- `safety_identifier` is stripped at the canonical ChatGPT forward destination.
- Ultra quota windows are supported and subscription names are shown.
- Pool installation identity is isolated per account.

## Facts and sources

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