Claude Code - Configuration Professionnelle

Une configuration Claude Code complète et réutilisable, optimisée pour le développement en équipe. Inclut un workflow EPCT structuré, des agents spécialisés, et un suivi des coûts en temps réel.

🎯 Pourquoi cette configuration ?

🚀 Productivité x3 : Workflow EPCT automatisé (Explore → Plan → Code → Test)
💰 Économie de tokens : Agents isolés qui préservent votre contexte principal
📊 Visibilité totale : Statusline avec coûts, tokens et métriques en temps réel
🔒 Sécurité renforcée : Permissions granulaires, fichiers sensibles protégés
👥 Collaboration facilitée : Configuration partageable et versionnable avec l'équipe

⚙️ Prérequis

Avant de commencer, assurez-vous d'avoir :

Claude Code v1.0+ (Installation)
Node.js 18+ (node --version)
Git (git --version)
jq - Parser JSON (brew install jq sur macOS)
ccusage v15.9.4+ - Suivi des coûts (npm install -g ccusage)

🚀 Quick Start (5 minutes)

Option A : Via Plugin Marketplace ⚠️

⚠️ ATTENTION - Statut Expérimental

La marketplace a actuellement des problèmes d'installation :

❌ Agents ne s'installent pas correctement

❌ Scripts ne s'installent pas correctement

✅ Commandes s'installent correctement

Recommandation : Utilisez l'installation manuelle (Option B) jusqu'à résolution.

Si vous souhaitez quand même tester :

# 1. Ajouter la Lingelo Marketplace
/plugin marketplace add Lingelo/lingelo-marketplace

# 2. Installer le plugin lingelo-base
/plugin install lingelo-base

# 3. Vérifier l'installation (agents et scripts manqueront probablement)
ls ~/.claude/agents/explore-code.md      # ❌ Manquant
ls ~/.claude/commands/epct.md            # ✅ OK
ls ~/.claude/scripts/statusline-ccusage.sh  # ❌ Manquant

⚠️ Vous devrez ensuite installer manuellement les agents et scripts manquants.

Option B : Installation Manuelle

1. Cloner et installer

# Cloner le repository
git clone https://github.com/Lingelo/claude-code-sample.git
cd claude-code-sample

# Installer ccusage pour la statusline
npm install -g ccusage

# Rendre le script statusline exécutable
chmod +x .claude/scripts/statusline-ccusage.sh

2. Choisir votre mode d'installation

Global (tous vos projets)

