Sazabi
Sandbox CLIs

Codex

Give the Sazabi agent the OpenAI Codex CLI (codex) in its sandbox for AI-powered coding.

About

This CLI connection makes OpenAI's Codex CLI (codex) available in the Sazabi agent's sandbox. The agent can use it for AI-powered coding tasks. The tool is baked into the sandbox image; connecting it authenticates the already-installed CLI.

Prerequisites

  • A Sazabi project.
  • An OpenAI API key (OPENAI_API_KEY).

Set up in the dashboard

Configure the sandbox in the dashboard under Settings > Sandbox CLIs.

Find Codex in the catalog

In Settings > Sandbox CLIs, find Codex under Browse sandbox CLIs and choose to connect it.

Provide credentials

Enter the required value: OPENAI_API_KEY — your OpenAI API key. Save to store it securely; Sazabi injects it into the sandbox when the agent runs.

Set up with the CLI

You can also configure the Codex CLI connection with the Sazabi CLI (installed and authenticated — see CLI reference).

sazabi sandbox-clis set --type codex --env OPENAI_API_KEY=<your-openai-key>

To validate the credentials without saving, run the same command with test in place of set (the test command also requires the --env flags).

Verify

Ask the agent, in a thread, to run the codex CLI (for example codex --version to confirm it is installed, then a real prompt) and confirm it responds using your API key. If the command is not found, the CLI connection may not be enabled; if it fails to authenticate, recheck the credentials.

Troubleshooting

Command not found — Confirm the Codex CLI connection is enabled for the project under Settings > Sandbox CLIs.

Authentication fails — Recheck the credential values; a rotated or revoked token must be re-entered under Settings > Sandbox CLIs or with sazabi sandbox-clis set --type codex.

Further reading