🤖 Retour d'expérience · 2025

Claude Code,
3 façons de l'utiliser

J'ai passé des semaines à tester Claude Code sur mes projets Spring Boot et Angular. Voici ce que j'aurais aimé savoir dès le départ — du premier npm install jusqu'au terminal qui fait tourner mon business.

Commencer niveau 1 → Vue d'ensemble ✦ Travailler avec moi
👨‍💻
Salim Hamidi Architecte logiciel · Spring Boot · Angular · Fondateur comptazone.tn & factureexpress.tn · Voir mon profil LinkedIn ↗
01

Par où tout le monde commence · et où beaucoup s'arrêtent

Les bases

Pas besoin de tout configurer d'un coup. Ces cinq trucs suffisent pour avoir Claude Code vraiment utile dès aujourd'hui.

① L'installation — ça prend 2 minutes chrono

Un simple npm install et c'est parti. Fonctionne dans le terminal, dans VS Code, dans Windsurf. Pas de setup compliqué.

Terminal
# Installation globale
npm install -g @anthropic-ai/claude-code

# Lancer dans votre projet Spring Boot
cd mon-projet-springboot
claude
💡 Premier réflexe : Tapez claude /plan avant de toucher quoi que ce soit. Claude lit le pom.xml, comprend la structure du projet et vous dit ce qu'il compte faire. Évite pas mal de surprises.
📄

② Le fichier CLAUDE.md — votre mémoire permanente

Claude repart de zéro à chaque session. Le CLAUDE.md règle ce problème : tout ce que vous mettez dedans est relu automatiquement. Plus besoin de ré-expliquer le projet à chaque fois.

CLAUDE.md (exemple Spring Boot)
# Contexte Projet
Application: API REST Spring Boot 3.2, Java 17
BDD: PostgreSQL via JPA/Hibernate
Tests: JUnit 5 + Mockito, couverture > 80%
Messaging: Kafka (topics: orders.*, payments.*)

# Conventions
- Pas de field injection (@Autowired), toujours constructeur
- Utiliser records Java pour les DTOs
- Chaque service doit avoir son interface
- Javadoc obligatoire sur les méthodes publiques
💡 Ce que j'y mets : Les conventions de nommage, les topics Kafka du projet, les règles d'injection Spring. Une semaine après, Claude code comme si c'était lui qui avait écrit le projet.
🔐

③ Permissions — Claude peut faire beaucoup, mais vous décidez quoi

Quatre niveaux d'accès. Au début je laissais tout ouvert, c'est une erreur. Sur un projet de prod, commencez en lecture seule et montez progressivement.

Modes
# Mode 1 : Lecture seule (par défaut)
claude --permission read

# Mode 2 : Lecture + écriture fichiers
claude --permission write

# Mode 3 : Avec exécution de commandes
claude --permission execute

# Mode 4 : Full bypass (dangereux en prod!)
claude --permission bypass
💡 Mon usage : read quand je fais une revue de code sur les consumers Kafka, execute uniquement quand je veux qu'il génère et lance les tests directement.
🔭

④ /plan d'abord — la règle que j'aurais voulu apprendre plus tôt

Pendant longtemps je donnais une tâche directement à Claude et je regardais ce qu'il faisait. Mauvaise idée. Depuis que j'utilise /plan systématiquement, je perd beaucoup moins de temps à corriger des erreurs évitables.

Exemple concret
# Dans Claude Code :
/plan Ajouter un circuit breaker Resilience4j 
sur le service de paiement Kafka, 
avec fallback et métriques Micrometer

→ Claude analysera :
- Vos consumers Kafka existants
- Votre pom.xml (dépendances manquantes ?)
- Les classes de config Spring
- Votre structure de tests
⌨️

⑤ Les commandes slash — simples mais indispensables

Quatre commandes que j'utilise tous les jours. Rien de magique, juste très pratiques une fois qu'on les a en réflexe.

Slash Commands
/plan     # Mode recherche lecture seule
/context  # Affiche le contexte chargé
/compact  # Compresse l'historique (tokens)
/clear    # Repart de zéro

# Exemples d'usage quotidien :
/plan Analyser pourquoi mon consumer Kafka
       CommitFailedException en production

/compact  # Avant une longue session de refacto
02

Là où ça devient vraiment intéressant

Ce que la plupart ne font pas

Quand j'ai découvert les Skills et les agents parallèles, j'ai compris pourquoi certains devs semblent produire trois fois plus que les autres.

📚

① Les Skills — vos workflows écrits une fois, réutilisés à l'infini

Un fichier Markdown qui décrit une procédure complète. Claude le lit et l'exécute en entier. J'en ai un pour chaque tâche répétitive : consumer Kafka, audit sécu, génération de doc.

