OpenCodex
Universal provider proxy for OpenAI Codex & Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code
Overview
OpenCodex (@bitkyc08/opencodex, ocx) is a high-star open-source universal local gateway connecting your favorite AI coding agents (Codex CLI, Codex App, Claude Code, Claude Desktop, Grok Build, OpenCode, Cursor, Cline) to any LLM provider (Claude, Gemini, Grok, DeepSeek, Kimi, Qwen, Ollama, and 40+ built-ins) on localhost:10100. Featuring full streaming, tool calls, reasoning preservation, native Tauri 2 desktop installers, and macOS WidgetKit status widgets, OpenCodex lets every coding harness run whichever model you choose.
How It Works
OpenCodex operates through structured, deterministic execution stages:
ocx claude), Claude Desktop, and Grok Build through custom models while keeping streaming, tool calling, and reasoning intact.
Claude Code running a routed non-OpenAI model through OpenCodex status bar
OpenCodex proxy executing a development task inside the OpenAI Codex desktop application
OpenCodex local proxy architecture translating multi-model client protocols
Key Technical Features & Capabilities
ocx claude, ocx claude desktop, Grok Build (ocx-*), OpenCode, Pi, Kilo, Cline, and custom endpoints..dmg, Windows .msi, Docker hub, or headless CLI daemon (ocx start) with macOS 14+ WidgetKit quota widgets.Architecture & Technology Stack
System Requirements
| Specification | Minimum Requirement | Recommended Specification |
|---|---|---|
| Operating System | macOS 13+ (Universal DMG), Windows 10/11 x64 (MSI), Linux | Latest stable release build |
| Processor Architecture | 4-Core x86_64 or Apple Silicon M1 | 8-Core Apple Silicon / Core i7+ |
| Memory (RAM) | 4 GB Unified Memory | 16 GB+ High-Speed RAM |
| Disk Space | 1 GB free SSD storage | 5 GB+ free SSD storage |
Installation & Setup Guide
Desktop App & CLI Installation
OpenCodex-2.99.0-macos.dmg (notarized Universal Apple Silicon + Intel) and drag to /Applications.OpenCodex-2.99.0-windows-x64.msi and run installer (More info → Run anyway while SignPath rolls out).npm install -g --allow-scripts=bun @bitkyc08/opencodex ocx start
Building from Source
git clone -b dev https://github.com/lidge-jun/opencodex.git cd opencodex bun install bun run build:gui bun run src/cli/index.ts start
Installation & Setup Guide
Mở khóa ứng dụng để xem chi tiết hướng dẫn cài đặt, cấu hình môi trường và vận hành.
How to Use & Workflow
ocx start to bind http://127.0.0.1:10100.http://localhost:10100 and configure API keys or OAuth logins across Claude, Gemini, Grok, DeepSeek, or Ollama.ocx claude, ocx claude desktop, or point any client base URL to http://localhost:10100/v1.How to Use & Workflow
Mở khóa ứng dụng để xem chi tiết hướng dẫn cài đặt, cấu hình môi trường và vận hành.
Troubleshooting & Common Issues
npm install warns or misses the bundled Bun binary.**npm install -g --allow-scripts=bun @bitkyc08/opencodex.ocx-* models.**ocx ensure / restart proxy, then completely quit and reopen the target desktop client.How to Use & Getting Started
How to Use & Getting Started
Unlock this app with 2 Redit to access verified runbooks and usage workflows.
Ready to run OpenCodex?
100% Free & Open-Source native desktop software. Star the repository to support development.
More in ai-automation
View all ai-automation apps →
CodexClaw
Development discipline + multi-model subagents for OpenAI Codex — 13 dev skills, PABCD workflow, repo map, recall, skill search. Single plugin, no external harness.
Aside Codemode
One call where Aside used to spend fifty — rg-backed search, Aside-shaped file tools, and batched browser work inside a single sandboxed JavaScript block. On a real folder, 55s of find+grep became ...
AGBrowse
Ultimate browser automation toolkit for AI agents. Zero MCP token tax, JS evaluate, vision-click with DPR correction.