models.md Codex Docs, 2026-03-04 06:20 UTC → 2026-04-30 18:36 UTC

2 2 

3## Recommended models3## Recommended models

4 4 

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

6 6 

7gpt-5.3-codex7gpt-5.5

8 8 

9Most capable agentic coding model to date, combining frontier coding performance with stronger reasoning and professional knowledge capabilities.9OpenAI's newest frontier model for complex coding, computer use, knowledge work, and research workflows in Codex.

10 10 

11codex -m gpt-5.3-codex11codex -m gpt-5.5

12 12 

13Copy command13Copy command

14 14 

26 26 

27API Access27API Access

28 28 

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

30 30 

31gpt-5.3-codex-spark31gpt-5.4

32 32 

33Text-only research preview model optimized for near-instant, real-time coding iteration. Available to ChatGPT Pro users.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-codex-spark35codex -m gpt-5.4

36 36 

37Copy command37Copy command

38 38 

50 50 

51API Access51API Access

52 52 

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

54 54 

55gpt-5.2-codex55gpt-5.4-mini

56 56 

57Advanced coding model for real-world engineering. Succeeded by GPT-5.3-Codex.57Fast, efficient mini model for responsive coding tasks and subagents.

58 58 

59codex -m gpt-5.2-codex59codex -m gpt-5.4-mini

60 60 

61Copy command61Copy command

62 62 

74 74 

75API Access75API Access

76 76 

77For most coding tasks in Codex, start with gpt-5.3-codex. It is available for77![gpt-5.3-codex](/images/codex/codex-wallpaper-1.webp)

78ChatGPT-authenticated Codex sessions in the Codex app, CLI, IDE extension, and

79Codex Cloud. API access for GPT-5.3-Codex will come soon. The

80gpt-5.3-codex-spark model is available in research preview for ChatGPT Pro

81subscribers.

82 

83## Alternative models

84 

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

86 

87gpt-5.2

88 

89Our best general agentic model for tasks across industries and domains.

90 

91codex -m gpt-5.2

92 

93Copy command

94 

95Show details

96 

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

98 78 

99gpt-5.1-codex-max79gpt-5.3-codex

100 80 

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

102 82 

103codex -m gpt-5.1-codex-max83codex -m gpt-5.3-codex

104 84 

105Copy command85Copy command

106 86 

107Show details87Capability

108 88 

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

110 90 

111gpt-5.191Codex CLI & SDK

112 92 

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

114 94 

115codex -m gpt-5.195Codex Cloud

116 96 

117Copy command97ChatGPT Credits

118 98 

119Show details99API Access

120 100 

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

122 102 

123gpt-5.1-codex103gpt-5.3-codex-spark

124 104 

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

126 106 

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

128 108 

129Copy command109Copy command

130 110 

131Show details111Capability

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 112 

141Copy command113Speed

142 114 

143Show details115Codex CLI & SDK

144 116 

145![gpt-5-codex-mini](/images/api/models/gpt-5-codex.jpg)117Codex app & IDE extension

146 118 

147gpt-5-codex-mini119Codex Cloud

148 120 

149Smaller, more cost-effective version of GPT-5-Codex. Succeeded by GPT-5.1-Codex-Mini.121ChatGPT Credits

150 122 

151codex -m gpt-5-codex123API Access

152 124 

153Copy command125For 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.

154 134 

155Show details135## Alternative models

156 136 

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

158 138 

159gpt-5139gpt-5.2

160 140 

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

162 142 

163codex -m gpt-5143codex -m gpt-5.2

164 144 

165Copy command145Copy command

166 146 

168 148 

169## Other models149## Other models

170 150 

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

172 152 

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

174 154 

181 161 

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

183 163 

164```toml

165model = "gpt-5.5"

184```166```

185model = "gpt-5.2"167 

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

187 169 

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

189 171 

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

193 175 

194```bash176```bash

195codex -m gpt-5.3-codex177codex -m gpt-5.5

196```178```

197 179 

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