skills/add-kafka-consumer.md
## Skill: Ajouter un Consumer Kafka Spring
1. Lire la config Kafka dans application.yml
2. Créer KafkaConsumerConfig.java avec
   ConcurrentKafkaListenerContainerFactory
3. Générer le @KafkaListener avec :
   - Gestion d'erreur + DeadLetterTopic
   - Méthode de retry avec @Retryable
4. Créer KafkaConsumerTest.java avec
   EmbeddedKafka
5. Vérifier la cohérence avec pom.xml

# Utilisation :
claude "Appliquer skill add-kafka-consumer 
        pour le topic orders.created"
🤖🤖

② Agents en parallèle — comme avoir 3 devs sur le même sprint

Je lance plusieurs agents sur des tâches indépendantes en même temps. Ce qui prenait une journée entière se règle en fin de matinée.

Agents parallèles — Spring Boot
# Lancer 3 agents en parallèle :
claude --parallel \
  "Agent 1: Migrer UserService vers records Java" \
  "Agent 2: Ajouter tests manquants OrderService" \
  "Agent 3: Écrire OpenAPI spec pour /api/v2/*"

# Résultat : 3 PRs distinctes en ~5 minutes
# au lieu de 3 heures de travail séquentiel
💡 Cas concret : Pendant une migration Java 17 sur un vieux projet, j'ai lancé 4 agents en même temps sur 4 microservices différents. Aucune interférence, chacun travaillait dans son coin.
🏭

③ CI/CD avec Claude — la doc qui se met à jour toute seule

Release notes, spec OpenAPI, CHANGELOG — des tâches que personne n'aime faire et que tout le monde repousse. Je les ai mises dans le pipeline GitHub Actions. Elles tournent sans que j'y pense.

Automatisation CI/CD
# Dans votre pipeline GitHub Actions :
- name: Generate Release Notes
  run: |
    claude "Lire les commits depuis le dernier tag,
    générer un CHANGELOG.md structuré avec:
    - Nouvelles fonctionnalités
    - Corrections de bugs Kafka
    - Breaking changes API"

- name: Update OpenAPI Docs  
  run: claude "Synchroniser openapi.yaml avec 
            les @RestController modifiés"
Hébergez n8n sur Hostinger — offre partenaire VPS n8n prêt en 5 min · -20% de réduction avec ce lien d'affiliation
-20% →

🤝 Lien affilié — vous obtenez 20% de réduction, je perçois une commission. Aucun surcoût.

🔌

④ Les serveurs MCP — Claude branché sur vos outils réels

Là c'est le truc qui change vraiment la donne. Claude ne travaille plus sur des fichiers isolés — il a accès à votre Jira, votre GitHub, votre base Postgres. Il voit le projet en vrai.

.claude/config.json
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["@upstash/context7-mcp"]
    },
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp"]
    }
  }
}
# Context7 = doc Spring Boot always up-to-date
# Playwright = tests E2E générés auto
Hébergez vos MCPs & n8n sur Hostinger VPS Node.js en 5 min · -20% de réduction avec ce lien d'affiliation
-20% →

🤝 Lien affilié — vous obtenez 20% de réduction, je perçois une commission. Aucun surcoût.

📦

⑤ Packager pour un client — livrer un outil, pas juste du code

Au lieu de livrer un repo et d'expliquer comment s'en servir, je livre un ZIP avec tout dedans. Le client tape une commande, ça tourne. Ça fait une grosse différence sur la perception.

Structure ZIP plugin
audit-spring-security.zip/
├── CLAUDE.md          # Context du plugin
├── skills/
│   ├── check-deps.md  # Scan CVE pom.xml
│   ├── audit-jwt.md   # Vérif JWT config
│   └── report.md      # Génère rapport PDF
└── run.sh             # claude /run audit

# Client exécute :
unzip audit-spring-security.zip && ./run.sh
03

Peu de gens arrivent ici — c'est là que le ROI devient sérieux

L'usage avancé

À ce stade Claude Code n'est plus un outil de dev. C'est l'infrastructure de votre activité. Tout ce qui est répétitif tourne sans vous.

🧠

① Organiser ses projets en PARA — le Second Brain

J'ai tout mis dans une arborescence de dossiers structurée : projets actifs, domaines de compétence, ressources, archives. Claude navigue dedans comme si c'était lui qui l'avait rangé.

Structure PARA — Dev Consultant
~/brain/
├── Projects/
│   ├── comptazone-v2/    # JHipster SaaS
│   │   ├── CLAUDE.md
│   │   └── backlog.md
│   └── client-windeco/
├── Areas/
│   ├── kafka-expertise/  # Veille technique
│   └── spring-boot-3/
├── Resources/
│   └── spring-security/
└── Archive/
    └── 2024-missions/
