Configure sua chave RouteLabz em qualquer ferramenta

1. Abra o terminal (PowerShell, bash ou zsh).
2. Exporte ANTHROPIC_BASE_URL apontando para https://api.routelabz.com.br (sem /v1 — o Claude Code anexa /v1/messages sozinho).
3. Exporte ANTHROPIC_AUTH_TOKEN com a chave route-sk-…
4. Rode `claude` normalmente — todas as chamadas passam pelo gateway.

# Linux / macOS
export ANTHROPIC_BASE_URL=https://api.routelabz.com.br
export ANTHROPIC_AUTH_TOKEN=route-sk-xxxxxxxxxxxxx
claude

# Windows PowerShell
$env:ANTHROPIC_BASE_URL = "https://api.routelabz.com.br"
$env:ANTHROPIC_AUTH_TOKEN = "route-sk-xxxxxxxxxxxxx"
claude

Teste rápido: claude --version && claude # depois /model para escolher Claude

Atenção: Aplicativos GUI no macOS lançados pelo Dock não herdam variáveis do shell — exporte no ~/.zprofile ou inicie o Claude Code pelo terminal.

1. Instale @anthropic-ai/sdk (Node) ou anthropic (Python).
2. Passe base_url=https://api.routelabz.com.br e api_key=route-sk-… no construtor.
3. Use os métodos normais do SDK — todo o protocolo Messages é suportado.

// Node / TypeScript
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "https://api.routelabz.com.br",
  apiKey: "route-sk-xxxxxxxxxxxxx",
});

const msg = await client.messages.create({
  model: "claude-sonnet-4-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Oi!" }],
});

# Python
from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.routelabz.com.br",
    api_key="route-sk-xxxxxxxxxxxxx",
)

msg = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Oi!"}],
)

Teste rápido: curl https://api.routelabz.com.br/v1/messages -H "x-api-key: route-sk-xxxxxxxxxxxxx" -H "anthropic-version: 2023-06-01" -H "content-type: application/json" -d '{"model":"claude-haiku-4-5","max_tokens":50,"messages":[{"role":"user","content":"ping"}]}'

1. Cursor Settings (⌘/Ctrl + ,) → Models.
2. Em OpenAI API: cole a chave route-sk-… no campo OpenAI API Key.
3. Marque "Override OpenAI Base URL" e cole https://api.routelabz.com.br/v1.
4. Em "Add Model", adicione claude-sonnet-4-5 (e demais Claude que quiser usar).
5. Clique em Verify — Cursor pinga /v1/models para confirmar.

// Cursor → Settings → Models → OpenAI API
OpenAI API Key:        route-sk-xxxxxxxxxxxxx
Override Base URL:     https://api.routelabz.com.br/v1
Add Model:             claude-sonnet-4-5
                       claude-opus-4-5
                       claude-haiku-4-5

// Marcar "Verify" — Cursor faz GET https://api.routelabz.com.br/v1/models

Teste rápido: curl https://api.routelabz.com.br/v1/models -H "Authorization: Bearer route-sk-xxxxxxxxxxxxx"

Atenção: O Override Base URL exige HTTPS público — perfeito para o RouteLabz, mas significa que o mesmo campo não roda Ollama local sem túnel.

1. Instale Cline (saoudrizwan.claude-dev) no Marketplace.
2. Abra a aba Cline → ⚙ Settings.
3. API Provider: OpenAI Compatible.
4. Base URL: https://api.routelabz.com.br/v1
5. API Key: route-sk-xxxxxxxxxxxxx
6. Model ID: claude-sonnet-4-5 (ou claude-opus-4-5 / claude-haiku-4-5).

// Cline → ⚙ Settings
API Provider:  OpenAI Compatible
Base URL:      https://api.routelabz.com.br/v1
API Key:       route-sk-xxxxxxxxxxxxx
Model ID:      claude-sonnet-4-5

Teste rápido: Crie uma task qualquer no painel do Cline e veja se sai resposta.

1. Instale Kilo Code no Marketplace do VS Code.
2. Painel Kilo → ícone de configurações.
3. API Provider: OpenAI Compatible.
4. Base URL: https://api.routelabz.com.br/v1
5. API Key: route-sk-xxxxxxxxxxxxx
6. Model: ao colar uma URL válida, Kilo lista automaticamente os modelos disponíveis — escolha um Claude.

// Kilo Code → ⚙ Settings
API Provider:  OpenAI Compatible
Base URL:      https://api.routelabz.com.br/v1
API Key:       route-sk-xxxxxxxxxxxxx
Model:         claude-sonnet-4-5

Teste rápido: O dropdown de modelos deve listar os Claude disponíveis no RouteLabz.

1. Abra ~/.continue/config.yaml (config.json também é aceito, mas YAML é o formato recomendado em 2026).
2. Adicione um bloco em models[] com provider: openai e apiBase apontando para o RouteLabz.
3. Salve — o Continue recarrega o config sem reiniciar a IDE.

# ~/.continue/config.yaml
name: RouteLabz
version: 0.0.1
schema: v1

models:
  - name: Claude Sonnet (RouteLabz)
    provider: openai
    model: claude-sonnet-4-5
    apiBase: https://api.routelabz.com.br/v1
    apiKey: route-sk-xxxxxxxxxxxxx
    roles:
      - chat
      - edit
      - apply

Teste rápido: Abra o painel do Continue → seletor de modelos deve mostrar "Claude Sonnet (RouteLabz)".

1. Roo Code → ícone de engrenagem.
2. API Provider: OpenAI Compatible.
3. Base URL: https://api.routelabz.com.br/v1
4. API Key: route-sk-xxxxxxxxxxxxx
5. Model ID: claude-sonnet-4-5 (qualquer Claude com tool-calling nativo serve).

