Official public Codex install

Install the official OpenAI Codex CLI, then point it at Codex API.

The dashboard generates commands with the user's real wallet key already inserted. These generic examples show the provider shape.

Linux one-time setup and start

npm install -g @openai/codex@latest
mkdir -p "$HOME/.codex"
cat > "$HOME/.codex/config.toml" <<'TOML'
model = "gpt-5.5"
preferred_auth_method = "apikey"
model_provider = "codexapi"
model_reasoning_effort = "medium"
approval_policy = "never"
sandbox_mode = "danger-full-access"

[model_providers.codexapi]
name = "CodexAPI.pro"
base_url = "https://codexapi.pro/v1"
experimental_bearer_token = "your_wallet_key"
wire_api = "responses"
supports_websockets = false
TOML

codex --search

This saves CodexAPI.pro into Codex's normal config file and starts a new Codex session with web search enabled.

macOS one-time setup and start

brew install node git
npm install -g @openai/codex@latest
mkdir -p "$HOME/.codex"
cat > "$HOME/.codex/config.toml" <<'TOML'
model = "gpt-5.5"
preferred_auth_method = "apikey"
model_provider = "codexapi"
model_reasoning_effort = "medium"
approval_policy = "never"
sandbox_mode = "danger-full-access"

[model_providers.codexapi]
name = "CodexAPI.pro"
base_url = "https://codexapi.pro/v1"
experimental_bearer_token = "your_wallet_key"
wire_api = "responses"
supports_websockets = false
TOML

codex --search

The dashboard version also installs Homebrew when it is missing. Use the logged-in dashboard command for the exact wallet username.

Future starts and resume

codex
codex --search
codex resume --search
codex resume --last --search

After the one-time setup, normal Codex commands use the saved CodexAPI.pro provider and wallet username.

Windows PowerShell

winget source update
winget install --id OpenJS.NodeJS.LTS -e --accept-package-agreements --accept-source-agreements
winget install --id Git.Git -e --accept-package-agreements --accept-source-agreements
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force

npm install -g @openai/codex@latest
$CodexHome = "$env:USERPROFILE\.codex"
$ConfigPath = Join-Path $CodexHome "config.toml"
New-Item -ItemType Directory -Force -Path $CodexHome | Out-Null

@'
model = "gpt-5.5"
preferred_auth_method = "apikey"
model_provider = "codexapi"
model_reasoning_effort = "medium"
approval_policy = "never"
sandbox_mode = "danger-full-access"

[model_providers.codexapi]
name = "CodexAPI.pro"
base_url = "https://codexapi.pro/v1"
experimental_bearer_token = "your_wallet_key"
wire_api = "responses"
supports_websockets = false
'@ | Set-Content -Path $ConfigPath -Encoding utf8

codex --search

This saves the wallet username into the Windows Codex config. Future sessions can start with codex or codex resume --search.