> ## Documentation Index > Fetch the complete documentation index at: https://docs.harogo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Claude Code > Ce guide vous permet de prendre en main Claude Code avec Harogo en quelques minutes. > [!NOTE] > > **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](https://docs.harogo.ai/fr/codex.md). ### 1. Installer Claude Code #### Installation locale ```shellscript macOS theme={null} curl -fsSL https://claude.ai/install.sh | bash ``` ```shellscript Windows theme={null} irm https://claude.ai/install.ps1 | iex ``` #### Installation via npm Nécessite [Node.js 18 ou une version ultérieure](https://nodejs.org/en/download/) ```shellscript theme={null} npm install -g @anthropic-ai/claude-code ``` ### 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](https://console.harogo.ai/keys) 3. Définissez `ANTHROPIC_MODEL` sur un modèle Claude pris en charge par Harogo, par exemple `claude-sonnet-5`. > [tab] macOS > > 1. Exécutez la commande suivante dans votre terminal pour vérifier votre shell par défaut. > > ```shellscript theme={null} > echo $SHELL > ``` > > 2. Définissez les variables d'environnement selon votre type de shell : > > ```shellscript Zsh theme={null} > # Remplacez par la vraie clé obtenue sur votre plateforme Harogo > echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.zshrc > echo 'export ANTHROPIC_AUTH_TOKEN=""' >> ~/.zshrc > echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.zshrc > ``` > > ```shellscript Bash theme={null} > # Remplacez par la vraie clé obtenue sur votre plateforme Harogo > echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.bash_profile > echo 'export ANTHROPIC_AUTH_TOKEN=""' >> ~/.bash_profile > echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.bash_profile > ``` > > 3. Exécutez la commande suivante dans votre terminal pour appliquer les variables d'environnement. > > ```shellscript Zsh theme={null} > source ~/.zshrc > ``` > > ```shellscript Bash theme={null} > source ~/.bash_profile > ``` > > 4. Ouvrez un nouveau terminal et exécutez les commandes suivantes pour vérifier que les variables d'environnement sont bien prises en compte. > > ```shellscript theme={null} > echo $ANTHROPIC_BASE_URL > test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set" > echo $ANTHROPIC_MODEL > ``` > [tab] Windows > > Sous Windows, vous pouvez définir l'URL de base et la [clé API](https://console.harogo.ai/keys) de Harogo comme variables d'environnement avec CMD ou PowerShell. > > > [tab] CMD > > > > 1. Exécutez la commande suivante dans CMD pour définir les variables d'environnement. > > > > ```shellscript theme={null} > > REM Remplacez par la vraie clé obtenue sur votre plateforme Harogo > > setx ANTHROPIC_AUTH_TOKEN "" > > setx ANTHROPIC_BASE_URL "https://api.harogo.ai" > > setx ANTHROPIC_MODEL "claude-sonnet-5" > > ``` > > > > 2. Ouvrez une nouvelle fenêtre CMD et exécutez les commandes suivantes pour vérifier que les variables d'environnement sont bien prises en compte. > > > > ```shellscript theme={null} > > if defined ANTHROPIC_AUTH_TOKEN echo ANTHROPIC_AUTH_TOKEN is set > > echo %ANTHROPIC_BASE_URL% > > echo %ANTHROPIC_MODEL% > > ``` > > > [tab] PowerShell > > > > 1. Exécutez la commande suivante dans PowerShell pour définir les variables d'environnement. > > > > ```shellscript theme={null} > > # Remplacez par la vraie clé obtenue sur votre plateforme Harogo > > [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "", [EnvironmentVariableTarget]::User) > > [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.harogo.ai", [EnvironmentVariableTarget]::User) > > [Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-5", [EnvironmentVariableTarget]::User) > > ``` > > > > 2. Ouvrez une nouvelle fenêtre PowerShell et exécutez les commandes suivantes pour vérifier que les variables d'environnement sont bien prises en compte. > > > > ```shellscript theme={null} > > if ($env:ANTHROPIC_AUTH_TOKEN) { "ANTHROPIC_AUTH_TOKEN is set" } > > echo $env:ANTHROPIC_BASE_URL > > echo $env:ANTHROPIC_MODEL > > ``` > [!NOTE] > > 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. ```bash macOS/Linux theme={null} curl https://api.harogo.ai/v1/messages \ -H "content-type: application/json" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \ -d '{ "model": "claude-sonnet-5", "max_tokens": 16, "messages": [{"role": "user", "content": "1+1, output only the answer"}] }' ``` ```powershell Windows theme={null} curl.exe https://api.harogo.ai/v1/messages ` -H "content-type: application/json" ` -H "anthropic-version: 2023-06-01" ` -H "x-api-key: $env:ANTHROPIC_AUTH_TOKEN" ` -d "{\"model\":\"claude-sonnet-5\",\"max_tokens\":16,\"messages\":[{\"role\":\"user\",\"content\":\"1+1, output only the answer\"}]}" ``` ### 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. ```bash theme={null} $ cd /path/your-project > claude ``` 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](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/cc-7.avif?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=80bd9b41f8af28fa7679659117d6266c) 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` ```json theme={null} { "hasCompletedOnboarding": true } ``` 3. 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 ` pour changer de modèle. Pratique pour un changement ponctuel. ```text theme={null} /model claude-sonnet-5 ``` 2. **Au lancement de Claude Code :** exécutez `claude --model ` pour indiquer un modèle. Pratique pour une seule session. ```text theme={null} claude --model claude-sonnet-5 ``` 3. **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. ```shellscript theme={null} export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5" export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5" export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5" ``` 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. 4. **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](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/1.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=3a0a45652c18bbabd158f7e3a17a8dce) 2. 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](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_16.51.01.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=2d63af589968a3f94173587919cbf9a2) 3. Renseignez le nom du fournisseur, la clé API, l'endpoint ([https://api.harogo.ai](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](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_16.55.17.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=37caaae4e1ccd895dbe089f656e55751) 4. 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](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.00.16.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=78acb5f499057ae22c6e97c4d770f499) > ![Vérification de la configuration du modèle avec les commandes status et models dans le terminal Claude Code](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.03.17.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=192f4da074881e069682f2c9da8b3cd9) > > ![I Shot 2026 08 07 17 04 52](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.04.52.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=a8f4c213e6115c8c874979a1d7b0c388) > > 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é. > [!WARNING] > > 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=` 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. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.