1# Codex Models1# Models – Codex

2 2 

3## Recommended models3## Recommended models

4 4 

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

6 <ModelDetails6 

7 client:load7gpt-5.5

8 name="gpt-5.5"8 

9 slug="gpt-5.5"9OpenAI's newest frontier model for complex coding, computer use, knowledge work, and research workflows in Codex.

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

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

12 data={{12 

13 features: [13Copy command

14 {14 

15 title: "Capability",15Capability

16 value: "",16 

17 icons: [17Speed

18 "openai.SparklesFilled",18 

19 "openai.SparklesFilled",19Codex CLI & SDK

20 "openai.SparklesFilled",20 

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

22 "openai.SparklesFilled",22 

23 ],23Codex Cloud

24 },24 

25 {25ChatGPT Credits

26 title: "Speed",26 

27 value: "",27API Access

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

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

30 {30 

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

32 value: true,32 

33 },33Flagship 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.

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

35 {35codex -m gpt-5.4

36 title: "Codex Cloud",36 

37 value: false,37Copy command

38 },38 

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

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

41 ],41Speed

42 }}42 

43 />43Codex CLI & SDK

44 44 

45<ModelDetails45Codex app & IDE extension

46 client:load46 

47 name="gpt-5.4"47Codex Cloud

48 slug="gpt-5.4"48 

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

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

51 data={{51API Access

52 features: [52 

53 {53![gpt-5.4-mini](/images/api/models/gpt-5-mini.jpg)

54 title: "Capability",54 

55 value: "",55gpt-5.4-mini

56 icons: [56 

57 "openai.SparklesFilled",57Fast, efficient mini model for responsive coding tasks and subagents.

58 "openai.SparklesFilled",58 

59 "openai.SparklesFilled",59codex -m gpt-5.4-mini

60 "openai.SparklesFilled",60 

61 "openai.SparklesFilled",61Copy command

62 ],62 

63 },63Capability

64 {64 

65 title: "Speed",65Speed

66 value: "",66 

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

68 },68 

69 {69Codex app & IDE extension

70 title: "Codex CLI & SDK",70 

71 value: true,71Codex Cloud

72 },72 

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

74 {74 

75 title: "Codex Cloud",75API Access

76 value: false,76 

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

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

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

80 ],80 

81 }}81Industry-leading coding model for complex software engineering. Its coding capabilities now also power GPT-5.4.

82/>82 

83 83codex -m gpt-5.3-codex

84<ModelDetails84 

85 client:load85Copy command

86 name="gpt-5.4-mini"86 

87 slug="gpt-5.4-mini"87Capability

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

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

90 data={{90 

91 features: [91Codex CLI & SDK

92 {92 

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

94 value: "",94 

95 icons: [95Codex Cloud

96 "openai.SparklesFilled",96 

97 "openai.SparklesFilled",97ChatGPT Credits

98 "openai.SparklesFilled",98 

99 ],99API Access

100 },100 

101 {101![gpt-5.3-codex-spark](/images/codex/codex-wallpaper-2.webp)

102 title: "Speed",102 

103 value: "",103gpt-5.3-codex-spark

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

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

106 {106 

107 title: "Codex CLI & SDK",107codex -m gpt-5.3-codex-spark

108 value: true,108 

109 },109Copy command

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

111 {111Capability

112 title: "Codex Cloud",112 

113 value: false,113Speed

114 },114 

115 { title: "ChatGPT Credits", value: true },115Codex CLI & SDK

116 { title: "API Access", value: true },116 

117 ],117Codex app & IDE extension

118 }}118 

119/>119Codex Cloud

120 120 

121<ModelDetails121ChatGPT Credits

122 client:load122 

123 name="gpt-5.3-codex"123API Access

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 124 

205For most tasks in Codex, start with `gpt-5.5` when it appears in your model125For 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, and126picker. 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 in127research workflows. GPT-5.5 is currently available in Codex when you sign in

208 with ChatGPT or API-key authentication. Use `gpt-5.4-mini` when you want a128with ChatGPT or API-key authentication. Use `gpt-5.4-mini` when you want a

209 faster, lower-cost option for lighter coding tasks or subagents. The129faster, lower-cost option for lighter coding tasks or subagents. The

210 `gpt-5.3-codex-spark` model is available in research preview for ChatGPT Pro130`gpt-5.3-codex-spark` model is available in research preview for ChatGPT Pro

211 subscribers and is optimized for near-instant, real-time coding iteration.131subscribers and is optimized for near-instant, real-time coding iteration.

212 132 

213## Alternative models133## Alternative models

214 134 

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

216<ModelDetails136 

217 client:load137gpt-5.2

218 name="gpt-5.2"138 

219 slug="gpt-5.2"139Previous general-purpose model for coding and agentic tasks, including hard debugging tasks that benefit from deeper deliberation.

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

221 collapsible141codex -m gpt-5.2

222 data={{142 

223 features: [143Copy command

224 {144 

225 title: "Capability",145Show details

226 value: "",

227 icons: [

228 "openai.SparklesFilled",

229 "openai.SparklesFilled",

230 "openai.SparklesFilled",

231 "openai.SparklesFilled",

232 ],

233 },

234 {

235 title: "Speed",

236 value: "",

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

238 },

239 {

240 title: "Codex CLI & SDK",

241 value: true,

242 },

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

244 {

245 title: "Codex Cloud",

246 value: false,

247 },

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

249 { title: "API Access", value: true },

250 ],

251 }}

252/>

253 

254 </div>

255 146 

256## Other models147## Other models

257 148 

260You 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.151You 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.

261 152 

262Support for the Chat Completions API is deprecated and will be removed in153Support for the Chat Completions API is deprecated and will be removed in

263 future releases of Codex.154future releases of Codex.

264 155 

265## Configuring models156## Configuring models

266 157 

267### Configure your default local model158### Configure your default local model

268 159 

269The 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.160The 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.

270 161 

271```toml162```

272model = "gpt-5.5"163model = "gpt-5.5"

273```164```

274 165 

275If `gpt-5.5` isn't available in your account yet, use `gpt-5.4`.166If `gpt-5.5` isn’t available in your account yet, use `gpt-5.4`.

276 167 

277### Choosing a different local model temporarily168### Choosing a different local model temporarily

278 169 

280 171 

281To 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:172To 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:

282 173 

283```bash174```

284codex -m gpt-5.5175codex -m gpt-5.5

285```176```

286 177 

287### Choosing your model for cloud tasks178### Choosing your model for cloud tasks

288 179 

289Currently, you can't change the default model for Codex cloud tasks.180Currently, you can’t change the default model for Codex cloud tasks.

181