Skip to main content

​
Overview

While cmd’s agent mode can autonomously take on complex tasks, you might prefer to bring in an external agent.
Setting up Codex gives you access to powerful agentic capabilities through cmd’s native interface in Xcode.

​
Prerequisites

Before configuring Codex in cmd, you need to have Codex installed and set up on your system.
1

Install Codex

Follow the official setup guide to install Codex.
2

Verify Installation

Ensure Codex is working properly by running it from your terminal:
codex --version
3

Login in Codex

Launch Codex in your terminal to authenticate with your ChatGPT subscription or API key

​
Configuring Codex in cmd

Once Codex is installed and configured, you can enable it in cmd:
1

Open AI Provider Settings

Go to Settings > AI Providers in cmd
2

Configuration

cmd should automatically detect where Codex is installed on your system.Otherwise, or if you need specific launch arguments, you can manually specify how to launch Codex
  1. Click “Add Provider” or “Configure” for Codex
  2. Provide the path to the Codex binary
  3. Optionally, specify a custom command if you use a specific way to run Codex
If you have Codex installed in a specific location:
/usr/local/bin/codex
If installed via Homebrew:
/opt/homebrew/bin/codex
3

Enable Codex

Toggle “Enable” for Codex

​
Using Codex

Once enabled, Codex will appear in your model selection:
1

Select Codex

In the cmd interface, open the model selector and choose “Codex”
2

Start Using

You can now use Codex’s advanced agentic capabilities:
  • Multi-step task execution
  • Integrates with your existing Codex configuration, include Agent.md
  • Rich native UI in cmd
Codex appears in the model selector just like any other AI model, but as an external agent it provides advanced capabilities that go beyond simple chat interactions.