Claude code mod WordPress : mes configs prêtes à l'emploi

Station de travail futuriste illustrant la configuration d'un claude code mod wordpress sécurisé
Creil – Chambly – Chantilly – Clermont – Abbeville – Albert – Amiens – Beaumont-sur-Oise – Cergy – Château-Thierry – Chauny – Compiègne – Crévecœur-le-Grand – Grandvilliers – L'Isle-Adam – Lacroix-Saint-Ouen – Laon – Montdidier – Nanteuil-le-Haudouin – Nogent-sur-Oise – Noyon – Péronne – Persan – Pontoise – Roissy-en-France – Roye – Saint-Maximin (60) – Saint-Quentin – Soissons – Tergnier – Thourotte – Villers-Cotterêts – Département de l'Aisne (02) – Département de la Somme (80) – Estrées-Saint-Denis – Gouvieux – Lamorlaye – Liancourt – Margny-lès-Compiègne – Méru – Ribécourt-Dreslincourt – Saint-Just-en-Chaussée – Senlis – Beauvais – Breteuil – Montataire – Mouy – Pont-Sainte-Maxence – Villers-Saint-Paul – Crépy-en-Valois – Creil – Chambly – Chantilly – Clermont – Abbeville – Albert – Amiens – Beaumont-sur-Oise – Cergy – Château-Thierry – Chauny – Compiègne – Crévecœur-le-Grand – Grandvilliers – L'Isle-Adam – Lacroix-Saint-Ouen – Laon – Montdidier – Nanteuil-le-Haudouin – Nogent-sur-Oise – Noyon – Péronne – Persan – Pontoise – Roissy-en-France – Roye – Saint-Maximin (60) – Saint-Quentin – Soissons – Tergnier – Thourotte – Villers-Cotterêts – Département de l'Aisne (02) – Département de la Somme (80) – Estrées-Saint-Denis – Gouvieux – Lamorlaye – Liancourt – Margny-lès-Compiègne – Méru – Ribécourt-Dreslincourt – Saint-Just-en-Chaussée – Senlis – Beauvais – Breteuil – Montataire – Mouy – Pont-Sainte-Maxence – Villers-Saint-Paul – Crépy-en-Valois
Table des matières

Vous lancez Claude Code dans votre terminal, vous lui demandez de coder une fonctionnalité, et vous admirez le spectacle. Cinq minutes plus tard, vous ouvrez le fichier PHP généré. L’horreur intégrale. Des requêtes SQL brutes injectées sans pitié, des fonctions dépréciées depuis dix ans, zéro nonce, zéro échappement de variable.

Le moteur d’Anthropic est bluffant de rapidité. Mais sans un cadrage chirurgical dès le départ, il code exactement comme un stagiaire pressé qui empile les snippets trouvés sur des forums poussiéreux. C’est du pur bricolage.

Dans mon agence web installée dans l’Oise, je passe mes journées entre la ligne de commande, le monitoring de mes serveurs et des audits de sites mal en point. L’impact IA développement web ne doit pas être synonyme de code jetable ou de failles béantes.

J’ai donc conçu deux configurations sur-mesure — deux « mods » au format CLAUDE.md — que j’utilise chaque jour sur mes propres machines. Un premier taillé sur mesure pour le CMS au logo W, et un second universel taillé pour n’importe quel projet d’application moderne. Je vous les partage ici, sans filtre.

Claude Code sans fichier de cadrage : la garantie d’un code poubelle

Soyons clairs deux minutes. Quand Claude Code tourne en roue libre dans un répertoire WordPress, que fait-il ? Il improvise.

Il va aller chercher la solution la plus courte, quitte à créer des trous de sécurité gros comme le tunnel sous la Manche. Vous voulez un exemple concret ? Pas plus tard que la semaine passée, j’ai récupéré le code pondu par un client enthousiaste qui avait tenté de générer un plugin WordPress personnalisé avec son terminal.

Le résultat ? Des variables passées directes dans $_POST sans aucun assainissement. Aucune vérification des capacités utilisateurs avec current_user_can(). Résultat : n’importe quel visiteur mal intentionné pouvait modifier les options critiques du site en exécutant une simple requête cURL. Un carnage absolu.

