Conecte agentes de código à Rota Nacional

Suportado

Claude Code

Claude Code fala o formato Anthropic Messages API (/v1/messages), não o formato OpenAI. A Rota Nacional traduz isso automaticamente — configure em ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://rota-nacional.ia.br",
    "ANTHROPIC_AUTH_TOKEN": "sk-rota-..."
  }
}

Ou por variável de ambiente na sessão: export ANTHROPIC_BASE_URL="https://rota-nacional.ia.br" e export ANTHROPIC_AUTH_TOKEN="sk-rota-...". Use um dos IDs do catálogo (ex. rota/agentes ou rota/auto) como modelo. Tool use e streaming funcionam normalmente.

Suportado

OpenCode

OpenCode aceita qualquer endpoint OpenAI-compatible via o provedor @ai-sdk/openai-compatible. Configure em opencode.json (raiz do projeto ou ~/.config/opencode/opencode.json):

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "rota-nacional": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Rota Nacional",
      "options": {
        "baseURL": "https://rota-nacional.ia.br/v1",
        "apiKey": "{env:ROTA_API_KEY}"
      },
      "models": {
        "rota/agentes": { "name": "Rota Agentes" }
      }
    }
  }
}

Suportado

Pi

O Pi Coding Agent aceita endpoints OpenAI-compatible via ~/.pi/agent/models.json (recarrega sozinho, sem precisar reiniciar):

{
  "providers": {
    "rota-nacional": {
      "baseUrl": "https://rota-nacional.ia.br/v1",
      "api": "openai-completions",
      "apiKey": "$ROTA_API_KEY",
      "models": [{ "id": "rota/agentes", "name": "Rota Agentes" }]
    }
  }
}

Ainda não suportado

Codex CLI

Desde fevereiro de 2026 o Codex CLI só fala a Responses API da OpenAI (/v1/responses), não o formato Chat Completions que a Rota Nacional expõe em /v1/chat/completions. Apontar base_url pro nosso domínio hoje não funciona. Estamos avaliando construir uma tradução equivalente à do Claude Code; volte aqui ou fale com o comercial se esse é o seu caso de uso.