Codex CLI

Use Codex in the terminal for code editing, review, and engineering tasks with the GPT-5.6 series.

Prepare a key

YOUR_API_KEY is a placeholder in public documentation. Sign in to generate a configuration using one of your API keys.

Generate configuration with my API key

Configure the endpoint

This tool uses the OpenAI-compatible protocol. Enter the URL below as the client's Base URL.

https://your-domain.example/v1

One-click CLI setup (recommended)

Install the CodeNodex CLI to sign in, validate your API key, and prepare the matching local configuration.

Install CodeNodex CLI

macOS / Linux

curl -fsSL https://token.codenodex.com/cli/install.sh | bash

Windows PowerShell

iex "& { $(irm https://token.codenodex.com/cli/install.ps1) }"

Sign in and configure Codex CLI

Select an API key after signing in. The CLI verifies it and safely merges the Codex CLI configuration into your local files.

Terminal

codenodex login -o "https://token.codenodex.com"
codenodex setup --client codex

Copy configuration manually

If you do not use the CLI, replace YOUR_API_KEY with your API key. For real use, prefer the personalized configuration generator after signing in.

Manual configuration examples

~/.codex/config.toml

model_provider = "OpenAI"
model = "gpt-5.6-sol"
review_model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://your-domain.example/v1"
wire_api = "responses"
requires_openai_auth = true

[features]
goals = true

~/.codex/auth.json

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

Verify connectivity

Run this command. A successful model list means the endpoint and API key are working.

Terminal

curl "https://your-domain.example/v1/models" -H "Authorization: Bearer YOUR_API_KEY"

One-click CLI setup (recommended)

Install the CodeNodex CLI to sign in, validate your API key, and prepare the matching local configuration.

Install CodeNodex CLI

macOS / Linux

curl -fsSL https://token.codenodex.com/cli/install.sh | bash

Windows PowerShell

iex "& { $(irm https://token.codenodex.com/cli/install.ps1) }"

Sign in and configure Codex CLI

Select an API key after signing in. The CLI verifies it and safely merges the Codex CLI configuration into your local files.

Terminal

codenodex login -o "https://token.codenodex.com"
codenodex setup --client codex

Copy configuration manually

If you do not use the CLI, replace YOUR_API_KEY with your API key. For real use, prefer the personalized configuration generator after signing in.

Manual configuration examples

~/.codex/config.toml

model_provider = "OpenAI"
model = "gpt-5.6-sol"
review_model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://your-domain.example/v1"
wire_api = "responses"
requires_openai_auth = true

[features]
goals = true

~/.codex/auth.json

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}