Claude Code

Claude Code sait passer par une passerelle à la place du compte claude.ai : il lit l’adresse de l’API et la clé dans deux variables d’environnement. Une fois configuré, tu l’utilises exactement comme d’habitude.

Ce qu’il te faut

• Une clé Kloria, idéalement dédiée à Claude Code (voir Démarrage rapide).
• macOS 13+, Windows 10+ ou une distribution Linux récente.

Configuration

1. Installe Claude Code

   macOS / Linux

   curl -fsSL https://claude.ai/install.sh | bash

   Windows (PowerShell)

   irm https://claude.ai/install.ps1 | iex

   Git for Windows est recommandé pour que Claude Code puisse utiliser Bash. Sans lui, il utilise PowerShell.

   Ouvre un nouveau terminal et vérifie avec claude --version. Si tu l’as déjà installé, passe à l’étape suivante.

2. Déclare Kloria dans les réglages de Claude Code

   Ouvre (ou crée) le fichier de réglages utilisateur :

   • macOS / Linux : ~/.claude/settings.json
   • Windows : %USERPROFILE%\.claude\settings.json

   Ajoute le bloc env suivant, avec ta clé à la place de sk-… :

   ~/.claude/settings.json

   {
     "env": {
       "ANTHROPIC_BASE_URL": "https://api.kloria.dev",
       "ANTHROPIC_AUTH_TOKEN": "sk-…",
       "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
       "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
       "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5"
     }
   }

   Si le fichier contient déjà d’autres réglages, ajoute seulement la clé env à côté d’eux.

3. Lance Claude Code et vérifie

   Dans le dossier de ton projet :

   claude

   Tape /status : la ligne Anthropic base URL doit afficher https://api.kloria.dev, et une ligne Auth token doit mentionner ANTHROPIC_AUTH_TOKEN. Ferme le menu et envoie un message : une réponse normale confirme que tout passe par Kloria.

Pourquoi ces variables

Variable	Rôle
ANTHROPIC_BASE_URL	Envoie les requêtes à Kloria au lieu d’Anthropic. Sans /v1 : Claude Code l’ajoute lui-même.
ANTHROPIC_AUTH_TOKEN	Ta clé Kloria, envoyée dans l’en-tête Authorization: Bearer. Elle prend le pas sur une connexion claude.ai existante.
ANTHROPIC_DEFAULT_OPUS_MODEL	Le modèle utilisé quand tu choisis « Opus » dans /model.
ANTHROPIC_DEFAULT_SONNET_MODEL	Le modèle utilisé pour « Sonnet », le choix par défaut.
ANTHROPIC_DEFAULT_HAIKU_MODEL	Le modèle utilisé pour « Haiku » et pour les tâches de fond (titres de session, résumés).

Pourquoi Haiku pointe vers Sonnet

Kloria ne propose pas de modèle Haiku. Sans ce réglage, les tâches de fond de Claude Code demanderaient un modèle indisponible et échoueraient. On les redirige vers claude-sonnet-5, le modèle Claude le moins cher de la grille. Ces tâches consomment des crédits, en petite quantité.

Changer de modèle

• Pendant une session : /model, puis choisis Opus ou Sonnet. Les alias sont traduits par les variables ci-dessus.
• Au lancement : claude --model claude-opus-5-5.
• Pour une session ponctuelle, tu peux aussi définir ANTHROPIC_MODEL avec l’identifiant voulu.

Les identifiants disponibles sont sur la page Modèles et tarifs.

Garder la clé hors du fichier de réglages

Si tu préfères ne pas écrire la clé dans settings.json, laisse ANTHROPIC_BASE_URL et les modèles dans le fichier, retire ANTHROPIC_AUTH_TOKEN, et exporte-la dans ton shell avant de lancer claude :

macOS / Linux

read -s ANTHROPIC_AUTH_TOKEN && export ANTHROPIC_AUTH_TOKEN
claude

Windows (PowerShell)

$s = Read-Host "Clé Kloria" -AsSecureString
$env:ANTHROPIC_AUTH_TOKEN = [System.Net.NetworkCredential]::new("", $s).Password
claude

Une variable exportée dans le shell ne vaut que pour ce terminal et les programmes lancés depuis lui. Ne mets jamais la clé dans le .claude/settings.json d’un projet : ce fichier est partagé avec le dépôt.

Ce qui change par rapport à un compte claude.ai

Via une passerelle, Claude Code désactive les fonctions liées à un compte claude.ai : Remote Control, la dictée vocale et le mode rapide (/fast). Le reste (agents, MCP, hooks, plugins, mode plan) fonctionne normalement.

Ta connexion claude.ai, si tu en as une, reste enregistrée mais n’est plus utilisée tant que ANTHROPIC_AUTH_TOKEN est défini. Retire la variable pour revenir à ton compte.

Options utiles

Variable	Quand l’ajouter
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS = 1	Si tu obtiens des erreurs 400 qui mentionnent anthropic-beta, context_management ou « Extra inputs are not permitted ».
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = 1	Pour couper la télémétrie et les vérifications de version. Désactive aussi les mises à jour automatiques : pense à lancer claude update de temps en temps.
CLAUDE_CODE_SUBAGENT_MODEL	Pour imposer un modèle aux sous-agents, par exemple claude-sonnet-5 pendant que la session principale tourne sur Opus.

Toutes ces variables se placent dans le même bloc env du fichier de réglages.

Ça ne marche pas ?

Symptôme	Piste
Claude Code demande de te connecter à claude.ai	La clé n’est pas lue. Vérifie que ANTHROPIC_AUTH_TOKEN est dans ~/.claude/settings.json (pas dans un fichier de projet) et que le JSON est valide : claude doctor le signale.
/status n’affiche pas api.kloria.dev	ANTHROPIC_BASE_URL n’est pas pris en compte. Même vérification que ci-dessus.
Erreur 401	Clé invalide, désactivée ou expirée. Vérifie-la dans la console, ou crée-en une nouvelle.
Erreur 403 avec « quota »	Solde ou quota de la clé épuisé. Voir Crédits et facturation.
Avertissement au démarrage sur deux sources d’authentification	Une connexion claude.ai existe en plus de la clé. /logout la retire, la clé Kloria reste.

D’autres cas sur la page Dépannage.