Official public Codex install

Install Codex CLI, or use the Windows desktop setup client.

The dashboard generates commands with the user's real wallet key already inserted. Linux instructions appear first, and Windows users can use the CodexAPI.pro Desktop Setup Client v1.0.17 for Codex Desktop, Claude Desktop, Coding Mode, live MCP tools, bundled skills, and remote Ubuntu/Debian setup.

Windows desktop path

Download the Desktop Setup Client first if you use Windows.

The setup client verifies your CodexAPI.pro account, checks existing Codex Desktop and Claude Desktop configuration, offers official desktop app downloads, and installs the correct API settings for your wallet.

Download Setup Client v1.0.17 Download Codex Desktop for Windows Download Claude Desktop for Windows

Linux one-time setup and start

npm install -g @openai/codex@latest
CODEX_HOME_DIR="$HOME/.codex"
CONFIG_PATH="$CODEX_HOME_DIR/config.toml"
mkdir -p "$CODEX_HOME_DIR" 2>/dev/null || true
if [ -e "$CODEX_HOME_DIR" ] && [ ! -w "$CODEX_HOME_DIR" ]; then
  sudo chown -R "$(id -u):$(id -g)" "$CODEX_HOME_DIR"
fi
if [ -e "$CONFIG_PATH" ] && [ ! -w "$CONFIG_PATH" ]; then
  sudo chown "$(id -u):$(id -g)" "$CONFIG_PATH"
fi
mkdir -p "$CODEX_HOME_DIR"
cat > "$CONFIG_PATH" <<'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
CODEX_HOME_DIR="$HOME/.codex"
CONFIG_PATH="$CODEX_HOME_DIR/config.toml"
mkdir -p "$CODEX_HOME_DIR" 2>/dev/null || true
if [ -e "$CODEX_HOME_DIR" ] && [ ! -w "$CODEX_HOME_DIR" ]; then
  sudo chown -R "$(id -u):$(id -g)" "$CODEX_HOME_DIR"
fi
if [ -e "$CONFIG_PATH" ] && [ ! -w "$CONFIG_PATH" ]; then
  sudo chown "$(id -u):$(id -g)" "$CONFIG_PATH"
fi
mkdir -p "$CODEX_HOME_DIR"
cat > "$CONFIG_PATH" <<'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.