Laisser un agent autonome modifier vos scripts sans lui imposer des garde-fous stricts, c’est comme confier les clés de votre serveur de production à un inconnu croisé sur un parking.

Pourquoi ce fiasco arrive-t-il systématiquement ? L’intelligence artificielle n’a pas votre recul d’architecte. Elle ignore les spécificités de votre environnement, vos impératifs de performance ou les exigences d’une mise à jour PHP récente sur vos clusters d’hébergement. Sans directives écrites noir sur blanc dans son contexte de démarrage, elle prendra toujours le raccourci le plus simpliste.

Comment fonctionne le système de mémoire CLAUDE.md sous le capot

Pour dompter l’outil, il faut comprendre ses entrailles. À chaque lancement d’une session, Claude Code scrute la racine de votre répertoire de travail à la recherche d’un fichier bien précis : CLAUDE.md.

Ce document Markdown n’est pas une simple note bloc-notes. C’est la boussole permanente de l’agent. Tout ce qui figure à l’intérieur est injecté directement dans sa fenêtre de contexte initiale. Comme l’explique la documentation officielle sur le site d’Anthropic, ces directives écrasent les comportements par défaut du modèle.

Si vous structurez ce fichier avec précision, le comportement change du tout au tout. L’agent cesse d’inventer des fonctions fantaisistes. Il respecte à la lettre vos conventions de nommage, vos standards de sécurité et vos commandes de tests.

Critère technique Claude Code sans mod Claude Code avec mod CLAUDE.md
Gestion de la sécurité Variables brutes, nonces oubliés un coup sur deux Nonces obligatoires, sanitization et validation strictes
Standards de code Mélange aléatoire de styles, PHP procédural bancal Conformité WPCS, PSR-12, typage strict
Intégration d’outils Commandes bash risquées exécutées à l’aveugle Exécution ciblée via WP-CLI, Composer et PHPUnit
Prise en compte serveur Ignore les versions PHP et les caches OPcache Respect strict de la version PHP minimale définie

Ce tableau résume la différence entre un outil qui bousille un thème en pleine nuit et un véritable copilote qui respecte vos règles métier. Le secret réside uniquement dans la qualité de votre fichier de règles.

Mon mod Claude Code pour WordPress : la sécurité et les standards d’abord

Voici le premier cadeau. C’est le mod claude code mod wordpress que j’injecte systématiquement dans mes projets clients à l’agence. Copiez-le tel quel dans un fichier CLAUDE.md placé à la racine de votre thème ou de votre extension.

# DIRECTIVES DE DÉVELOPPEMENT WORDPRESS

## IDENTITÉ & ENVIRONNEMENT DU PROJET
- Type de projet : Plugin / Thème WordPress
- PHP minimum requis : 8.1 (Typage strict activé : declare(strict_types=1);)
- WordPress minimum : 6.4
- Standards : Respect absolu du WordPress Coding Standards (WPCS)

## SÉCURITÉ ABSOLUE (RÈGLES INNÉGOCIABLES)
1. Toujours vérifier les nonces sur chaque formulaire et appel AJAX / REST avec wp_verify_nonce() ou check_ajax_referer().
2. Assainir (sanitize) TOUTES les entrées utilisateurs selon leur type : sanitize_text_field(), absint(), sanitize_email().
3. Échapper (escape) TOUTES les sorties HTML sans exception : esc_html(), esc_attr(), esc_url(), wp_kses_post().
4. Vérifier les autorisations utilisateurs avant toute action : current_user_can('manage_options') ou capacité adéquate.
5. Zéro requête SQL manuelle non préparée : utiliser impérativement $wpdb->prepare().

## ARCHITECTURE & HOOKS
- Ne jamais coder en bloc monolithique dans functions.php.
- Séparer la logique métier, l'administration (admin/) et le rendu public (public/).
- Toujours déclarer les styles et scripts via wp_enqueue_scripts et admin_enqueue_scripts avec gestion de versions.
- Pour les requêtes personnalisées, privilégier WP_Query avec pagination propre plutôt que query_posts().

