Connect Codex Desktop to TeamoRouter
Codex Desktop is OpenAI's desktop AI coding assistant.
One-click setup with the Teamo client (recommended)
Teamo client is the official TeamoRouter desktop app. It can download Codex Desktop, connect it to TeamoRouter, and apply the model configuration for you, so the whole setup can be finished in a few minutes.
Download for Windows Download for macOS
Tip: If your system shows a risk warning during installation, choose trust or continue.
After installation, create or sign in to your account.
In the client, find Codex Desktop and install it, or download it yourself from the OpenAI download page.
Then click the one-click connect button. The client will automatically connect your local Codex Desktop app to TeamoRouter.
To switch back to an official OpenAI subscription, click the disconnect TeamoRouter button. This removes the TeamoRouter connection from Codex Desktop.
When the setup is complete, open Codex Desktop and start using it normally.
You can check request usage for every call in the TeamoRouter dashboard.
Manual setup (not recommended)
If you do not want to use the Teamo client, follow this section to install Codex Desktop and connect it to TeamoRouter manually.
Step 1: Download Codex Desktop manually
Skip this section if Codex Desktop is already installed.
- Download the installer for your system:
- macOS Apple Silicon: Codex.dmg
- macOS Intel: Codex-latest-x64.dmg
- Windows: Microsoft Store install
- Open the installer and finish the installation. Linux users should use the CLI version for now. See Connect Codex CLI to TeamoRouter.
Step 2: Update the system configuration file
macOS / Linux
Open a terminal, paste the full block below, and press Enter:
mkdir -p ~/.codex && cat > ~/.codex/config.toml <<'EOF'
model_provider = "teamorouter"
model = "gpt-5.5"
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, paste the full block below, and press Enter:
New-Item -ItemType Directory -Force -Path "$HOME\.codex" | Out-Null
@'
model_provider = "teamorouter"
model = "gpt-5.5"
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 your own API Key. You can create it in the TeamoRouter dashboard.
macOS
echo 'export OPENAI_API_KEY="<your-TeamoRouter-key>"' >> ~/.zshrc
source ~/.zshrc
Linux
echo 'export OPENAI_API_KEY="<your-TeamoRouter-key>"' >> ~/.bashrc
source ~/.bashrc
Windows
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "<your-TeamoRouter-key>", "User")
Windows users: after running the command above, fully close Codex Desktop and open it again so it can read the new environment variable.
Step 3: Launch Codex Desktop
Open Codex Desktop. If it was already running, quit it completely and reopen it.