// Roo Code → ⚙ Settings
API Provider:  OpenAI Compatible
Base URL:      https://api.routelabz.com.br/v1
API Key:       route-sk-xxxxxxxxxxxxx
Model ID:      claude-sonnet-4-5

Teste rápido: Roo Code exige tool-calling nativo — qualquer Claude 4.x serve.

Atenção: Roo Code não tem fallback para modelos sem tool-calling — use sempre Claude Sonnet/Opus, não Haiku se a task exigir ferramentas pesadas.

1. Settings | Tools | AI Assistant | Providers & API keys.
2. Em "Third-party AI providers", adicione um provider OpenAI-compatible.
3. URL: https://api.routelabz.com.br/v1
4. API Key: route-sk-xxxxxxxxxxxxx
5. Model: claude-sonnet-4-5 (e adicione os outros que quiser usar).
6. Clique em Test Connection → Apply.

// Settings → Tools → AI Assistant → Providers & API keys
Provider:  OpenAI-compatible
URL:       https://api.routelabz.com.br/v1
API Key:   route-sk-xxxxxxxxxxxxx
Model:     claude-sonnet-4-5

Teste rápido: Test Connection precisa retornar OK; depois selecione o modelo no AI Chat.

Atenção: Se o seu modelo precisa de tool-calling, marque a opção "Tool calling" antes de salvar.

1. Instale openai (pip install openai ou npm i openai).
2. Inicialize o client com baseURL=https://api.routelabz.com.br/v1 e apiKey=route-sk-…
3. Use chat.completions.create normalmente, escolhendo um model Claude.

// Node / TypeScript
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.routelabz.com.br/v1",
  apiKey: "route-sk-xxxxxxxxxxxxx",
});

const r = await client.chat.completions.create({
  model: "claude-sonnet-4-5",
  messages: [{ role: "user", content: "Oi!" }],
});

# Python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.routelabz.com.br/v1",
    api_key="route-sk-xxxxxxxxxxxxx",
)

r = client.chat.completions.create(
    model="claude-sonnet-4-5",
    messages=[{"role": "user", "content": "Oi!"}],
)

Teste rápido: curl https://api.routelabz.com.br/v1/chat/completions -H "Authorization: Bearer route-sk-xxxxxxxxxxxxx" -H "Content-Type: application/json" -d '{"model":"claude-haiku-4-5","messages":[{"role":"user","content":"ping"}]}'

1. Instale o Aider: pipx install aider-chat.
2. Exporte OPENAI_API_BASE=https://api.routelabz.com.br/v1 e OPENAI_API_KEY=route-sk-…
3. Rode aider com --model openai/claude-sonnet-4-5 (o prefixo openai/ é obrigatório para custom endpoints).

# Linux / macOS
export OPENAI_API_BASE=https://api.routelabz.com.br/v1
export OPENAI_API_KEY=route-sk-xxxxxxxxxxxxx
aider --model openai/claude-sonnet-4-5

# Windows PowerShell
$env:OPENAI_API_BASE = "https://api.routelabz.com.br/v1"
$env:OPENAI_API_KEY  = "route-sk-xxxxxxxxxxxxx"
aider --model openai/claude-sonnet-4-5

Teste rápido: Dentro da sessão Aider digite /tokens para ver se o endpoint respondeu.

Atenção: Sempre prefixe o nome do modelo com openai/ quando estiver usando endpoint customizado — sem o prefixo, o LiteLLM tenta inferir o provider e falha.

1. Abra o settings.json do Zed (cmd-shift-P → "zed: open settings").
2. Adicione um bloco em language_models.openai_compatible.
3. Liste os modelos Claude que quer usar em available_models.
4. Exporte ROUTELABZ_API_KEY como variável de ambiente (Zed lê do shell).

// ~/.config/zed/settings.json
{
  "language_models": {
    "openai_compatible": {
      "RouteLabz": {
        "api_url": "https://api.routelabz.com.br/v1",
        "available_models": [
          {
            "name": "claude-sonnet-4-5",
            "display_name": "Claude Sonnet 4.5 (RouteLabz)",
            "max_tokens": 200000
          },
          {
            "name": "claude-opus-4-5",
            "display_name": "Claude Opus 4.5 (RouteLabz)",
            "max_tokens": 200000
          }
        ]
      }
    }
  }
}

# Variável de ambiente (a chave NÃO fica no settings.json)
export ROUTELABZ_API_KEY=route-sk-xxxxxxxxxxxxx

Teste rápido: Agent Panel → seletor de modelos deve listar "Claude Sonnet 4.5 (RouteLabz)".

Atenção: Zed propositalmente não armazena a API key no settings.json — defina via env var no formato {NOME_DO_PROVIDER}_API_KEY (no nosso caso, ROUTELABZ_API_KEY).

1. No painel Windsurf, abra Settings → Models.
2. Se a sua build tiver "Custom OpenAI Provider" liberado: cole base URL + key abaixo.
3. Caso contrário, use o terminal integrado com Aider, OpenAI SDK ou Claude Code — todos passam pelo RouteLabz do mesmo jeito.

// Windsurf → Settings → Models → Custom Provider (quando disponível)
Base URL:  https://api.routelabz.com.br/v1
API Key:   route-sk-xxxxxxxxxxxxx
Model:     claude-sonnet-4-5

// Plano B: terminal integrado
export OPENAI_API_BASE=https://api.routelabz.com.br/v1
export OPENAI_API_KEY=route-sk-xxxxxxxxxxxxx
aider --model openai/claude-sonnet-4-5

Atenção: Em maio/2026 a Windsurf ainda gerencia modelos via Codeium em vários planos — verifique a documentação oficial se a opção "Custom Provider" não aparece para você.