Skip to main content
Available on the Core plan and higher. Codex Agent runs on Ona Cloud and supported customer-managed runners. Contact sales to learn more.
Codex Agent runs the open-source Codex harness in an Ona environment with your project context, environment isolation, integrations, and guardrails.

​
How Codex Agent works

Codex Agent can read your repository, use configured tools, run commands, and open pull requests while following your organization’s policies. On Ona Cloud, Codex Agent uses the model access available to your organization. Core users can connect their ChatGPT account so Codex model requests use their ChatGPT plan instead. On a customer-managed runner, Codex Agent uses OpenAI model access provided by Ona Intelligence or an OpenAI-compatible LLM integration configured for that runner. See Model access for the available options.

​
Prerequisites

  • Your organization is on a Core or Enterprise plan.
  • Codex Agent is enabled for your organization.
  • Customer-managed runners require OpenAI model access through Ona Intelligence or an OpenAI-compatible LLM integration.
Core users who want to use a ChatGPT plan for Codex model requests also need a ChatGPT account with Codex access. See Connect Codex to ChatGPT.

​
Start Codex Agent

  1. Start an environment.
  2. Open the conversation menu.
  3. Choose Codex.
  4. Describe the task you want Codex Agent to work on.

​
Organization controls

Administrators can control Codex Agent behavior for the organization.

​
Goal mode

Goal mode lets members set Codex goals that keep running until achieved. It is enabled by default. To change it, go to Organization Settings > Agents and toggle Goal mode in the Codex settings. When disabled, members can still run Codex Agent, but requests that ask it to run in goal mode are rejected.

​
Usage and billing

Compute and model usage follow your organization’s plan and model-access configuration:
  • On Core, the environment consumes OCUs while Codex Agent runs. If you connect your ChatGPT account, OpenAI manages usage and limits for Codex model requests, and Ona does not charge OCUs for those model requests.
  • On Enterprise, model usage follows the Ona Intelligence or BYOK configuration for your runner.
See Cost & Budgets and Model access for details.