## TESTS & CONTRÔLE
- Avant de valider un commit, exécuter la vérification de syntaxe : php -l sur chaque fichier modifié.
- Utiliser WP-CLI pour les opérations système : wp plugin list, wp cache flush.

Pourquoi ce cadrage est-il vital ? Parce que la documentation pour développeurs WordPress regorge de conventions oubliées par les générateurs d’IA génériques. Avec ce mod, Claude Code arrête immédiatement de vous proposer des codes qui mettent en péril la stabilité de votre hébergement.

Que vous soyez un freelance solitaire ou un développeur web chevronné en agence, ce template évite des heures entières de refactorisation manuelle. Mieux : il vous aide à securiser site wordpress dès la toute première ligne de code tapée dans votre console.

Comparaison technique de structure de fichiers pour configurer un mod claude code wordpress

Mon second mod : le template universel pour tous vos dépôts web

Travailler sur WordPress, c’est mon pain quotidien. Mais comme tout artisan du web, je gère aussi des projets Laravel, des API Node.js ou des applications front-end modernes. Claude Code a cette fâcheuse tendance à vouloir trop en faire dès qu’on lui donne un peu de liberté.

Mon second mod est taillé pour calmer ses ardeurs sur n’importe quelle pile technologique. Il empêche l’agent de réécrire l’intégralité d’un fichier quand vous lui demandez une bête modification de trois lignes.

# RÈGLES DE DÉVELOPPEMENT UNIVERSELLES

## DIRECTIVES D'ACTION
- Ne modifie JAMAIS des fichiers non sollicités sans en expliquer clairement la raison au préalable.
- Préserve l'architecture existante : adopte le style de code déjà présent dans le dépôt (indentation, conventions, structure).
- Reste concis : ne réécris pas des blocs entiers si une modification localisée suffit.
- Pas de dépendances inutiles : n'ajoute aucun package npm ou composer sans accord explicite.

## FLUX GIT & SÉCURITÉ
- Les commits doivent respecter la norme Conventional Commits (ex: feat:, fix:, refactor:, chore:).
- Ne jamais toucher aux fichiers sensibles (.env, clés privées, secrets de configuration).
- Toujours vérifier l'intégrité du code après intervention (lancer la commande de test ou le linter défini).

## GESTION DES ANOMALIES
- En cas de doute sur une règle métier, pose la question au développeur avant d'assumer un comportement.
- Pas d'hallucination d'API : vérifie les signatures de fonctions dans la documentation locale avant d'écrire.

Ce template universel agit comme un silencieux sur l’enthousiasme débordant de l’agent. Il supprime les réécritures destructrices et évite de pourrir vos historiques Git avec des modifications parasites que personne n’a demandées.

Pourquoi cadrer les permissions de Claude Code évite le carnage en production

On ne va pas se mentir : laisser un script exécuter des commandes système sur votre machine implique une vigilance absolue. Claude Code intègre un fichier de permissions situé dans .claude/settings.json.

Ignorer ce fichier, c’est jouer à la roulette russe avec vos bases de données. Un jour, l’agent décide d’exécuter un wp db reset ou un rm -rf un peu trop enthousiaste pour « nettoyer » le cache, et c’est le drame.

Voici les règles de sécurité que j’impose dans mes configurations locales :

  • Verrouiller les commandes destructrices : Bloquez formellement l’accès aux commandes de suppression de tables ou de répertoires récursifs dans les paramètres deny.
  • Autoriser uniquement les outils de diagnostic : Permettez sans validation préalable php -l, git status, ou git diff pour que l’agent puisse auto-corriger ses bugs sans vous solliciter toutes les dix secondes.
  • Isoler les accès aux bases de données : Interdisez à l’agent de manipuler vos identifiants SQL bruts ou de modifier directement les fichiers de configuration type wp-config.php.

