Ligue o Teapot Router ao seu cliente

Prepare estes três elementos

Trate a chave API como uma palavra-passe. Não a partilhe em chats, imagens, documentos ou repositórios públicos; introduza-a apenas em clientes de confiança.

Codex CLI: primeira chamada

Teste o Teapot Router neste terminal sem alterar a configuração existente do Codex. Precisa de canal e modelo Responses ativos e saldo na conta.

1. Confirme o saldo da conta real e prepare uma chave API válida.
2. Peça ao administrador para ativar um canal e modelo compatíveis com Responses.
3. Escolha abaixo a chave e o modelo; copie o comando pronto para um novo terminal. A pré-visualização oculta a chave, mas o comando copiado inclui-a.
4. Peça ao Codex para responder OK e confirme o pedido em Utilização.

(
  printf 'OpenAI Base URL (ends in /v1): '
  IFS= read -r RELAY_BASE
  printf 'Responses model ID: '
  IFS= read -r RELAY_MODEL
  printf 'Teapot Router API Key: '
  IFS= read -r -s RELAY_KEY_FOR_CODEX
  printf '\n'
  export RELAY_KEY_FOR_CODEX
  codex -m "$RELAY_MODEL" \
    -c 'model_provider="relay"' \
    -c "model_providers.relay={name=\"Teapot Router\",base_url=\"$RELAY_BASE\",env_key=\"RELAY_KEY_FOR_CODEX\",wire_api=\"responses\",requires_openai_auth=false}"
)

O comando afeta apenas esta sessão. A chave pode ficar no clipboard e no histórico do terminal; limpe-os após o teste. Verifique o NEW-API em caso de erro de modelo ou canal.

Claude Code

Este método configura o Claude Code apenas na sessão atual do terminal e não substitui definições existentes.

1. Se ainda não tem Claude Code, siga as instruções oficiais de instalação e confirme que o comando claude abre.
2. No painel Teapot Router, abra « Configurar cliente » → Claude Code. Copie o endereço sem /v1, revele a chave e obtenha um ID de modelo Claude disponível.
3. Abra o terminal. Substitua <TEAPOT_API_BASE_URL> e <CLAUDE_MODEL_ID> pelos seus valores. Execute os comandos, cole a chave quando for pedido e prima Enter. A chave não aparece no ecrã.
4. Envie uma mensagem curta no Claude Code, por exemplo « Responde OK ». Depois encontre o pedido no histórico de utilização Teapot Router.

macOS / Linux (bash, zsh)

export ANTHROPIC_BASE_URL="<TEAPOT_API_BASE_URL>"
printf 'Teapot Router API Key: '
read -rs ANTHROPIC_AUTH_TOKEN
printf '
'
export ANTHROPIC_AUTH_TOKEN
export ANTHROPIC_MODEL="<CLAUDE_MODEL_ID>"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"
claude

Windows PowerShell

$env:ANTHROPIC_BASE_URL = "<TEAPOT_API_BASE_URL>"
$secret = Read-Host "Teapot Router API Key" -AsSecureString
$env:ANTHROPIC_AUTH_TOKEN = [System.Net.NetworkCredential]::new("", $secret).Password
$env:ANTHROPIC_MODEL = "<CLAUDE_MODEL_ID>"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = $env:ANTHROPIC_MODEL
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = $env:ANTHROPIC_MODEL
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = $env:ANTHROPIC_MODEL
claude

As variáveis duram apenas nesta sessão do terminal. Para guardar a configuração, use um método suportado pelo Claude Code e faça uma cópia das definições atuais antes de as alterar.

Cliente compatível com OpenAI

Para aplicações de chat com fornecedor OpenAI personalizado ou aplicações com o SDK OpenAI. Os nomes dos menus variam; os três valores são os mesmos.

1. Abra as definições de fornecedor ou API do cliente e escolha « OpenAI compatible », « Custom OpenAI » ou uma API personalizada.
2. Em « Base URL », introduza o endereço do separador OpenAI compatível do Teapot Router, terminado em /v1. Em « API Key », coloque a chave real revelada.
3. Introduza o ID completo de um modelo permitido para a chave. Guarde, envie uma mensagem curta e confirme o pedido no Teapot Router.

# First run: python3 -m pip install openai
from getpass import getpass
from openai import OpenAI

base_url = input("Teapot Router Base URL (ends in /v1): ").strip()
model = input("Model ID: ").strip()
client = OpenAI(base_url=base_url, api_key=getpass("Teapot Router API Key: "))
result = client.chat.completions.create(
    model=model,
    messages=[{"role": "user", "content": "Reply with OK."}],
)
print(result.choices[0].message.content)

Confirmar ligação

Copiar os valores ou marcar « Cliente configurado » não prova que o pedido funcionou. Confirme uma chamada real.

1. O cliente apresenta uma resposta do modelo, não apenas « definições guardadas ».
2. No histórico de utilização Teapot Router, encontre o pedido com hora, modelo e chave correspondentes.
3. Na visão geral, clique em « Verificar chamada ». Se for a primeira chamada da conta, a terceira etapa muda. Caso contrário, atualize e confirme a conta.

Resolver problemas

Continua com dificuldades? Envie ao suporte o nome do cliente, o erro e a hora. Nunca envie a chave API completa.