💡 Gain concret : Mon standup du matin se résume à claude "Résume mes projets actifs". En 30 secondes j'ai une vue de ce qui avance, ce qui bloque, ce qui attend.
🔧

② Des Skills pour tout — posts LinkedIn, devis, rapports hebdo

J'ai des Skills pour les tâches que je faisais à la main et qui me coûtaient du temps sans m'apporter de valeur. Rédiger un post technique, générer une proposition commerciale, faire le bilan de la semaine pour un client.

Exemples de skills high-value
# skills/write-linkedin-post.md
"Transformer une réalisation technique
 en post LinkedIn 300 mots avec hook,
 leçon et CTA. Ton expert bienveillant."

# skills/generate-proposal.md
"Depuis ~/brain/client-{name}/, générer
 une proposition commerciale PDF avec
 stack technique, planning et devis."

# skills/weekly-review.md
"Analyser commits Git, tickets Jira fermés,
 générer weekly report pour le client."
🌐

③ Connecter 7 serveurs MCP ou plus — Claude voit tout

Jira, GitHub, Postgres, Slack, Notion, un CRM… à ce stade Claude ne répond plus à des questions sur le code, il agit directement dans vos outils. Créer un ticket, interroger la base, notifier l'équipe — en une phrase.

MCP pour consultant Java/SaaS
{
  "mcpServers": {
    "jira":    { ... },  // Gestion tickets
    "github":  { ... },  // PRs et reviews
    "notion":  { ... },  // Wiki technique
    "slack":   { ... },  // Notifs équipe
    "postgres":{ ... },  // Requêtes directes
    "attio":   { ... },  // CRM clients
    "context7":{ ... }   // Docs Spring up-to-date
  }
}
# "Crée un ticket Jira depuis ce bug Kafka
#  et notifie #backend sur Slack"
💼

④ LinkedIn depuis le terminal — sans ouvrir le navigateur

Je sais que ça paraît gadget. Mais quand vous avez 10 minutes entre deux tâches et que vous voulez publier quelque chose ou contacter des prospects, ne pas avoir à ouvrir un onglet change vraiment les habitudes.

Workflow LinkedIn CLI
# Poster un contenu technique depuis le terminal
claude "Lis ~/brain/Projects/comptazone-v2/
dernière-feature.md et publie un post
LinkedIn technique avec code snippet
et 3 hashtags pertinents"

# Prospecter automatiquement
claude "Via Unipile MCP, envoyer message
de connection à 10 DSI tunisiens
qui ont liké mon dernier post"
🚀

⑤ Une vraie journée de travail — ce que ça donne en pratique

Voilà à quoi ressemble ma matinée maintenant. Ce n'est pas de la magie, c'est juste de la rigueur dans la mise en place des workflows. Mais une fois en place, le temps libéré est réel.

Journée type — Consultant Avancé
09:00 claude /run morning-review
       → Commits hier, tickets en retard,
         métriques SaaS, messages clients

10:00 claude /run sprint-planning
       → Analyse backlog, propose tickets
         prioritisés avec effort estimé

17:00 claude /run end-of-day
       → Weekly report client, post LinkedIn,
         mise à jour CRM, backup brain
💡 Ce que ça change vraiment : Je passe moins de temps sur ce qui est urgent mais pas important — et plus sur ce qui l'est. L'architecture, les décisions techniques, les clients.

Les 3 usages en un coup d'œil

Critère Les bases Ce qui change tout L'usage avancé
Temps d'apprentissage 1 journée 1-2 semaines 1-3 mois
Temps économisé/semaine 2-5h 5-10h 15-20h
Cas d'usage Java/Spring/Angular Génération code, debug Agents parallèles, CI/CD Business automatisé
Intégration Kafka Analyse erreurs Génère consumers + tests Monitoring + alertes auto
Configuration requise CLAUDE.md basique Skills Markdown + MCP PARA Brain + 7+ MCP
ROI estimé consultant +20% productivité ×2 capacité de delivery Business semi-automatisé
Pour tout le monde
🚀 Guide Gratuit

L'IA au quotidien :
ce que personne
ne vous explique

J'ai vu beaucoup de gens "essayer l'IA" une fois, ne pas savoir quoi en faire, et abandonner. Ce guide, c'est ce que j'aurais aimé avoir au départ — des cas concrets, pas de jargon.

Guide "IA Pratique" — 28 pages
PDF illustré · lecture en 20 min
Écrire
Gagner du temps
Apprendre
Créer
7 cas d'usage
20 min de lecture
0€ 100% gratuit

Ce que vous trouverez dedans

