Skip to main content
Codex CLI (codex) is OpenAI’s agentic coding CLI. It authenticates with an OpenAI API key.

Set it up

1

Open Admin → Agent LLM

Scroll to the per-agent keys section.
2

Add the OpenAI key (Codex)

Paste your OpenAI API key. It’s write-only and encrypted at rest, and only needed if you enable the Codex agent.
3

(Optional) allow specific models

Set a Codex model allowlist (e.g. gpt-5, gpt-5-mini). With two or more, the New Task form shows a Model dropdown for Codex tasks.

Using it in a task

Pick Codex CLI as the agent in the New Task form. If a Codex model allowlist is set, choose the model per task.
An org’s Agent allowlist controls which CLIs users may launch. If Codex isn’t in the allowlist, it won’t appear in the New Task dropdown.

Through the internal gateway

If your org routes everything through the internal gateway, Codex traffic goes through it too. Codex uses the OpenAI SDK, so the gateway path for Codex is the origin plus /v1 — this is derived automatically from your single gateway endpoint; you don’t configure it separately. A per-agent key is only needed if your gateway issues a different key per model family.