Tuto #9 : Débuter avec Claude Code pour son SEO ?

Avant d'aller plus loin : si vous n'avez pas vu les premiers tutos vous pouvez les consulter ici :

• #1 Tuto Skills Claude : comment bien commencer avec les MCP ?
• #2 Tuto Skills Claude : connecter ses données Google Search Console via MCP
• #3 Tuto Skills Claude : comment faire un audit SEO avec Claude ?
• #4 Tuto Skills Claude : connecter ses données Google Analytics via MCP
• #5 Tuto Skills Claude : analyser la SERP
• #6 Tuto Skills Claude : analyse de crawl SEO
• #7 Tuto Claude utiliser le MCP DataforSEO pour construire un dashboard de visibilité
• Tuto #8 Claude : audit de cannibalisation de pages avec le MCP DataForSEO

Depuis le début de cette série, on a presque exclusivement dans l’application Claude Desktop : on connecte des MCP, on configure des Skills, on uploade des CSV. C'est un super efficace et fonctionne dans la majorité des cas d'usage SEO.

Mais il a une limite structurelle : Claude Desktop est une interface de conversation. À chaque session, vous repartez de zéro. Claude ne sait pas dans quel dossier vous travaillez, ne voit pas vos fichiers sauf si vous les uploadez manuellement, et n'a aucune mémoire de votre contexte professionnel d'une conversation à l'autre.

Claude code se rapproche plus d’un agent qui travaille dans votre environnement, avec un accès direct à vos fichiers, votre terminal, et vos données. Je l’utilise intégré dans Visual Studio Code :

Ce tuto couvre trois choses :

