Conecta Teapot Router con tu cliente

Prepara estas tres cosas

Tu clave API es como una contraseña. No la compartas en chats, capturas, documentos ni repositorios públicos; pégala solo en clientes de confianza.

Codex CLI: primera llamada

Prueba Teapot Router en esta terminal sin cambiar tu configuración actual de Codex. Necesitas un canal y modelo Responses activos y saldo en la cuenta.

1. Comprueba el saldo de la cuenta real y prepara una clave API válida.
2. Pide al administrador que active un canal y modelo compatibles con Responses.
3. Elige abajo la clave y el modelo; copia el comando listo para una terminal nueva. La vista previa oculta la clave, pero el comando copiado la incluye.
4. Pide a Codex que responda OK y comprueba la solicitud en Uso.

(
  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}"
)

El comando afecta solo a esta sesión. La clave puede quedar en el portapapeles y el historial de la terminal; bórralos después. Revisa NEW-API si falla el modelo o el canal.

Claude Code

Estos comandos configuran Claude Code solo en la sesión actual de la terminal y no reemplazan tus ajustes existentes.

1. Si aún no tienes Claude Code, sigue sus instrucciones oficiales de instalación y comprueba que el comando claude se inicia.
2. En Teapot Router, abre « Configurar cliente » → Claude Code. Copia la dirección sin /v1, muestra tu clave y obtén el ID de un modelo Claude disponible.
3. Abre una terminal. Sustituye <TEAPOT_API_BASE_URL> y <CLAUDE_MODEL_ID> por tus valores. Ejecuta los comandos, pega la clave cuando se solicite y pulsa Intro. No verás los caracteres al escribir.
4. Envía un mensaje breve en Claude Code, por ejemplo « Responde OK ». Después busca la solicitud en el historial de uso de 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

Estas variables solo duran durante esta sesión. Para una configuración permanente, usa un método admitido por Claude Code y guarda una copia de tus ajustes antes de modificarlos.

Cliente compatible con OpenAI

Para aplicaciones de chat con proveedor OpenAI personalizado o aplicaciones con el SDK de OpenAI. Los menús cambian, pero los tres valores son los mismos.

1. Abre los ajustes de proveedor o API y elige « OpenAI compatible », « Custom OpenAI » o un endpoint personalizado.
2. En « Base URL », pega la dirección de la pestaña OpenAI compatible de Teapot Router, terminada en /v1. En « API Key », pega la clave real que has mostrado.
3. Introduce el ID completo de un modelo permitido para la clave. Guarda, envía un mensaje corto y comprueba la solicitud en 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)

Comprobar la conexión

Copiar los datos o marcar « Cliente configurado » no demuestra que haya funcionado. Comprueba una solicitud real.

1. El cliente muestra una respuesta del modelo, no solo « configuración guardada ».
2. En el historial de uso de Teapot Router, encuentra la solicitud con la hora, el modelo y la clave correspondientes.
3. En el resumen del panel, pulsa « Comprobar solicitud ». Si es la primera de la cuenta, avanzará el tercer paso; si no, actualiza y confirma la cuenta.

Solucionar problemas

¿Sigues atascado? Envía a soporte el nombre del cliente, el error y la hora. Nunca envíes la clave API completa.