Configuration Claude

1. Qu’est-ce que Claude Code ?

Claude Code est l’agent de codage en terminal fourni officiellement par Anthropic. Il peut comprendre le code dans un projet local, modifier des fichiers et exécuter des commandes. Il peut aussi être utilisé avec VS Code, JetBrains et d’autres IDE.

Lorsque vous utilisez Claude Code via RouteAPI, vous continuez essentiellement à utiliser le protocole Anthropic, mais les requêtes de Claude Code sont envoyées vers votre point d’accès RouteAPI. Cela facilite la gestion unifiée des clés, des crédits et des modèles disponibles.

Avant de commencer, préparez :

Un terminal accessible et fonctionnel
Claude Code CLI installé
L’adresse de votre site RouteAPI
Votre clé RouteAPI
Un ID de modèle au protocole Claude disponible dans la console RouteAPI

2. Étape 1 : installer Claude Code

Installer la CLI

Sous macOS / Linux / WSL, vous pouvez exécuter directement :

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

Sous Windows PowerShell, vous pouvez exécuter :

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

Si vous installez dans un environnement Windows natif, il faut généralement préparer Git for Windows à l’avance.

Vérifier l’installation

claude --version

Si un numéro de version s’affiche, la CLI est installée correctement.

3. Étape 2 : configurer RouteAPI

Claude Code peut lire le point d’accès et la clé depuis les variables d’environnement. Pour que le terminal et l’IDE partagent la même configuration, il est recommandé d’écrire ces variables dans settings.json.

3.1 Trouver le fichier de configuration

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

3.2 Écrire les informations d’accès RouteAPI

{
  "env": {
"ANTHROPIC_BASE_URL": "https://www.routeapi.ai/",
"ANTHROPIC_AUTH_TOKEN": "votre clé RouteAPI"
  }
}

Dans cette configuration :

ANTHROPIC_BASE_URL : renseignez l’adresse racine de votre site RouteAPI, généralement sans /v1.
ANTHROPIC_AUTH_TOKEN : renseignez votre clé RouteAPI, adaptée aux accès de passerelle avec authentification Bearer Token.

Si vous voulez seulement tester temporairement, vous pouvez aussi définir les variables directement dans la session de terminal courante. Choisissez les commandes selon votre Shell.

Si vous utilisez bash, zsh ou sh sous macOS / Linux / WSL :

export ANTHROPIC_BASE_URL="https://votre-domaine-routeapi"
export ANTHROPIC_AUTH_TOKEN="votre clé RouteAPI"

Si vous utilisez Windows PowerShell :

$env:ANTHROPIC_BASE_URL="https://votre-domaine-routeapi"
$env:ANTHROPIC_AUTH_TOKEN="votre clé RouteAPI"

Après la configuration, il est généralement plus fiable d’ouvrir une nouvelle fenêtre de terminal avant de lancer claude.

4. Étape 3 : choisir votre modèle

Claude Code propose deux méthodes courantes de sélection du modèle.

Méthode A : fixer un modèle par défaut

Si vous souhaitez que toutes les sessions utilisent par défaut le même modèle, définissez directement ANTHROPIC_MODEL :

{
  "env": {
"ANTHROPIC_BASE_URL": "https://votre-domaine-routeapi",
"ANTHROPIC_AUTH_TOKEN": "votre clé RouteAPI",
"ANTHROPIC_MODEL": "ID de modèle disponible dans la console"
  }
}

Cette méthode est la plus simple et convient aux équipes qui veulent désigner un modèle par défaut unique.

Méthode B : conserver les trois niveaux Opus / Sonnet / Haiku

Si vous souhaitez continuer à utiliser la sélection par niveaux dans Claude Code, vous pouvez définir les modèles par défaut pour les trois niveaux :

{
  "env": {
"ANTHROPIC_BASE_URL": "https://votre-domaine-routeapi",
"ANTHROPIC_AUTH_TOKEN": "votre clé RouteAPI",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "votre ID de modèle haute performance",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "votre ID de modèle principal",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "votre ID de modèle léger"
  }
}

Une fois la configuration terminée, lancez Claude Code :

claude

Puis saisissez dans la session :

/model

Vous pourrez choisir dans Claude Code le niveau de modèle à utiliser pour la session courante.