models.md +38 −9
2 2
3## Recommended models3## Recommended models
4 4
5
6
7gpt-5.5
8
9OpenAI's newest frontier model for complex coding, computer use, knowledge work, and research workflows in Codex.
10
11codex -m gpt-5.5
12
13Copy command
14
15Capability
16
17Speed
18
19Codex CLI & SDK
20
21Codex app & IDE extension
22
23Codex Cloud
24
25ChatGPT Credits
26
27API Access
28
529
6 30
7gpt-5.431gpt-5.4
98 122
99API Access123API Access
100 124
101125For most tasks in Codex, start with `gpt-5.4`. It combines strong coding,For most tasks in Codex, start with `gpt-5.5` when it appears in your model
102126reasoning, native computer use, and broader professional workflows in one picker. It is strongest for complex coding, computer use, knowledge work, and
103127model. Use `gpt-5.4-mini` when you want a faster, lower-cost option for research workflows. GPT-5.5 is currently available in Codex when you sign in
104128lighter coding tasks or subagents. The `gpt-5.3-codex-spark` model is with ChatGPT; it isn't available with API-key authentication. During the
105129available in research preview for ChatGPT Pro subscribers and is optimized for rollout, continue using `gpt-5.4` if `gpt-5.5` is not yet available. Use
106130near-instant, real-time coding iteration. `gpt-5.4-mini` when you want a faster, lower-cost option for lighter coding
131 tasks or subagents. The `gpt-5.3-codex-spark` model is available in research
132 preview for ChatGPT Pro subscribers and is optimized for near-instant,
133 real-time coding iteration.
107 134
108## Alternative models135## Alternative models
109 136
134 161
135The Codex CLI and IDE extension use the same `config.toml` [configuration file](https://developers.openai.com/codex/config-basic). To specify a model, add a `model` entry to your configuration file. If you don't specify a model, the Codex app, CLI, or IDE Extension defaults to a recommended model.162The Codex CLI and IDE extension use the same `config.toml` [configuration file](https://developers.openai.com/codex/config-basic). To specify a model, add a `model` entry to your configuration file. If you don't specify a model, the Codex app, CLI, or IDE Extension defaults to a recommended model.
136 163
137164``````toml
138165model = "gpt-5.4"model = "gpt-5.5"
139```166```
140 167
168If `gpt-5.5` isn't available in your account yet, use `gpt-5.4`.
169
141### Choosing a different local model temporarily170### Choosing a different local model temporarily
142 171
143In the Codex CLI, you can use the `/model` command during an active thread to change the model. In the IDE extension, you can use the model selector below the input box to choose your model.172In the Codex CLI, you can use the `/model` command during an active thread to change the model. In the IDE extension, you can use the model selector below the input box to choose your model.
145To start a new Codex CLI thread with a specific model or to specify the model for `codex exec` you can use the `--model`/`-m` flag:174To start a new Codex CLI thread with a specific model or to specify the model for `codex exec` you can use the `--model`/`-m` flag:
146 175
147```bash176```bash
148177codex -m gpt-5.4codex -m gpt-5.5
149```178```
150 179
151### Choosing your model for cloud tasks180### Choosing your model for cloud tasks