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

# Codex

> Connect Codex to your downloaded Magnitude models.

## Connect

1. [Install Codex](https://developers.openai.com/codex/cli) if needed.
2. Download a compatible model in Magnitude.
3. Open **Connections → Codex** and click **Connect**.
4. Open or restart Codex and choose your Magnitude model.

Magnitude configures Codex’s local gateway and model catalog. Local model IDs use the `magnitude-local/` prefix inside Codex. Keep Magnitude running while connected, including when you select a hosted model: hosted requests pass through the gateway to their provider. Disconnect in Magnitude and restart Codex before using it independently again.

## Select a model from the terminal

To configure the connection and select a specific downloaded model, first find its exact ID:

```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
magnitude models status
magnitude connections add codex --set-model "MODEL_ID"
```

Replace `MODEL_ID` with the ID from the first command, not the friendly display name. Restart the agent after changing its configuration.

## Configuration

Default configuration files:

* `~/.codex/config.toml`
* `~/.codex/magnitude.config.toml`
* `~/.codex/magnitude.models.json`

On Windows, `~` means your user profile directory.

Supported location overrides: `CODEX_HOME`. The paths displayed in Connections show which files Magnitude is actually checking.

## Repair or disconnect

If Connections shows **Connection needs repair**, click **Repair connection**. To stop using the integration, click **Disconnect**, then restart the agent.

Terminal equivalents:

```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
magnitude connections sync codex
magnitude connections remove codex
```

See [connection states](/integrations/overview#connection-states) if the agent is not detected or its configuration cannot be verified.