PaseoPaseo
View as markdown

Codex

Paseo runs Codex through the official codex CLI and its app-server interface.

Does Codex cost extra in Paseo?

No. Paseo does not add a charge for Codex. Sign in to the Codex CLI with ChatGPT to use the access included with your ChatGPT plan, or sign in with an API key for usage billed through your OpenAI Platform account.

Your plan's normal Codex limits and OpenAI's standard API pricing still apply.

Getting started

Install the Codex CLI on the machine running Paseo:

npm install -g @openai/codex

Sign in with ChatGPT for subscription access:

codex login

Or sign in with an API key for usage billed through your OpenAI Platform account:

# macOS or Linux
printenv OPENAI_API_KEY | codex login --with-api-key

# Windows PowerShell
$env:OPENAI_API_KEY | codex login --with-api-key

Then confirm the CLI starts:

codex

Paseo uses this installation and its existing authentication when you start a Codex agent.

Codex is missing in Paseo

The ChatGPT desktop app and the Codex CLI are separate installs. Installing the desktop app does not make the codex command available to Paseo.

Check whether the CLI is on your PATH:

# macOS or Linux
which -a codex

# Windows
where.exe codex

If the command is not found:

  1. Install the Codex CLI.
  2. Sign in with ChatGPT or an API key using the commands above. See Codex authentication.
  3. Restart Paseo if its daemon was already running when you installed the CLI.
  4. In Paseo, open Settings → Providers → Codex and select Refresh.

The provider should become available once Paseo can find and start the codex command.

Use Codex in the Paseo terminal

Codex also works inside the Paseo terminal. Open a terminal in your workspace and run codex for the standard CLI experience while keeping access to your workspace, git changes, and other Paseo tools.

See also