← All Agents

Codex CLI

OpenAI's Codex coding agent with support for reasoning effort configuration.

Prerequisites

  • Node.js installed and on your PATH.
  • An OpenAI API key.

Setup

  1. Install the Codex CLI:
    npm install -g @openai/codex
  2. Set your API key — Export your OpenAI API key as an environment variable or configure it through the Codex CLI setup.
  3. Select in Blueprint AI — Choose Codex CLI from the agent dropdown. The plugin will auto-install the ACP adapter on first use.

Key Details

TypeCLI (JSON-RPC over stdio)
ACP Adapter@anthropic-ai/codex-acp
Default ModelSet by Codex configuration

Troubleshooting

  • Verify installation by running codex --version in a terminal.
  • If you see authentication errors, make sure your OPENAI_API_KEY environment variable is set.