Prérequis et installation¶

De zero a Claude Code fonctionnel dans VSCode, avec Docker pour le sandboxing.

Prérequis¶

Un seul outil est obligatoire pour tous les utilisateurs : Git. Node.js n'est requis que si vous choisissez plus bas la méthode d'installation via npm.

Git (obligatoire)¶

brew install git

sudo apt-get update && sudo apt-get install git

Configurez votre identité :

git config --global user.name "Votre Nom"
git config --global user.email "votre@email.com"

Installer Claude Code¶

Deux méthodes. Choisissez-en une, pas les deux.

graph LR
    A["Quelle méthode ?"] --> B["Installeur natif<br/>(recommandé)"]
    A --> C["npm"]
    B --> D["Aucun prérequis"]
    C --> E["Node.js 18+ requis<br/>(étape ci-dessous)"]

    style B fill:#4caf50,color:#fff
    style C fill:#2196f3,color:#fff

Méthode 1 — Installeur natif (recommandée)¶

Aucun prérequis supplémentaire. Un seul copier-coller.

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

brew install claude-code

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

irm https://claude.ai/install.ps1 | iex

Passez directement à Vérification et authentification.

Méthode 2 — npm (requiert Node.js 18+)¶

Cette méthode nécessite Node.js. Installez-le d'abord, puis Claude Code.

2.1 Installer Node.js 18 ou supérieur¶

# Via nvm (évite les problèmes de permissions)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.zshrc
nvm install 22    # version LTS courante, compatible avec la contrainte "18 ou +"

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 22

Vérifiez :

node --version   # doit afficher v18.x ou supérieur (v22.x recommandé)
npm --version

2.2 Installer Claude Code via npm¶

npm install -g @anthropic-ai/claude-code

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc  # ou ~/.bashrc
source ~/.zshrc
npm install -g @anthropic-ai/claude-code

Vérification et authentification¶

claude --version

Lancez Claude Code pour la première fois :

claude

1. Une fenêtre de navigateur s'ouvre automatiquement
2. Connectez-vous avec votre compte Anthropic (Pro / Max / Team / Enterprise)
3. Autorisez Claude Code
4. Retournez au terminal — vous êtes connecté

Diagnostic¶

claude /doctor

Tous les indicateurs doivent être au vert :

✅ Authentication
✅ Model access
✅ Tool permissions
✅ Network connectivity

Mises à jour¶

L'installeur natif se met à jour automatiquement en arrière-plan. Pour forcer :

claude update

Configurer VSCode¶

CLI vs extension : un seul produit, deux interfaces¶

Avant d'installer l'extension, un point qui prête à confusion :

graph LR
    A["Claude Code<br/>(CLI, le vrai produit)"] --> B["Terminal intégré<br/>claude"]
    A --> C["Extension VSCode<br/>(UI par-dessus la CLI)"]

    style A fill:#4caf50,color:#fff
    style B fill:#2196f3,color:#fff
    style C fill:#2196f3,color:#fff

• Claude Code est une CLI. Elle a été installée à l'étape précédente.
• L'extension VSCode n'est pas un second logiciel : c'est une surcouche graphique qui lance la même CLI en arrière-plan et ajoute : panneau latéral, détection de la sélection de l'éditeur, raccourcis IDE.

Extension Claude Code (optionnelle)¶

code --install-extension anthropic.claude-code

code --install-extension anthropic.claude-code

code --install-extension anthropic.claude-code

Une fois installée, l'extension ajoute l'icône Claude dans la barre latérale. Le panneau qui s'ouvre et la commande claude dans un terminal VSCode pilotent la même CLI — utilisez celui des deux que vous préférez, sans attendre de différence fonctionnelle.

Configuration recommandée¶

{
  "editor.formatOnSave": true,
  "editor.autoSave": "onFocusChange",
  "files.autoSave": "onFocusChange",
  "terminal.integrated.scrollback": 10000,
  "editor.minimap.enabled": false,
  "editor.bracketPairColorization.enabled": true,
  "editor.guides.bracketPairs": true,
  "workbench.editor.enablePreview": false
}

Setup du terminal¶

{
  "terminal.integrated.fontFamily": "JetBrains Mono, Fira Code, monospace",
  "terminal.integrated.fontSize": 14,
  "terminal.integrated.cursorStyle": "line",
  "terminal.integrated.cursorBlinking": true
}

Raccourcis utiles¶

Docker Desktop et Sandboxing¶

Docker Sandboxes permet d'exécuter Claude Code dans une microVM isolée : l'agent peut installer des paquets, modifier des fichiers et exécuter des commandes sans toucher à votre machine.

Pourquoi un sandbox ?¶

graph TB
    subgraph "Sans sandbox"
        A[Claude Code] -->|accès direct| B[Votre système]
        B --> C[Fichiers personnels]
        B --> D[Config système]
        B --> E[Réseau complet]
    end

    subgraph "Avec sandbox"
        F[Claude Code] -->|isolé| G[MicroVM Docker]
        G --> H[Copie du projet uniquement]
        G --> I[Docker daemon dédié]
        G --> J[Réseau contrôlé]
    end

    style A fill:#f44336,color:#fff
    style F fill:#4caf50,color:#fff

Installer le CLI Sandboxes¶

brew install docker/tap/docker-sbx

# Installer Docker Engine rootless (pas besoin de sudo)
curl -fsSL https://get.docker.com/rootless | sh

# Ajouter au PATH (dans ~/.bashrc ou ~/.zshrc)
export PATH=$HOME/bin:$PATH
export DOCKER_HOST=unix://$XDG_RUNTIME_DIR/docker.sock

# Vérifier
docker info | grep -i rootless

curl -fsSL https://download.docker.com/linux/static/stable/x86_64/docker-sbx -o ~/.local/bin/sbx
chmod +x ~/.local/bin/sbx

winget install Docker.DockerSandbox

Connectez-vous :

sbx login

Politique réseau¶

Au premier lancement, choisissez une politique :

Lancer Claude Code dans un sandbox¶

# Naviguez dans votre projet
cd ~/mon-projet

# Lancez le sandbox
sbx run claude

Pour passer un prompt directement :

sbx run claude -- "Lis PROMPT.md et commence la Phase 1"

Authentification dans le sandbox¶

/login

sbx secret set ANTHROPIC_API_KEY
# Entrez votre clé quand demandé

Accès GitHub depuis le sandbox¶

sbx gh login

Commandes utiles¶