Claude Code : l'installer et le maintenir, pas à pas

← Retour au guide des agents IA

Claude Code est un agent d’Anthropic qui travaille dans un dossier de votre ordinateur : il lit vos fichiers, écrit de petits programmes, les lance et vous montre le résultat. Ici, le cas concret est le nettoyage d’un export de votre CRM (votre base de clients) au format CSV : suppression des doublons, téléphones remis au format français, e-mails invalides mis de côté. À la fin, la procédure devient un skill que vous relancez en une ligne le mois suivant.

En bref

Avant de commencer

Un abonnement payant. Claude Code est inclus dans les offres Pro, Max, Ultra, Team et Enterprise, ou dans un compte Console (facturation à l’usage). Le plan gratuit de claude.ai ne l’inclut pas. Les offres et les prix sont détaillés dans la dernière section.

Un ordinateur compatible. macOS 13 ou plus récent, ou Windows 10 (version 1809) ou plus récent, 4 Go de mémoire, une connexion internet, et un pays supporté par Anthropic (liste officielle). Voir la page d’installation.

Trois décisions à prendre avant d’installer. Une erreur ici est difficile à rattraper ensuite.

• Quel compte. Utilisez un compte professionnel, au nom de la personne qui sera responsable de l’outil. Si le compte est personnel et que son titulaire quitte l’entreprise, le skill et les réglages restent sur son ordinateur, et l’abonnement part avec lui. Sur une offre Team, l’administrateur crée les sièges et fixe les plafonds de dépense.
• Quel dossier. Claude Code travaille dans le dossier où vous le lancez, et lit ce qu’il y trouve sans vous demander. Lancez-le toujours dans un dossier créé pour la tâche, jamais dans « Documents » ou sur le Bureau. Ici : un dossier nettoyage-crm.
• Quelles données restent hors de portée. Le contenu des fichiers que l’agent lit est envoyé au service pour qu’il réponde. Gardez dans ce dossier la copie de l’export, rien d’autre : pas de mots de passe, pas de fichiers .env, pas de contrats. Si vous ne pouvez pas faire lire de vraies données à un prestataire, la section « Votre premier agent utile » prévoit un fichier d’essai inventé.

Le piège du mode de permission. Depuis la version 2.1.283, Claude Code démarre dans le terminal en mode auto : un second programme filtre les actions et n’interrompt plus pour les actions de routine. La documentation précise que ce mode réduit les demandes de validation mais ne garantit pas la sécurité. Pour apprendre, choisissez explicitement le mode manual, où l’agent demande votre accord avant d’agir. Les étapes ci-dessous le font à votre place.

Installer

On tape les commandes dans un terminal : une fenêtre où l’on écrit des instructions à l’ordinateur au lieu de cliquer.

1. Ouvrez le terminal.

   • Sur Mac : Cmd + Espace, tapez Terminal, Entrée.
   • Sous Windows : Win + X, puis Windows PowerShell (ou Terminal). La ligne d’invite doit commencer par PS C:\Users\VotreNom>. Sans le PS, vous êtes dans une autre fenêtre (CMD) et les commandes ci-dessous échoueront.

2. Installez Claude Code. Copiez la commande de votre système, collez-la (Cmd + V sur Mac, clic droit ou Ctrl + V sous Windows), puis Entrée.

   Mac :

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

   Windows PowerShell :

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

   Ce que vous devez voir : rien pendant le téléchargement. Laissez la fenêtre ouverte et attendez le message Installation complete!. Fermez ensuite cette fenêtre et ouvrez-en une nouvelle : sans cela, la commande claude peut rester introuvable.

3. Vérifiez l’installation, dans la nouvelle fenêtre.

   claude --version

   Ce que vous devez voir : un numéro de version, par exemple 2.1.211 (Claude Code).

   Si ça ne marche pas :

   • command not found: claude (Mac) ou 'claude' is not recognized (Windows) : le dossier d’installation n’est pas connu du système. Sur Mac, tapez ces deux lignes puis ouvrez un nouveau terminal :

     echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
     source ~/.zshrc

     Sous Windows PowerShell, la correction est plus longue : suivez la section sur claude is not recognized de la page de dépannage.

   • syntax error near unexpected token '<' : l’adresse a renvoyé une page web au lieu du programme. Si la page dit « App unavailable in region », votre pays n’est pas supporté. Sinon, réessayez plus tard ou installez par Homebrew (brew install --cask claude-code) ou WinGet (winget install Anthropic.ClaudeCode).

   • Sous Windows, 'irm' is not recognized : vous êtes dans CMD, ouvrez PowerShell.

