OpenCodex
lidge-jun · Run Codex, Claude Code, Claude Desktop and Grok Build on Claude, Gemini, DeepSeek, Ollama or 40+ other model providers through one local proxy.
brew install --cask opencodex- 30-day installs
- 9
- #1970 in App
- 1-year installs
- 9
- Last 365 days
- Latest version
- 2.96.0
- Download size
- 107MB
- dmg
- Release cadence
- Daily
- 23 releases in 30 days
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 stopputs Codex back into its original configuration. If the preferred port is taken,ocx startstops 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.
At a glance
- System
- macOS 13 or later
- Chip
- Apple silicon · Intel
- Auto-updates
- Yes
- Repository
- Open source · MIT · Updated 1 day ago★18.1K
- Developer
- lidge-jun
- Homebrew
- Available; the app updates itself
- Also known as
- opencodex
- Homepage
- opencodex.me
- Token
- opencodex
Checked
What’s new in 2.96.0
New · OpenNavo editorial
OpenCodex 2.96.0 adds opt-in MCP tools for stored Codex queues.
How to install OpenCodex on Mac
Homebrew installs the app in your Applications folder.
Install without Homebrew
Download the same file Homebrew uses: Install Details
Uninstall OpenCodex and optional data cleanup
brew uninstall --cask opencodexA regular uninstall removes the app and keeps its settings and caches.
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.
Questions about OpenCodex
Is OpenCodex safe?
OpenCodex is in Homebrew’s official catalog and has not been disabled. Since September 2026, Homebrew disables apps that fail macOS Gatekeeper checks. When installing, Homebrew checks the download from github.com against its SHA-256 checksum. It was installed 9 times through Homebrew in the last 30 days.
Is OpenCodex open source?
OpenCodex’s source code is public on GitHub (lidge-jun/opencodex) under the MIT license.
How do I completely uninstall OpenCodex on a Mac?
Run brew uninstall --cask opencodex. It quits the app and stops 2 background services. To delete its settings and caches as well, run 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. That also deletes 10 files and folders, including ~/.
Does OpenCodex run on Apple silicon (M1 and later) Macs?
Homebrew installs it on both Apple silicon and Intel Macs, from the same download. It needs macOS 13 or later.
Where does OpenCodex store its settings and data?
Its settings are in ~/. Its data is in ~/, ~/, and ~/. These locations come from Homebrew’s clean-up list.
What is the latest version of OpenCodex?
The latest version is 2.96.0, added to Homebrew on Nov 1, 2026. OpenCodex updates itself; to update it with Homebrew, run brew upgrade --cask --greedy opencodex.
Similar Apps
- ThinkRailOpen-source agentic IDE from JetBrains that runs the pi coding agent in isolated git-worktree workspaces, with Monaco editing, terminals, live diffs and a spec graph the agent reads.
- JunieJetBrains' AI coding agent for the terminal, JetBrains IDEs and CI: plan mode, models of your choice via BYOK, subagents, MCP tools and agentic debugging.
- QoderAn agentic coding platform for delegating development tasks and reviewing agent work.
- diriA native Mac workspace for running coding agents side by side, with SSH sessions, Git worktrees and change review.
