Claude Code pour le SEO : le guide ultime (installation, prompts et cas d'usage)

Vous exportez 80 000 URL depuis Screaming Frog. Vous ouvrez le CSV dans ChatGPT. Le fichier est trop lourd, ou l'interface le tronque, ou vous passez vingt minutes à découper en morceaux.

Claude Code résout ce problème d'une manière différente : il ne lit pas votre fichier dans une fenêtre de conversation, il l'ouvre sur votre disque, écrit un script Python pour l'analyser, l'exécute, et vous rend le résultat. C'est la différence entre discuter d'un fichier et travailler dessus.

Ce guide couvre l'installation vérifiée sur la documentation officielle, cinq cas d'usage SEO opérationnels avec les commandes exactes, et un kit de configuration à copier-coller.

Qu'est-ce que Claude Code et pourquoi change-t-il le travail SEO ?

Claude Code est l'outil en ligne de commande d'Anthropic. Vous l'installez sur votre machine, vous l'ouvrez dans un dossier, et vous lui parlez en français. Il lit vos fichiers, écrit du code, l'exécute et vous montre le résultat.

Claude web et Claude Code : la vraie différence

Une clarification s'impose, car la confusion est courante et fausse le raisonnement. Claude Code n'est pas un modèle différent. C'est une interface différente qui utilise les mêmes modèles que l'application web (Opus, Sonnet, Haiku selon ce que vous choisissez). La différence n'est pas l'intelligence, c'est l'accès à votre machine.

Fonctionnalité	Claude web / app	Claude Code (CLI)
Taille des fichiers analysés	Limitée par l'interface	Limitée par votre disque
Exécution de code Python / Bash	Environnement isolé	Directement sur votre machine
Accès aux fichiers locaux	Upload manuel	Lecture directe du dossier de travail
Automatisation par lot	Manuelle	Scriptable, planifiable via cron
Persistance entre sessions	Conversation	Fichiers CLAUDE.md chargés à chaque lancement
Connexion à vos outils	Connecteurs	Serveurs MCP, scripts, API

Pourquoi des SEO passent au terminal

Trois raisons concrètes, au-delà de l'effet de mode.

Le volume. Un export de crawl, un fichier de logs, un dump Search Console : ce sont des fichiers de dizaines ou centaines de mégaoctets. Le terminal ne les lit pas dans une fenêtre de contexte, il les traite avec du code.

La reproductibilité. Une analyse faite une fois dans un chat est perdue. La même analyse dans Claude Code produit un script que vous relancez le mois suivant en une commande.

Le contexte persistant. Un fichier CLAUDE.md à la racine de votre dossier client décrit le site, la stack, les conventions et vos règles d'analyse. Il est chargé automatiquement à chaque session. Vous ne réexpliquez plus le contexte à chaque fois.

Vous n'aimez pas le terminal ? Une application de bureau permet d'utiliser Claude Code sans ligne de commande, sur macOS, Windows et Linux. Les cas d'usage de ce guide fonctionnent de la même façon. Si le terminal est votre blocage principal, commencez par là.

Comment installer et configurer Claude Code, pas à pas

Instructions vérifiées sur la documentation officielle à la date de publication. Consultez la page setup officielle en cas de doute, l'outil évolue vite.

Prérequis réels

Système : macOS 13.0+, Windows 10 1809+ ou Windows Server 2019+, Ubuntu 20.04+, Debian 10+, ou Alpine 3.19+. Il faut 4 Go de RAM et un processeur x64 ou ARM64.

Compte : Claude Code nécessite un compte Pro, Max, Team, Enterprise ou Console. Le plan gratuit de Claude.ai ne donne pas accès à Claude Code.

Node.js n'est pas nécessaire. C'est une idée reçue tenace, héritée des premières versions. L'installation recommandée passe aujourd'hui par un installeur natif qui embarque son propre binaire. Node.js 22 ou plus n'est requis que si vous choisissez la voie npm.

Installation

macOS, Linux, WSL :

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

Windows PowerShell :

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

Alternatives selon votre écosystème :

# Homebrew (macOS)
brew install --cask claude-code
# WinGet (Windows)
winget install Anthropic.ClaudeCode
# npm (nécessite Node.js 22+)
npm install -g @anthropic-ai/claude-code

L'installation native se met à jour automatiquement en arrière-plan. Les installations Homebrew, WinGet et par gestionnaire de paquets Linux demandent une mise à jour manuelle.

Vérification et premier lancement

claude --version

La commande affiche un numéro de version. En cas de doute sur votre configuration :

claude doctor

Ce diagnostic vérifie l'installation, valide vos fichiers de réglages et signale les problèmes avec des correctifs suggérés, sans démarrer de session. Pour démarrer, placez-vous dans le dossier de votre projet SEO et lancez :

cd ~/clients/monsite-seo
claude

À la première exécution, une authentification s'ouvre dans le navigateur.

Sécuriser vos dossiers et votre budget

C'est l'étape que tout le monde saute et qu'il ne faut pas sauter.

Cloisonnez le dossier de travail. Claude Code voit le dossier depuis lequel vous le lancez et ses sous-dossiers. Lancez-le depuis un dossier client précis, jamais depuis votre répertoire personnel.

Déclarez les permissions. Créez .claude/settings.json dans votre projet :

{
  "permissions": {
    "allow": [
      "Bash(python3:*)",
      "Bash(pip:*)",
      "Bash(ls:*)",
      "Bash(cat:*)",
      "Read(./data/**)",
      "Write(./output/**)",
      "Edit(./output/**)"
    ],
    "deny": [
      "Read(./secrets/**)",
      "Read(./.env)",
      "Bash(rm -rf:*)"
    ]
  }
}

Cette configuration autorise l'analyse de données et l'écriture de résultats, tout en bloquant la lecture de vos identifiants et les suppressions récursives.

Maîtrisez la consommation. Le coût dépend de votre formule : inclus dans un abonnement Pro, Max ou Team avec des limites d'usage, ou facturé à la consommation via un compte Console. Vérifiez les conditions actuelles sur la page tarifaire d'Anthropic avant de lancer des traitements lourds.

Le principe qui économise le plus : ne faites jamais lire un gros fichier à Claude, faites-lui écrire un script qui le lit. La différence de coût est d'un ordre de grandeur.

Cinq cas d'usage concrets pour vos audits et contenus

1. Analyse de logs serveur et d'exports Screaming Frog

Le cas d'usage le plus rentable, parce qu'il porte sur des fichiers que les interfaces web ne peuvent pas traiter.

claude "Analyse export_screaming_frog.csv. Écris un script Python
pour éviter de charger le fichier en mémoire conversationnelle.
Donne-moi : les 10 URL en 404 recevant le plus de liens internes,
la répartition des codes réponse, et les pages en 200 avec une
profondeur de clic supérieure à 4. Exporte le résultat dans
output/audit_crawl.csv."

Pour les logs serveur :

claude "Parse access.log (format combined). Croise avec
sitemap.xml. Liste les URL du sitemap jamais crawlées par
Googlebot sur la période, et les URL crawlées mais absentes
du sitemap. Résultat en tableau markdown."

Le réflexe déterminant : demandez explicitement un script plutôt qu'une lecture. Sans cette consigne, Claude Code peut tenter de charger le fichier, ce qui sature le contexte et coûte cher.

2. Analyse du maillage interne

claude "À partir de all_inlinks.csv, construis le graphe du site
avec networkx. Calcule le PageRank interne de chaque page.
Identifie : les pages orphelines, les pages à fort PageRank
interne mais faible trafic (fichier gsc_export.csv), et les
pages business prioritaires (liste dans priorites.txt) sous-maillées.
Propose 20 liens internes à créer, triés par gain estimé."

C'est le type d'analyse qu'aucun outil SEO du marché ne fait exactement comme vous le voulez, et qui prend une journée à la main.

3. Audit technique par lot

claude "Pour chaque URL de urls_a_verifier.txt, récupère le HTML
et vérifie : présence et longueur du title, meta description,
canonical, balise robots, H1 unique, données structurées valides.
Signale les anomalies dans output/audit_technique.csv avec une
colonne gravité (bloquant / important / mineur)."

Ajoutez une vérification de cohérence entre robots.txt, sitemaps et canoniques : c'est le triangle où se logent la plupart des problèmes d'indexation.

4. Croisement Search Console et Analytics

claude "Croise gsc_performance.csv et ga4_export.csv sur l'URL.
Identifie : les pages avec beaucoup d'impressions et un CTR
inférieur à la moyenne de leur position, les pages qui ont perdu
plus de 30 % de clics sur 3 mois, et les requêtes en position
11-20 avec un volume d'impressions significatif.
Classe par potentiel de gain."

Cette analyse produit directement une liste de priorités de réoptimisation. Les requêtes en position 11 à 20 sont les gains les plus rapides d'un site existant. C'est le moment de réoptimiser ces pages par la sémantique.

5. Génération et validation de données structurées

claude "Pour chaque fiche produit du dossier ./fiches/, génère
le JSON-LD Product avec offers, aggregateRating si les données
existent, et brand. Valide la syntaxe. N'invente aucune donnée
absente : laisse le champ vide et signale-le dans un rapport."

La consigne « n'invente aucune donnée » n'est pas optionnelle. Sans elle, vous risquez des notes moyennes fictives dans votre balisage, ce qui relève du spam structuré.

Note sur les formats : HowTo ne produit plus de résultat enrichi depuis 2023, et FAQPage depuis mai 2026. Concentrez vos efforts sur Product, Article, BreadcrumbList et Organization, qui restent affichés.

Le kit ultime : configuration d'un projet SEO

Contrairement à ce que l'on lit parfois, il n'existe pas de fichier .clauderc. La configuration repose sur trois mécanismes distincts.

Le fichier CLAUDE.md

C'est la mémoire de votre projet, chargée automatiquement au début de chaque session. Placez-le à la racine de votre dossier client, ou lancez /init pour en générer une première version.

# Projet SEO, [Nom du client]
## Contexte
- Site : exemple.fr
- CMS : WordPress
- Marché : France, B2B
- Objectif prioritaire : trafic qualifié sur les pages service
## Structure des données
- ./data/ : exports bruts (crawl, logs, GSC, GA4). Lecture seule.
- ./output/ : livrables générés. Écriture autorisée.
- ./scripts/ : scripts réutilisables.
## Règles d'analyse
- Toujours écrire un script Python pour tout fichier de plus de 5 Mo.
  Ne jamais charger un gros CSV en contexte.
- Toujours indiquer la taille de l'échantillon et la période.
- Ne jamais inventer une donnée absente. Signaler le manque.
- Distinguer explicitement observation et hypothèse.
## Conventions de sortie
- Rapports en markdown dans ./output/
- Données en CSV, séparateur virgule, encodage UTF-8
## Ce qu'il ne faut pas faire
- Ne pas modifier les fichiers de ./data/
- Ne pas produire de recommandation de contenu sans avoir
  consulté les données GSC du projet

Visez moins de 200 lignes. Au-delà, l'adhérence baisse et le coût en contexte augmente.

Les règles par thème

Pour un projet volumineux, découpez en fichiers thématiques dans .claude/rules/ : un fichier analyse-technique.md, un redaction.md, un reporting.md, aux côtés de CLAUDE.md et de .claude/settings.json. Les règles peuvent être restreintes à certains fichiers via un champ paths en frontmatter, ce qui les charge uniquement quand elles servent.

Les commandes personnalisées

Créez .claude/commands/audit-express.md pour disposer d'un /audit-express réutilisable :

Réalise un audit express du site à partir des fichiers de ./data/.
Étapes :
1. Vérifier la présence des exports nécessaires. Signaler
   les manquants et s'arrêter si un fichier critique manque.
2. Analyser les codes réponse et la profondeur de clic.
3. Croiser avec les données GSC : pages crawlées sans
   impression, pages à impressions sans clic.
4. Produire output/audit-express.md avec, dans l'ordre :
   les 3 problèmes bloquants, les 5 opportunités rapides,
   puis le détail.
Contraintes :
- Script Python obligatoire pour tout fichier de plus de 5 Mo.
- Indiquer le niveau de confiance de chaque conclusion.
- Ne rien affirmer qui ne soit vérifiable dans les données.

Les commandes utiles au quotidien

Commande	Usage
/init	Générer un premier CLAUDE.md à partir du dossier
/memory	Ouvrir et éditer les fichiers de mémoire
/context	Vérifier ce qui est réellement chargé dans la session
/config	Régler le comportement, dont le canal de mise à jour
claude doctor	Diagnostiquer installation et réglages

/context est la commande de débogage la plus utile : si votre CLAUDE.md n'y apparaît pas sous Memory files, il n'est pas chargé, et c'est presque toujours l'explication d'un comportement inattendu.

Limites et bonnes pratiques

Gérer le contexte sur les fichiers lourds

La règle unique : script d'abord, lecture ensuite. Faites produire un script qui traite le fichier et n'en remonte que le résultat agrégé. Un CSV de 200 Mo ne doit jamais entrer dans une conversation. Pour l'exploration, travaillez d'abord sur un échantillon (head -1000 gros_export.csv > data/echantillon.csv), validez la logique, puis lancez le script sur le fichier complet.

Vérifier le travail produit

Trois contrôles systématiques. Les chiffres : un total, une moyenne, un comptage, recalculez-en un à la main. Une erreur de filtre ou de jointure produit un rapport parfaitement présenté et totalement faux. La syntaxe générée : validez tout JSON-LD, toute redirection, tout robots.txt avant déploiement. Un fichier de redirections malformé casse un site en production. La sur-optimisation : si vous demandez d'optimiser un contenu pour un mot-clé, vous obtiendrez un texte saturé. Formulez la consigne en termes de qualité de réponse, jamais de densité ou de score.

Ce que Claude Code ne remplace pas

Il n'a pas de données de marché : pas de volume de recherche, pas de backlinks, pas de positions, sauf si vous les lui fournissez ou connectez une API. Il ne crawle pas un site comme un crawler dédié, sauf si vous lui faites écrire ce crawler. Et il ne décide pas des priorités. Le partage des rôles est stable : les outils SEO produisent la donnée, Claude Code la traite et la croise, vous décidez. C'est d'ailleurs le même principe qui gouverne les agents SEO.

La règle de la validation

Aucune action irréversible sans relecture. Claude Code peut préparer un fichier de redirections, un balisage, un script de mise à jour, et vous le lisez avant de le déployer. Utilisez les permissions deny pour rendre certaines erreurs impossibles plutôt que de compter sur votre vigilance.

En résumé

Claude Code déplace le SEO de la conversation vers l'exécution.

• Le gain vient du volume et de la reproductibilité, pas d'une IA plus intelligente : c'est le même modèle, avec accès à vos fichiers.
• Écrivez un CLAUDE.md avant tout le reste. C'est lui qui transforme un assistant générique en outil qui connaît votre projet.
• Script d'abord, lecture ensuite. C'est la règle qui détermine à la fois le coût et la faisabilité.
• Vérifiez les chiffres et validez avant déploiement. L'outil est rapide, il n'est pas responsable.

Vous voulez industrialiser vos audits sans monter une équipe technique ? Je mets en place des environnements Claude Code adaptés à vos process, avec les configurations et les garde-fous. Parlons de votre projet.