codex app-server protocol, in each agent’s sandbox.
Models
Codex runs OpenAI models over the Responses API:- The platform model
gpt-5.5. - Project models of an
openaioropenai-compatibleprovider, namedprovider/model. Anopenai-compatibleendpoint must serve the Responses API. See Models.
apply_patch for editing files, from what it knows about the model name. A model it does not know runs without apply_patch, so the agent edits files through the shell. A project model whose ID Codex knows, such as acme/gpt-5.5, runs with the same tools as gpt-5.5.
Codex has one model setting; small_model is Claude Code only and is rejected on Codex.
Capabilities
Plugins are installed with
codex plugin commands and MCP servers with codex mcp, then taken up by the running app-server without reloading the conversation. Changes apply between turns; see Capabilities.
Configuration
Tools
Codex edits files with patches, so its file changes are
file_patch calls rather than file_write and file_edit. Its reasoning arrives as summaries in reasoning messages. Items paddock does not map, such as a plan or a context compaction, are unknown messages with their raw JSON.