Connect Codex Desktop to TeamoRouter
Codex Desktop is OpenAI's desktop AI coding assistant.
One-click setup with Teamo Desktop (recommended)
Teamo Desktop is TeamoRouter's official 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: On Windows, if a security warning appears, click "More info" then "Run anyway". On macOS, right-click the app and choose "Open".
After installation, create or sign in to your account.
In Teamo Desktop, find Codex Desktop and install it, or download it yourself from the OpenAI download page.
Then click "Connect to TeamoRouter". Teamo Desktop will automatically connect your local Codex Desktop app to TeamoRouter.
To switch back to an official OpenAI subscription, click "Disconnect TeamoRouter". This removes the TeamoRouter connection from Codex Desktop.
When the setup is complete, open Codex Desktop and start using it normally.
You can review usage for each request in the TeamoRouter dashboard.
Manual setup (not recommended)
If you do not want to use Teamo Desktop, 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 Codex Desktop for your system from the official OpenAI website, then install it.
-
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.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, paste the full block below, and press Enter:
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 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.