Passer au contenu principal
Ce guide utilise uniquement les modèles Claude. Claude Code peut exécuter les modèles Claude (Claude Opus 5.5, Claude Sonnet 5.5, Claude Sonnet 5, Claude Fable 5.1, Claude Haiku 5.5) ainsi que les modèles sans restriction de client (GLM, Qwen, Kimi, MiniMax, DeepSeek). Les modèles GPT ne sont pas disponibles dans Claude Code — voir Codex.

1. Installer Claude Code

Installation locale

Installation via npm

Nécessite Node.js 18 ou une version ultérieure

2. Configurer l’API Harogo

Pour vous connecter au service de modèles de Harogo via l’API compatible Anthropic, définissez les variables d’environnement suivantes.
  1. Définissez ANTHROPIC_BASE_URL sur https://api.harogo.ai/
  2. Définissez ANTHROPIC_AUTH_TOKEN sur la clé API obtenue sur la plateforme Harogo
  3. Définissez ANTHROPIC_MODEL sur un modèle Claude pris en charge par Harogo, par exemple claude-sonnet-5.
  1. Exécutez la commande suivante dans votre terminal pour vérifier votre shell par défaut.
  1. Définissez les variables d’environnement selon votre type de shell :
  1. Exécutez la commande suivante dans votre terminal pour appliquer les variables d’environnement.
  1. Ouvrez un nouveau terminal et exécutez les commandes suivantes pour vérifier que les variables d’environnement sont bien prises en compte.
Si vous prévoyez de gérer Claude Code avec CC Switch, nous vous recommandons de ne pas définir en plus des valeurs globales pour ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL ou ANTHROPIC_MODEL. Les variables d’environnement système ou utilisateur peuvent écraser la configuration de fournisseur écrite par CC Switch : l’interface affiche alors le bon fournisseur sélectionné, alors que Claude Code utilise en réalité encore une ancienne clé ou un ancien modèle.

3. Vérifier la configuration

Après avoir configuré les variables d’environnement ou CC Switch, envoyez d’abord une requête minimale pour vérifier que la clé, le modèle et l’endpoint compatible Anthropic fonctionnent, avant de lancer une session plus longue.

4. Commencer à utiliser Claude Code

Une fois la configuration terminée, placez-vous dans votre répertoire de travail et exécutez la commande claude dans votre terminal pour commencer.
Si Not logged in · Please run /login s’affiche au démarrage, ou si vous êtes redirigé vers le processus de connexion d’Anthropic, cela signifie généralement que Claude Code n’a pas trouvé de configuration Harogo fonctionnelle, ou que la configuration initiale n’a pas été terminée. Vérifiez d’abord que la requête minimale de l’étape précédente renvoie 2, et que ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL ou ANTHROPIC_MODEL ne sont pas écrasées par d’anciennes variables d’environnement globales. Si la clé fonctionne et que vous êtes toujours redirigé vers la connexion, vous pouvez ignorer la configuration initiale en suivant les étapes ci-dessous : Terminal affichant l'invite de connexion ou de poursuite au premier lancement de Claude Code Terminal affichant l'invite de connexion ou de poursuite au premier lancement de Claude Code
  1. Repérez le fichier .claude.json dans votre répertoire personnel :
    • macOS / Linux : ~/.claude.json
    • Windows : C:\Users\%USERNAME%\.claude.json
  2. Définissez le champ hasCompletedOnboarding sur true
  1. Enregistrez le fichier, puis exécutez à nouveau claude dans votre terminal.

(Facultatif) Autres façons de configurer le modèle

Claude Code permet de configurer le modèle des manières suivantes, classées par priorité décroissante : un réglage de priorité plus élevée remplace un réglage de priorité plus faible.
  1. Pendant une conversation : exécutez la commande /model <model-name> pour changer de modèle. Pratique pour un changement ponctuel.
  1. Au lancement de Claude Code : exécutez claude --model <model-name> pour indiquer un modèle. Pratique pour une seule session.
  1. Définir des variables d’environnement : configurez différents niveaux de modèles selon la complexité des tâches, et Claude Code choisira automatiquement le modèle adapté. S’applique globalement.
Où :
  • ANTHROPIC_DEFAULT_OPUS_MODEL : pour le raisonnement complexe, la conception d’architecture et les autres tâches difficiles.
  • ANTHROPIC_DEFAULT_SONNET_MODEL : pour l’écriture de code, l’implémentation de fonctionnalités et les autres tâches courantes.
  • ANTHROPIC_DEFAULT_HAIKU_MODEL : pour les vérifications de syntaxe, la recherche de fichiers et les autres tâches simples.
  1. Définir de façon permanente dans settings.json : écrivez la configuration du modèle dans le fichier de configuration utilisateur de Claude Code (par ex. ~/.claude/settings.json, ou C:\Users\%USERNAME%\.claude\settings.json sous Windows) ou dans une configuration au niveau du projet, pour un réglage permanent au niveau utilisateur ou projet.

Configuration via CC Switch

  1. Lancez CC Switch, sélectionnez Claude Code à gauche, puis cliquez sur « Ajouter un fournisseur » (Add Provider).
Point d'accès Ajouter un fournisseur sur l'écran d'accueil de CC Switch Point d'accès Ajouter un fournisseur sur l'écran d'accueil de CC Switch
  1. Dans la liste des préréglages, choisissez « Configuration personnalisée » (Custom Configuration) comme fournisseur.
Sélection de Custom Configuration dans la liste des préréglages de fournisseurs de CC Switch Sélection de Custom Configuration dans la liste des préréglages de fournisseurs de CC Switch
  1. Renseignez le nom du fournisseur, la clé API, l’endpoint (https://api.harogo.ai), etc. Une fois tous les champs remplis, cliquez sur « Ajouter » (Add).
Saisie de la clé API dans le formulaire de configuration du fournisseur de CC Switch Saisie de la clé API dans le formulaire de configuration du fournisseur de CC Switch
  1. De retour sur l’écran d’accueil, sélectionnez « harogo » dans la liste des fournisseurs et cliquez sur « Utiliser » (Use).
Sélection de harogo et clic sur Use sur l'écran d'accueil de CC Switch Sélection de harogo et clic sur Use sur l'écran d'accueil de CC Switch
Vérification de la configuration du modèle avec les commandes status et models dans le terminal Claude CodeVérification de la configuration du modèle avec les commandes status et models dans le terminal Claude Code
I Shot 2026 08 07 17 04 52
Astuce : une fois Claude Code ouvert dans votre terminal, tapez /status pour vérifier l’ID du modèle, ou /models pour choisir un autre modèle configuré.
Si CC Switch affiche « Conflit de variables d’environnement système détecté » (System environment variable conflict detected), traitez d’abord ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL et ANTHROPIC_MODEL. Ces variables globales écrasent la configuration du fournisseur actuel : une valeur fictive comme ANTHROPIC_AUTH_TOKEN=<HAROGO_API_KEY> fera directement échouer l’authentification. Une fois certain de ne plus avoir besoin des variables globales, supprimez les entrées en conflit dans CC Switch, ou supprimez manuellement les variables d’environnement système/utilisateur et redémarrez votre terminal.