> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ollama.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex App

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.

<img src="https://mintcdn.com/ollama-9269c548/Fw0HGVBarMASKyhi/images/codex-app-home.png?fit=max&auto=format&n=Fw0HGVBarMASKyhi&q=85&s=e97befd3384f711903050d32029d583c" alt="Codex App with Ollama selected" style={{ borderRadius: "12px" }} width="2088" height="1404" data-path="images/codex-app-home.png" />

## Install

Install the [Codex App](https://developers.openai.com/codex/quickstart/) for macOS or Windows.

<Note>Codex App support is available in Ollama v0.24.0 and newer.</Note>

## Quick setup

```shell theme={"system"}
ollama launch codex-app
```

Once Codex App opens, start a task or open a repository as usual.

## Built-in browser

Codex App can open local servers and sites in its built-in browser. Annotate directly on the page to request changes.

<img src="https://mintcdn.com/ollama-9269c548/Fw0HGVBarMASKyhi/images/codex-app-annotate.png?fit=max&auto=format&n=Fw0HGVBarMASKyhi&q=85&s=8bf1243702c327e5e56707bae0c89d70" alt="Codex App browser annotations" style={{ borderRadius: "12px" }} width="2145" height="1336" data-path="images/codex-app-annotate.png" />

## Review mode

Use review mode to inspect code changes, leave comments, and iterate on fixes without leaving the app.

<img src="https://mintcdn.com/ollama-9269c548/Fw0HGVBarMASKyhi/images/codex-app-review.png?fit=max&auto=format&n=Fw0HGVBarMASKyhi&q=85&s=f507519443fb7ae71a1660a7722b8e2e" alt="Codex App review comments" style={{ borderRadius: "12px" }} width="2273" height="1392" data-path="images/codex-app-review.png" />

### Run directly with a model

```shell theme={"system"}
ollama launch codex-app --model kimi-k2.6:cloud
```

Use a local model by passing its model name:

```shell theme={"system"}
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.

### Restore Codex App

To switch Codex App back to the profile you were using before `ollama launch codex-app`, run:

```shell theme={"system"}
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.

## Troubleshooting

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.