Codex Setup

Codex is OpenAI's AI coding assistant CLI. Clauddy is fully compatible with the OpenAI API format.

Prerequisites

• Clauddy API token (create one)
• Node.js 18+ (environment check)

Install

macOS / Linux

npm install -g @openai/codex

Windows (Run as Admin)

npm install -g @openai/codex

Verify: codex --version

Configuration

Codex uses config files for API setup.

macOS / Linux (~/.codex/config.toml)

model_provider = "clauddy"
model = "gpt-5.3-codex"

[model_providers.clauddy]
name = "clauddy"
base_url = "https://clauddy.com/v1"
wire_api = "responses"
requires_openai_auth = true

Windows (%USERPROFILE%\.codex\config.toml)

# 1. Press Win+R, type %USERPROFILE% and press Enter
# 2. Create .codex folder
# 3. Create config.toml and auth.json inside

model_provider = "clauddy"
model = "gpt-5.3-codex"

[model_providers.clauddy]
name = "clauddy"
base_url = "https://clauddy.com/v1"
wire_api = "responses"
requires_openai_auth = true

Also create auth.json in the same directory:

macOS / Linux (~/.codex/auth.json)

{
  "OPENAI_API_KEY": "sk-your-clauddy-token"
}

Windows (%USERPROFILE%\.codex\auth.json)

{
  "OPENAI_API_KEY": "sk-your-clauddy-token"
}

Creating .codex folder on Windows

mkdir "%USERPROFILE%\.codex"

Config Reference

Setting	Description
base_url	Clauddy OpenAI-compatible endpoint: https://clauddy.com/v1
OPENAI_API_KEY	Your Clauddy API token
model	Recommended: gpt-5.3-codex

URL Format

Codex requires the /v1 suffix. Use https://clauddy.com/v1, not https://clauddy.com.

Launch

cd your-project-folder
codex

Troubleshooting

See Codex FAQ.