Claude Code : installer et bien démarrer

Claude Code sert aussi bien aux développeurs qu'aux administrateurs : scripts PowerShell ou Bash, fichiers Ansible, configurations, Dockerfile, documentation d'un dépôt Git. Pour la prise en main de Claude dans l'application, voir prise en main de Claude. Informations vérifiées le 20 octobre 2026 dans la documentation officielle ; les commandes évoluent, la documentation fait foi.

1. Où utiliser Claude Code

2. Installer

L'installateur natif est la méthode recommandée : il installe un exécutable autonome et le met à jour automatiquement. Vous n'avez pas besoin des droits administrateur.

macOS, Linux, WSL :

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

Windows, dans PowerShell :

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

Windows, dans l'invite de commandes (CMD) :

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Avec un gestionnaire de paquets

Windows : natif ou WSL ?

Vérifier l'installation

Ouvrez un nouveau terminal, puis :

claude --version

2.1.xxx (Claude Code)

Pour un diagnostic complet (installation, réglages, mises à jour) :

claude doctor

Si claude n'est pas reconnu, le dossier d'installation n'est pas encore dans le PATH : fermez et rouvrez le terminal, puis consultez la page de dépannage de la documentation.

3. Se connecter et lancer une première session

Placez-vous dans le dossier du projet, puis lancez Claude Code :

cd ~/projets/scripts-admin
claude

À la première utilisation, une page de connexion s'ouvre dans le navigateur : connectez-vous avec votre compte Claude. Les identifiants sont ensuite conservés. Pour changer de compte : tapez /login dans la session.

Commencez par faire explorer le projet avant de demander des modifications :

que fait ce projet ? quelle est l'arborescence et quels outils utilise-t-il ?

Puis une première tâche simple :

ajoute au script sauvegarde.sh une vérification que le disque de destination
est monté avant de lancer la copie, et un message d'erreur clair sinon

Claude Code repère le fichier, propose la modification, l'applique selon le mode de permission, et peut lancer le script ou les tests pour vérifier.

4. Les modes de permission : qui décide ?

C'est le réglage le plus important. Il fixe ce que Claude Code peut faire sans vous demander. On passe d'un mode à l'autre avec Maj+Tab (Shift+Tab) pendant la session, ou au lancement avec --permission-mode.

5. Le fichier CLAUDE.md : la mémoire du projet

Chaque session repart d'un contexte vide. Le fichier CLAUDE.md contient les consignes permanentes que Claude Code lit au démarrage : commandes de compilation et de test, conventions, architecture, pièges connus.

Pour en générer une première version, lancez dans la session :

/init

Claude analyse le projet et rédige un CLAUDE.md, que vous complétez ensuite avec ce qu'il ne peut pas deviner.

Exemple pour un dépôt de scripts d'administration :

# Scripts d'administration

- Scripts Bash pour Debian 13, PowerShell 7 pour Windows Server 2025.
- Tester un script Bash : `shellcheck script.sh` puis exécution sur la VM de test `test01`.
- Ne jamais lancer un script sur un serveur de production.
- Chaque script commence par un bloc d'aide (`--help`) et journalise dans /var/log/admin/.
- Variables en majuscules, fonctions en minuscules avec des tirets bas.
- Utilisateur des exemples : spo.

Un CLAUDE.md peut en importer d'autres avec la syntaxe @chemin/fichier.md. Claude Code tient aussi une mémoire automatique de vos corrections et préférences, propre à chaque dépôt.

6. Les commandes essentielles

Dans le terminal

Dans une session

7. Sécuriser son usage

Les règles de permission

Les règles s'ajoutent aux modes : allow (autoriser sans demander), ask (toujours demander), deny (toujours refuser, même en mode bypassPermissions). Elles se placent dans un fichier de réglages :

Exemple de .claude/settings.json pour un dépôt d'infrastructure :

{
  "permissions": {
    "allow": [
      "Bash(shellcheck *)",
      "Bash(git status)",
      "Bash(git diff *)"
    ],
    "ask": [
      "Bash(git push *)",
      "Bash(ssh *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./secrets/**)",
      "Bash(rm -rf *)"
    ]
  }
}

Les bons réflexes

• Travaillez dans Git : committez avant une tâche importante. Chaque modification se relit avec git diff et s'annule facilement.
• Pas de secrets dans le projet : mots de passe et clés vont dans un coffre ou des variables d'environnement, et les fichiers .env sont interdits en lecture par une règle deny.
• Jamais directement en production : faites travailler Claude Code sur une copie, une branche ou une VM de test, puis déployez vous-même.
• Activez le bac à sable (/sandbox, sur macOS, Linux et WSL 2) : il limite ce que les commandes lancées peuvent atteindre sur le disque et le réseau.
• Le mode bypassPermissions uniquement dans un conteneur ou une VM jetable, sans accès à vos données ni à vos identifiants.
• Méfiez-vous du contenu lu : un fichier, une page web ou un ticket peut contenir des instructions cachées (injection d'instructions). Le mode manuel ou les règles ask gardent un humain dans la boucle pour les actions sensibles.
• Relisez le code produit avant de le faire tourner sur un système important, comme vous le feriez pour le code d'un collègue.

8. Aller plus loin

Anthropic propose un cours gratuit, Claude Code 101, sur Claude Academy.

À retenir

• Installation en une commande (curl … | bash ou irm … | iex), mises à jour automatiques ; vérification avec claude --version et claude doctor.
• Nécessite une offre Pro, Max, Team, Enterprise ou un compte Console.
• Maj+Tab change le mode de permission ; les sessions récentes démarrent en auto : passez en Manuel pour le travail sensible.
• /init crée le CLAUDE.md : consignes courtes et concrètes du projet.
• Règles deny pour les secrets et les commandes dangereuses, Git pour tout relire et annuler, jamais en production directement.