models.md +54 −74
1# Codex Models1# Codex Models
2 2
3Meet the AI models that power Codex
4
5## Recommended models3## Recommended models
6 4
75
8 6
97gpt-5.3-codexgpt-5.5
10 8
119Most capable agentic coding model to date, combining frontier coding performance with stronger reasoning and professional knowledge capabilities.OpenAI's newest frontier model for complex coding, computer use, knowledge work, and research workflows in Codex.
12 10
1311codex -m gpt-5.3-codexcodex -m gpt-5.5
14 12
15Copy command13Copy command
16 14
28 26
29API Access27API Access
30 28
3129
32 30
3331gpt-5.3-codex-sparkgpt-5.4
34 32
3533Text-only research preview model optimized for near-instant, real-time coding iteration. Available to ChatGPT Pro users.Flagship frontier model for professional work that brings the industry-leading coding capabilities of GPT-5.3-Codex together with stronger reasoning, tool use, and agentic workflows.
36 34
3735codex -m gpt-5.3-codex-sparkcodex -m gpt-5.4
38 36
39Copy command37Copy command
40 38
52 50
53API Access51API Access
54 52
5553
56 54
5755gpt-5.2-codexgpt-5.4-mini
58 56
5957Advanced coding model for real-world engineering. Succeeded by GPT-5.3-Codex.Fast, efficient mini model for responsive coding tasks and subagents.
60 58
6159codex -m gpt-5.2-codexcodex -m gpt-5.4-mini
62 60
63Copy command61Copy command
64 62
76 74
77API Access75API Access
78 76
7977For most coding tasks in Codex, start with gpt-5.3-codex. It is available for
80ChatGPT-authenticated Codex sessions in the Codex app, CLI, IDE extension, and
81Codex Cloud. API access for GPT-5.3-Codex will come soon. The
82gpt-5.3-codex-spark model is available in research preview for ChatGPT Pro
83subscribers.
84
85## Alternative models
86
87
88
89gpt-5.2
90
91Our best general agentic model for tasks across industries and domains.
92
93codex -m gpt-5.2
94
95Copy command
96
97Show details
98
99
100 78
10179gpt-5.1-codex-maxgpt-5.3-codex
102 80
10381Optimized for long-horizon, agentic coding tasks in Codex.Industry-leading coding model for complex software engineering. Its coding capabilities now also power GPT-5.4.
104 82
10583codex -m gpt-5.1-codex-maxcodex -m gpt-5.3-codex
106 84
107Copy command85Copy command
108 86
10987Show detailsCapability
110 88
11189Speed
112 90
11391gpt-5.1Codex CLI & SDK
114 92
11593Great for coding and agentic tasks across domains. Succeeded by GPT-5.2.Codex app & IDE extension
116 94
11795codex -m gpt-5.1Codex Cloud
118 96
11997Copy commandChatGPT Credits
120 98
12199Show detailsAPI Access
122 100
123101
124 102
125103gpt-5.1-codexgpt-5.3-codex-spark
126 104
127105Optimized for long-running, agentic coding tasks in Codex. Succeeded by GPT-5.1-Codex-Max.Text-only research preview model optimized for near-instant, real-time coding iteration. Available to ChatGPT Pro users.
128 106
129107codex -m gpt-5.1-codexcodex -m gpt-5.3-codex-spark
130 108
131Copy command109Copy command
132 110
133111Show detailsCapability
134
135
136
137gpt-5-codex
138
139Version of GPT-5 tuned for long-running, agentic coding tasks. Succeeded by GPT-5.1-Codex.
140
141codex -m gpt-5-codex
142 112
143113Copy commandSpeed
144 114
145115Show detailsCodex CLI & SDK
146 116
147117Codex app & IDE extension
148 118
149119gpt-5-codex-miniCodex Cloud
150 120
151121Smaller, more cost-effective version of GPT-5-Codex. Succeeded by GPT-5.1-Codex-Mini.ChatGPT Credits
152 122
153123codex -m gpt-5-codexAPI Access
154 124
155125Copy commandFor most tasks in Codex, start with `gpt-5.5` when it appears in your model
126 picker. It is strongest for complex coding, computer use, knowledge work, and
127 research workflows. GPT-5.5 is currently available in Codex when you sign in
128 with ChatGPT; it isn't available with API-key authentication. During the
129 rollout, continue using `gpt-5.4` if `gpt-5.5` is not yet available. Use
130 `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.
156 134
157135Show details## Alternative models
158 136
159137
160 138
161139gpt-5gpt-5.2
162 140
163141Reasoning model for coding and agentic tasks across domains. Succeeded by GPT-5.1.Previous general-purpose model for coding and agentic tasks, including hard debugging tasks that benefit from deeper deliberation.
164 142
165143codex -m gpt-5codex -m gpt-5.2
166 144
167Copy command145Copy command
168 146
170 148
171## Other models149## Other models
172 150
173151Codex works best with the models listed above.When you sign in with ChatGPT, Codex works best with the models listed above.
174 152
175You can also point Codex at any model and provider that supports either the [Chat Completions](https://platform.openai.com/docs/api-reference/chat) or [Responses APIs](https://platform.openai.com/docs/api-reference/responses) to fit your specific use case.153You can also point Codex at any model and provider that supports either the [Chat Completions](https://platform.openai.com/docs/api-reference/chat) or [Responses APIs](https://platform.openai.com/docs/api-reference/responses) to fit your specific use case.
176 154
183 161
184The 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.
185 163
164```toml
165model = "gpt-5.5"
186```166```
187167model = "gpt-5.2"
188168```If `gpt-5.5` isn't available in your account yet, use `gpt-5.4`.
189 169
190### Choosing a different local model temporarily170### Choosing a different local model temporarily
191 171
194To 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:
195 175
196```bash176```bash
197177codex -m gpt-5.3-codexcodex -m gpt-5.5
198```178```
199 179
200### Choosing your model for cloud tasks180### Choosing your model for cloud tasks