> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code CLI

> Connecter Claude Code CLI à EvoLink.AI

## Aperçu

<img src="https://mintcdn.com/muyutechnology/ogYegfyiYikRHauR/images/integration-guide/image-9.png?fit=max&auto=format&n=ogYegfyiYikRHauR&q=85&s=343a46989688b9870d289bae53974074" alt="Claude Code CLI Interface" width="1692" height="517" data-path="images/integration-guide/image-9.png" />

Claude Code CLI est l'outil en ligne de commande officiel d'Anthropic pour interagir avec les modèles Claude dans le terminal.
En intégrant Claude Code CLI avec **EvoLink API**, vous pouvez accéder directement aux capacités des modèles Claude via EvoLink.

## Prérequis

Avant de configurer, assurez-vous d'avoir :

### Obtenir une clé API EvoLink

* Connectez-vous au [tableau de bord EvoLink](https://evolink.ai/dashboard)
* Trouvez les clés API dans le tableau de bord, cliquez sur le bouton "Créer une nouvelle clé", puis copiez la clé générée
* La clé API commence généralement par `sk-`

## Étape 1 : Installer Claude Code CLI

<Note>
  **Astuce :** Si vous ne savez pas comment ouvrir un terminal en ligne de commande, consultez [FAQ - Comment ouvrir un terminal en ligne de commande](#14-comment-ouvrir-un-terminal-en-ligne-de-commande)
</Note>

### 1. Installation en une commande

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    curl -fsSL https://claude.ai/install.sh | bash
    ```

    **Résultat attendu :** Vous verrez les informations de téléchargement et d'installation, se terminant par un message de succès.

    **En cas d'erreur :** `permission denied` signifie que vous devez ajouter `sudo` avant la commande.
  </Tab>

  <Tab title="Windows">
    ### 1.1 Installer Node.js et npm (Ignorer si déjà installés)

    **Première installation :**

    1. Visitez le [site officiel de Node.js](https://nodejs.org/) pour télécharger et installer (version LTS recommandée)
    2. Si vous n'êtes pas familier avec le processus d'installation, consultez le [Guide d'installation de Node.js](https://nodejs.org/fr/download/package-manager)
    3. Node.js v20 ou supérieur est recommandé

    **Vérifier l'installation :**

    ```bash theme={null}
    node -v
    npm -v
    ```

    <img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/claude-node-npm-verify.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=13be4f60f117fca3024b2b2c1d0fd208" alt="Node.js and npm version verification" width="1730" height="923" data-path="images/integration-guide/claude-node-npm-verify.png" />

    ### 1.2 Installer Claude Code CLI

    Exécutez dans PowerShell ou CMD :

    ```bash theme={null}
    npm install -g @anthropic-ai/claude-code
    ```

    **Résultat attendu :** Vous verrez les informations de téléchargement et d'installation, se terminant par un message de succès.

    **En cas d'erreur :**

    * `permission denied` : Exécutez PowerShell ou CMD en tant qu'administrateur
    * `npm command not found` : Node.js n'est pas correctement installé ou n'est pas ajouté aux variables d'environnement
  </Tab>
</Tabs>

**Remarque :** macOS/Linux utilise un script d'installation en une commande, Windows utilise l'installation via npm.

### 2. Vérifier l'installation

```bash theme={null}
claude --version
```

**Indicateur de succès :** Affiche le numéro de version (par ex., `1.x.x`).

<img src="https://mintcdn.com/muyutechnology/zYVnvTrpvj8xvjrr/images/integration-guide/image-copy.png?fit=max&auto=format&n=zYVnvTrpvj8xvjrr&q=85&s=4cc1f795f8c39d7341d942e780b0c674" alt="Claude Code CLI Version" width="1730" height="923" data-path="images/integration-guide/image-copy.png" />

## Étape 2 : Configurer l'API EvoLink

Claude Code CLI est configuré via `settings.json`.

<Tabs>
  <Tab title="CC Switch">
    [CC Switch](https://github.com/farion1231/cc-switch) est un outil de bureau avec interface graphique pour gérer la configuration des fournisseurs de Claude Code, sans avoir à modifier manuellement les fichiers de configuration.

    ### 1. Installer CC Switch

    Téléchargez le programme d'installation pour votre plateforme depuis [GitHub Releases](https://github.com/farion1231/cc-switch/releases).

    ### 2. Configurer EvoLink

    1. Ouvrez CC Switch
    2. Cliquez sur l'icône en haut à droite pour accéder à la page de configuration

    <Frame>
      <img src="https://mintcdn.com/muyutechnology/js6gY_V1bzKBWRJz/images/integration-guide/cc-switch/cc-switch-install.png?fit=max&auto=format&n=js6gY_V1bzKBWRJz&q=85&s=9b7aef4e499e4b86a939b8516c718120" alt="CC Switch Ouvrir la configuration" width="1374" height="974" data-path="images/integration-guide/cc-switch/cc-switch-install.png" />
    </Frame>

    3. Remplissez les champs comme indiqué dans l'image

    <Frame>
      <img src="https://mintcdn.com/muyutechnology/js6gY_V1bzKBWRJz/images/integration-guide/cc-switch/cc-switch-config-en.png?fit=max&auto=format&n=js6gY_V1bzKBWRJz&q=85&s=aab64a278072380cc26b2e2b3e942194" alt="CC Switch Configurer EvoLink" width="1389" height="1007" data-path="images/integration-guide/cc-switch/cc-switch-config-en.png" />
    </Frame>

    4. Cliquez sur « Ajouter »

    CC Switch écrira automatiquement la configuration dans `settings.json`, sans opération manuelle.

    <Tip>
      CC Switch prend également en charge le changement rapide depuis la barre des tâches, la gestion des serveurs MCP, la synchronisation de configuration cloud, et plus encore.
    </Tip>
  </Tab>

  <Tab title="settings.json">
    <Note>
      **Remarque :** Si c'est la première fois que vous utilisez Claude Code CLI, nous vous recommandons de commencer par "Temporaire" pour tester votre configuration avant d'utiliser cette méthode pour une configuration permanente.
    </Note>

    ### 1. Ouvrir le répertoire de configuration

    <Tabs>
      <Tab title="Windows">
        Appuyez sur `Win + R`, collez ce qui suit, puis appuyez sur Entrée :

        ```
        %userprofile%\.claude
        ```

        **Si le dossier n'existe pas** : Créez manuellement le dossier `.claude` (appuyez sur `Win + R`, tapez `%userprofile%`, appuyez sur Entrée pour ouvrir le répertoire utilisateur, puis créez un nouveau dossier nommé `.claude`).

        <img src="https://mintcdn.com/muyutechnology/hdDK-GS-iVpfdhZR/images/integration-guide/enclaudewin-r.png?fit=max&auto=format&n=hdDK-GS-iVpfdhZR&q=85&s=96f493f5552d08f86b87c50c87910c6b" alt="Windows Win+R open terminal" width="568" height="334" data-path="images/integration-guide/enclaudewin-r.png" />
      </Tab>

      <Tab title="macOS">
        Dans le Finder, appuyez sur `Command + Shift + G`, collez le chemin suivant, puis appuyez sur Entrée :

        ```
        ~/.claude
        ```

        **Si le dossier n'existe pas** : Ouvrez le Terminal et exécutez `mkdir ~/.claude` pour créer le dossier.
      </Tab>

      <Tab title="Linux">
        Ouvrez le gestionnaire de fichiers et naviguez vers :

        ```
        ~/.claude
        ```

        **Si le dossier n'existe pas** : Ouvrez le Terminal et exécutez `mkdir ~/.claude` pour créer le dossier.
      </Tab>
    </Tabs>

    ### 2. Modifier settings.json

    Dans le dossier ouvert, si `settings.json` n'existe pas, faites un clic droit dans l'espace vide → Nouveau → Document texte → Renommez en `settings.json` (supprimez l'extension `.txt`). Puis double-cliquez pour ouvrir avec un éditeur et ajoutez le contenu suivant :

    ```json theme={null}
    {
      "env": {
        "ANTHROPIC_AUTH_TOKEN": "your-evolink-api-key",
        "ANTHROPIC_BASE_URL": "https://direct.evolink.ai",
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
      },
      "permissions": {
        "allow": [],
        "deny": []
      }
    }
    ```

    **Important :**

    * **Copiez intégralement** sans oublier aucun symbole
    * Remplacez `"your-evolink-api-key"` par votre clé API réelle (conservez les guillemets)
    * N'utilisez pas de méthode de saisie chinoise pour la ponctuation

    **Options de configuration :**

    * `ANTHROPIC_AUTH_TOKEN` : Votre clé API EvoLink
    * `ANTHROPIC_BASE_URL` : `https://direct.evolink.ai` (point de terminaison de l'API EvoLink)
    * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` : Réduire les requêtes réseau non essentielles

          <img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/claude-config-env-en.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=2abc02bdf6f9734547f588f53eb9a786" alt="Claude Code CLI configuration environment" width="1264" height="848" data-path="images/integration-guide/claude-config-env-en.png" />
  </Tab>

  <Tab title="Permanent">
    <Tabs>
      <Tab title="Windows">
        **Configuration via l'interface graphique :**

        1. Faites un clic droit sur "Ce PC" → "Propriétés" → "Paramètres système avancés" → "Variables d'environnement"
        2. Dans "Variables utilisateur" ou "Variables système", créez une nouvelle variable :
           * Nom de la variable : `ANTHROPIC_BASE_URL`
           * Valeur de la variable : `https://direct.evolink.ai`
        3. Ajoutez `ANTHROPIC_AUTH_TOKEN` avec votre clé API comme valeur
        4. Cliquez sur "OK" pour enregistrer

        **Commande PowerShell :**

        ```powershell theme={null}
        [System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://direct.evolink.ai', 'User')
        [System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'your-evolink-api-key', 'User')
        ```

        **Remarque :** Redémarrez le terminal pour que les changements prennent effet.
      </Tab>

      <Tab title="macOS">
        Modifiez le fichier de configuration du shell (choisissez selon votre shell) :

        **Si vous utilisez zsh (par défaut sur macOS) :**

        ```bash theme={null}
        echo 'export ANTHROPIC_BASE_URL="https://direct.evolink.ai"' >> ~/.zshrc
        echo 'export ANTHROPIC_AUTH_TOKEN="your-evolink-api-key"' >> ~/.zshrc
        ```

        **Si vous utilisez bash :**

        ```bash theme={null}
        echo 'export ANTHROPIC_BASE_URL="https://direct.evolink.ai"' >> ~/.bash_profile
        echo 'export ANTHROPIC_AUTH_TOKEN="your-evolink-api-key"' >> ~/.bash_profile
        ```

        **Appliquer immédiatement :**

        ```bash theme={null}
        source ~/.zshrc  # ou source ~/.bash_profile
        ```
      </Tab>

      <Tab title="Linux">
        Modifiez le fichier de configuration du shell (choisissez selon votre shell) :

        **Si vous utilisez bash (courant sous Linux) :**

        ```bash theme={null}
        echo 'export ANTHROPIC_BASE_URL="https://direct.evolink.ai"' >> ~/.bashrc
        echo 'export ANTHROPIC_AUTH_TOKEN="your-evolink-api-key"' >> ~/.bashrc
        ```

        **Si vous utilisez zsh :**

        ```bash theme={null}
        echo 'export ANTHROPIC_BASE_URL="https://direct.evolink.ai"' >> ~/.zshrc
        echo 'export ANTHROPIC_AUTH_TOKEN="your-evolink-api-key"' >> ~/.zshrc
        ```

        **Appliquer immédiatement :**

        ```bash theme={null}
        source ~/.bashrc  # ou source ~/.zshrc
        ```
      </Tab>
    </Tabs>

    **Remarque** : Remplacez `your-evolink-api-key` par votre clé API réelle.
  </Tab>

  <Tab title="Temporaire">
    <Tabs>
      <Tab title="Windows">
        Dans PowerShell :

        ```powershell theme={null}
        $env:ANTHROPIC_BASE_URL="https://direct.evolink.ai"
        $env:ANTHROPIC_AUTH_TOKEN="your-evolink-api-key"
        ```

        Dans CMD :

        ```cmd theme={null}
        set ANTHROPIC_BASE_URL=https://direct.evolink.ai
        set ANTHROPIC_AUTH_TOKEN=your-evolink-api-key
        ```

        **Remarque :** La configuration expire après la fermeture du terminal.
      </Tab>

      <Tab title="macOS / Linux">
        Dans le Terminal :

        ```bash theme={null}
        export ANTHROPIC_BASE_URL="https://direct.evolink.ai"
        export ANTHROPIC_AUTH_TOKEN="your-evolink-api-key"
        ```

        **Remarque :** La configuration expire après la fermeture du terminal.
      </Tab>
    </Tabs>

    **Remarque** : Remplacez `your-evolink-api-key` par votre clé API réelle.
  </Tab>
</Tabs>

## Étape 3 : Commencer à utiliser Claude Code CLI

### 1. Accéder à un répertoire de travail sécurisé

```bash theme={null}
cd your-working-directory
```

**Remarque :** Remplacez `your-working-directory` par le chemin réel

### 2. Mode interactif

```shell theme={null}
claude
```

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/claude-interface.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=c6294e3424b61a8509244a6d65f96e2e" alt="Claude Code CLI interface" width="1730" height="923" data-path="images/integration-guide/claude-interface.png" />

### 3. Vérifier la configuration

```shell theme={null}
claude "Who are you"
```

**Indicateurs de succès :**

* Vous voyez un texte de réponse IA (plusieurs lignes)
* **Aucune** erreur du type `401`, `403`, `API Key invalid`

**Si vous voyez des erreurs :**

* `401 Unauthorized` : Clé API non définie ou invalide → Vérifiez settings.json
* `403 Forbidden` : Permissions insuffisantes de la clé API → Vérifiez la clé API
* `Network error` : Problème réseau → Vérifiez la connexion

## FAQ

### 1. Qu'est-ce que Claude Code CLI et à quoi sert-il ?

Claude Code CLI est l'outil en ligne de commande officiel d'Anthropic qui permet aux utilisateurs d'interagir avec les modèles Claude dans le terminal. Il est principalement utilisé pour l'assistance au code, la génération de texte, les conversations de questions-réponses et l'analyse de fichiers — particulièrement adapté aux développeurs qui ont besoin de capacités IA rapides dans un environnement en ligne de commande.

### 2. Comment vérifier l'installation et la configuration lors de la première utilisation ?

Exécutez ces commandes dans l'ordre :

* `claude --version` : Confirmer que Claude Code CLI est installé
* `claude "Who are you"` : Confirmer que la configuration API est correcte

### 3. Quelle est la différence entre le mode interactif et le mode commande unique ?

* **Mode interactif** : Exécutez `claude` pour entrer en conversation continue pour des interactions multi-tours, idéal pour les tâches complexes
* **Mode commande unique** : Exécutez `claude "question"` pour obtenir une seule réponse et quitter, idéal pour les requêtes rapides

### 4. Claude Code CLI lira-t-il ou téléchargera-t-il automatiquement mes fichiers et mon code locaux ?

Non. Claude Code CLI ne lit le contenu des fichiers que lorsque vous le référencez ou l'autorisez explicitement, et demandera une confirmation avant d'effectuer des opérations sensibles. Il est recommandé de l'utiliser dans un dossier de projet dédié.

### 5. Comment utiliser Claude Code CLI pour analyser ou traiter le contenu de fichiers locaux ?

En mode interactif, vous pouvez référencer des fichiers en :

* Tapant le chemin du fichier pour que Claude le lise
* Glissant des fichiers dans la fenêtre du terminal
* Copiant et collant le contenu du fichier

### 6. Claude Code CLI prend-il en charge la saisie et la sortie en chinois ?

Oui, entièrement pris en charge. Claude Code CLI prend en charge la saisie et la sortie en chinois — vous pouvez poser des questions en chinois et recevoir des réponses en chinois.

### 7. Aucune sortie après l'exécution — quelle pourrait en être la cause ?

Les causes courantes incluent :

* Problèmes de connexion réseau empêchant l'accès au serveur API
* Clé API invalide ou solde insuffisant
* Configuration incorrecte de `ANTHROPIC_BASE_URL`
* Pare-feu ou proxy bloquant les requêtes

### 8. Pourquoi mes modifications du fichier de configuration ou des variables d'environnement ne prennent-elles pas effet ?

* Redémarrez votre terminal ou fenêtre de ligne de commande
* Vérifiez que `settings.json` a une syntaxe JSON valide
* Vérifiez le chemin du fichier de configuration :
  * Windows : `C:\Users\{username}\.claude\settings.json`
  * macOS / Linux : `~/.claude/settings.json`

### 9. Quelles sont les causes des erreurs 401/403 ?

* **Erreur 401** : `ANTHROPIC_AUTH_TOKEN` non défini ou clé API invalide
* **Erreur 403** : Permissions insuffisantes de la clé API ou clé expirée
* Vérifiez que `ANTHROPIC_BASE_URL` est défini sur `https://direct.evolink.ai`

### 10. Pour quels scénarios Claude Code CLI est-il adapté ? Pour lesquels ne l'est-il pas ?

**Adapté pour :**

* Écriture, débogage et refactorisation de code
* Questions-réponses rapides dans les environnements en ligne de commande
* Analyse et traitement du contenu de fichiers
* Intégration de scripts d'automatisation

**Non adapté pour :**

* Interactions complexes nécessitant une interface graphique
* Édition collaborative en temps réel
* Traitement de fichiers en masse à grande échelle

### 11. Comment changer de modèle ?

Tapez `/model` en mode interactif pour changer de modèle.

### 12. Quels modèles Claude EvoLink prend-il en charge ?

EvoLink prend en charge les modèles Claude suivants :

| Nom du modèle                | Description    |
| ---------------------------- | -------------- |
| `claude-haiku-4-5-20251001`  | Réponse rapide |
| `claude-sonnet-4-5-20250929` | Équilibré      |
| `claude-opus-4-5-20251101`   | Avancé         |
| `claude-fable-5`             | Dernier        |
| `claude-opus-4-8`            | Dernier        |
| `claude-opus-4-7`            | Dernier        |
| `claude-opus-4-6`            | Avancé         |

### 13. Comment télécharger des images ?

* Option 1 : Référencer le chemin de l'image
* Option 2 : Glisser-déposer une image dans le terminal
* Option 3 : Coller une image directement

Toutes les méthodes nécessitent une action de l'utilisateur — Claude Code CLI ne lira ni ne téléchargera automatiquement les images locales.

### 14. Comment ouvrir un terminal en ligne de commande ?

<Tabs>
  <Tab title="Windows">
    * Méthode 1 : Appuyez sur `Win + R`, tapez `cmd` ou `powershell`, puis appuyez sur Entrée
    * Méthode 2 : Recherchez "Invite de commandes" ou "PowerShell" dans le menu Démarrer
    * Méthode 3 : Maintenez Shift et faites un clic droit dans un dossier, sélectionnez "Ouvrir une fenêtre PowerShell ici"
  </Tab>

  <Tab title="macOS">
    * Méthode 1 : Appuyez sur `Command + Space` pour ouvrir Spotlight, tapez `Terminal`, puis appuyez sur Entrée
    * Méthode 2 : Allez dans "Applications" → "Utilitaires" → "Terminal"
  </Tab>

  <Tab title="Linux">
    * Méthode 1 : Appuyez sur le raccourci `Ctrl + Alt + T`
    * Méthode 2 : Recherchez "Terminal" dans le menu des applications
  </Tab>
</Tabs>

## Remarques

<Warning>
  Exécutez Claude Code CLI dans un dossier de projet dédié. Évitez de l'exécuter dans des répertoires sensibles (tels que les dossiers système ou les répertoires contenant des identifiants). Claude Code CLI opère à partir du répertoire de travail actuel.
</Warning>

<Tip>
  Si vous vous êtes précédemment connecté avec un compte officiel, effacez la variable d'environnement `ANTHROPIC_AUTH_TOKEN` ou remplacez-la dans `settings.json`.
</Tip>