Connect Codex CLI to TeamoRouter

Codex CLI is OpenAI's terminal-based AI coding assistant. If Codex is already installed, skip to the second section.

1. Install Codex from scratch

Install Codex

  • Codex requires Node.js 22 or later. Install it from the official installer or via Homebrew (brew install node).

  • macOS users can also install Codex with Homebrew: brew install codex.
  • In your terminal, run:
plaintext
npm install -g @openai/codex
  • After installation, check the version:
plaintext
codex --version

Configure the provider

macOS / Linux

Open a terminal, paste the full block below, and press Enter:

plaintext
mkdir -p ~/.codex && cat > ~/.codex/config.toml <<'EOF'
model_provider = "teamorouter"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
[model_providers.teamorouter]
name = "TeamoRouter"
base_url = "https://api.teamorouter.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
EOF
Windows

Open PowerShell and run:

plaintext
New-Item -ItemType Directory -Force -Path "$HOME\.codex" | Out-Null
@'
model_provider = "teamorouter"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"

[model_providers.teamorouter]
name = "TeamoRouter"
base_url = "https://api.teamorouter.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
'@ | Set-Content -Path "$HOME\.codex\config.toml" -Encoding UTF8

Set the API key

Replace <your-TeamoRouter-key> with the API key you created in the TeamoRouter dashboard.

macOS
plaintext
echo 'export OPENAI_API_KEY="<your-TeamoRouter-key>"' >> ~/.zshrc
source ~/.zshrc
Linux
plaintext
echo 'export OPENAI_API_KEY="<your-TeamoRouter-key>"' >> ~/.bashrc
source ~/.bashrc
Windows
plaintext
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "<your-TeamoRouter-key>", "User")

Windows users: after running the command above, close the current PowerShell window and open a new one.

After all three steps, run codex in the terminal. It will use TeamoRouter.

2. If Codex is already installed

If Codex is already installed, update the provider and API key configuration. Create your API key in the TeamoRouter dashboard.

Configure the provider

macOS / Linux
plaintext
mkdir -p ~/.codex && cat > ~/.codex/config.toml <<'EOF'
model_provider = "teamorouter"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
[model_providers.teamorouter]
name = "TeamoRouter"
base_url = "https://api.teamorouter.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
EOF
Windows
plaintext
New-Item -ItemType Directory -Force -Path "$HOME\.codex" | Out-Null
@'
model_provider = "teamorouter"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"

[model_providers.teamorouter]
name = "TeamoRouter"
base_url = "https://api.teamorouter.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
'@ | Set-Content -Path "$HOME\.codex\config.toml" -Encoding UTF8

Set the API key

macOS
plaintext
echo 'export OPENAI_API_KEY="<your-TeamoRouter-key>"' >> ~/.zshrc
source ~/.zshrc
Linux
plaintext
echo 'export OPENAI_API_KEY="<your-TeamoRouter-key>"' >> ~/.bashrc
source ~/.bashrc
Windows
plaintext
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "<your-TeamoRouter-key>", "User")

Windows users: after running the command above, close the current PowerShell window and open a new one.

After both steps, run codex in the terminal. It will use TeamoRouter.

Ready? Three steps to startLog in to the console · top up · create an API key
Get API KeyView Pricing
DiscordGet community help instantly
Join Discord
Connect Codex CLI to TeamoRouter · Docs