Answers are generated based on the documentation.

Codex

Table of contents
Availability: Experimental

This guide covers authentication, configuration, and usage of Codex in a sandboxed environment.

Official documentation: Codex CLI

Quick start

Create a sandbox and run Codex for a project directory:

$ sbx run codex ~/my-project

The workspace parameter is optional and defaults to the current directory:

$ cd ~/my-project
$ sbx run codex

Authentication

Codex requires an OpenAI API key. Store your key using stored secrets:

$ sbx secret set -g openai

Alternatively, export the OPENAI_API_KEY environment variable in your shell before running the sandbox. See Credentials for details on both methods.

Configuration

Sandboxes don't pick up user-level configuration from your host, such as ~/.codex. Only project-level configuration in the working directory is available inside the sandbox. See Why doesn't the sandbox use my user-level agent configuration? for workarounds.

The sandbox runs Codex without approval prompts by default. Pass additional Codex CLI options after --:

$ sbx run codex --name <sandbox-name> -- <codex-options>

Base image

Template: docker/sandbox-templates:codex

Preconfigured to run without approval prompts.

See Custom environments to pre-install tools or customize this environment.