models.md Codex Docs, 2026-03-17 18:24 UTC → 2026-05-07 17:08 UTC

2 2 

3## Recommended models3## Recommended models

4 4 

5![gpt-5.4](/images/api/models/gpt-5.4.jpg)5<div class="not-prose grid gap-6 md:grid-cols-2 xl:grid-cols-3">

6 6 <ModelDetails

7gpt-5.47 client:load

8 8 name="gpt-5.5"

9Flagship 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.9 slug="gpt-5.5"

10 10 wallpaperUrl="/images/api/models/gpt-5.5.jpg"

11codex -m gpt-5.411 description="OpenAI's newest frontier model for complex coding, computer use, knowledge work, and research workflows in Codex."

12 12 data={{

13Copy command13 features: [

14 14 {

15Capability15 title: "Capability",

16 16 value: "",

17Speed17 icons: [

18 18 "openai.SparklesFilled",

19Codex CLI & SDK19 "openai.SparklesFilled",

20 20 "openai.SparklesFilled",

21Codex app & IDE extension21 "openai.SparklesFilled",

22 22 "openai.SparklesFilled",

23Codex Cloud23 ],

24 24 },

25ChatGPT Credits25 {

26 26 title: "Speed",

27API Access27 value: "",

28 28 icons: ["openai.Flash", "openai.Flash", "openai.Flash"],

29![gpt-5.4-mini](/images/api/models/gpt-5-mini.jpg)29 },

30 30 {

31gpt-5.4-mini31 title: "Codex CLI & SDK",

32 32 value: true,

33Fast, efficient mini model for responsive coding tasks and subagents.33 },

34 34 { title: "Codex app & IDE extension", value: true },

35codex -m gpt-5.4-mini35 {

36 36 title: "Codex Cloud",

37Copy command37 value: false,

38 38 },

39Capability39 { title: "ChatGPT Credits", value: true },

40 40 { title: "API Access", value: false },

41Speed41 ],

42 42 }}

43Codex CLI & SDK43 />

44 44 

45Codex app & IDE extension45<ModelDetails

46 46 client:load

47Codex Cloud47 name="gpt-5.4"

48 48 slug="gpt-5.4"

49ChatGPT Credits49 wallpaperUrl="/images/api/models/gpt-5.4.jpg"

50 50 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."

51API Access51 data={{

52 52 features: [

53![gpt-5.3-codex](/images/codex/codex-wallpaper-1.webp)53 {

54 54 title: "Capability",

55gpt-5.3-codex55 value: "",

56 56 icons: [

57Industry-leading coding model for complex software engineering. Its coding capabilities now also power GPT-5.4.57 "openai.SparklesFilled",

58 58 "openai.SparklesFilled",

59codex -m gpt-5.3-codex59 "openai.SparklesFilled",

60 60 "openai.SparklesFilled",

61Copy command61 "openai.SparklesFilled",

62 62 ],

63Capability63 },

64 64 {

65Speed65 title: "Speed",

66 66 value: "",

67Codex CLI & SDK67 icons: ["openai.Flash", "openai.Flash", "openai.Flash"],

68 68 },

69Codex app & IDE extension69 {

70 70 title: "Codex CLI & SDK",

71Codex Cloud71 value: true,

72 72 },

73ChatGPT Credits73 { title: "Codex app & IDE extension", value: true },

74 74 {

75API Access75 title: "Codex Cloud",

76 76 value: false,

77![gpt-5.3-codex-spark](/images/codex/codex-wallpaper-2.webp)77 },

78 78 { title: "ChatGPT Credits", value: true },

79gpt-5.3-codex-spark79 { title: "API Access", value: true },

80 80 ],

81Text-only research preview model optimized for near-instant, real-time coding iteration. Available to ChatGPT Pro users.81 }}

82 82/>

83codex -m gpt-5.3-codex-spark83 

84 84<ModelDetails

85Copy command85 client:load

86 86 name="gpt-5.4-mini"

87Capability87 slug="gpt-5.4-mini"

88 88 wallpaperUrl="/images/api/models/gpt-5-mini.jpg"

89Speed89 description="Fast, efficient mini model for responsive coding tasks and subagents."

