You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 9ccd9b3
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: README.md
+27-8Lines changed: 27 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,10 +1,11 @@
1
1
<palign="center">
2
-
<imgsrc="assets/banner.png"alt="opencodex — universal provider proxy for Codex, Claude Code, Claude Desktop and Grok Build"width="100%">
2
+
<imgsrc="assets/banner.png"alt="opencodex — one local gateway for Codex, Claude Code, Claude Desktop, Grok Build and more"width="100%">
3
3
</p>
4
4
5
-
<h3align="center">make codex open!</h3>
6
-
<palign="center"><b>Universal provider proxy for OpenAI Codex, Claude Code, Claude Desktop & Grok Build</b><br>
7
-
Two commands, and every one of them runs any LLM you point it at.</p>
5
+
<h3align="center">One local gateway for your AI coding tools and models.</h3>
6
+
<palign="center"><b>Use the models you choose with Codex, Claude Code, Claude Desktop and Grok Build,<br>
7
+
and connect OpenCode, Pi, Qoder, WorkBuddy, Kilo, Cline, T3 Code and more through managed configs.</b><br>
8
+
<ahref="https://opencodex.me/reference/client-support/">See every supported tool →</a></p>
8
9
9
10
<palign="center">
10
11
<ahref="https://x.com/claudeebum"><imgsrc="https://img.shields.io/badge/%40claudeebum-000000?logo=x&logoColor=white"alt="Follow @claudeebum on X"></a>
@@ -80,10 +81,12 @@ Sol drives the session and calls a Kimi K3 subagent.
opencodex is a lightweight local proxy that translates Codex's Responses API into whatever your
84
-
provider speaks — streaming, tool calls, reasoning tokens, images, in both directions. Use Claude,
85
-
Gemini, Grok, GLM, DeepSeek, Kimi, Qwen, Ollama, or any other LLM with Codex, Claude Code, Claude
86
-
Desktop, and Grok Build. It can also manage a **ChatGPT account pool** for Codex auth: add accounts,
84
+
opencodex is a lightweight local gateway between your coding tools and your model providers. It
85
+
accepts the Responses, Chat Completions and Anthropic Messages APIs and translates each request into
86
+
whatever your provider speaks, carrying streaming, tool calls, reasoning and images where the client,
87
+
model and provider support them. Use Claude, Gemini, Grok, GLM, DeepSeek, Kimi, Qwen, Ollama and other
88
+
providers with Codex, Claude Code, Claude Desktop, Grok Build and the tools listed on the
89
+
[client support page](https://opencodex.me/reference/client-support/). It can also manage a **ChatGPT account pool** for Codex auth: add accounts,
87
90
refresh their quotas in the dashboard, and let new sessions auto-route to the lowest-usage healthy
88
91
account while existing threads stay pinned to the account that started them.
89
92
@@ -102,6 +105,22 @@ Open **http://localhost:10100** and configure everything in the web dashboard
102
105
(40+ built-ins, or any OpenAI-compatible endpoint), pick models, manage accounts. `ocx gui`
103
106
re-opens the dashboard at any time.
104
107
108
+
### Connect your tool
109
+
110
+
Connect the tool you already use:
111
+
112
+
| Tool | How to connect |
113
+
|---|---|
114
+
| Codex | Turn on the Codex switch on the dashboard's **Connect** page, then run `codex` as usual. On a local listener this points Codex's built-in provider at the proxy. From the terminal, run `ocx init` before adding providers in the dashboard and accept its Codex prompt. |
115
+
| Claude Code | With the `claude` CLI installed, run `ocx claude`. It starts the proxy if needed and launches Claude Code through it. |
116
+
| Claude Desktop | Run `ocx claude desktop`. On a new install it sets up the gateway profile for the whole app; an existing first-party setup is kept, and `ocx claude desktop apply --gateway` switches explicitly. See the [Claude Code guide](https://opencodex.me/guides/claude-code/). Fully quit and reopen Claude Desktop after a switch. |
117
+
| Grok Build | On a local listener with Grok integration enabled, `ocx start` registers the models when `~/.grok` exists; pick an `ocx-*` model in Grok Build. Remote setups: see the [Grok Build guide](https://opencodex.me/guides/grok-build/). After adding providers, restart the proxy (or run `ocx ensure` when Codex autostart is enabled) to refresh the list. |
118
+
| Tools with a managed integration | Use the dashboard **Connect** page, or `ocx integration client enable --client <id>`. |
119
+
| Any other tool | Set a custom OpenAI-compatible base URL of `http://localhost:10100/v1`, or an Anthropic base URL of `http://localhost:10100`. |
120
+
121
+
The [client support page](https://opencodex.me/reference/client-support/) lists which path each tool has
0 commit comments