models.md Codex Docs, 2026-03-16 18:25 UTC → 2026-05-01 18:29 UTC

2 2 

3## Recommended models3## Recommended models

4 4 

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

6 6 

7gpt-5.47gpt-5.5

8 8 

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.9OpenAI's newest frontier model for complex coding, computer use, knowledge work, and research workflows in Codex.

10 10 

11codex -m gpt-5.411codex -m gpt-5.5

12 12 

13Copy command13Copy command

14 14 

26 26 

27API Access27API Access

28 28 

29![gpt-5.3-codex](/images/codex/codex-wallpaper-1.webp)29![gpt-5.4](/images/api/models/gpt-5.4.jpg)

30 30 

31gpt-5.3-codex31gpt-5.4

32 32 

33Industry-leading coding model for complex software engineering. Its coding capabilities now also power GPT-5.4.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 34 

35codex -m gpt-5.3-codex35codex -m gpt-5.4

36 36 

37Copy command37Copy command

38 38 

50 50 

51API Access51API Access

52 52 

53![gpt-5.3-codex-spark](/images/codex/codex-wallpaper-2.webp)53![gpt-5.4-mini](/images/api/models/gpt-5-mini.jpg)

54 54 

55gpt-5.3-codex-spark55gpt-5.4-mini

56 56 

57Text-only research preview model optimized for near-instant, real-time coding iteration. Available to ChatGPT Pro users.57Fast, efficient mini model for responsive coding tasks and subagents.

58 58 

59codex -m gpt-5.3-codex-spark59codex -m gpt-5.4-mini

60 60 

61Copy command61Copy command

62 62 

74 74 

75API Access75API Access

76 76 

77For most tasks in Codex, start with `gpt-5.4`. It combines strong coding,77![gpt-5.3-codex](/images/codex/codex-wallpaper-1.webp)

78reasoning, native computer use, and broader professional workflows in one

79model. The `gpt-5.3-codex-spark` model is available in research preview for

80ChatGPT Pro subscribers and is optimized for near-instant, real-time coding

81iteration.

82 

83## Alternative models

84 

85![gpt-5.2-codex](/images/codex/gpt-5.2-codex.png)

86 

87gpt-5.2-codex

88 

89Advanced coding model for real-world engineering. Succeeded by GPT-5.3-Codex.

90 

91codex -m gpt-5.2-codex

92 

93Copy command

94 

95Show details

96 

97![gpt-5.2](/images/api/models/gpt-5.2.jpg)

98 

99gpt-5.2

100 

101Previous general-purpose model for coding and agentic tasks across industries and domains. Succeeded by GPT-5.4.

102 

103codex -m gpt-5.2

104 

105Copy command

106 

107Show details

108 

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

110 78 

111gpt-5.1-codex-max79gpt-5.3-codex

112 80 

113Optimized for long-horizon, agentic coding tasks in Codex.81Industry-leading coding model for complex software engineering. Its coding capabilities now also power GPT-5.4.

114 82 

115codex -m gpt-5.1-codex-max83codex -m gpt-5.3-codex

116 84 

117Copy command85Copy command

118 86 

119Show details87Capability

120 88 

121![gpt-5.1](/images/api/models/gpt-5.1.jpg)89Speed

122 90 

123gpt-5.191Codex CLI & SDK

124 92 

125Great for coding and agentic tasks across domains. Succeeded by GPT-5.2.93Codex app & IDE extension

126 94 

127codex -m gpt-5.195Codex Cloud

128 96 

129Copy command97ChatGPT Credits

130 98 

131Show details99API Access

132 100 

133![gpt-5.1-codex](/images/api/models/gpt-5.1-codex.jpg)101![gpt-5.3-codex-spark](/images/codex/codex-wallpaper-2.webp)

134 102 

135gpt-5.1-codex103gpt-5.3-codex-spark

136 104 

137Optimized for long-running, agentic coding tasks in Codex. Succeeded by GPT-5.1-Codex-Max.105Text-only research preview model optimized for near-instant, real-time coding iteration. Available to ChatGPT Pro users.

138 106 

139codex -m gpt-5.1-codex107codex -m gpt-5.3-codex-spark

140 108 

141Copy command109Copy command

142 110 

143Show details111Capability

144 

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

146 

147gpt-5-codex

148 

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

150 112 

151codex -m gpt-5-codex113Speed

152 114 

153Copy command115Codex CLI & SDK

154 116 

155Show details117Codex app & IDE extension

156 118 

157![gpt-5-codex-mini](/images/api/models/gpt-5-codex.jpg)119Codex Cloud

158 120 

159gpt-5-codex-mini121ChatGPT Credits

160 122 

161Smaller, more cost-effective version of GPT-5-Codex. Succeeded by GPT-5.1-Codex-Mini.123API Access

162 124 

163codex -m gpt-5-codex125For most tasks in Codex, start with `gpt-5.5` when it appears in your model

126 picker. It is strongest for complex coding, computer use, knowledge work, and

127 research workflows. GPT-5.5 is currently available in Codex when you sign in

128 with ChatGPT; it isn't available with API-key authentication. During the

129 rollout, continue using `gpt-5.4` if `gpt-5.5` is not yet available. Use

130 `gpt-5.4-mini` when you want a faster, lower-cost option for lighter coding

131 tasks or subagents. The `gpt-5.3-codex-spark` model is available in research

132 preview for ChatGPT Pro subscribers and is optimized for near-instant,

133 real-time coding iteration.

164 134 

165Copy command135## Alternative models

166 

167Show details

168 136 

169![gpt-5](/images/api/models/gpt-5.jpg)137![gpt-5.2](/images/api/models/gpt-5.2.jpg)

170 138 

171gpt-5139gpt-5.2

172 140 

173Reasoning model for coding and agentic tasks across domains. Succeeded by GPT-5.1.141Previous general-purpose model for coding and agentic tasks, including hard debugging tasks that benefit from deeper deliberation.

174 142 

175codex -m gpt-5143codex -m gpt-5.2

176 144 

177Copy command145Copy command

178 146 

180 148 

181## Other models149## Other models

182 150 

183Codex works best with the models listed above.151When you sign in with ChatGPT, Codex works best with the models listed above.

184 152 

185You 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.153You 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.

186 154 

193 161 

194The 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.162The 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.

195 163 

196```164```toml

197model = "gpt-5.4"165model = "gpt-5.5"

198```166```

199 167 

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

169 

200### Choosing a different local model temporarily170### Choosing a different local model temporarily

201 171 

202In the Codex CLI, you can use the `/model` command during an active thread to change the model. In the IDE extension, you can use the model selector below the input box to choose your model.172In the Codex CLI, you can use the `/model` command during an active thread to change the model. In the IDE extension, you can use the model selector below the input box to choose your model.

204To 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:174To 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:

205 175 

206```bash176```bash

207codex -m gpt-5.4177codex -m gpt-5.5

208```178```

209 179 

210### Choosing your model for cloud tasks180### Choosing your model for cloud tasks