90 90 data={{

91Codex CLI & SDK91 features: [

92 92 {

93Codex app & IDE extension93 title: "Capability",

94 94 value: "",

95Codex Cloud95 icons: [

96 96 "openai.SparklesFilled",

97ChatGPT Credits97 "openai.SparklesFilled",

98 98 "openai.SparklesFilled",

99API Access99 ],

100 100 },

101For most tasks in Codex, start with `gpt-5.4`. It combines strong coding,101 {

102reasoning, native computer use, and broader professional workflows in one102 title: "Speed",

103model. Use `gpt-5.4-mini` when you want a faster, lower-cost option for103 value: "",

104lighter coding tasks or subagents. The `gpt-5.3-codex-spark` model remains104 icons: ["openai.Flash", "openai.Flash", "openai.Flash", "openai.Flash"],

105available in research preview for ChatGPT Pro subscribers and is optimized for105 },

106near-instant, text-only iteration.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.

107 214 

108## Alternative models215## Alternative models

109 216 

110![gpt-5.2-codex](/images/codex/gpt-5.2-codex.png)217<div class="not-prose grid gap-4 md:grid-cols-2 xl:grid-cols-3">

111 218<ModelDetails

112gpt-5.2-codex219 client:load

113 220 name="gpt-5.2"

114Advanced coding model for real-world engineering. Succeeded by GPT-5.3-Codex.221 slug="gpt-5.2"

115 222 description="Previous general-purpose model for coding and agentic tasks, including hard debugging tasks that benefit from deeper deliberation."

116codex -m gpt-5.2-codex223 collapsible

117 224 data={{

118Copy command225 features: [

119 226 {

120Show details227 title: "Capability",

121 228 value: "",

122![gpt-5.2](/images/api/models/gpt-5.2.jpg)229 icons: [

123 230 "openai.SparklesFilled",

124gpt-5.2231 "openai.SparklesFilled",

125 232 "openai.SparklesFilled",

126Previous general-purpose model for coding and agentic tasks across industries and domains. Succeeded by GPT-5.4.233 "openai.SparklesFilled",

127 234 ],

128codex -m gpt-5.2235 },

129 236 {

130Copy command237 title: "Speed",

131 238 value: "",

132Show details239 icons: ["openai.Flash", "openai.Flash", "openai.Flash"],

133 240 },

134![gpt-5.1-codex-max](/images/api/models/gpt-5.1-codex-max.jpg)241 {

135 242 title: "Codex CLI & SDK",

136gpt-5.1-codex-max243 value: true,

137 244 },

138Optimized for long-horizon, agentic coding tasks in Codex.245 { title: "Codex app & IDE extension", value: true },

139 246 {

140codex -m gpt-5.1-codex-max247 title: "Codex Cloud",

141 248 value: false,

142Copy command249 },

143 250 { title: "ChatGPT Credits", value: true },

144Show details251 { title: "API Access", value: true },

145 252 ],

146![gpt-5.1](/images/api/models/gpt-5.1.jpg)253 }}

147 254/>

148gpt-5.1255 

149 256 </div>

150Great for coding and agentic tasks across domains. Succeeded by GPT-5.2.

151 

152codex -m gpt-5.1

153 

154Copy command

155 

156Show details

157 

158![gpt-5.1-codex](/images/api/models/gpt-5.1-codex.jpg)

159 

160gpt-5.1-codex

161 

162Optimized for long-running, agentic coding tasks in Codex. Succeeded by GPT-5.1-Codex-Max.

163 

164codex -m gpt-5.1-codex

165 

166Copy command

167 

168Show details

169 

170![gpt-5-codex](/images/api/models/gpt-5-codex.jpg)

171 

172gpt-5-codex

173 

174Version of GPT-5 tuned for long-running, agentic coding tasks. Succeeded by GPT-5.1-Codex.

175 

176codex -m gpt-5-codex

177 

178Copy command

179 

180Show details

181 

182![gpt-5-codex-mini](/images/api/models/gpt-5-codex.jpg)

183 

184gpt-5-codex-mini

185 

186Smaller, more cost-effective version of GPT-5-Codex. Succeeded by GPT-5.1-Codex-Mini.

187 

188codex -m gpt-5-codex

189 

190Copy command

191 

192Show details

193 

194![gpt-5](/images/api/models/gpt-5.jpg)

195 

196gpt-5

197 

198Reasoning model for coding and agentic tasks across domains. Succeeded by GPT-5.1.

199 

200codex -m gpt-5

201 

202Copy command

203 

204Show details

205 257 

206## Other models258## Other models

207 259 

208Codex works best with the models listed above.260When you sign in with ChatGPT, Codex works best with the models listed above.

209 261 

210You 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.

211 263 

218 270 

219The 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.

220 272 

273```toml

274model = "gpt-5.5"

221```275```

222model = "gpt-5.4"276 

223```277If `gpt-5.5` isn't available in your account yet, use `gpt-5.4`.

224 278 

225### Choosing a different local model temporarily279### Choosing a different local model temporarily

226 280 

229To 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:

230 284 

231```bash285```bash

232codex -m gpt-5.4286codex -m gpt-5.5

233```287```

234 288 

235### Choosing your model for cloud tasks289### Choosing your model for cloud tasks