4. Vérifiez que git est présent. Git est le programme qui garde les points de retour de votre travail. Claude Code n’en a pas besoin pour démarrer, mais cette page s’en sert comme filet de sécurité.

   git --version

   Ce que vous devez voir : un numéro de version. Sur un Mac neuf, une fenêtre peut proposer d’installer les outils de développement Apple : acceptez, patientez quelques minutes, puis relancez la commande. Si la commande échoue, installez git depuis git-scm.com (sous Windows, cochez l’ajout au PATH).

   Git refuse d’enregistrer un point de retour sans savoir qui vous êtes. Une seule fois :

   git config --global user.name "Votre Nom"
   git config --global user.email "vous@votre-entreprise.fr"

5. Créez le dossier de travail. Dans le terminal :

   Mac :

   cd ~/Documents
   mkdir nettoyage-crm
   cd nettoyage-crm
   mkdir donnees scripts resultats .claude
   git init

   Windows PowerShell :

   cd ~\Documents
   mkdir nettoyage-crm
   cd nettoyage-crm
   mkdir donnees, scripts, resultats, .claude
   git init

   Ce que vous devez voir : un message disant que git a initialisé un dépôt vide. Si votre dossier Documents est ailleurs (OneDrive par exemple), choisissez un autre emplacement. Gardez ce terminal ouvert dans le dossier nettoyage-crm.

6. Copiez votre export dans le dossier donnees, avec le Finder ou l’Explorateur, et nommez-le export-crm.csv. Gardez l’original ailleurs. Dans votre CRM, l’export CSV se trouve en général dans le menu d’export de la liste des contacts : le libellé change d’un outil à l’autre.

7. Créez les deux fichiers de réglage de la section suivante (CLAUDE.md et .claude/settings.json) avant le premier lancement. Puis lancez :

   claude --permission-mode manual

   Le navigateur s’ouvre pour vous connecter à votre compte Claude. Si le navigateur ne s’ouvre pas, appuyez sur c pour copier l’adresse de connexion et collez-la dans le navigateur. Une fois connecté, le terminal affiche Login successful : appuyez sur Entrée. Si Claude demande s’il peut faire confiance au dossier, répondez oui : c’est le vôtre.

   Ce que vous devez voir : une zone de saisie et, en bas, manual mode on. Si vous lisez auto mode on, appuyez sur Shift + Tab jusqu’à voir manual. La commande /status affiche votre méthode de connexion et les fichiers de réglages chargés.

Sans terminal : installez l’application Claude Desktop (Mac, Windows), connectez-vous, ouvrez l’onglet Code, choisissez l’environnement Local, puis Open folder…. Le mode se lit sous la zone de saisie : choisissez Manual. Les étapes 5 à 7 se font alors avec le Finder ou l’Explorateur et un éditeur de texte, ou dans le terminal intégré de l’application. Voir le guide de démarrage de l’application. La version web claude.ai/code est autre chose : elle travaille sur une copie d’un dépôt GitHub dans le cloud, pas sur les fichiers de votre ordinateur. La documentation lue ne précise pas si l’application applique le fichier .claude/settings.json d’un projet : vérifiez avec les essais de la section suivante.

Configurer ce qui compte

CLAUDE.md : les consignes permanentes

CLAUDE.md est lu au début de chaque session. Claude le traite comme du contexte, pas comme une règle imposée : pour interdire vraiment une action, utilisez les permissions plus bas. Gardez-le court (moins de 200 lignes), concret et vérifiable.

Créez-le à la racine de nettoyage-crm. Sur Mac, copiez tout le bloc (de cat à EOF) dans le terminal ouvert dans le dossier :

cat > CLAUDE.md <<'EOF'
# Consignes pour l'agent : nettoyage de l'export CRM

## Qui je suis
Je dirige l'entreprise. Je ne suis pas développeur. Explique-moi en français simple,
sans jargon. Si tu emploies un terme technique, définis-le en une phrase.

