Installation

Installe Claude Code et configure-le pour être productif dès ton premier projet.

Prérequis

Un terminal (Terminal sur Mac, PowerShell ou Windows Terminal sur Windows, n'importe quel terminal sur Linux)
Git installé (requis sur Windows, généralement préinstallé sur macOS et Linux)
Un compte Anthropic (on va le créer ensemble si tu n'en as pas)

Installer Claude Code

Terminal

curl -fsSL https://claude.ai/install.sh | bash

L'installation se met à jour automatiquement en arrière-plan.

Tu peux aussi installer via Homebrew (brew install --cask claude-code) ou WinGet (winget install Anthropic.ClaudeCode), mais ces méthodes ne se mettent pas à jour automatiquement.

Quel plan choisir ?

Claude Code est inclus dans tous les plans payants d'Anthropic :

Pro : 20$/mois, inclut Claude Code mais les limites d'usage sont vite atteintes en utilisation active
Max 5x : 100$/mois, usage régulier, accès à Opus
Max 20x : 200$/mois, usage intensif, idéal pour construire un MVP

Pas de surprise sur la facture, tu te concentres sur le code.

Ma recommandation : Si tu prévois de construire un MVP en suivant ce guide, commence avec le Max 5x à 100$/mois. C'est le plan que j'utilise au quotidien. Tu peux passer au Max 20x si tu te retrouves limité.

Premier lancement

Terminal

cd mon-projet
claude

La première fois, Claude te demandera de t'authentifier. Voici ce qui va se passer :

Un lien s'ouvre dans ton navigateur
Tu te connectes à ton compte Anthropic (ou tu en crées un)
Tu autorises Claude Code
Tu reviens dans le terminal, c'est bon, tu es connecté

Les modèles disponibles

Modèle	Force	Quand l'utiliser
Opus 4.6	Le plus intelligent, raisonnement complexe	Tâches d'architecture, refactoring, debugging difficile
Sonnet 4.6	Excellent en code, rapide	Usage quotidien, features standard
Haiku 4.5	Rapide et économique	Tâches simples, questions rapides

Pour changer de modèle en session :

Claude Code

/model opus    # Passer à Opus (défaut recommandé)
/model sonnet  # Passer à Sonnet (plus rapide)

Utilise Opus par défaut. La différence de qualité avec Sonnet est significative, surtout pour les tâches complexes. Passe sur Sonnet uniquement quand tu as besoin de vitesse sur une tâche simple.

Configuration recommandée

Permissions

Quand Claude te demande la permission d'exécuter une commande, tu peux répondre "yes" à chaque fois, ou configurer les permissions automatiques pour gagner du temps.

Crée ou modifie .claude/settings.json à la racine de ton projet :

.claude/settings.json

{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(npm test *)",
      "Bash(git status)",
      "Bash(git diff *)",
      "Bash(git log *)",
      "Bash(git add *)",
      "Bash(git commit *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)"
    ]
  }
}

Ça autorise Claude à lancer tes scripts npm et les commandes git courantes sans te demander à chaque fois. Les fichiers .env sont explicitement bloqués en lecture. Tu garderas le contrôle sur tout le reste (écriture de fichiers, git push, etc.).

Attention : N'autorise jamais Bash(*) ou Bash(git *) en global. Bash(git *) inclut git push --force et git reset --hard. Toujours lister les commandes spécifiques.

Quand Claude te demande une permission en session, tu peux répondre "always" pour l'autoriser uniquement pour la session en cours. Pratique pour des commandes ponctuelles sans modifier ta config.

Le flag --dangerously-skip-permissions permet de lancer Claude en désactivant toutes les vérifications de permissions. Ne l'utilise jamais sur ta machine. Ce mode est réservé aux environnements isolés (containers, VMs) où Claude ne peut pas causer de dégâts.

CLAUDE.md initial

CLAUDE.md est le fichier que Claude lit en premier à chaque session. C'est là que tu lui donnes le contexte de ton projet : stack, commandes, conventions.

Plutôt que de l'écrire à la main, lance /init dans une session Claude Code. Il va explorer ton projet et générer un CLAUDE.md automatiquement. Voici le type de résultat que tu peux obtenir :

CLAUDE.md

Exemple raccourci généré par /init

# Mon Projet

## Stack
- Next.js 16 (App Router)
- TypeScript
- Tailwind CSS v4
- Drizzle ORM + PostgreSQL

## Commandes
- `npm run dev` - Serveur de dev (port 3000)
- `npm run build` - Build de production
- `npm run lint` - ESLint
- `npm run db:migrate` - Migrations de base de données

## Conventions
- Composants en PascalCase dans src/components/
- Server Components par défaut, "use client" uniquement si nécessaire
- Fichiers en kebab-case
- TypeScript strict activé

Relis le résultat et ajuste si besoin. On verra comment aller plus loin avec CLAUDE.md dans le chapitre dédié, c'est la clé pour une collaboration efficace avec Claude.

Ton premier essai

Vérifions que tout fonctionne. Crée un dossier vide et lance Claude Code :

Terminal

mkdir test-claude && cd test-claude
git init
claude

Puis tape ce prompt :

Prompt

Crée un fichier index.html avec une page qui affiche "Hello Claude Code"
en bleu centré sur la page. Utilise du CSS moderne (flexbox).

Claude va :

Créer le fichier index.html
Te demander la permission de l'écrire (dis "yes")
Te montrer le résultat

Ouvre le fichier dans ton navigateur. Si tu vois "Hello Claude Code" en bleu, tout est bon. Tu peux supprimer le dossier test.

Ça a l'air trivial, mais ce premier échange te permet de vérifier que l'authentification fonctionne, que les permissions sont correctes, et que Claude répond bien. On va très vite passer à des choses beaucoup plus intéressantes.

Problèmes courants

Prochaine étape

Claude Code est installé et configuré. Dans le prochain chapitre, on va découvrir les trois modes d'interaction (normal, Plan Mode, Auto-accept) et comprendre quand utiliser chacun. C'est la base pour être productif.