docs/integrations/codex-app.mdx
Codex App is OpenAI's desktop coding agent for macOS and Windows. Ollama configures the app to use Ollama's OpenAI-compatible endpoint, so Codex can work with local models and Ollama Cloud models in the desktop app.
Install the Codex App for macOS or Windows.
<Note>Codex App support is available in Ollama v0.24.0 and newer.</Note>
ollama launch codex-app
Once Codex App opens, start a task or open a repository as usual.
Codex App can open local servers and sites in its built-in browser. Annotate directly on the page to request changes.
Use review mode to inspect code changes, leave comments, and iterate on fixes without leaving the app.
ollama launch codex-app --model kimi-k2.6:cloud
Use a local model by passing its model name:
ollama launch codex-app --model gemma4:31b
Running ollama launch codex-app is persistent and will have your model selected next time you open Codex.
To switch Codex App back to the profile you were using before ollama launch codex-app, run:
ollama launch codex-app --restore
Ollama restores Codex App's settings and configs. If Codex App is open, Ollama asks before restarting it.
The Codex CLI profile managed by ollama launch codex is left separate from the Codex App profile.
Before overwriting Codex App config files, Ollama Launch saves backups under ~/.ollama/backup/codex-app/. On Windows, ~ resolves to your user profile directory.
If Codex App does not open after setup, open Codex manually once and run ollama launch codex-app again.
If Codex App is already running and does not switch models, allow Ollama to restart it when prompted, or quit Codex App and run ollama launch codex-app again.