Codex CLI

Codex CLI is OpenAI's coding agent. One-click setup is recommended; manual setup changes one configuration file.

For one-click setup, open the console, go to Key Management, select One-click integration beside an OpenAI or Codex plan key, choose Codex CLI, and run the command in a terminal. Windows and macOS are supported. You can also select Import to CCS and choose Codex CLI for a graphical setup.

Manual setup: edit config.toml

The configuration file is ~/.codex/config.toml on macOS and Linux, or C:\Users\your-name.codex\config.toml on Windows. Create it if it does not exist.

model_provider = "hopbase"
model = "gpt-5.5"

[model_providers.hopbase]
name = "HopBase"
base_url = "https://api.hop-base.com/v1"
wire_api = "responses"
requires_openai_auth = true

Set the key and start Codex on macOS or Linux:

export OPENAI_API_KEY=sk-your-key
codex

On Windows PowerShell:

$env:OPENAI_API_KEY = "sk-your-key"
codex

# For a persistent variable, run this and reopen the terminal:
setx OPENAI_API_KEY "sk-your-key"

Use a Codex plan key from a Codex Plus or Codex Pro group. See Troubleshooting when setup fails.

Manual setup: edit config.toml

On this page