Aller au contenu principal

Guide de Configuration

Fichiers de Configuration​

Claude Code utilise plusieurs fichiers de configuration pour personnaliser votre expérience de développement :

  • Configuration Globale : ~/.claude/config.json
  • Configuration de Projet : ./claude.config.json ou ./CLAUDE.md
  • Variables d'Environnement : Pour les clés API et autres informations sensibles

Configuration Globale​

Paramètres de Base​

{
  "apiKey": "votre-cle-api",
  "model": "claude-3-5-sonnet-20241022",
  "outputStyle": "concise",
  "planMode": "auto",
  "maxTokens": 8192
}

Détails des Options de Configuration​

OptionTypeDéfautDescription
apiKeystring-Clé API Anthropic
modelstringclaude-3-5-sonnet-20241022Modèle Claude à utiliser
outputStylestringbalancedStyle de sortie : concise, balanced, verbose
planModestringmanualMode plan : auto, manual, off
maxTokensnumber4096Nombre maximum de tokens
temperaturenumber0.3Niveau de créativité (0-1)

Configuration de Projet​

Fichier CLAUDE.md​

Créez un fichier CLAUDE.md à la racine du projet pour configurer les paramètres spécifiques au projet :

# Projet : Mon Application Web

## Description du Projet
Il s'agit d'une application web moderne utilisant React + TypeScript.

## Standards de Codage
- Utiliser ESLint + Prettier
- Suivre le style de code Airbnb
- Utiliser des composants fonctionnels + Hooks
- Préférer TypeScript

## Structure des Fichiers
- `src/components/` - Composants React
- `src/hooks/` - Hooks personnalisés
- `src/utils/` - Fonctions utilitaires
- `src/types/` - Définitions de types TypeScript

## Notes Importantes
- Tous les appels API nécessitent une gestion d'erreurs
- Les composants doivent inclure PropTypes ou des types TypeScript
- Les nouvelles fonctionnalités nécessitent des tests unitaires correspondants

claude.config.json​

Ou utilisez le format JSON pour la configuration de projet :

{
  "project": {
    "name": "Mon Application Web",
    "type": "react-typescript",
    "framework": "vite"
  },
  "codeStyle": {
    "indentSize": 2,
    "quotes": "single",
    "semicolons": true,
    "trailingComma": "es5"
  },
  "testing": {
    "framework": "jest",
    "coverageThreshold": 80
  },
  "hooks": {
    "beforeCommit": ["npm test", "npm run lint"]
  }
}

Variables d'Environnement​

Variables d'Environnement Requises​

# Clé API Anthropic
export ANTHROPIC_API_KEY=votre_cle_api_ici

# Optionnel : spécifier le modèle
export CLAUDE_MODEL=claude-3-5-sonnet-20241022

# Optionnel : chemin de fichier de configuration personnalisé
export CLAUDE_CONFIG_PATH=/chemin/vers/config.json

Support de Fichier .env​

Créez un fichier .env à la racine du projet :

ANTHROPIC_API_KEY=votre_cle_api_ici
CLAUDE_OUTPUT_STYLE=concise
CLAUDE_PLAN_MODE=auto
CLAUDE_MAX_TOKENS=8192

Configuration Avancée​

Agents Personnalisés​

{
  "agents": {
    "codeReviewer": {
      "prompt": "En tant qu'expert en révision de code, concentrez-vous sur la qualité du code, les performances et la sécurité",
      "model": "claude-3-5-sonnet-20241022",
      "temperature": 0.1
    },
    "documentationWriter": {
      "prompt": "Spécialisé dans la rédaction de documentation technique claire et complète",
      "model": "claude-3-haiku-20240307",
      "temperature": 0.5
    }
  }
}

Styles de Sortie​

{
  "outputStyles": {
    "development": {
      "verbosity": "detailed",
      "includeReasoning": true,
      "showProgress": true
    },
    "production": {
      "verbosity": "minimal",
      "includeReasoning": false,
      "showProgress": false
    }
  }
}

Configuration des Hooks​

{
  "hooks": {
    "beforeEdit": "npm run format",
    "afterEdit": "npm run lint",
    "beforeCommit": ["npm test", "npm run build"],
    "onError": "echo 'Erreur survenue, veuillez vérifier les logs'"
  }
}

Configuration Entreprise​

Intégration Bedrock​

{
  "provider": "bedrock",
  "bedrock": {
    "region": "us-east-1",
    "modelId": "anthropic.claude-3-sonnet-20240229-v1:0",
    "credentials": {
      "accessKeyId": "votre-cle-d-acces",
      "secretAccessKey": "votre-cle-secrete"
    }
  }
}

Intégration Vertex AI​

{
  "provider": "vertex",
  "vertex": {
    "projectId": "votre-projet-gcp",
    "location": "us-central1",
    "modelName": "claude-3-sonnet@20240229",
    "credentials": "/chemin/vers/service-account.json"
  }
}

Dépannage​

Validation de Configuration​

Validez votre configuration :

claude config validate

Voir la Configuration Actuelle​

claude config show

Réinitialiser la Configuration​

claude config reset

Modèles de Configuration​

Modèle de Développement Web​

{
  "project": { "type": "web", "framework": "react" },
  "codeStyle": { "prettier": true, "eslint": true },
  "testing": { "framework": "jest", "coverage": true },
  "deployment": { "platform": "vercel" }
}

Modèle de Développement Backend​

{
  "project": { "type": "backend", "framework": "express" },
  "database": { "type": "postgresql", "orm": "prisma" },
  "testing": { "framework": "mocha", "integration": true },
  "deployment": { "platform": "heroku" }
}

Bonnes Pratiques​

  1. Configuration de Contrôle de Version : Inclure claude.config.json dans le contrôle de version
  2. Séparation d'Environnement : Utiliser différentes configurations pour différents environnements
  3. Standardisation d'Équipe : Les membres de l'équipe doivent utiliser la même configuration de projet
  4. Mises à Jour Régulières : Mettre à jour la configuration à mesure que le projet évolue

Continuez vers Mécaniques Fondamentales pour plonger profondément dans le fonctionnement de Claude Code.