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

# Guide du terminal pour les nouveaux utilisateurs

> Un guide étape par étape pour installer Claude Code pour les utilisateurs du terminal débutants sur macOS et Windows.

Vous pouvez utiliser Claude Code même si vous n'avez jamais utilisé un terminal auparavant. Ce guide vous explique comment ouvrir un terminal, installer Claude Code et vos premières interactions.

* [macOS et Linux](#macos-and-linux)
* [Windows](#windows)

<Note>
  Vous ne voulez pas utiliser le terminal ? L'application de bureau Claude Code vous permet de contourner entièrement le terminal. Téléchargez-la pour [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs), [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) ou [Linux](https://claude.com/download?utm_source=claude_code\&utm_medium=docs), puis consultez le [guide de démarrage rapide pour le bureau](/fr/desktop-quickstart) pour commencer.
</Note>

<h2 id="macos-and-linux">
  macOS et Linux
</h2>

Suivez ces étapes pour installer et démarrer Claude Code à partir d'un terminal macOS ou Linux. Claude Code nécessite macOS 13.0 ou une version ultérieure. Consultez la [configuration requise](/fr/setup#system-requirements) pour les distributions Linux prises en charge.

<Steps>
  <Step title="Ouvrir un terminal">
    **macOS** : Appuyez sur `Cmd + Space` pour ouvrir Spotlight Search, tapez `Terminal` et appuyez sur `Entrée`.

    **Linux** : Ouvrez votre application de terminal. Sur la plupart des distributions, appuyez sur `Ctrl + Alt + T` ou recherchez ' Terminal ' dans votre menu d'applications.

    Une fenêtre apparaîtra avec un curseur clignotant. C'est votre terminal, où vous tapez des commandes.
  </Step>

  <Step title="Installer Claude Code">
    Copiez cette ligne, collez-la dans votre terminal (`Cmd + V` sur macOS, `Ctrl + Maj + V` sur Linux) et appuyez sur `Entrée` :

    ```bash theme={null}
    curl -fsSL https://claude.ai/install.sh | bash
    ```

    Cela télécharge et exécute le programme d'installation de Claude Code à partir de claude.ai. Vous verrez du texte défiler pendant qu'il fonctionne. Lorsque c'est terminé, vous verrez « Claude Code successfully installed! ». Si vous voyez une erreur à la place, consultez la [section dépannage](#macos-and-linux-troubleshooting) ci-dessous.
  </Step>

  <Step title="Démarrer Claude Code">
    Tapez `claude` et appuyez sur `Entrée` :

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

    Vous serez invité à [vous connecter](/fr/authentication) avec votre compte Claude. Suivez les instructions à l'écran. Une fenêtre de navigateur s'ouvrira pour vous permettre de vous connecter.
  </Step>

  <Step title="Commencer à utiliser Claude Code">
    Une fois connecté, vous pouvez commencer à poser des questions à Claude sur votre code ou n'importe quoi d'autre. Claude Code s'exécute entièrement en texte. Vous tapez des messages et appuyez sur `Entrée` pour les envoyer. Quelques points à connaître :

    * Vous ne pouvez pas cliquer sur les choses dans le terminal. Utilisez les touches fléchées pour vous déplacer.
    * Appuyez sur `Échap` pour interrompre Claude s'il est en cours d'exécution.
    * Tapez `exit` ou appuyez sur `Ctrl + D` pour quitter Claude Code.
    * Tapez `/help` pour voir les commandes disponibles.
  </Step>
</Steps>

***

<h2 id="windows">
  Windows
</h2>

Suivez ces étapes pour installer optionnellement Git pour Windows, configurer PowerShell et démarrer Claude Code sur Windows. Claude Code nécessite Windows 10 version 1809 ou ultérieure. Consultez la [configuration requise](/fr/setup#system-requirements) pour plus de détails.

<Steps>
  <Step title="Installer Git pour Windows (optionnel)">
    Git pour Windows fournit Git Bash, qui active l'outil Bash. Sans cela, Claude Code utilise PowerShell à la place. Vous n'aurez pas besoin d'apprendre Git vous-même.

    Si vous ne l'avez pas déjà :

    1. Allez sur [git-scm.com/downloads/win](https://git-scm.com/downloads/win) et téléchargez le programme d'installation
    2. Exécutez le programme d'installation. Cliquez sur Suivant sur chaque écran pour accepter les paramètres par défaut. Le programme d'installation a de nombreux écrans, mais vous n'avez besoin de rien modifier.
    3. S'il vous demande de choisir un éditeur, conservez la valeur par défaut et cliquez sur Suivant.
    4. Lorsque vous voyez ' Adjusting your PATH environment ', conservez l'option recommandée sélectionnée.

    <Note>
      Vous avez déjà Git ? Vous pouvez ignorer cette étape. Si vous n'êtes pas sûr, installez-le quand même. La réinstallation ne causera pas de problèmes.
    </Note>
  </Step>

  <Step title="Ouvrir PowerShell">
    PowerShell est le terminal intégré de Windows pour taper des commandes. Il est préinstallé sur tous les ordinateurs Windows.

    Appuyez sur `Win + X` et sélectionnez **Windows PowerShell** (ou **Terminal**) dans le menu. Une fenêtre avec un curseur clignotant apparaîtra. C'est là que vous taperez les commandes.

    <Note>
      Windows a deux programmes de ligne de commande : PowerShell et CMD. Ils se ressemblent mais utilisent des commandes différentes. Assurez-vous que vous êtes dans PowerShell pour l'étape suivante.

      Comment savoir dans lequel vous êtes :

      * **PowerShell** : affiche `PS C:\Users\YourName>` au début de chaque ligne
      * **CMD** : affiche `C:\Users\YourName>` sans le `PS`
    </Note>
  </Step>

  <Step title="Installer Claude Code">
    Copiez cette ligne, collez-la dans PowerShell avec `Ctrl + V` ou clic droit, et appuyez sur `Entrée` :

    ```powershell theme={null}
    irm https://claude.ai/install.ps1 | iex
    ```

    Cela télécharge et exécute le programme d'installation de Claude Code. `irm` récupère le fichier et `iex` l'exécute. Vous verrez du texte défiler pendant qu'il fonctionne. Lorsque c'est terminé, vous verrez ' Claude Code successfully installed! '. Si vous voyez une erreur à la place, consultez la [section dépannage](#windows-troubleshooting) ci-dessous.

    <Note>
      Si vous êtes dans CMD au lieu de PowerShell, utilisez cette commande :

      ```batch theme={null}
      curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
      ```
    </Note>
  </Step>

  <Step title="Démarrer Claude Code">
    Exécutez `claude`. Si PowerShell dit `'claude' is not recognized`, le répertoire d'installation n'est pas encore sur votre PATH. Suivez la correction [« claude is not recognized »](#windows-troubleshooting) ci-dessous, puis ouvrez une nouvelle fenêtre PowerShell et réessayez.

    ```powershell theme={null}
    claude
    ```

    Vous serez invité à [vous connecter](/fr/authentication) avec votre compte Claude. Suivez les instructions à l'écran. Une fenêtre de navigateur s'ouvrira pour vous permettre de vous connecter.
  </Step>

  <Step title="Commencer à utiliser Claude Code">
    Une fois connecté, vous pouvez commencer à poser des questions à Claude sur votre code ou n'importe quoi d'autre. Claude Code s'exécute entièrement en texte. Vous tapez des messages et appuyez sur `Entrée` pour les envoyer. Quelques points à connaître :

    * Vous ne pouvez pas cliquer sur les choses dans le terminal. Utilisez les touches fléchées pour vous déplacer.
    * Appuyez sur `Échap` pour interrompre Claude s'il est en cours d'exécution.
    * Tapez `exit` ou appuyez sur `Ctrl + D` pour quitter Claude Code.
    * Tapez `/help` pour voir les commandes disponibles.
  </Step>
</Steps>

***

<h2 id="what’s-next">
  Et ensuite ?
</h2>

Une fois que vous voyez l'écran de bienvenue de Claude Code, vous êtes prêt à commencer. Vous n'avez pas besoin de savoir coder. Décrivez ce que vous voulez en anglais simple, et Claude écrit le code pour vous.

<h3 id="build-something">
  Créer quelque chose
</h3>

Claude peut créer des projets à partir d'une description :

```text theme={null}
make me a simple webpage that says hello world
```

Claude crée les fichiers pour vous. Double-cliquez sur le fichier HTML pour l'ouvrir dans votre navigateur.

<h3 id="work-with-files-on-your-computer">
  Travailler avec des fichiers sur votre ordinateur
</h3>

Claude peut lire et organiser les fichiers que vous avez déjà :

```text theme={null}
look at the screenshots on my Desktop and rename them based on what's in each image
```

<h3 id="ask-questions">
  Poser des questions
</h3>

Claude peut expliquer les choses, vous aider à apprendre ou planifier un projet :

```text theme={null}
I want to build a personal budget tracker. What would I need?
```

Si vous n'avez pas encore de projet, ce n'est pas grave. Claude peut vous aider à en démarrer un nouveau.

<h3 id="other-ways-to-use-claude-code">
  Autres façons d'utiliser Claude Code
</h3>

Vous n'avez pas besoin d'utiliser le terminal. Claude Code est également disponible dans :

* [VS Code](/fr/vs-code) et [JetBrains IDEs](/fr/jetbrains) en tant qu'extensions d'éditeur
* L'[application de bureau](/fr/desktop-quickstart), sans terminal requis
* Le [web](/fr/claude-code-on-the-web) sur claude.ai/code pour les sessions à distance
* [GitHub Actions](/fr/github-actions) et [GitLab CI/CD](/fr/gitlab-ci-cd) pour l'automatisation

<h3 id="learn-more">
  En savoir plus
</h3>

* [Démarrage rapide](/fr/quickstart) : une présentation guidée de votre premier projet avec Claude Code
* [Comment fonctionne Claude Code](/fr/how-claude-code-works) : comprendre comment Claude lit vos fichiers, exécute des commandes et effectue des modifications
* [Meilleures pratiques](/fr/best-practices) : obtenez de meilleurs résultats avec des invites efficaces et une configuration de projet
* [Flux de travail courants](/fr/common-workflows) : guides étape par étape pour le débogage, les tests, la refactorisation et bien plus
* [Configuration du terminal](/fr/terminal-config) : personnalisez votre terminal pour la meilleure expérience Claude Code

***

<h2 id="troubleshooting">
  Dépannage
</h2>

<h3 id="macos-and-linux-troubleshooting">
  Dépannage macOS et Linux
</h3>

Si vous rencontrez des problèmes lors de l'installation sur macOS ou Linux, vérifiez ces problèmes courants :

<Accordion title="« command not found: claude »">
  Si vous voyez `command not found: claude` après l'installation, le dossier où le programme d'installation a placé `claude` ne se trouve pas dans votre PATH. Le programme d'installation affiche la correction exacte sous `Setup notes` à la fin de l'installation, alors exécutez cette commande, ou utilisez celle pour votre shell ci-dessous.

  Pour Zsh, le shell par défaut de macOS :

  ```bash theme={null}
  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
  source ~/.zshrc
  ```

  Pour Bash, le shell par défaut de Linux :

  ```bash theme={null}
  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
  source ~/.bashrc
  ```

  Ensuite, ouvrez un nouveau terminal et réessayez `claude`. S'il n'est toujours pas trouvé, vérifiez que le fichier `~/.local/bin/claude` existe. S'il n'existe pas, l'installation n'a pas été terminée. Pour plus de détails, consultez [corriger votre PATH](/fr/troubleshoot-install#verify-your-path).
</Accordion>

<Accordion title="Erreur avec le code HTML ou ' syntax error near unexpected token '">
  Si vous voyez `bash: line 1: syntax error near unexpected token '<'` ou du code HTML comme `<!DOCTYPE html>` dans votre terminal, l'URL d'installation a renvoyé une page web au lieu du script du programme d'installation.

  Si la page indique ' App unavailable in region ', Claude Code n'est pas disponible dans votre pays. Consultez les [pays pris en charge](https://www.anthropic.com/supported-countries).

  Sinon, essayez d'exécuter la commande à nouveau. Si cela continue à se produire, installez avec [Homebrew](https://brew.sh) à la place :

  ```bash theme={null}
  brew install --cask claude-code
  ```
</Accordion>

<Accordion title="Erreur « dyld » ou « built for Mac OS X 13.0 »">
  Si vous voyez `dyld: cannot load`, `dyld: Symbol not found` ou `built for Mac OS X 13.0`, votre version de macOS est probablement plus ancienne que celle que Claude Code prend en charge.

  Ouvrez le menu Apple et sélectionnez À propos de ce Mac pour vérifier votre version. Si elle est antérieure à 13.0, mettez à jour macOS via Mise à jour logicielle. Consultez le [guide de dépannage macOS](/fr/troubleshoot-install#dyld-cannot-load-on-macos) pour plus de détails.
</Accordion>

Pour les autres erreurs, consultez le [guide complet de dépannage de l'installation](/fr/troubleshoot-install).

<h3 id="windows-troubleshooting">
  Dépannage Windows
</h3>

Si vous rencontrez des problèmes lors de l'installation sur Windows, vérifiez ces problèmes courants :

<Accordion title="' irm is not recognized '">
  Vous êtes dans CMD, pas dans PowerShell. Fermez cette fenêtre et ouvrez PowerShell à la place (`Win + X` puis sélectionnez Windows PowerShell).

  Vous pouvez également utiliser la commande d'installation CMD :

  ```batch theme={null}
  curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  ```
</Accordion>

<Accordion title="Erreur SSL/TLS ou « Could not create SSL/TLS secure channel »">
  Cela se produit généralement sur les anciens systèmes Windows 10. Exécutez d'abord cette ligne, puis réessayez l'installation :

  ```powershell theme={null}
  [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
  irm https://claude.ai/install.ps1 | iex
  ```
</Accordion>

<Accordion title="' Claude Code on Windows requires either Git for Windows (for bash) or PowerShell '">
  Ni PowerShell ni Git Bash n'a été trouvé. Claude Code a besoin d'au moins un shell.

  1. Assurez-vous que `powershell.exe` se trouve sur votre `PATH`. Son emplacement par défaut est `C:\Windows\System32\WindowsPowerShell\v1.0\`. Vous pouvez également installer [PowerShell 7](https://aka.ms/powershell), qui fournit `pwsh`.
  2. Si vous préférez utiliser Git Bash, installez [Git for Windows](https://git-scm.com/downloads/win) selon la [première étape de la section Windows](#windows).
  3. Si Git est installé mais que Claude Code ne peut pas le trouver, dites-lui où chercher :
     ```powershell theme={null}
     $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"
     ```
     Ensuite, exécutez `claude` à nouveau. Si votre Git est installé ailleurs, trouvez le chemin en exécutant :
     ```powershell theme={null}
     Get-Command git | Select-Object Source
     ```
     Recherchez le dossier `Git\bin` dans ce chemin et utilisez-le à la place.

  Pour rendre cela permanent afin que vous n'ayez pas à le définir à chaque fois, consultez [configurer le chemin Git Bash](/fr/troubleshoot-install#claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell).
</Accordion>

<Accordion title="' claude is not recognized '">
  Cette erreur signifie que le répertoire d'installation ne se trouve pas dans votre PATH. Exécutez ces commandes dans PowerShell pour l'ajouter :

  ```powershell theme={null}
  $currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
  [Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
  ```

  Fermez PowerShell, ouvrez une nouvelle fenêtre et réessayez `claude`. Consultez [vérifier votre PATH](/fr/troubleshoot-install#verify-your-path) pour plus de détails.
</Accordion>

Pour les autres erreurs, consultez le [guide complet de dépannage de l'installation](/fr/troubleshoot-install).