## Où sont les choses
- `donnees/` : exports bruts. Ne jamais modifier ces fichiers : travaille sur une copie.
- `resultats/` : fichiers produits par les scripts.
- `scripts/` : les petits programmes que tu écris.

## Règles de travail
- Avant de modifier quoi que ce soit : dis-moi en deux phrases ce que tu vas faire.
- Fais une petite étape à la fois, puis montre-moi le résultat avant de continuer.
- Ne supprime jamais un fichier sans me le demander.
- N'envoie rien à l'extérieur (e-mail, message, formulaire) : prépare un brouillon, c'est moi qui envoie.
- Ne lis jamais les fichiers `.env`, `secrets/` ni les mots de passe. Si une tâche en a besoin, demande-moi.
- Ne fais pas `git push`. Fais un `git commit` après chaque étape qui marche.

## Données
- Les fichiers contiennent des données personnelles de clients (RGPD) : n'en copie aucune
  dans un exemple de test ni dans un site web ; utilise des données inventées pour les tests.
- Format des fichiers CSV : séparateur point-virgule ou virgule (à détecter), encodage UTF-8, dates JJ/MM/AAAA.

## Vérification
- Après chaque script : compte les lignes avant et après, donne 5 exemples de lignes modifiées,
  et liste ce qui a été rejeté et pourquoi.
EOF

Sous Windows, ouvrez le Bloc-notes, collez le contenu entre cat et EOF (sans ces deux lignes), puis Fichier > Enregistrer sous dans le dossier nettoyage-crm, avec le nom "CLAUDE.md" entre guillemets pour éviter une extension .txt, et l’encodage UTF-8.

Pour vérifier : une fois Claude lancé, tapez /memory : le fichier doit apparaître dans la liste. /context montre ce qui est chargé.

Les permissions : ce que l’agent peut faire sans demander

Les règles vont dans .claude/settings.json, à l’intérieur du dossier du projet. Chaque règle est de la forme Outil(spécificateur). Les règles deny (interdire) passent avant allow (autoriser) : une règle allow ne peut jamais lever un deny.

Mac, dans le terminal :

cat > .claude/settings.json <<'EOF'
{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "defaultMode": "default",
    "allow": [
      "Bash(git status)",
      "Bash(git diff *)",
      "Bash(git log *)",
      "Bash(git add *)",
      "Bash(git commit *)",
      "Bash(python3 scripts/*)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(~/.ssh/**)",
      "Edit(./donnees/**)",
      "Bash(git push *)",
      "Bash(rm *)",
      "Bash(curl *)",
      "Bash(sudo *)"
    ]
  }
}
EOF

