models.md Codex Docs, 2026-04-13 18:37 UTC → 2026-05-12 01:59 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 is104 icons: ["openai.Flash", "openai.Flash", "openai.Flash", "openai.Flash"],

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

106near-instant, real-time coding 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](/images/api/models/gpt-5.2.jpg)217<div class="not-prose grid gap-4 md:grid-cols-2 xl:grid-cols-3">

111 218<ModelDetails

112gpt-5.2219 client:load

113 220 name="gpt-5.2"

114Previous general-purpose model for coding and agentic tasks, including hard debugging tasks that benefit from deeper deliberation.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.2223 collapsible

117 224 data={{

118Copy command225 features: [

119 226 {

120Show details227 title: "Capability",

228 value: "",

229 icons: [

230 "openai.SparklesFilled",

231 "openai.SparklesFilled",

232 "openai.SparklesFilled",

233 "openai.SparklesFilled",

234 ],

235 },

236 {

237 title: "Speed",

238 value: "",

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

240 },

241 {

242 title: "Codex CLI & SDK",

243 value: true,

244 },

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

246 {

247 title: "Codex Cloud",

248 value: false,

249 },

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

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

252 ],

253 }}

254/>

255 

256 </div>

121 257 

122## Other models258## Other models

123 259 

134 270 

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

136 272 

273```toml

274model = "gpt-5.5"

137```275```

138model = "gpt-5.4"276 

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

140 278 

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

142 280 

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

146 284 

147```bash285```bash

148codex -m gpt-5.4286codex -m gpt-5.5

149```287```

150 288 

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