Connecter Teapot Router à votre client

Préparez ces trois éléments

Traitez votre clé API comme un mot de passe. Ne la publiez pas dans un chat, une capture, un document ou un dépôt. Collez-la uniquement dans un client fiable.

Codex CLI : premier appel

Testez Teapot Router dans ce terminal sans modifier la configuration Codex existante. Il faut un canal et un modèle Responses actifs, ainsi qu’un solde.

1. Vérifiez le solde du vrai compte dans Facturation et préparez une clé API valide.
2. Demandez à l’administrateur d’activer un canal et un modèle compatibles avec Responses.
3. Choisissez ci-dessous la clé et le modèle, puis copiez la commande prête à lancer dans un nouveau terminal. L’aperçu masque la clé ; la commande copiée la contient.
4. Demandez à Codex de répondre OK, puis vérifiez l’appel dans Utilisation.

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

La commande n’affecte que cette session. La clé peut rester dans le presse-papiers et l’historique du terminal ; effacez-les après le test. Vérifiez NEW-API en cas d’erreur de modèle ou de canal.

Claude Code

Ces commandes configurent Claude Code uniquement dans la fenêtre de terminal actuelle. Elles ne remplacent pas vos réglages existants.

1. Si Claude Code n'est pas installé, suivez ses instructions officielles et vérifiez que la commande claude démarre.
2. Dans Teapot Router, ouvrez « Configurer le client » → Claude Code. Copiez l'adresse sans /v1, affichez votre clé et obtenez l'identifiant d'un modèle Claude disponible.
3. Ouvrez un terminal. Remplacez <TEAPOT_API_BASE_URL> et <CLAUDE_MODEL_ID> ci-dessous par vos valeurs. Exécutez les commandes, puis collez la clé quand elle est demandée et appuyez sur Entrée. La saisie reste invisible.
4. Envoyez un message court dans Claude Code, par exemple « Réponds OK ». Retrouvez ensuite la requête dans l'historique d'utilisation 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

Ces variables ne durent que pendant cette session du terminal. Pour une configuration durable, utilisez une méthode prise en charge par Claude Code et sauvegardez vos réglages avant de les modifier.

Client compatible OpenAI

Pour un client de chat avec fournisseur OpenAI personnalisé ou une application utilisant le SDK OpenAI. Les menus changent selon le client, mais les trois valeurs restent les mêmes.

1. Ouvrez les paramètres du fournisseur ou de l'API dans le client et choisissez « OpenAI compatible », « Custom OpenAI » ou une adresse personnalisée.
2. Renseignez l'adresse « Base URL » indiquée sous l'onglet compatible OpenAI de Teapot Router ; elle doit finir par /v1. Collez votre vraie clé dans « API Key ».
3. Saisissez l'identifiant complet d'un modèle autorisé pour votre clé. Enregistrez, envoyez un message court et vérifiez la requête dans 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)

Vérifier la connexion

Copier les valeurs ou cliquer sur « Client configuré » ne prouve pas qu'une requête a réussi. Vérifiez un véritable appel.

1. Le client affiche une réponse du modèle, pas seulement « paramètres enregistrés ».
2. Dans l'historique d'utilisation Teapot Router, retrouvez la requête avec la bonne heure, le bon modèle et la bonne clé.
3. Cliquez sur « Vérifier l'appel » dans l'aperçu de l'espace. S'il s'agit du premier appel du compte, la troisième étape se met à jour ; sinon, rafraîchissez et vérifiez le compte.

Résoudre un problème

Toujours bloqué ? Transmettez au support le nom du client, l'erreur et l'heure. N'envoyez jamais votre clé API complète.