CANDIDATE INTEGRATION

Codex CLI reference-only setup.

A named Codex profile layers the AblitAI Responses provider over your normal configuration without replacing your plugins, agents, or approval policy.

This is a reference-only guide. Local/mock text, streaming, and simulated shell-tool protocol tests pass on Codex 0.153.4; tools are on; treat harness use as reference-only until sustained exact-GPU evidence is published. Do not use paid credits with this pending integration.

Before you start

1. Install the tested version

PowerShell, macOS, or Linux
node --version
npm --version
npm install --global @openai/codex@0.153.4
codex --version

2. Download the layered profile

The consumer profile contains no secret. It sets zero HTTP and stream retries so account, capacity, and service errors return once.

PowerShell

PowerShell
$homeDir = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $HOME ".codex" }
$profile = Join-Path $homeDir "ablitai.config.toml"
New-Item -ItemType Directory -Force $homeDir | Out-Null
if (Test-Path $profile) { throw "$profile exists; review and merge it manually." }
Invoke-WebRequest "https://ablitai.com/configs/codex-ablitai.config.toml" -OutFile $profile

macOS or Linux

macOS / Linux
home_dir="${CODEX_HOME:-$HOME/.codex}"
profile="$home_dir/ablitai.config.toml"
mkdir -p "$home_dir"
test ! -e "$profile" || { echo "$profile exists; review and merge it manually." >&2; exit 1; }
curl --fail --proto '=https' --tlsv1.2 https://ablitai.com/configs/codex-ablitai.config.toml -o "$profile"
chmod 600 "$profile"

3. Set the key for this terminal

PowerShell

PowerShell
$secret = Read-Host "AblitAI API key" -AsSecureString
$env:ABLITAI_API_KEY = [System.Net.NetworkCredential]::new("", $secret).Password
Remove-Variable secret

macOS or Linux

macOS / Linux
printf 'AblitAI API key: ' >&2
ablit_stty="$(stty -g)"
trap 'stty "$ablit_stty"' EXIT HUP INT TERM
stty -echo
IFS= read -r ABLITAI_API_KEY
stty "$ablit_stty"
trap - EXIT HUP INT TERM
unset ablit_stty
printf '\n' >&2
export ABLITAI_API_KEY

4. Confirm account access

Create or import your no-email account and save its offline backup. A valid key is required. This closed-tool diagnostic does not require funded credits and should return the documented 400 before inference or charging. Text inference separately requires a positive available balance.

5. Run the closed-gate probe

This probe is expected to return 400 Tool calling is disabled for this deployment. Codex includes tools in its Responses request even when the prompt says not to use them. Reaching that exact error proves the reference profile reached AblitAI, but it is not a launch step and does not establish support.

PowerShell
codex exec --profile ablitai --model qwen3.8-27b-abliterated --ephemeral `
  --skip-git-repo-check --sandbox read-only `
  "Reply with exactly ABLITAI_OK. Do not use tools."
macOS / Linux
codex exec --profile ablitai --model qwen3.8-27b-abliterated --ephemeral \
  --skip-git-repo-check --sandbox read-only \
  'Reply with exactly ABLITAI_OK. Do not use tools.'

In every new terminal used for this diagnostic, prompt for ABLITAI_API_KEY again. Do not start an interactive paid session unless this page is later promoted from reference-only to supported.

Known client behavior

Codex 0.153.4 prints a nonfatal warning because the custom model is absent from its bundled metadata catalog. Local/mock request and simulated tool protocol fixtures pass; standard tool-bearing requests remain unsupported until exact-GPU parser validation. This version preserves actionable audited errors except that it shows 429 while truncating the gateway detail.