Codex CLI

Prerequisites

Step 1: Install

Follow the Codex CLI installation instructions from the Codex repository, then confirm it is available:

$
codex --version

Step 2: Configure Codex

Codex can point directly at JoyToken’s OpenAI-compatible endpoint. No local bridge service is required.

Replace jt_xxx with your JoyToken API key, then run:

$
export JOY_TOKEN_API_KEY="jt_xxx"
$
export JOY_TOKEN_OPENAI_BASE_URL="https://api-dev.joytokens.ai/openai/v1"
$
mkdir -p ~/.codex
$
cat > ~/.codex/config.toml <<EOF
$
model_provider = "joytoken"
$
model = "auto"
$
$
[model_providers.joytoken]
$
name = "JoyToken"
$
base_url = "$JOY_TOKEN_OPENAI_BASE_URL"
$
env_key = "JOY_TOKEN_API_KEY"
$
EOF

For persistent use, add the API key to your shell profile:

$
printf '\nexport JOY_TOKEN_API_KEY="%s"\n' "$JOY_TOKEN_API_KEY" >> ~/.zshrc

Step 3: Start Codex

Run Codex from your project directory:

$
cd /path/to/your/project
$
codex

Step 4: Verify

$
codex exec \
>
  --skip-git-repo-check \
>
  --sandbox read-only \
>
  --ask-for-approval never \
>
  "Reply with exactly: pong"

A successful response includes pong.

JoyToken Check

Common Errors

Resources

• JoyToken API Guide
• JoyToken Models
• JoyToken Usage & Billing