Skip to content
Set up Codex
On this page
DocumentationProviders

Set up Codex

Connect Codex to Rudr through a ChatGPT subscription, OpenAI API access, or a configured Foundry route.

Availability variesSource reviewed 2026-09-06 · Rudr 0.34.0

Install and detect Codex

  1. Open Settings → Code Harnesses → Codex.
  2. If the CLI is missing, choose Install Codex, review the command and host, then choose Download and run it.
  3. Wait for installer completion and the detection refresh. Continue with sign-in only after Codex is detected.
  4. If installation fails, read the error, then use Try again after fixing the cause or Open install docs. The official Codex CLI guide provides standalone and package-manager installation choices.
  5. For a manual install, select the native OS instructions, verify codex --version in a new terminal, fully quit and reopen Rudr, and return to the Codex settings. Rudr detects PATH and known locations; it does not scan every custom directory or automatically use a WSL-only installation.

Connect ChatGPT access

  1. Choose ChatGPT subscription.
  2. Choose Sign in to Codex, or Manage if you deliberately need to change an existing sign-in.
  3. Read the shared-credential notice. Choose Continue in browser or Use a device code, according to the options offered by the current flow.
  4. Finish the provider flow and return to Rudr. Check readiness, use Refresh status if offered, select an available model, and Save settings.

Sign-in changes the Codex CLI credential immediately, including its use outside Rudr. Sign-out has a separate confirmation and Sign out shared credential action. Cancel in Settings does not undo either operation. Rudr’s ready-state text deliberately omits account identity, so do not infer the signed-in account from a generic Ready message. OpenAI authentication documentation explains subscription and API access as distinct sign-in methods.

Use OpenAI API or Foundry

Configure the key or deployment in Settings → Models, save it, then return to Code Harnesses → Codex and select OpenAI API or Foundry. Check the selected route’s available model before starting work. Existing sessions retain their route; changing the default is not a way to reroute every earlier session.

For a detected CLI with no usable models, follow readiness troubleshooting. Codex estimate-triggered stopping is best effort, as described in cost warnings.

Instructions have been reviewed against the application source; native setup and account walkthroughs remain to be verified. Platform and provider limitations are described above.

Set up Codex — Rudr