Codex setup guide

Use CC Switch for one-click import, or update the Codex config files manually.

Before You Start

Option 1: CC Switch

  • Download and install CC Switch first
  • On the API Keys page, click the “Import to CCS” button on the right to import directly

Option 2: Manual Setup

  • Mac and Linux: ~/.codex/config.toml, ~/.codex/auth.json
  • Windows: %USERPROFILE%\.codex\config.toml, %USERPROFILE%\.codex\auth.json, usually C:\Users\YourName\.codex\

Edit config.toml

Copy this into config.toml.

config.toml
# Use Genius Coder as the Codex model provider
model_provider = "geniuscoder"

# Model and reasoning effort
model = "gpt-5.5"
model_reasoning_effort = "high"

# Connect to the Genius Coder API
[model_providers]
[model_providers.geniuscoder]
name = "geniuscoder"
base_url = "https://api.geniuscoder.net/v1"
wire_api = "responses"

Edit auth.json

Copy this into auth.json, then replace sk-xxx with your Genius Coder API Key.

auth.json
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "sk-xxx"
}

Restart Codex

Save both files, restart Codex, then send one request to verify the setup.