Sous Windows, même méthode qu’au-dessus avec le Bloc-notes : fichier "settings.json" dans le dossier .claude. Remplacez python3 par python (ou py) dans la règle Bash(python3 scripts/*) si python3 --version ne répond pas chez vous.

Sous Windows, Claude peut aussi lancer ses commandes dans PowerShell, et les règles Bash(...) ne s’y appliquent pas. Dans la liste deny, remplacez la dernière ligne "Bash(sudo *)" par ce bloc :

      "Bash(sudo *)",
      "PowerShell(git push *)",
      "PowerShell(Remove-Item *)",
      "PowerShell(Invoke-WebRequest *)",
      "PowerShell(Invoke-RestMethod *)"

Les règles allow ci-dessus ne valent pas pour PowerShell : l’agent vous y demandera plus souvent votre accord.

Ce que chaque règle fait :

Deux limites à connaître. Une règle deny sur une commande n’est pas une barrière absolue : la documentation note que d’autres formes d’appel existent (par exemple git -C . push). Et Edit(./donnees/**) arrête l’outil d’édition de Claude, pas un script qui écrirait dans donnees/ : c’est pourquoi le script du cas ne lit que ce dossier, et pourquoi vous contrôlez à la fin avec git status.

Pour vérifier : /permissions liste les règles actives. Si le fichier contient une erreur de syntaxe, Claude signale des réglages invalides au démarrage ; claude doctor (à taper dans un terminal ordinaire, hors session) liste les entrées rejetées. Le JSON est strict : pas de commentaire, pas de virgule finale. Documentation complète des règles : permissions.

Les modes de permission

Changez de mode en session avec Shift + Tab.

Les modes auto et bypassPermissions écrits dans les réglages d’un projet ne sont pas pris en compte. Détail : modes de permission.

Votre premier agent utile : nettoyer un export CRM

Le principe : vous ne demandez jamais à l’agent de « nettoyer le fichier ». Vous lui demandez un script (un petit programme), vous le testez sur un échantillon, vous vérifiez les chiffres, puis vous le lancez sur tout le fichier. Le script est reproductible et l’original reste intact.

Python doit être installé pour que le script tourne (sous Windows, cochez « Add python.exe to PATH » dans l’installateur). Vérifiez avec python3 --version (sous Windows, python --version). S’il est absent, installez-le depuis python.org.

Un fichier d’essai avec des données inventées

Avant de toucher au vrai export, créez donnees/essai.csv avec ces neuf lignes inventées, par la même méthode que pour CLAUDE.md (Bloc-notes sous Windows, ou cat > donnees/essai.csv <<'EOF' puis le contenu puis EOF sur Mac). Faites-le dans un second terminal, car le premier est occupé par Claude : sur Mac, Cmd + N ouvre une nouvelle fenêtre, puis tapez cd ~/Documents/nettoyage-crm (Windows : cd ~\Documents\nettoyage-crm). Les lignes contiennent les cas pièges : un doublon à la casse près, un e-mail invalide, un e-mail vide, des noms en majuscules, un téléphone étranger, un numéro inexploitable, un client avec deux e-mails.

Prénom;Nom;Email;Téléphone;Société
Camille;DUBOIS;camille.dubois@exemple.fr;0612345678;Atelier Martin
camille;Dubois;Camille.Dubois@exemple.fr ;06 12 34 56 78;Atelier Martin
JEAN-ÉRIC;le gall;je.legall@exemple.fr;+33 (0)6 98 76 54 32;Boulangerie Soleil
Sophie;Martin;sophie.martin@@exemple;0145678901;Cabinet Roux
Paul;Lefèvre;;0601020304;Garage Neuf
Inès;McDonald;ines@exemple.com;+44 7911 123456;Studio Nord
Marc;Petit;marc.petit@exemple.fr;612345678;Petit SARL
Léa;Bernard;lea.bernard@exemple.fr;12 34;Bernard Conseil
Marc;Petit;marc.petit2@exemple.fr;0033612345670;Petit SARL

Dans ce second terminal, enregistrez maintenant le point de départ, export compris : git add . puis git commit -m "départ".

Attendu après nettoyage, si le script suit les règles de l’étape 3 ci-dessous : 9 lignes avant, 6 après, 3 rejetées (un doublon, un e-mail invalide, un e-mail vide), un téléphone laissé tel quel (12 34) et signalé. Le client Marc Petit reste en double, avec deux e-mails : le script ne peut pas savoir que c’est la même personne, c’est à vous de le savoir.

Les prompts, dans l’ordre

Tapez-les dans Claude, un par un, et lisez chaque réponse avant de passer au suivant. Ces textes sont rédigés pour cette page et n’ont pas été exécutés de bout en bout, d’où le contrôle à chaque étape.

1. Explorer sans rien modifier. Appuyez sur Shift + Tab jusqu’à plan mode on, puis :

Regarde le fichier donnees/essai.csv. Dis-moi combien de lignes et de colonnes il contient, quelles colonnes sont vides ou incohérentes, et montre-moi 5 lignes d'exemple. Ne modifie rien.

Avec le vrai export, refaites cette étape sur donnees/export-crm.csv et notez le séparateur et le nom des colonnes (e-mail, téléphone, nom, prénom) : l’étape 3 en a besoin.

2. Faire proposer les nettoyages. Revenez en mode manual (Shift + Tab jusqu’à manual mode on), puis :

Propose-moi la liste des nettoyages possibles : doublons, espaces en trop, majuscules des noms, formats de téléphone français, e-mails invalides, dates. Je choisirai.

3. Choisir et faire écrire le script. Ce prompt applique les choix de cette page : modifiez les règles si vous voulez autre chose. Sous Windows, remplacez python3 par python dans la ligne « Commande ».

Fais ces nettoyages et pas d'autres. Écris le script scripts/nettoyer_crm.py, en Python, sans bibliothèque à installer.
Commande : python3 scripts/nettoyer_crm.py FICHIER --sortie resultats --limite N (l'option --limite est facultative : elle ne traite que les N premières lignes).
Colonnes du fichier essai.csv : Prénom, Nom, Email, Téléphone, Société. Pour un autre fichier, retrouve ces colonnes par leur nom (par exemple « Mobile » pour le téléphone) et dis-moi lesquelles tu as prises.
Règles :
1) E-mail : retire les espaces, mets en minuscules. Vide ou invalide (pas de @ unique, pas de point dans le domaine) : la ligne va dans les rejets avec la raison. Doublon d'un e-mail déjà vu : la ligne va dans les rejets avec « doublon de la ligne X ». Garde la première.
2) Noms et prénoms : majuscule initiale seulement si le texte est tout en majuscules ou tout en minuscules. Garde les tirets et les accents (Jean-Éric). Ne touche pas à McDonald.
3) Téléphone : format français 06 12 34 56 78. Accepte +33, 0033, (0), 9 chiffres sans zéro. Numéro étranger : garde-le en format international. Numéro non reconnu : laisse-le tel quel et signale la ligne.
4) Sorties dans resultats/ : crm-propre.csv, crm-rejets.csv (avec la ligne d'origine et la raison) et rapport.txt. Même séparateur que le fichier d'entrée (détecte-le : ; ou ,). Lis le fichier en UTF-8 avec ou sans BOM, et écris en UTF-8 avec BOM pour qu'Excel affiche les accents.
5) Le rapport donne : lignes avant, lignes après, rejets par raison, et un contrôle « avant = après + rejets ».
6) Ne modifie jamais le fichier d'entrée.

Claude vous montre le script et demande l’autorisation de créer le fichier (mode Manual). Lisez au moins le haut du fichier et la partie qui écrit les résultats : elle ne doit écrire que dans resultats/.

4. Tester sur un échantillon.

Lance le script sur donnees/essai.csv et montre-moi avant et après.

Sur le vrai export, la même demande avec --limite 50 : « Lance-le sur les 50 premières lignes de donnees/export-crm.csv seulement et montre-moi avant et après ».

5. Lancer sur tout le fichier.

Lance-le sur donnees/export-crm.csv et donne-moi le rapport : lignes avant, lignes après, doublons retirés, lignes rejetées avec la raison.

6. Enregistrer un point de retour.

Fais un commit git avec un message qui décrit ce que fait le script.

Comment juger que le résultat est bon

• Les chiffres s’additionnent. Lignes avant = lignes après + lignes rejetées. Si ce n’est pas le cas, demandez à l’agent d’expliquer l’écart avant de continuer.
• Vous lisez. Ouvrez resultats/crm-propre.csv dans Excel ou Numbers, triez par nom, comparez 10 lignes prises au hasard avec l’original. Ouvrez crm-rejets.csv et lisez les raisons : un rejet à tort est plus grave qu’un doublon laissé.
• Vous testez les cas pièges : un client avec deux e-mails (non détecté, normal), un nom à tiret ou à accent, un téléphone étranger, un e-mail avec des majuscules.
• L’original n’a pas bougé. Dans un second terminal ouvert dans le dossier, tapez git status : le fichier de donnees/ ne doit pas apparaître comme modifié (à condition d’avoir fait le commit de départ décrit plus bas).

Voici à quoi ressemble un rapport. Il a été produit par un script de référence sur le fichier d’essai ci-dessus ; la formulation du vôtre différera, les nombres doivent être les mêmes :

Lignes avant : 9
Lignes après : 6
Lignes rejetées : 3 (doublons : 1, e-mails invalides : 1, e-mails vides : 1)
Contrôle : 9 = 6 + 3 -> OK
Téléphones : 0 déjà au bon format, 4 corrigés, 1 étrangers laissés au format international, 1 non reconnus (laissés tels quels), 0 vides
Lignes du fichier à vérifier à la main (téléphone) : ligne 9

Le git minimum vital

Git garde des points de retour (des « commits ») de votre dossier. Six commandes suffisent, à taper dans un second terminal ouvert dans nettoyage-crm (Claude peut aussi les lancer pour vous) :

La règle d’or : enregistrez un point de retour avant chaque demande risquée. Le commit de départ, export compris, a été fait avant le premier prompt : ce dossier reste sur votre ordinateur, vous ne le publiez nulle part. Claude Code a aussi /rewind (ou Esc deux fois) pour revenir à un état précédent de la conversation et du code, mais la documentation précise que ce n’est pas un remplacement du contrôle de version et qu’il ne suit pas les fichiers modifiés par des commandes dans le terminal (détails).

Transformer le cas en skill

Un skill est une procédure écrite que Claude suit quand vous l’appelez. C’est un dossier contenant un fichier SKILL.md. Ici, le skill capture ce que vous venez de faire : tester sur 50 lignes, attendre votre accord, lancer, vérifier les chiffres. Le script voyage avec lui, dans son dossier.

Vous le placez dans ~/.claude/skills/ pour qu’il serve dans tous vos dossiers (dans .claude/skills/ d’un projet, il ne sert que dans ce projet, et il se partage avec git).

Mac, depuis le dossier nettoyage-crm :

mkdir -p ~/.claude/skills/nettoyer-export-crm/scripts
cp scripts/nettoyer_crm.py ~/.claude/skills/nettoyer-export-crm/scripts/
cat > ~/.claude/skills/nettoyer-export-crm/SKILL.md <<'EOF'
---
name: nettoyer-export-crm
description: Nettoie un export CRM en CSV (doublons, e-mails invalides, noms, téléphones français) et produit un fichier propre, un fichier de rejets et un rapport chiffré. À utiliser quand on demande de nettoyer, dédoublonner ou fiabiliser un export de contacts ou de clients.
argument-hint: chemin/vers/export.csv
allowed-tools: Bash(python3 ${CLAUDE_SKILL_DIR}/scripts/nettoyer_crm.py *)
---

Le fichier à traiter est : $ARGUMENTS
Si aucun fichier n'est indiqué, demande-le.

## Procédure
1. Ne modifie jamais le fichier d'origine.
2. Lance d'abord un test sur 50 lignes :
   `python3 ${CLAUDE_SKILL_DIR}/scripts/nettoyer_crm.py "$ARGUMENTS" --sortie resultats --limite 50`
   Montre le rapport et 5 lignes avant/après, puis attends l'accord avant de continuer.
3. Après accord, lance sans `--limite`, puis donne le rapport complet.
4. Vérifie que lignes avant = lignes après + lignes rejetées. Sinon, explique l'écart et arrête-toi.
5. Résultats dans `resultats/` : `crm-propre.csv`, `crm-rejets.csv`, `rapport.txt`.

## Rappels
- Les données sont personnelles (RGPD) : ne recopie aucune ligne réelle ailleurs que dans cette conversation.
- Un même client avec deux e-mails différents n'est pas détecté comme doublon : signale-le si tu le vois.
- Les noms avec particules ou majuscules internes ne sont modifiés que s'ils sont tout en majuscules ou tout en minuscules.
EOF

Sous Windows PowerShell, créez le dossier et copiez le script ainsi, puis créez SKILL.md avec le Bloc-notes dans ce dossier, nom entre guillemets (même contenu, sans les lignes cat et EOF), en remplaçant python3 par python aux deux endroits où il apparaît :

New-Item -ItemType Directory -Force "$HOME\.claude\skills\nettoyer-export-crm\scripts"
Copy-Item scripts\nettoyer_crm.py "$HOME\.claude\skills\nettoyer-export-crm\scripts\"

Ce que contient ce fichier : name est le nom de la commande, description dit à Claude quand l’utiliser, argument-hint s’affiche dans l’aide de saisie, et allowed-tools autorise ce seul script sans demander. ${CLAUDE_SKILL_DIR} est remplacé par le dossier du skill, donc le script est retrouvé où que vous soyez. Sous Windows, la documentation lue ne précise pas le comportement de cette variable avec les barres obliques inverses : testez-le sur le fichier d’essai.

Pour vérifier : dans un nouveau dossier de test qui ne contient que essai.csv, lancez Claude puis tapez /skills : nettoyer-export-crm doit apparaître. Si le dossier ~/.claude/skills n’existait pas avant, lancez /reload-skills. Puis :

/nettoyer-export-crm essai.csv

Le skill doit tester, montrer le rapport et attendre votre accord. Les modifications de SKILL.md sont prises en compte pendant la session. Toutes les options sont dans la documentation des skills.

Le faire tourner tout seul ?

Pas pour ce cas, et il est utile de savoir pourquoi. Les tâches planifiées du cloud d’Anthropic (encore en préversion de recherche) travaillent sur une copie fraîche d’un dépôt GitHub, sans accès à vos fichiers locaux, au plus toutes les heures (détails). Les tâches planifiées de l’application de bureau voient vos fichiers, mais ne tournent que si l’application est ouverte et l’ordinateur éveillé. Pour un export que vous déposez à la main chaque mois, l’appel manuel /nettoyer-export-crm suffit.

Les droits et la sécurité

Ce que l’agent voit. Le dossier où vous le lancez, et ce que vos règles ne lui interdisent pas. En mode Manual, il lit sans demander. La documentation lue ne décrit pas jusqu’où il peut lire en dehors du dossier : le plus sûr est de ne rien laisser de sensible dedans et de garder les règles deny ci-dessus.

Ce qu’il fait sur votre accord. Écrire un fichier, lancer une commande qui n’est pas dans allow. Vous voyez chaque demande, avec le détail.

Ce qui reste à valider par un humain : le contenu de crm-rejets.csv (un contact légitime a pu être écarté), tout envoi vers l’extérieur (mailing, import dans le CRM), et tout import des fichiers propres dans l’outil de production. Importez d’abord sur 20 contacts ou dans un espace de test.

Les risques propres à Claude Code

• Le mode auto n’est pas neutre. Il filtre, il ne garantit rien. Pour un dirigeant qui découvre l’outil, ce n’est pas le bon point de départ.
• Les données peuvent contenir des consignes. Une cellule du CSV, un champ « notes » ou une page web peuvent contenir un texte du genre « ignore tes consignes ». L’agent peut le lire comme une instruction. Gardez le mode Manual, ne lui donnez aucun accès réseau inutile, et lisez ce qu’il demande avant d’accepter.
• Un script a tous vos droits. Bash(python3 scripts/*) autorise n’importe quel script de ce dossier. Relisez-les.
• Les connecteurs (MCP) ouvrent la porte. Ce cas n’en utilise aucun. Quand vous en brancherez un (claude mcp add --transport http nom adresse), commencez par un seul, en lecture seule si possible, sur un compte non administrateur. La documentation rappelle de ne connecter que des serveurs de confiance : ceux qui récupèrent du contenu externe exposent à l’injection de consignes. Voir la page MCP.
• Un administrateur peut imposer des règles. Sur Team et Enterprise, les réglages gérés priment sur les vôtres (/status indique la source appliquée), et peuvent interdire les modes auto et bypassPermissions.

Le maintenir

Première semaine

• Après chaque session : git log pour voir ce qui a été enregistré, git status pour voir ce qui traîne.
• Chaque jour d’usage : /usage pour voir où vous en êtes de votre quota (barres du plan, répartition par skill et par connecteur). Le montant en dollars affiché est une estimation, sans valeur de facturation pour un abonné.
• Notez les demandes de validation que vous acceptez toujours : ce sont les candidates à une règle allow. Ajoutez-les une par une, jamais en bloc.

Chaque mois

1. claude update : l’installation native se met à jour seule en arrière-plan, mais la commande force la mise à jour (Claude Code is up to date si tout est bon). Avec Homebrew ou WinGet, rien n’est automatique : brew upgrade claude-code ou winget upgrade Anthropic.ClaudeCode.
2. claude doctor : diagnostic en lecture seule de l’installation et des réglages.
3. Relisez CLAUDE.md : moins de 200 lignes, aucune consigne périmée.
4. Relancez /nettoyer-export-crm sur essai.csv : les nombres attendus (9, 6, 3) doivent sortir.
5. Sauvegardez la configuration (voir plus bas).
6. Regardez la page des retraits de modèles.

Sur événement

• Un modèle est retiré. Anthropic prévient au moins 60 jours avant pour les modèles de l’API (par e-mail et dans la documentation). Au 4 novembre 2026, claude-sonnet-4-5-20250929 est annoncé retiré le 30 novembre 2026. La documentation lue ne dit pas quel effet cela a sur les abonnements Claude Code. Dans tous les cas, utilisez les alias (sonnet, opus, haiku, acceptés par --model) plutôt qu’un identifiant complet, et cherchez les endroits où un modèle est écrit en dur : la clé model des fichiers settings.json, les sous-agents, les tâches planifiées.
• Un salarié part. Retirez son siège (offre Team : c’est l’administrateur) et récupérez son dossier de travail, son CLAUDE.md, son .claude/ et ses skills (~/.claude/skills/). Ses tâches planifiées appartiennent à son compte et ne sont pas partagées avec l’équipe : recréez-les sous le compte du repreneur. Un skill reste sur le poste de son auteur tant que vous ne l’avez pas copié dans un dossier de projet sous git.
• Un connecteur expire. Tapez /mcp dans la session et reconnectez-vous, ou claude mcp login nom dans le terminal.
• Une mise à jour change un comportement. Le réglage "autoUpdatesChannel": "stable" dans settings.json donne une version d’environ une semaine d’âge, qui saute les versions à régression majeure ; "latest" est le défaut.
• Service en panne. Consultez status.claude.com.

Que sauvegarder

Dans chaque projet : CLAUDE.md, .claude/settings.json, .claude/skills/, .claude/agents/, .mcp.json. Pour vous : ~/.claude/CLAUDE.md, ~/.claude/settings.json, ~/.claude/skills/. Le plus simple : un dépôt git privé « config-agents » qui contient ces fichiers, sans aucun secret. Ne partagez pas ~/.claude.json : il contient votre compte et la configuration des connecteurs.

Symptômes et solutions

Ce que ça coûte

Prix lus sur claude.com/pricing le 4 novembre 2026, en dollars américains, hors taxes. La page précise qu’ils peuvent changer.

Un calcul réaliste pour ce cas. Un abonnement se consomme en quota, pas en euros, et les pages lues ne donnent pas de conversion pour un nettoyage de CSV. La seule mesure fiable est la vôtre : tapez /usage avant et après votre première session et notez l’écart. Pour un ordre de grandeur en facturation à l’usage (compte Console), Sonnet 5.5 coûte 2 $ par million de jetons lus et 10 $ par million de jetons écrits ; une session d’hypothèse de 200 000 jetons lus et 20 000 écrits coûterait 0,40 $ plus 0,20 $, soit 0,60 $. C’est une hypothèse de calcul, pas une mesure. Pour mémoire, la documentation cite une moyenne d’environ 13 $ par développeur et par jour actif en facturation à l’usage dans les entreprises : c’est un usage de développeur à temps plein, sans rapport avec ce cas.

Poser un plafond. Sur Pro et Max, le plafond, c’est le quota de l’abonnement : tant que vous n’activez pas les crédits d’usage, rien n’est facturé en plus. Sur Team et Enterprise, un administrateur fixe des limites de dépense par organisation, groupe ou membre dans claude.ai/admin-settings/usage.

Quand le plafond est atteint. Claude affiche You've hit your session limit ou weekly limit. Trois choix : attendre la réinitialisation, laisser la tâche reprendre toute seule (/rate-limit-options), ou activer les crédits d’usage (/usage-credits), après quoi la facturation à l’usage s’applique. Sur Team sans accès à la facturation, /usage-credits envoie une demande aux administrateurs. Pour consommer moins : /clear entre deux sujets, Sonnet plutôt qu’Opus pour les tâches courantes, CLAUDE.md court, connecteurs inutiles désactivés. Voir la page des coûts.

Ce qui a été vérifié, le 4 novembre 2026 : les commandes d’installation, les modes de permission, le format des règles et des skills et les prix, sur la documentation officielle d’Anthropic (code.claude.com et claude.com/pricing) ; la version locale de Claude Code (2.1.314) pour la liste des options de ligne de commande. Le fichier settings.json, l’en-tête du fichier SKILL.md et le script de référence ont été contrôlés hors de Claude Code : le JSON et l’en-tête sont valides, et le script donne les chiffres annoncés sur le fichier d’essai (9 lignes, 6 propres, 3 rejetées). Les prompts et l’enchaînement complet dans Claude Code n’ont pas été exécutés de bout en bout : testez chaque étape sur le fichier d’essai avant de toucher à vos vrais contacts. Les libellés de l’application de bureau et de votre outil CRM peuvent différer de ce qui est décrit.