Codex CLI

What is Codex CLI?

Codex CLI is OpenAI's open-source local coding agent that runs in your terminal. It supports multiple model providers, including AIRouter24, so you can use AIRouter24's unified API, provider failover, and organizational controls with Codex's agentic coding workflows.

Quick Start

Step 1: Install Codex CLI

Follow the Codex CLI installation instructions to install the CLI on your system.

Step 2: Get Your AIRouter24 API Key

1. Sign up or log in at AIRouter24
2. Navigate to your API Keys page
3. Create a new API key
4. Copy your key (starts with sk-***)

Step 3: Configure Codex for AIRouter24

Codex uses a config.toml file, typically located at ~/.codex/config.toml. Create or edit this file with the following configuration:

model_provider = "airouter24"
model_reasoning_effort = "high"
model="~openai/gpt-latest"

[model_providers.airouter24]
name = "AIRouter24"

base_url="https://airouter24.com/v1"
env_key="AIROUTER24_API_KEY"

Step 4: Set Your API Key

Export your AIRouter24 API key in your shell profile:

# Add to ~/.zshrc, ~/.bashrc, or ~/.config/fish/config.fish
export AIROUTER24_API_KEY="sk-***"

Note: Codex reads the API key from the environment variable specified in env_key (default: AIROUTER24_API_KEY). Ensure this is set before starting Codex.

Step 5: Start Codex

Navigate to your project directory and run:

cd /path/to/your/project
codex

Your requests will now be routed through AIRouter24.

Configuration Reference

Core Settings

AIRouter24 Provider Block

[model_providers.airouter24]
name = "AIRouter24"
base_url = "https://airouter24.com/v1"
env_key = "AIROUTER24_API_KEY"

• base_url: AIRouter24 API endpoint. Use https://airouter24.com/v1 for production.
• env_key: Environment variable name for your API key.

Project Trust Levels

Codex supports per-project trust levels. Add project paths to control what the agent can access:

[projects."/path/to/trusted/project"]
trust_level = "trusted"

[projects."/path/to/untrusted/project"]
trust_level = "untrusted"

• trusted: Agent has full access (e.g., run commands, edit files).
• untrusted: Agent has restricted access for safety.

Why Use AIRouter24 with Codex CLI?

Provider Failover

AIRouter24 routes requests across multiple providers. If one provider is unavailable or rate-limited, AIRouter24 can fail over to another, keeping your coding sessions uninterrupted.

Organizational Controls

For teams, AIRouter24 provides centralized budget management. Set spending limits, allocate credits, and prevent unexpected cost overruns across developers using Codex.

Usage Visibility

Track Codex usage in real-time via the AIRouter24 Activity Dashboard. Monitor costs, token usage, and request patterns.

Model Flexibility

Point model at any AIRouter24 slug (e.g. ~openai/gpt-latest, ~anthropic/claude-sonnet-latest) or a pinned version to switch models without changing your Codex installation—just update config.toml.

Troubleshooting

• Auth Errors: Ensure AIROUTER24_API_KEY is set and valid. Check at airouter24.com/keys.
• Model Not Found: Verify the model ID on airouter24.com/models. Use the exact format (e.g., ~openai/gpt-latest).
• Privacy: AIRouter24 does not log your source code prompts unless you opt-in to prompt logging. See our Privacy Policy for details.

Resources

• Codex CLI on GitHub
• AIRouter24 Codex Models
• AIRouter24 Activity Dashboard
• AIRouter24 API Documentation