models.md Codex Docs, 2026-03-05 06:22 UTC → 2026-05-05 23:00 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: 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: [

53The gpt-5.3-codex-spark model is available in research preview for ChatGPT Pro53 {

54subscribers. It is optimized for near-instant, real-time coding iteration.54 title: "Capability",

55 value: "",

56 icons: [

57 "openai.SparklesFilled",

58 "openai.SparklesFilled",

59 "openai.SparklesFilled",

60 "openai.SparklesFilled",

61 "openai.SparklesFilled",

62 ],

63 },

64 {

65 title: "Speed",

66 value: "",

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

68 },

69 {

70 title: "Codex CLI & SDK",

71 value: true,

72 },

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

74 {

75 title: "Codex Cloud",

76 value: false,

77 },

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

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

80 ],

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

55 214 

56## Alternative models215## Alternative models

57 216 

58![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">

59 218<ModelDetails

60gpt-5.2-codex219 client:load

61 220 name="gpt-5.2"

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

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

64codex -m gpt-5.2-codex223 collapsible

65 224 data={{

66Copy command225 features: [

67 226 {

68Show details227 title: "Capability",

69 228 value: "",

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

71 230 "openai.SparklesFilled",

72gpt-5.2231 "openai.SparklesFilled",

73 232 "openai.SparklesFilled",

74Our best general agentic model for tasks across industries and domains.233 "openai.SparklesFilled",

75 234 ],

76codex -m gpt-5.2235 },

77 236 {

78Copy command237 title: "Speed",

79 238 value: "",

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

81 240 },

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

83 242 title: "Codex CLI & SDK",

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

85 244 },

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

87 246 {

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

89 248 value: false,

90Copy command249 },

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

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

93 252 ],

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

95 254/>

96gpt-5.1255 

97 256 </div>

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

99 

100codex -m gpt-5.1

101 

102Copy command

103 

104Show details

105 

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

107 

108gpt-5.1-codex

109 

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

111 

112codex -m gpt-5.1-codex

113 

114Copy command

115 

116Show details

117 

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

119 

120gpt-5-codex

121 

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

123 

124codex -m gpt-5-codex

125 

126Copy command

127 

128Show details

129 

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

131 

132gpt-5-codex-mini

133 

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

135 

136codex -m gpt-5-codex

137 

138Copy command

139 

140Show details

141 

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

143 

144gpt-5

145 

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

147 

148codex -m gpt-5

149 

150Copy command

151 

152Show details

153 257 

154## Other models258## Other models

155 259 

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

157 261 

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

159 263 

166 270 

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

168 272 

273```toml

274model = "gpt-5.5"

169```275```

170model = "gpt-5.2"276 

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

172 278 

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

174 280 

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

178 284 

179```bash285```bash

180codex -m gpt-5.3-codex286codex -m gpt-5.5

181```287```

182 288 

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