Quand un client dans l’Oise vient me voir paniqué parce que son environnement local a été rayé de la carte après une fausse manip d’outil d’automatisation, la cause est toujours la même : zéro barrière de sécurité à l’exécution. En balisant les droits d’action, vous gardez la main sur votre terminal quoi qu’il arrive.

Mettre en place vos mods dans votre terminal en deux minutes chrono

Pas besoin de sortir l’artillerie lourde ni de compiler quoi que ce soit. L’installation de ces deux fichiers prend moins de temps que de vous servir un café entre deux builds.

Pour le fichier WordPress, créez simplement un fichier CLAUDE.md directement à la racine de votre dossier de développement (par exemple dans wp-content/plugins/mon-plugin/). Collez-y le contenu du premier mod.

Pour votre mod universel, vous avez deux options :

  • Au niveau du projet : Créez le fichier CLAUDE.md à la racine de votre dépôt Git pour qu’il soit partagé avec toute votre équipe de développeurs.
  • Au niveau global de votre machine : Placez vos règles globales dans votre dossier utilisateur personnel pour que Claude Code applique ce comportement par défaut sur tous vos dossiers de travail. Pour approfondir ces configurations globales, consultez la documentation officielle de Mozilla Developer Network (MDN) sur l’outillage et l’environnement de développement web.

Une fois le fichier sauvegardé, lancez votre session habituelle dans le terminal. Tapez une simple requête. Vous constaterez immédiatement la différence de ton et de rigueur : l’agent commence par auditer la syntaxe, utilise les fonctions natives et refuse d’injecter du code non sécurisé.

Foire Aux Questions (FAQ)

Est-ce que le fichier CLAUDE.md ralentit les réponses de l’agent dans le terminal ?

Pas du tout. Le fichier est injecté une seule fois dans la mémoire contextuelle au moment où vous démarrez votre session. Tant que vous gardez votre document clair, concis et inférieur à 200 lignes, l’impact sur le temps de réponse est totalement invisible à l’usage.

Puis-je utiliser ces deux configurations simultanément sur une même machine ?

Oui, absolument. C’est même l’approche la plus saine : placez le mod universel dans votre configuration globale utilisateur pour cadrer vos habitudes Git et de concision, et ajoutez le mod WordPress spécifique à la racine de chacun de vos plugins ou thèmes pour écraser les règles génériques avec des contraintes PHP et sécurité très ciblées.

Le mod WordPress garantit-il un code sans aucune faille de sécurité ?

Non. Aucun prompt ni fichier de règles ne remplace l’œil averti d’un développeur humain expérimenté. Ce fichier élimine 90 % des bêtises classiques produites par l’IA (variables non échappées, requêtes brutes), mais vous devez systématiquement relire le diff avant de commiter ou de déployer sur vos serveurs.

Pourquoi privilégier CLAUDE.md plutôt que de répéter mes consignes dans mes prompts ?

Parce que vous allez inévitablement oublier de mentionner la moitié de vos consignes de sécurité un jour où vous êtes sous pression. Inscrire ces règles dans un fichier permanent garantit que l’agent applique le même niveau d’exigence à chaque interaction, sans gaspiller votre temps à retaper les mêmes instructions techniques.

Sebastien-Larrivee-v2.png

Sébastien Larrivée

Développeur - Rédacteur de contenu

iZyLiFy Conception Web, agence web oise

Je suis Sébastien Larrivée, développeur web sénior chez Nord-Image à Abbeville le jour, et freelance acharné la nuit. Concepteur d’applications, grand malade de SEO, accroc aux cryptos et collectionneur compulsif d’intelligences artificielles… Mais avant tout, je suis expert WordPress depuis plus de 10 ans. Ici, pas de blabla : je partage ce que je teste sur mes serveurs, j’aime quand le code est propre, quand c’est optimisé et surtout, quand ça ranke sur Google.

WordPress
SEO Technique
Développement Web
PHP
Table des matières
Generic selectors
Exact matches only
Search in title
Search in content
Post Type Selectors

Besoin
d'un site internet d'un site e-commerce de référencement naturel d'optimisation technique d'un audit ?

Chat avec Izy
1 Chat
izy ×
Fermer