Skip to main content

Documentation Index

Fetch the complete documentation index at: https://ona.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Available on the Core plan. ChatGPT plan connections for Codex are currently supported on Ona Cloud only. Contact sales to learn more.
Connect Codex when you want the Codex agent in Ona to use your ChatGPT plan for model requests. You can use Codex without this integration; without it, Codex uses the model access available to your organization. This page covers the ChatGPT connection. For the agent itself, see Codex Agent. The running environment still consumes OCUs, but Codex model requests that use your ChatGPT plan are not billed by Ona.

​
How Codex uses your ChatGPT plan

Codex runs inside the same isolated Ona Cloud environments as other agents. It can read your repository, use configured tools, run commands, and open pull requests while following your organization’s policies. After you connect your ChatGPT account, the Codex agent uses your ChatGPT plan for model requests. The connection changes model billing and limits only. Ona still provisions and meters the environment that Codex works in.

​
Prerequisites

  • Your organization is on the Core plan.
  • Your organization uses Ona Cloud.
  • An organization admin enabled the Codex integration.
  • You have a ChatGPT account with Codex access.
If Codex is not listed under User Settings > Integrations, ask an organization admin to enable it or contact Ona support.

​
Connect your ChatGPT account

  1. Go to User Settings > Integrations.
  2. Find Codex.
  3. Click Connect.
  4. Ona opens the OpenAI device authorization page and copies a one-time code.
  5. Sign in to ChatGPT, enter the code, and approve the authorization.
  6. Return to Ona. The dialog updates when the account is connected.

​
Use Codex in Ona

Start an environment, open the conversation menu, and choose Codex when it is available. If you connected your ChatGPT account, Codex uses your ChatGPT plan for model requests from your user session. If you disconnect the integration, future Codex sessions fall back to the model access available to your organization.

​
Billing and limits

  • OpenAI manages ChatGPT plan usage. Ona does not charge OCUs for Codex model requests that use your connected ChatGPT account.
  • Ona still charges for the environment while it is running. See Usage & credits.
  • If ChatGPT rate limits or usage limits are reached, Codex can pause or fail until the limit resets or your ChatGPT plan changes.

​
Disconnect Codex

  1. Go to User Settings > Integrations.
  2. Find Codex.
  3. Click Disconnect.

​
Troubleshooting

The integration is not enabled for your organization yet. Ask an organization admin to check Organization Settings > Integrations, or contact Ona support.
Close the dialog and click Connect again to start a new authorization flow.
The connected ChatGPT account has likely reached a Codex limit set by OpenAI. Check your ChatGPT plan and billing details, then retry after the limit resets.