1. Pourquoi Claude Code plutôt que Claude Desktop pour certains workflows SEO
2. Les fichiers clés à connaître (et ce qu'ils font concrètement)
3. Comment installer Claude Code dans VS Code et faire votre premier test SEO

1. Claude Code vs Claude Desktop : quand utiliser l'un ou l'autre ?

La règle simple pour choisir

• Tâche ponctuelle, fichier unique, workflow standard → Claude Desktop
• Projet multi-fichiers, scripts Python, résultats à sauvegarder, automatisation → Claude Code

2. Les fichiers clés à connaître avant de se lancer dans Claude Code

Avant de lancer une session Claude Code, il faut comprendre l'architecture des fichiers qui la gouvernent. Deux niveaux : un niveau global (valable pour tous vos projets) et un niveau projet (spécifique à un client).

2.1 Le niveau global

Ces fichiers vivent dans le fichier à la racine ~/.claude/ et sont lus automatiquement à chaque session, quel que soit le dossier dans lequel vous travaillez. Vous les écrivez une fois, Claude s'en souvient toujours.

Voici deux exemples mais on peut imaginer en ajouter d’autres :

CLAUDE.md : Les instructions générales de session

C'est le chef d'orchestre. Il dit à Claude comment se comporter : langue, format des réponses, outils disponibles, règles de priorisation. Tout ce qui est transversal à toutes vos tâches.

Exemple :

# Instructions générales

- Réponds toujours en français
- Priorise les recommandations par impact/effort
- Pour les contenus >1200 mots : rédige section par section
- Date toujours tes analyses SERP
- Avant d'agir sur une tâche complexe : pose 2-3 questions de clarification

my-voice.md : Votre style d'écriture

Claude utilise votre vocabulaire et évite tous les patterns IA reconnaissables. Phrases courtes, verbes d'action, zéro remplissage.

Exemple :

commands/ : Vos slash commands (l'équivalent des Skills)

Chaque fichier .md dans ce dossier devient une commande disponible dans toutes vos sessions, accessible avec /nom-de-la-commande. C'est l'équivalent des Skills de Claude Desktop, mais portables dans le terminal.

Dans une session Claude Code, vous tapez /seo-brief "meilleur soin anti-taches visage" Claude exécute le workflow complet défini dans seo-brief.md.

➡️ Voir les skills présentées lors des tutos de ces dernières semaines.

.mcp.json : La configuration des MCP

L'équivalent de l'interface "Connecteurs" de Claude Desktop, mais en fichier texte. Il configure les serveurs MCP disponibles dans toutes vos sessions.

➡️ Voir les MCP présentées lors des tutos de ces dernières semaines.

2.2 Le niveau projet : le contexte client

Ces fichiers vivent à la racine de chaque dossier projet. Ils sont lus en plus des fichiers globaux quand Claude Code est lancé dans ce dossier.

La logique est simple : vos fichiers globaux définissent qui vous êtes. Le fichier projet définit dans quel contexte vous travaillez aujourd'hui.

project-context.md : Le brief client permanent

C'est tout ce que vous réexpliquez normalement à chaque fois quand vous travaillez sur un client. Vous l'écrivez une fois, Claude s'en souvient à chaque session dans ce dossier.

3. Tuto : installer Claude Code dans VS Code et faire votre premier test SEO

3.1 Prérequis

Avant de commencer :

• Un abonnement Claude Pro ou Max (Claude Code est inclus, pas besoin de clé API séparée)
• VS Code installé (version 1.98 ou plus récente)
• Node.js 18+ installé sur votre machine (vérifiez avec node --version dans votre terminal)

3.2 Étape 1 : Installer le CLI Claude Code

Ouvrez votre terminal et lancez :

npm install -g @anthropic-ai/claude-code

3.3 Étape 2 : Installer l'extension VS Code

Dans VS Code, ouvrez le panneau Extensions :

• Mac : Cmd+Shift+X
• Windows/Linux : Ctrl+Shift+X

Recherchez "Claude Code" et installez l'extension officielle publiée par Anthropic (vérifiez bien le nom de l'éditeur — il y a des extensions tierces avec des noms similaires).

Une icône ✦ (spark) apparaît dans la barre latérale gauche de VS Code. Cliquez dessus pour ouvrir le panneau Claude Code.

👉 Doc officiel de Claude sur le sujet

Lors de la première ouverture, vous serez invité à vous connecter avec votre compte Anthropic.

3.4 Étape 3 : Créer vos fichiers de contexte global

Dans votre terminal, créez la structure complète d'un coup :

mkdir -p ~/.claude/commands
touch ~/.claude/CLAUDE.md
touch ~/.claude/my-voice.md

Puis ouvrez le dossier dans VS code pour compléter les deux fichiers .md que vous venez de créer.

code ~/.claude

Remplissez chaque fichier selon les exemples de la section 2.1. Commencez par about-me.md. c'est celui qui a l'impact immédiat le plus fort. Claude saura qui vous êtes dès la première session sans que vous ayez à vous présenter.

3.5 Étape 4 : Créer vos premières commandes

Créez votre première commande SEO. Dans VS Code, créez le fichier ~/.claude/commands/gsc-analyse.md :

Pour cela :

3.6 Etape 5 : Créer votre premier project-context.md client

Vous pouvez maintenant créer un dossier sur votre machine (~/projets-seo/mon-client/) et ajouter dedans un fichier project-context.md avec le contexte spécifique à ce client

À partir de là, quand vous ouvrez ce dossier dans VS Code et lancez Claude Code, il lit automatiquement vos fichiers globaux et le contexte client. Vous arrivez directement en mode opérationnel.

Pour cela dans VS code, vous allez ouvrir votre dossier avec :

/cd 'chemin_vers_votre_dossier'

Puis ajouter “Claude” pour ouvrir Claude dans votre session !

3.7 Étape 6 : Place au test avec l’analyse d’un export GSC

J’ai rajouté à la racine de mon dossier client un export de la search console. Je demande à Claude Code d’analyser ce fichier avec la commande project-context.md que j'ai créé ci-avant !

/gsc-analyse analyse le fichier export-gsc-monsite-mars2026.csv

Alors qu’est ce que ça donne ?

Je prépare une vidéo plus complète de ce tuto! RDV la semaine prochaine pour voir ça ensemble!

FOUCAULD HENIN

Senior SEO consultant et fondateur de 30A  

Je vous accompagne dans conception et la mise en place de vos chantiers SEO.

Après plusieurs expériences chez des retaillers, clients grand comptes et scale up, j’apporte une vision rationnelle et data driven dans les stratégies SEO.

Références : Oscaro, Total Energie, Intermarché, Oreegami

#bigquery #Looker #data analyse