Skip to main content
kRouter
All integrations

Use OpenAI Codex CLI / App with any AI provider

OpenAI Codex CLI. Pointing OpenAI Codex CLI / App at kRouter gives it 100+ providers behind a single local endpoint — free tiers, subscriptions you already pay for, and paid APIs — with automatic failover when one runs out. OpenAI Codex CLI / App is configured through a config file.

Setup

  1. Install kRouter

    Install globally, then start it in the background.

  2. Connect a provider

    Open the dashboard and connect whichever providers you want OpenAI Codex CLI / App to reach.

  3. Point OpenAI Codex CLI / App at kRouter

    Set the base URL to http://localhost:20128/v1 and paste a kRouter API key.

What changes for OpenAI Codex CLI / App

Nothing about how you use OpenAI Codex CLI / App changes — same interface, same workflow. What changes is where its requests land. Instead of being tied to one vendor and one bill, every request goes through your own machine first and out to whichever provider you mapped: a free tier for routine edits, a subscription you already pay for on the heavy turns, a paid API only when nothing else fits. When one account hits a limit, the next takes over mid-session rather than failing the task. And because the router runs locally, your prompts are not passing through a third-party service on the way.

Troubleshooting OpenAI Codex CLI / App

The config file change has no effect

Confirm you edited the file the tool actually reads — some tools keep separate global and project configs, and the project one wins. Restart the tool after editing.

Model not found after switching

Model ids are provider-prefixed here (provider/model). Call GET /v1/models against kRouter to see the exact ids your connected providers expose.

OpenAI Codex CLI / App + kRouter FAQ

Can OpenAI Codex CLI / App use providers other than its default?

Yes — that is the point of routing it through kRouter. kRouter presents one OpenAI-compatible endpoint that fans out to 100+ providers, so OpenAI Codex CLI / App can reach any of them without knowing they exist.

How is OpenAI Codex CLI / App pointed at kRouter?

Through a config file. Nothing about OpenAI Codex CLI / App itself changes — it still speaks the same API.

Does routing OpenAI Codex CLI / App through kRouter cost anything?

kRouter is free and MIT-licensed and adds nothing to your bill. What you pay is whatever the provider you routed to charges — which is often nothing, if you route to a free tier or a subscription you already hold.

What happens when a provider runs out of quota mid-session?

kRouter parks that account until its real reset time and fails over to the next one you have connected, so OpenAI Codex CLI / App keeps working instead of erroring out mid-task.

Get OpenAI Codex CLI / App routing in two minutes

kRouter is free, MIT-licensed, and runs entirely on your machine — no account, no proxy in the middle.

Install kRouter