Set up coding tools with OzRouter

After you receive your key by email, use it as OZROUTER_API_KEY and point your tool at the OzRouter endpoint.

Use the endpoint from your key email or the current production configuration if it changes later.

Set the environment variable

All examples below read the API key from OZROUTER_API_KEY. Set this variable in the environment that actually starts your coding tool or SDK app.

macOS / Linux


# Applies only to the current terminal
export OZROUTER_API_KEY="sk-ozr-..."

To make new terminals pick it up automatically, add the export line to ~/.zshrc, ~/.bashrc, or the shell profile you use.

Windows WSL

From PowerShell, enter your WSL distro first:

wsl

Then run these commands inside the WSL shell:


export OZROUTER_API_KEY="sk-ozr-..."
 
# Optional: save it for new WSL terminals
echo 'export OZROUTER_API_KEY="sk-ozr-..."' >> ~/.bashrc

If you use zsh or another shell in WSL, add the same export line to that shell’s profile instead.

PowerShell


# Applies only to the current PowerShell window
$env:OZROUTER_API_KEY="sk-ozr-..."
 
# Saves it for the current user, then open a new terminal
[Environment]::SetEnvironmentVariable("OZROUTER_API_KEY", "sk-ozr-...", "User")

Windows CMD


:: Applies only to the current CMD window
set OZROUTER_API_KEY=sk-ozr-...
 
:: Saves it for the current user, then open a new CMD window
setx OZROUTER_API_KEY "sk-ozr-..."

Docker / CI


# GitHub Actions
env:
  OZROUTER_API_KEY: ${{ secrets.OZROUTER_API_KEY }}
 
# Docker Compose
environment:
  OZROUTER_API_KEY: ${OZROUTER_API_KEY}

For hosted apps or your own server, add OZROUTER_API_KEY to that environment’s variables or secrets before starting the app.

After changing an environment variable, reopen the terminal or restart the tool session so it reads the new value.

Codex CLI

~/.codex/config.toml


model = "gpt-5.6-sol"
model_reasoning_effort = "medium"
model_provider = "ozrouter"
 
[model_providers.ozrouter]
name = "OpenAI"
base_url = "https://api.ozrouter.com/codex"
wire_api = "responses"
env_key = "OZROUTER_API_KEY"
supports_websockets = true
requires_openai_auth = true

OpenCode

~/.config/opencode/opencode.json


{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://api.ozrouter.com/v1",
        "apiKey": "{env:OZROUTER_API_KEY}"
      },
      "models": {
        "gpt-5.6-sol": {
          "name": "GPT-5.6-Sol",
          "reasoning": true,
          "options": { "reasoningEffort": "medium", "reasoningSummary": "detailed" },
          "limit": { "context": 272000, "output": 128000 }
        }
      }
    }
  },
  "model": "openai/gpt-5.6-sol"
}

OpenClaw

~/.openclaw/openclaw.json


{
  "agents": {
    "defaults": {
      "model": { "primary": "ozrouter/gpt-5.6-sol" },
      "models": {
        "ozrouter/gpt-5.6-sol": { "params": { "cacheRetention": "short", "reasoningEffort": "medium" } }
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "ozrouter": {
        "baseUrl": "https://api.ozrouter.com/v1",
        "apiKey": "${OZROUTER_API_KEY}",
        "api": "openai-responses",
        "models": [
          { "id": "gpt-5.6-sol", "name": "gpt-5.6-sol (ozrouter)", "contextWindow": 1050000, "maxTokens": 4096, "input": ["text"] }
        ]
      }
    }
  }
}

Python SDK


import os
from openai import OpenAI
 
client = OpenAI(
    base_url="https://api.ozrouter.com/v1",
    api_key=os.environ["OZROUTER_API_KEY"],
)
 
response = client.chat.completions.create(
    model="gpt-5.6-sol",
    reasoning_effort="medium",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content)

Available models

The examples above use gpt-5.6-sol by default. To try another model, replace every gpt-5.6-sol value in your tool config with one of these customer-facing model IDs:

Model ID	Use when
`gpt-5.6-sol`	Latest frontier agentic coding model
`gpt-5.6-terra`	Balanced agentic coding model for everyday work
`gpt-5.6-luna`	Fast and affordable agentic coding model
`gpt-5.5`	Frontier model for complex coding, research, and real-world work
`gpt-5.4`	Strong model for everyday coding
`gpt-5.4-mini`	Small, fast, and cost-efficient model for simpler coding tasks

For Codex CLI, change the top-level model value. For OpenCode, change both the key under models and the final "model": "openai/..." value. For OpenClaw, change the defaults.model.primary value and the matching model entry under the models.providers.ozrouter.models list.

You can also query https://api.ozrouter.com/v1/models with your OzRouter API key to see the live model catalog exposed by the router.

Quick check

Restart the terminal or tool session after changing environment variables.
Run one small request before starting a long coding session.
If the tool still calls its default endpoint directly, check base_url, baseURL, or the tool’s own config file.

CI usage

Set OZROUTER_API_KEY through your CI secret store. Do not commit keys to a repository, build log, screenshot, or debug output.