models.md Codex Docs, 2026-02-24 06:27 UTC → 2026-05-13 00:57 UTC

2 2 

3## Recommended models3## Recommended models

4 4 

5![gpt-5.3-codex](/images/codex/codex-wallpaper-1.webp)5<div class="not-prose grid gap-6 md:grid-cols-2 xl:grid-cols-3">

6 6 <ModelDetails

7gpt-5.3-codex7 client:load

8 8 name="gpt-5.5"

9Most capable agentic coding model to date, combining frontier coding performance with stronger reasoning and professional knowledge capabilities.9 slug="gpt-5.5"

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

11codex -m gpt-5.3-codex11 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.3-codex-spark](/images/codex/codex-wallpaper-2.webp)29 },

30 30 {

31gpt-5.3-codex-spark31 title: "Codex CLI & SDK",

32 32 value: true,

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

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

35codex -m gpt-5.3-codex-spark35 {

36 36 title: "Codex Cloud",

37Copy command37 value: false,

38 38 },

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

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

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.2-codex](/images/codex/gpt-5.2-codex.png)53 {

54 54 title: "Capability",

55gpt-5.2-codex55 value: "",

56 56 icons: [

57Advanced coding model for real-world engineering. Succeeded by GPT-5.3-Codex.57 "openai.SparklesFilled",

58 58 "openai.SparklesFilled",

59codex -m gpt-5.2-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,

77For most coding tasks in Codex, start with gpt-5.3-codex. It is available for77 },

78ChatGPT-authenticated Codex sessions in the Codex app, CLI, IDE extension, and78 { title: "ChatGPT Credits", value: true },

79Codex Cloud. API access for GPT-5.3-Codex will come soon. The79 { title: "API Access", value: true },

80gpt-5.3-codex-spark model is available in research preview for ChatGPT Pro80 ],

81subscribers.81 }}

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 or API-key authentication. Use `gpt-5.4-mini` when you want a

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

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

82 212 

83## Alternative models213## Alternative models

84 214 

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

86 216<ModelDetails

87gpt-5.2217 client:load

88 218 name="gpt-5.2"

89Our best general agentic model for tasks across industries and domains.219 slug="gpt-5.2"

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

91codex -m gpt-5.2221 collapsible

92 222 data={{

93Copy command223 features: [

94 224 {

95Show details225 title: "Capability",

96 226 value: "",

97![gpt-5.1-codex-max](/images/api/models/gpt-5.1-codex-max.jpg)227 icons: [

98 228 "openai.SparklesFilled",

99gpt-5.1-codex-max229 "openai.SparklesFilled",

100 230 "openai.SparklesFilled",

101Optimized for long-horizon, agentic coding tasks in Codex.231 "openai.SparklesFilled",

102 232 ],

103codex -m gpt-5.1-codex-max233 },

104 234 {

105Copy command235 title: "Speed",

106 236 value: "",

107Show details237 icons: ["openai.Flash", "openai.Flash", "openai.Flash"],

108 238 },

109![gpt-5.1](/images/api/models/gpt-5.1.jpg)239 {

110 240 title: "Codex CLI & SDK",

111gpt-5.1241 value: true,

112 242 },

113Great for coding and agentic tasks across domains. Succeeded by GPT-5.2.243 { title: "Codex app & IDE extension", value: true },

114 244 {

115codex -m gpt-5.1245 title: "Codex Cloud",

116 246 value: false,

117Copy command247 },

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

119Show details249 { title: "API Access", value: true },

120 250 ],

121![gpt-5.1-codex](/images/api/models/gpt-5.1-codex.jpg)251 }}

122 252/>

123gpt-5.1-codex253 

124 254 </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![gpt-5-codex](/images/api/models/gpt-5-codex.jpg)

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![gpt-5-codex-mini](/images/api/models/gpt-5-codex.jpg)

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![gpt-5](/images/api/models/gpt-5.jpg)

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 255 

169## Other models256## Other models

170 257 

171Codex works best with the models listed above.258When you sign in with ChatGPT, Codex works best with the models listed above.

172 259 

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

174 261 

181 268 

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

183 270 

271```toml

272model = "gpt-5.5"

184```273```

185model = "gpt-5.2"274 

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

187 276 

188### Choosing a different local model temporarily277### Choosing a different local model temporarily

189 278 

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

193 282 

194```bash283```bash

195codex -m gpt-5.3-codex284codex -m gpt-5.5

196```285```

197 286 

198### Choosing your model for cloud tasks287### Choosing your model for cloud tasks