7 situations du quotidien où l'IA fait vraiment gagner du temps :

  • Écrire un email difficile sans tourner en rond pendant 20 minutes
  • 📋 Comprendre un long document sans tout lire ligne par ligne
  • 💡 Sortir du blocage quand une idée ne vient pas
  • 🗓 Organiser une semaine chargée sans y passer une heure
  • 🔍 Faire une recherche approfondie en quelques minutes
  • 🎨 Créer du contenu pour les réseaux sans que ça se voit
  • 🧾 Déchiffrer un contrat ou une facture sans être juriste

🔒 Gratuit. Sans spam. Désinscription en 1 clic.

Email envoyé !

Le guide arrive dans votre boîte mail.
Vérifiez vos spams si vous ne le voyez pas sous 2 min.

🎁 Ressource Gratuite

Récupérez mon
CLAUDE.md Spring Boot
tel que je l'utilise

Le template exact que j'ai mis des semaines à affiner, avec les 10 Skills Kafka que j'utilise au quotidien. Pas du théorique — du code qui tourne en prod.

Mon CLAUDE.md Spring Boot 3.x 10 Skills Kafka testés en prod Config MCP Context7 + GitHub Skill audit sécurité Spring Mon template de rapport client Exemples JUnit 5 + Mockito

🔒 Aucun spam. Désabonnement en 1 clic. Vos données restent privées.

Email envoyé !

Le kit arrive dans votre boîte mail dans quelques secondes.
Vérifiez vos spams si vous ne le voyez pas sous 2 min.

Par où commencer ?
Les bases, tout simplement.

Pas besoin de tout mettre en place d'un coup. Installez Claude Code, créez un CLAUDE.md honnête sur votre projet, et testez /plan sur votre prochaine tâche. La suite vient naturellement.

Revoir le Niveau 1 → Docs officielles ↗
👨‍💻
● Disponible

Salim Hamidi

Architecte logiciel senior · Spring Boot · Angular · Consultant IA · Fondateur SaaS

J'ai passé 20 ans à construire des applications Java en production — des monolithes Spring Boot aux architectures microservices avec Kafka, en passant par des frontends Angular complexes. Il y a quelques années j'ai commencé à intégrer l'IA dans mes workflows, et ce site est le résultat de ce que j'ai appris en chemin.

Je suis le fondateur de comptazone.tn, une plateforme SaaS de comptabilité pour les entreprises tunisiennes, et de factureexpress.tn, un outil gratuit de facturation électronique conforme El-Fatoora. J'aide aussi des équipes francophones à intégrer concrètement l'IA dans leur quotidien de dev — pas de la théorie, du concret qui tourne en prod.

20 ans Java · Spring Boot · Angular
2 SaaS en production
Kafka architectures event-driven
Tunisie marché francophone
✦ Travaillons ensemble

Vous voulez
intégrer l'IA dans
votre équipe ?

Ce que vous venez de lire, je le fais en vrai — sur mes propres projets et pour des clients. Si vous voulez aller vite sans vous tromper de direction, je peux intervenir directement chez vous.

500€
/ jour · audit & formation
800€
/ jour · intégration complète
2–3j
pour une équipe opérationnelle

Missions typiques

  • Lire votre codebase et écrire un CLAUDE.md qui colle à votre projet
  • Créer les Skills pour vos tâches répétitives : reviews, release notes, tests
  • Brancher les MCP sur vos outils : Jira, GitHub, Postgres, Slack
  • Mettre en place n8n pour automatiser sans toucher au code
  • Former votre équipe — 2 à 4 devs, une journée, autonomes après
  • Moderniser une appli Spring Boot / Angular / JHipster

Décrivez votre projet —
je vous réponds sous 24h

Pas de commercial. Je réponds personnellement à chaque message.

✦ Envoyer ma demande →

🔒 Vos données ne sont pas partagées.

Outils que j'utilise et que je recommande

🚀
Hostinger
Hébergement VPS & Cloud · -20% avec ce lien

C'est là que j'héberge mes serveurs n8n et mes MCPs custom. VPS NVMe, Node.js et Java configurés en quelques minutes. À partir de 4,99€/mois — et 20% de réduction automatiquement appliqués via ce lien d'affiliation.

Obtenir -20% →

🤝 Lien affilié — vous obtenez 20% de réduction, je perçois une commission. Aucun surcoût.

n8n sur Hostinger
Automatisation · -20% avec ce lien

L'outil que j'utilise pour tout ce qui est automatisation sans toucher au code. Hébergé sur Hostinger — VPS n8n prêt en 5 minutes. 20% de réduction via ce lien d'affiliation, appliqués automatiquement.

Obtenir -20% →

🤝 Lien affilié — vous obtenez 20% de réduction, je perçois une commission. Aucun surcoût.