cp -r .claude/agents/* ~/.claude/agents/
cp -r .claude/commands/* ~/.claude/commands/
cp -r .claude/scripts/* ~/.claude/scripts/

Par projet (ce projet uniquement)

# La configuration est déjà dans .claude/
# Rien à faire !

3. Tester l'installation

# Lancer Claude Code dans le projet
claude

# Tester la commande /epct
/epct ajouter une fonction de logging simple

# Vérifier la statusline (s'affiche automatiquement)

✅ C'est tout ! Vous êtes prêt à utiliser la configuration.

✨ Features Principales

1. 🔄 Workflow EPCT - Développement Structuré

La commande /epct automatise un workflow en 4 phases :

/epct [description-de-la-fonctionnalité]

Les 4 phases :

EXPLORE : Lance des agents en parallèle pour trouver patterns et fichiers pertinents
PLAN : Crée une stratégie détaillée basée sur l'exploration
CODE : Implémente en suivant exactement les patterns du projet
TEST : Vérifie que tout fonctionne (tests ciblés uniquement)

Avantage clé : L'agent explore-code travaille dans son propre contexte isolé, économisant jusqu'à 70% de tokens sur votre conversation principale.

2. 🤖 Agent explore-code - Spécialiste du Codebase

Un agent autonome qui analyse votre code en profondeur :

Recherche exhaustive de patterns et conventions
Analyse des dépendances et imports
Identification des APIs et schémas de données
Extraction d'exemples de code pertinents

Automatiquement invoqué par /epct - fonctionne en arrière-plan sans polluer votre contexte.

3. 📊 Statusline Personnalisée - Suivi en Temps Réel

Affichage en temps réel de vos métriques :

🌿 main* (+15 -3) | 💄 default | 📁 ~/projects/my-app | 🤖 Claude 3.5 Sonnet
💰 $0.26 (5m) | 📅 $8.03 | 🧊 $8.03 (2h 45m left) | 🧩 2.7K tokens

Informations affichées :

🌿 Branche Git et changements en cours
💰 Coût de la session actuelle
📅 Coût journalier total
🧩 Nombre de tokens (input + output uniquement)
🤖 Modèle Claude utilisé

4. 🔒 Permissions Sécurisées

Configuration de permissions granulaires :

✅ Autorisé :

WebSearch (documentation)
git commit/add (version control automatisé)
npm/yarn (gestion de packages)
MCP servers (Context7, Atlassian, Playwright)

❌ Bloqué :

Lecture de .env* (protection des secrets)

Configuration partageable : settings.json versionné, settings.local.json personnel et gitignored.

📦 Installation

Méthode 1 : Plugin Marketplace ⚠️ Expérimental

⚠️ ATTENTION - Installation Incomplète

La marketplace Lingelo a actuellement des limitations :

❌ Agents : Ne s'installent pas dans ~/.claude/agents/

❌ Scripts : Ne s'installent pas dans ~/.claude/scripts/

✅ Commandes : S'installent correctement dans ~/.claude/commands/

Status : Problème en cours d'investigation avec l'équipe Claude Code.

Recommandation : Utilisez la Méthode 2 (Installation Manuelle) pour une installation complète.

Installation via marketplace (si vous souhaitez tester) :

# Ajouter la Lingelo Marketplace
/plugin marketplace add Lingelo/lingelo-marketplace

# Installer le plugin lingelo-base
/plugin install lingelo-base

# ⚠️ Installation incomplète - manquera agents et scripts
# Vous devrez compléter manuellement avec la Méthode 2

📦 Lingelo Marketplace - En développement actif

Méthode 2 : Installation Manuelle

Configuration Globale vs Par Projet

Aspect	Globale (`~/.claude/`)	Par Projet (`./.claude/`)
Disponibilité	Tous vos projets	Ce projet uniquement
Versioning Git	❌ Non	✅ Oui
Partage équipe	❌ Personnel	✅ Automatique via Git
Maintenance	Une seule config	Config par projet

Installation Globale

# Copier agents, commandes et scripts
cp -r .claude/agents/* ~/.claude/agents/
cp -r .claude/commands/* ~/.claude/commands/
cp -r .claude/scripts/* ~/.claude/scripts/

# Adapter settings.json à vos besoins
cp .claude/settings.json ~/.claude/settings.json

Installation Par Projet

La configuration est déjà présente dans .claude/. Il suffit de :

Cloner le repo
Rendre le script statusline exécutable : chmod +x .claude/scripts/statusline-ccusage.sh
Lancer Claude Code : claude

Approche Hybride

Combinez les deux pour un maximum de flexibilité :

# Global : Agents et commandes réutilisables
cp -r .claude/agents/* ~/.claude/agents/
cp -r .claude/commands/* ~/.claude/commands/

# Par projet : Settings spécifiques dans ./.claude/settings.json

Claude Code fusionnera automatiquement les deux configurations.

💡 Exemples & Workflows

Exemple 1 : Ajouter une nouvelle API

/epct ajouter un endpoint API pour récupérer les utilisateurs actifs

Ce qui se passe :

EXPLORE : Agent trouve les endpoints existants, patterns de routing, modèles de données
PLAN : Claude propose un plan aligné avec votre architecture
CODE : Implémentation avec les mêmes conventions que le reste du code
TEST : Vérification avec les tests pertinents uniquement

Résultat : Code cohérent, qui s'intègre naturellement dans votre codebase.

Exemple 2 : Débugger un problème

/epct débugger pourquoi l'authentification échoue en production

Ce qui se passe :

EXPLORE : Agent analyse le flux d'authentification, middlewares, logs
PLAN : Hypothèses de bugs basées sur le code existant
CODE : Fix avec ajout de logging approprié
TEST : Validation que le bug est corrigé

Exemple 3 : Refactoring complexe

/epct refactoriser le système de cache pour utiliser Redis au lieu de memcached

Ce qui se passe :

EXPLORE : Agent trouve toutes les utilisations de memcached, config, dépendances
PLAN : Stratégie de migration progressive
CODE : Remplacement avec patterns Redis existants (si déjà utilisé ailleurs)
TEST : Tests de régression sur les fonctionnalités de cache

📚 Documentation Détaillée

Pour aller plus loin :

Guide Complet : Configuration avancée, permissions, bonnes pratiques
MCP Servers : Installation et utilisation de Context7, Atlassian, Playwright
Voice Inc. : Interaction vocale avec Claude Code
CLAUDE.md : Référence technique pour Claude Code

🛠️ Troubleshooting

La statusline ne s'affiche pas

Problème : La statusline reste vide ou affiche des erreurs.

Solutions :

# Vérifier que ccusage est installé
ccusage --version  # Doit être >= v15.9.4

# Vérifier que jq est installé
jq --version

# Vérifier les permissions du script
chmod +x .claude/scripts/statusline-ccusage.sh

# Tester le script manuellement
./.claude/scripts/statusline-ccusage.sh

L'agent explore-code ne se lance pas

Problème : /epct ne lance pas l'agent en phase EXPLORE.

Solutions :

# Vérifier que l'agent existe
ls .claude/agents/explore-code.md

# Pour installation globale
ls ~/.claude/agents/explore-code.md

# Vérifier le contenu du fichier
cat .claude/agents/explore-code.md

Erreurs de permissions

Problème : Claude demande des permissions pour des actions autorisées.

Solutions :

# Vérifier settings.json
cat .claude/settings.json

# Vérifier qu'il n'y a pas d'erreurs JSON
jq . .claude/settings.json

# Si settings.local.json existe, vérifier la cohérence
cat .claude/settings.local.json | jq .

La commande /epct n'existe pas

Problème : /epct n'est pas reconnue.

Solutions :

# Vérifier que le fichier de commande existe
ls .claude/commands/epct.md

# Pour installation globale
ls ~/.claude/commands/epct.md

# Redémarrer Claude Code
# Ctrl+C puis relancer : claude

Tokens qui explosent pendant l'exploration

Problème : La phase EXPLORE consomme trop de tokens.

Solution : C'est normal ! L'agent explore-code travaille dans un contexte isolé. Les tokens d'exploration ne comptent PAS dans votre conversation principale. Votre contexte reste léger.

🔧 Configuration Avancée

Personnaliser les permissions

Éditez .claude/settings.json ou créez .claude/settings.local.json :

{
  "permissions": {
    "allow": [
      "WebSearch",
      "Bash(git commit:*)",
      "Bash(git add:*)",
      "Bash(npm:*)",
      "mcp__context7"
    ],
    "deny": [
      "Read(.env*)"
    ]
  }
}

Ajouter des serveurs MCP

Voir la documentation MCP détaillée pour installer :

Context7 : Documentation technique en temps réel
Atlassian : Intégration Jira, Confluence, Bitbucket
Playwright : Automatisation navigateur

Comparaison settings.json vs settings.local.json

Aspect	settings.json	settings.local.json
Git	✅ Versionné	❌ Gitignored
Scope	Équipe	Personnel
Priorité	Base	Override (écrase settings.json)
Usage	Standards d'équipe	Préférences personnelles
Exemple	Permissions de base	MCP personnels, API keys

💡 Tips et Astuces

Raccourcis Clavier

Échap (1x) : Vide l'input texte en cours
Échap Échap (2x) : Rewind d'une étape dans la conversation

Commandes de Contextualisation

# (dièse) : Ajouter une mémoire dans CLAUDE.md
- Sauvegarde d'informations importantes sur le projet
- Claude Code lira automatiquement ce fichier
@ (arobase) : Cibler un fichier particulier
- Usage : @nom-du-fichier.ext
- Charge le contenu du fichier dans le contexte

Bonnes Pratiques

1. Structure des demandes

✅ Formuler des demandes claires et précises
✅ Décomposer les tâches complexes avec /epct
✅ Vérifier les résultats après chaque modification

2. Gestion du code

✅ Préférer l'édition de fichiers existants à la création
✅ Laisser /epct découvrir les patterns avant de coder
✅ Demander validation du plan avant l'implémentation

3. Utilisation des workflows

✅ Toujours commencer par la phase EXPLORE avec /epct
✅ Ne pas modifier le scope pendant la phase CODE
✅ Exécuter uniquement les tests pertinents en phase TEST

🌟 Fonctionnalités à venir

Support de nouveaux MCP servers
Templates de projets préconfigurés
Intégration CI/CD avec hooks
Dashboard web pour métriques de session

🤝 Contribution

Les contributions sont les bienvenues ! N'hésitez pas à :

Fork le projet
Créer une branche pour votre feature (git checkout -b feature/AmazingFeature)
Commit vos changements (git commit -m 'Add AmazingFeature')
Push vers la branche (git push origin feature/AmazingFeature)
Ouvrir une Pull Request

📄 License

Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.

📞 Support & Ressources

Documentation

Documentation Claude Code officielle
Lingelo Marketplace : Plugin marketplace avec configurations prêtes à l'emploi
Guide détaillé de cette configuration
Documentation MCP
ccusage GitHub

Communauté

GitHub Issues : Signaler un bug ou demander une feature
Discussions : Questions et discussions

🙏 Remerciements

Anthropic pour Claude Code
Communauté Claude Code pour les retours et contributions
ryoppippi pour l'outil ccusage

Maintenu avec ❤️ par Angelo LIMA

Ce projet est continuellement mis à jour avec les meilleures pratiques de développement.

Name		Name	Last commit message	Last commit date
Latest commit History 11 Commits
.claude		.claude
docs		docs
.gitignore		.gitignore
CLAUDE.md		CLAUDE.md
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation

Claude Code - Configuration Professionnelle

🎯 Pourquoi cette configuration ?

📋 Table des matières

⚙️ Prérequis

🚀 Quick Start (5 minutes)

Option A : Via Plugin Marketplace ⚠️

Option B : Installation Manuelle

1. Cloner et installer

2. Choisir votre mode d'installation

3. Tester l'installation

✨ Features Principales

1. 🔄 Workflow EPCT - Développement Structuré

2. 🤖 Agent explore-code - Spécialiste du Codebase

3. 📊 Statusline Personnalisée - Suivi en Temps Réel

4. 🔒 Permissions Sécurisées

📦 Installation

Méthode 1 : Plugin Marketplace ⚠️ Expérimental

Méthode 2 : Installation Manuelle

Configuration Globale vs Par Projet

Installation Globale

Installation Par Projet

Approche Hybride

💡 Exemples & Workflows

Exemple 1 : Ajouter une nouvelle API

Exemple 2 : Débugger un problème

Exemple 3 : Refactoring complexe

📚 Documentation Détaillée

🛠️ Troubleshooting

La statusline ne s'affiche pas

L'agent explore-code ne se lance pas

Erreurs de permissions

La commande /epct n'existe pas

Tokens qui explosent pendant l'exploration

🔧 Configuration Avancée

Personnaliser les permissions

Ajouter des serveurs MCP

Comparaison settings.json vs settings.local.json

💡 Tips et Astuces

Raccourcis Clavier

Commandes de Contextualisation

Bonnes Pratiques

🌟 Fonctionnalités à venir

🤝 Contribution

📄 License

📞 Support & Ressources

Documentation

Communauté

🙏 Remerciements

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages