Codex CLI overlay for a shell workload, with OpenAI credentials and agent hooks.
10K+
Codex CLI overlay for a shell workload, with OpenAI credentials and agent hooks.
| Name | Required | Default | Description |
|---|---|---|---|
model | Optional | | Codex model to use (config.toml `model`); empty keeps the CLI default |
reasoningEffort | Optional | | Reasoning effort (config.toml `model_reasoning_effort`); empty keeps the CLI default |
version | Required | — | Codex CLI release the overlay carries |
[email protected]| Type | Required | Description | |
|---|---|---|---|
com.docker.sandbox/network-policy@1 | Required | — | |
com.docker.sandbox/credential@1 | Optional | OpenAI API access (API key or ChatGPT OAuth) | |
com.docker.sandbox/lifecycle@1 | Required | — | |
com.docker.sandbox/agent-skills@1 | Optional | — | |
com.docker.sandbox/agent-context@1 | Optional | — | |
com.docker.sandbox/agent-context@2 | Optional | — | |
sbx run <agent> --kit sbx/codex-mixin:latestRun the following command to install sbx on your machine.
brew install docker/tap/sbxwinget install Docker.sbxThis v3 mixin Kit packages Codex for Docker Sandboxes. It adds the agent, authentication configuration, and runtime integration to a compatible workload. The workload keeps its entrypoint.
This Kit is built on Docker Hardened Images.
sbx run sbx/shell:latest --kit sbx/codex-mixin:latest /path/to/workspace
When the shell opens, run codex. This kit supplies an overlay, so it needs a workload such as
Shell.
Set these arguments when creating the sandbox with --kit-arg <name>=<value>. Repeat the flag for multiple arguments.
Use --kit-arg <kit>.<name>=<value> to target one kit in a composition, as in the example below.
| Argument | Default | Description | Accepted values |
|---|---|---|---|
model | "" | Codex model to use (config.toml model); empty keeps the CLI default | Letters, digits, ., _, and -. |
reasoningEffort | "" | Reasoning effort (config.toml model_reasoning_effort); empty keeps the CLI default | Empty, none, minimal, low, medium, high, xhigh, max, ultra, or persistent. |
An empty value keeps the agent default. The model must be available to your provider account, and the selected model
must support the requested effort or thinking level. These are kit configuration inputs, separate from agent
command-line arguments passed after --.
sbx run sbx/shell:latest --kit sbx/codex-mixin:latest \
--kit-arg codex-mixin.model=gpt-5 --kit-arg codex-mixin.reasoningEffort=high \
/path/to/workspace
Bind an OpenAI API key on the host with sbx secret set openai. For a ChatGPT login, run
sbx secret set openai --oauth on the host. You can also sign in from Codex inside the sandbox. Host-bound credentials
remain proxy-managed.
The sandbox supplies the isolation for agent tool execution. Launch the kit through Docker Sandboxes and configure extra tool or MCP destinations in the runtime network policy as needed.
sbx/codex provides the complete agent workload.sbx/codex-acp provides the ACP adapter for the composed agent.sbx/codex-sessions provides host-backed conversation state.For the Kit format and capability contracts, see the Sandbox Kit v3 specification.
For runtime setup, see the Docker Sandboxes documentation. For provenance, SBOM, VEX, and image verification, see the Docker Hardened Images documentation.
Codex and OpenAI are trademarks of OpenAI, L.L.C. Product names and logos do not imply sponsorship or endorsement.