models.md +255 −164
2 2
3## Recommended models3## Recommended models
4 4
55<div class="not-prose grid gap-6 md:grid-cols-2 xl:grid-cols-3">
66 <ModelDetails
77gpt-5.3-codex client:load
88 name="gpt-5.5"
99Most capable agentic coding model to date, combining frontier coding performance with stronger reasoning and professional knowledge capabilities. slug="gpt-5.5"
1010 wallpaperUrl="/images/api/models/gpt-5.5.jpg"
1111codex -m gpt-5.3-codex description="OpenAI's newest frontier model for complex coding, computer use, knowledge work, and research workflows in Codex."
1212 data={{
1313Copy command features: [
1414 {
1515Capability title: "Capability",
1616 value: "",
1717Speed icons: [
1818 "openai.SparklesFilled",
1919Codex CLI & SDK "openai.SparklesFilled",
2020 "openai.SparklesFilled",
2121Codex app & IDE extension "openai.SparklesFilled",
2222 "openai.SparklesFilled",
2323Codex Cloud ],
2424 },
2525ChatGPT Credits {
2626 title: "Speed",
2727API Access value: "",
2828 icons: ["openai.Flash", "openai.Flash", "openai.Flash"],
2929 },
3030 {
3131gpt-5.3-codex-spark title: "Codex CLI & SDK",
3232 value: true,
3333Text-only research preview model optimized for near-instant, real-time coding iteration. Available to ChatGPT Pro users. },
3434 { title: "Codex app & IDE extension", value: true },
3535codex -m gpt-5.3-codex-spark {
3636 title: "Codex Cloud",
3737Copy command value: false,
3838 },
3939Capability { title: "ChatGPT Credits", value: true },
4040 { title: "API Access", value: false },
4141Speed ],
4242 }}
4343Codex CLI & SDK />
4444
4545Codex app & IDE extension<ModelDetails
4646 client:load
4747Codex Cloud name="gpt-5.4"
4848 slug="gpt-5.4"
4949ChatGPT Credits wallpaperUrl="/images/api/models/gpt-5.4.jpg"
5050 description="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."
5151API Access data={{
5252 features: [
5353 {
5454 title: "Capability",
5555gpt-5.2-codex value: "",
5656 icons: [
5757Advanced coding model for real-world engineering. Succeeded by GPT-5.3-Codex. "openai.SparklesFilled",
5858 "openai.SparklesFilled",
5959codex -m gpt-5.2-codex "openai.SparklesFilled",
6060 "openai.SparklesFilled",
6161Copy command "openai.SparklesFilled",
6262 ],
6363Capability },
6464 {
6565Speed title: "Speed",
6666 value: "",
6767Codex CLI & SDK icons: ["openai.Flash", "openai.Flash", "openai.Flash"],
6868 },
6969Codex app & IDE extension {
7070 title: "Codex CLI & SDK",
7171Codex Cloud value: true,
7272 },
7373ChatGPT Credits { title: "Codex app & IDE extension", value: true },
7474 {
7575API Access title: "Codex Cloud",
7676 value: false,
7777For most coding tasks in Codex, start with gpt-5.3-codex. It is available for },
7878ChatGPT-authenticated Codex sessions in the Codex app, CLI, IDE extension, and { title: "ChatGPT Credits", value: true },
7979Codex Cloud. API access for GPT-5.3-Codex will come soon. The { title: "API Access", value: true },
8080gpt-5.3-codex-spark model is available in research preview for ChatGPT Pro ],
8181subscribers. }}
82/>
83
84<ModelDetails
85 client:load
86 name="gpt-5.4-mini"
87 slug="gpt-5.4-mini"
88 wallpaperUrl="/images/api/models/gpt-5-mini.jpg"
89 description="Fast, efficient mini model for responsive coding tasks and subagents."
90 data={{
91 features: [
92 {
93 title: "Capability",
94 value: "",
95 icons: [
96 "openai.SparklesFilled",
97 "openai.SparklesFilled",
98 "openai.SparklesFilled",
99 ],
100 },
101 {
102 title: "Speed",
103 value: "",
104 icons: ["openai.Flash", "openai.Flash", "openai.Flash", "openai.Flash"],
105 },
106 {
107 title: "Codex CLI & SDK",
108 value: true,
109 },
110 { title: "Codex app & IDE extension", value: true },
111 {
112 title: "Codex Cloud",
113 value: false,
114 },
115 { title: "ChatGPT Credits", value: true },
116 { title: "API Access", value: true },
117 ],
118 }}
119/>
120
121<ModelDetails
122 client:load
123 name="gpt-5.3-codex"
124 slug="gpt-5.3-codex"
125 wallpaperUrl="/images/codex/codex-wallpaper-1.webp"
126 description="Industry-leading coding model for complex software engineering. Its coding capabilities now also power GPT-5.4."
127 data={{
128 features: [
129 {
130 title: "Capability",
131 value: "",
132 icons: [
133 "openai.SparklesFilled",
134 "openai.SparklesFilled",
135 "openai.SparklesFilled",
136 "openai.SparklesFilled",
137 "openai.SparklesFilled",
138 ],
139 },
140 {
141 title: "Speed",
142 value: "",
143 icons: ["openai.Flash", "openai.Flash", "openai.Flash"],
144 },
145 {
146 title: "Codex CLI & SDK",
147 value: true,
148 },
149 { title: "Codex app & IDE extension", value: true },
150 {
151 title: "Codex Cloud",
152 value: true,
153 },
154 { title: "ChatGPT Credits", value: true },
155 { title: "API Access", value: true },
156 ],
157 }}
158/>
159
160<ModelDetails
161 client:load
162 name="gpt-5.3-codex-spark"
163 slug="gpt-5.3-codex-spark"
164 wallpaperUrl="/images/codex/codex-wallpaper-2.webp"
165 description="Text-only research preview model optimized for near-instant, real-time coding iteration. Available to ChatGPT Pro users."
166 data={{
167 features: [
168 {
169 title: "Capability",
170 value: "",
171 icons: [
172 "openai.SparklesFilled",
173 "openai.SparklesFilled",
174 "openai.SparklesFilled",
175 ],
176 },
177 {
178 title: "Speed",
179 value: "",
180 icons: [
181 "openai.Flash",
182 "openai.Flash",
183 "openai.Flash",
184 "openai.Flash",
185 "openai.Flash",
186 ],
187 },
188 {
189 title: "Codex CLI & SDK",
190 value: true,
191 },
192 { title: "Codex app & IDE extension", value: true },
193 {
194 title: "Codex Cloud",
195 value: false,
196 },
197 { title: "ChatGPT Credits", value: false },
198 { title: "API Access", value: false },
199 ],
200 }}
201/>
202
203</div>
204
205For most tasks in Codex, start with `gpt-5.5` when it appears in your model
206 picker. It is strongest for complex coding, computer use, knowledge work, and
207 research workflows. GPT-5.5 is currently available in Codex when you sign in
208 with ChatGPT; it isn't available with API-key authentication. During the
209 rollout, continue using `gpt-5.4` if `gpt-5.5` is not yet available. Use
210 `gpt-5.4-mini` when you want a faster, lower-cost option for lighter coding
211 tasks or subagents. The `gpt-5.3-codex-spark` model is available in research
212 preview for ChatGPT Pro subscribers and is optimized for near-instant,
213 real-time coding iteration.
82 214
83## Alternative models215## Alternative models
84 216
85217<div class="not-prose grid gap-4 md:grid-cols-2 xl:grid-cols-3">
86218 <ModelDetails
87219gpt-5.2 client:load
88220 name="gpt-5.2"
89221Our best general agentic model for tasks across industries and domains. slug="gpt-5.2"
90222 description="Previous general-purpose model for coding and agentic tasks, including hard debugging tasks that benefit from deeper deliberation."
91223codex -m gpt-5.2 collapsible
92224 data={{
93225Copy command features: [
94226 {
95227Show details title: "Capability",
96228 value: "",
97229 icons: [
98230 "openai.SparklesFilled",
99231gpt-5.1-codex-max "openai.SparklesFilled",
100232 "openai.SparklesFilled",
101233Optimized for long-horizon, agentic coding tasks in Codex. "openai.SparklesFilled",
102234 ],
103235codex -m gpt-5.1-codex-max },
104236 {
105237Copy command title: "Speed",
106238 value: "",
107239Show details icons: ["openai.Flash", "openai.Flash", "openai.Flash"],
108240 },
109241 {
110242 title: "Codex CLI & SDK",
111243gpt-5.1 value: true,
112244 },
113245Great for coding and agentic tasks across domains. Succeeded by GPT-5.2. { title: "Codex app & IDE extension", value: true },
114246 {
115247codex -m gpt-5.1 title: "Codex Cloud",
116248 value: false,
117249Copy command },
118250 { title: "ChatGPT Credits", value: true },
119251Show details { title: "API Access", value: true },
120252 ],
121253 }}
122254 />
123255gpt-5.1-codex
124256 </div>
125Optimized for long-running, agentic coding tasks in Codex. Succeeded by GPT-5.1-Codex-Max.
126
127codex -m gpt-5.1-codex
128
129Copy command
130
131Show details
132
133
134
135gpt-5-codex
136
137Version of GPT-5 tuned for long-running, agentic coding tasks. Succeeded by GPT-5.1-Codex.
138
139codex -m gpt-5-codex
140
141Copy command
142
143Show details
144
145
146
147gpt-5-codex-mini
148
149Smaller, more cost-effective version of GPT-5-Codex. Succeeded by GPT-5.1-Codex-Mini.
150
151codex -m gpt-5-codex
152
153Copy command
154
155Show details
156
157
158
159gpt-5
160
161Reasoning model for coding and agentic tasks across domains. Succeeded by GPT-5.1.
162
163codex -m gpt-5
164
165Copy command
166
167Show details
168 257
169## Other models258## Other models
170 259
171260Codex works best with the models listed above.When you sign in with ChatGPT, Codex works best with the models listed above.
172 261
173You 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.262You 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.
174 263
181 270
182The 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.271The 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.
183 272
273```toml
274model = "gpt-5.5"
184```275```
185276model = "gpt-5.2"
186277```If `gpt-5.5` isn't available in your account yet, use `gpt-5.4`.
187 278
188### Choosing a different local model temporarily279### Choosing a different local model temporarily
189 280
192To 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:283To 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:
193 284
194```bash285```bash
195286codex -m gpt-5.3-codexcodex -m gpt-5.5
196```287```
197 288
198### Choosing your model for cloud tasks289### Choosing your model for cloud tasks