Configuration de l'environnement

Vue d'ensemble de la configuration

Claude Code utilise trois niveaux de configuration, du plus global au plus spécifique :

1. La variable d'environnement ANTHROPIC_API_KEY : votre identité
2. Le fichier settings.json : vos préférences globales
3. Le fichier CLAUDE.md : le contexte spécifique à chaque projet

Chaque niveau enrichit le précédent. Ensemble, ils permettent à Claude Code de comprendre qui vous êtes, comment vous travaillez, et sur quoi vous travaillez.

Abonnement ou clé API ?

Avant de configurer quoi que ce soit, un point important : aujourd'hui, un abonnement Claude (Pro ou Max) est bien plus avantageux financièrement qu'une clé API pour utiliser Claude Code.

Si vous utilisez un abonnement Claude (Pro ou Max), sélectionnez simplement "Claude App" lors de l'authentification, aucune configuration supplémentaire n'est nécessaire.

Configurer la clé API (si applicable)

Si vous avez choisi d'utiliser une clé API plutôt qu'un abonnement, la méthode recommandée est de définir une variable d'environnement dans votre shell.

# Ajoutez cette ligne à votre ~/.bashrc (bash) ou ~/.zshrc (zsh)
export ANTHROPIC_API_KEY="sk-ant-votre-clé-ici"

# Rechargez votre configuration
source ~/.bashrc  # ou source ~/.zshrc

# Vérifiez que la variable est bien définie
echo $ANTHROPIC_API_KEY
# sk-ant-... ← Vous devriez voir votre clé

Alternative : définir la clé dans settings.json

Vous pouvez aussi stocker votre clé dans le fichier de configuration de Claude Code (voir section suivante). Cette méthode est moins recommandée car elle mélange configuration et secrets, mais elle fonctionne.

Le fichier settings.json

Le fichier ~/.claude/settings.json est le fichier de configuration globale de Claude Code. Il contrôle le comportement par défaut sur toute votre machine.

Emplacement

# Le fichier se trouve dans votre dossier home
~/.claude/settings.json

# Sur macOS/Linux
/home/votre-nom/.claude/settings.json

# Sur Windows (WSL)
/home/votre-nom/.claude/settings.json

Structure du fichier

Voici un exemple complet avec les options les plus utiles :

{
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(git *)",
      "Bash(npm run *)",
      "Bash(node *)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(sudo *)"
    ]
  },
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-..."
  }
}

Les permissions en détail

Le système de permissions contrôle ce que Claude Code peut faire sans vous demander confirmation.

Configuration par projet

En plus du fichier global ~/.claude/settings.json, vous pouvez créer un fichier .claude/settings.json à la racine de chaque projet. Les paramètres du projet sont fusionnés avec les paramètres globaux (le projet a priorité).

mon-projet/
├── .claude/
│   └── settings.json   ← Configuration spécifique au projet
├── CLAUDE.md            ← Contexte du projet
├── src/
├── package.json
└── ...

Le fichier CLAUDE.md

C'est le fichier le plus important de toute votre configuration. Le fichier CLAUDE.md donne du contexte permanent à Claude Code sur votre projet. Il le lit automatiquement à chaque session.

Où le placer ?

Placez le fichier CLAUDE.md à la racine de votre projet (au même niveau que package.json ou Cargo.toml).

Structure recommandée

Voici un template que vous pouvez adapter à vos projets :

# CLAUDE.md

## À propos de ce projet
Application e-commerce construite avec Next.js 14, TypeScript et Prisma.
Base de données PostgreSQL hébergée sur Supabase.

## Conventions de code
- Composants fonctionnels React uniquement (pas de classes)
- Nommage des fichiers en kebab-case (mon-composant.tsx)
- Tests avec Vitest, coverage minimum 80%
- Imports absolus avec le préfixe @/
- TypeScript strict, jamais de `any`

## Commandes utiles
- `npm run dev` : Serveur de développement (port 3000)
- `npm run test` : Lancer les tests
- `npm run build` : Build de production
- `npm run lint` : Vérifier le linting

## Structure du projet
- src/app/ : Pages Next.js (App Router)
- src/components/ : Composants réutilisables
- src/lib/ : Utilitaires et configuration
- prisma/ : Schéma et migrations de la BDD

## Règles importantes
- Ne JAMAIS modifier les fichiers dans /generated/
- Les migrations Prisma doivent toujours être nommées
- Les variables d'environnement sont dans .env.local (jamais commitées)
- Le déploiement se fait via GitHub Actions sur la branche main

CLAUDE.md hiérarchique

Claude Code supporte les fichiers CLAUDE.md hiérarchiques. Cela signifie que vous pouvez placer un CLAUDE.md dans n'importe quel sous-dossier. Claude Code lira tous les fichiers CLAUDE.md entre la racine du projet et le dossier courant.

mon-monorepo/
├── CLAUDE.md                    ← Règles globales du monorepo
├── apps/
│   ├── web/
│   │   ├── CLAUDE.md            ← Règles spécifiques à l'app web
│   │   └── src/
│   └── api/
│       ├── CLAUDE.md            ← Règles spécifiques à l'API
│       └── src/
└── packages/
    └── shared/
        ├── CLAUDE.md            ← Règles du package partagé
        └── src/

Ce qui fait un bon CLAUDE.md

Un bon CLAUDE.md est :

• Concis : allez droit au but, pas de prose inutile
• Structuré : utilisez des titres, des listes et des blocs de code
• Actionnable : chaque information doit aider Claude Code à prendre de meilleures décisions
• À jour : mettez-le à jour quand vos conventions changent

Un mauvais CLAUDE.md est vague ("ce projet est cool") ou trop long (copier-coller de toute la documentation). Visez 30 à 100 lignes.

Permissions et sécurité

Claude Code est conçu avec la sécurité au centre. Voici les principes clés.

Le principe du moindre privilège

Par défaut, Claude Code vous demande votre accord avant chaque action qui modifie votre système (écriture de fichiers, exécution de commandes). C'est le comportement le plus sûr.

Bonnes pratiques de sécurité

• Utilisez la liste deny pour bloquer les commandes dangereuses (rm -rf, sudo, etc.)
• Gardez votre clé API secrète et ne la commitez jamais
• Vérifiez toujours les commandes proposées par Claude Code avant de les accepter
• Utilisez des clés API avec des permissions limitées quand c'est possible
• Activez la rotation régulière de vos clés API

Prochaines étapes

Votre environnement est configuré. Il est temps de passer à la pratique et de créer votre premier projet avec Claude Code.

• Votre premier projet : Créer un site web en 5 minutes
• Qu'est-ce que Claude Code ? : Revenir aux fondamentaux
• Retour à la vue d'ensemble : Toutes les pages du guide