models.md Codex Docs, 2026-03-05 06:22 UTC → 2026-05-01 18:29 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 

53The gpt-5.3-codex-spark model is available in research preview for ChatGPT Pro53![gpt-5.4-mini](/images/api/models/gpt-5-mini.jpg)

54subscribers. It is optimized for near-instant, real-time coding iteration.

55 

56## Alternative models

57 

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

59 54 

60gpt-5.2-codex55gpt-5.4-mini

61 56 

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

63 58 

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

65 60 

66Copy command61Copy command

67 62 

68Show details63Capability

69 64 

70![gpt-5.2](/images/api/models/gpt-5.2.jpg)65Speed

71 66 

72gpt-5.267Codex CLI & SDK

73 68 

74Our best general agentic model for tasks across industries and domains.69Codex app & IDE extension

75 70 

76codex -m gpt-5.271Codex Cloud

77 72 

78Copy command73ChatGPT Credits

79 74 

80Show details75API Access

81 76 

82![gpt-5.1-codex-max](/images/api/models/gpt-5.1-codex-max.jpg)77![gpt-5.3-codex](/images/codex/codex-wallpaper-1.webp)

83 78 

84gpt-5.1-codex-max79gpt-5.3-codex

85 80 

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

87 82 

88codex -m gpt-5.1-codex-max83codex -m gpt-5.3-codex

89 84 

90Copy command85Copy command

91 86 

92Show details87Capability

93 88 

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

95 90 

96gpt-5.191Codex CLI & SDK

97 92 

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

99 94 

100codex -m gpt-5.195Codex Cloud

101 96 

102Copy command97ChatGPT Credits

103 98 

104Show details99API Access

105 100 

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

107 102 

108gpt-5.1-codex103gpt-5.3-codex-spark

109 104 

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

111 106 

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

113 108 

114Copy command109Copy command

115 110 

116Show details111Capability

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 112 

126Copy command113Speed

127 114 

128Show details115Codex CLI & SDK

129 116 

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

131 118 

132gpt-5-codex-mini119Codex Cloud

133 120 

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

135 122 

136codex -m gpt-5-codex123API Access

137 124 

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

139 134 

140Show details135## Alternative models

141 136 

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

143 138 

144gpt-5139gpt-5.2

145 140 

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

147 142 

148codex -m gpt-5143codex -m gpt-5.2

149 144 

150Copy command145Copy command

151 146 

153 148 

154## Other models149## Other models

155 150 

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

157 152 

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

159 154 

166 161 

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

168 163 

164```toml

165model = "gpt-5.5"

169```166```

170model = "gpt-5.2"167 

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

172 169 

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

174 171 

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

178 175 

179```bash176```bash

180codex -m gpt-5.3-codex177codex -m gpt-5.5

181```178```

182 179 

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