traduction

2026-06-02 23:24:21 +02:00
parent 89ed5d7f86
commit e8f2b1a034
114 changed files with 17211 additions and 0 deletions
@@ -0,0 +1,61 @@
+# Jour 0 — Configuration de Claude Code
+
+Ce guide t'accompagne pour installer Claude Code sur ta machine et t'authentifier afin de commencer à l'utiliser.
+
+## Étape 1 : installer Claude Code
+
+Choisis ton système d'exploitation :
+
+| OS | Guide |
+|----|-------|
+| Windows | [windows.md](windows.md) |
+| Linux | [linux.md](linux.md) |
+| macOS | [mac.md](mac.md) |
+
+Suis le guide correspondant à ton OS, puis reviens ici pour l'authentification.
+
+---
+
+## Étape 2 : vérifier l'installation
+
+Après avoir suivi le guide propre à ton OS, confirme que tout fonctionne :
+
+```bash
+node --version    # Doit afficher v18.x ou supérieur
+claude --version  # Doit afficher la version installée de Claude Code
+```
+
+---
+
+## Étape 3 : connexion
+
+<img src="../../../tutorial/day0/assets/login.png" alt="Écran de connexion Claude Code" width="50%">
+
+Lance `claude` dans ton terminal. Au premier lancement, il te demandera de choisir une méthode de connexion.
+
+### Méthode 1 : abonnement (Claude Pro / Max)
+
+- Sélectionne **Claude.ai account**
+- Le navigateur s'ouvre — connecte-toi et autorise
+- Retourne au terminal, tu es connecté
+
+### Méthode 2a : clé API (invitation d'équipe)
+
+Ton admin d'équipe t'invite depuis le dashboard Anthropic.
+
+- Tu reçois un **email d'invitation** — accepte-le et crée ton compte Anthropic
+- Lance `claude` dans ton terminal
+- Sélectionne **Anthropic API Key**
+- Ta clé est **auto-générée** sur le dashboard — aucune configuration manuelle nécessaire
+- Claude Code commence à fonctionner immédiatement
+
+### Méthode 2b : clé API (tu as la clé)
+
+Si quelqu'un t'a partagé la clé (via Slack, email, etc.) ou si tu as créé la tienne :
+
+- Lance `claude` dans ton terminal
+- Sélectionne **Anthropic API Key**
+- Colle ta clé (elle commence par `sk-ant-`)
+- La clé est **stockée définitivement** — elle ne te sera plus redemandée
+
+---
@@ -0,0 +1,118 @@
+# Configuration Linux
+
+[Retour au Jour 0](README.md)
+
+## Prérequis
+
+Tu as besoin de **Node.js v18 ou supérieur** et de **npm**.
+
+## Étape 1 : installer Node.js
+
+### Option A : via la page de téléchargement nodejs.org avec fnm (recommandé)
+
+**fnm** (Fast Node Manager) est officiellement recommandé par Node.js. Il est rapide, léger, et te permet de changer facilement de version Node si besoin plus tard.
+
+1. Ouvre ton navigateur et va sur [nodejs.org/en/download](https://nodejs.org/en/download).
+
+2. Tu verras une ligne de menus déroulants indiquant : **"Get Node.js® vXX.XX.X (LTS) for __ using __ with __"**. Règle les menus comme suit :
+
+   | Menu | Sélection |
+   |------|-----------|
+   | Version | **vXX.XX.X (LTS)** — garde la version LTS par défaut, ne la change pas |
+   | OS | **Linux** |
+   | Package Manager | **fnm** (dans "Recommended (Official)") |
+   | Package Format | **npm** — garde la valeur par défaut |
+
+3. La page affichera les commandes exactes à lancer. Ouvre ton terminal et copie-colle-les. Elles ressembleront à ceci :
+
+   ```bash
+   # Step 1 — Install fnm
+   curl -fsSL https://fnm.vercel.app/install | bash
+
+   # Step 2 — Restart your terminal or reload your shell profile
+   source ~/.bashrc   # or: source ~/.zshrc (if you use zsh)
+
+   # Step 3 — Install Node.js
+   fnm install 24   # The page will show the exact version number
+   ```
+
+   > Le numéro de version peut différer de celui ci-dessus — utilise toujours ce que le site affiche.
+
+4. **Ferme et rouvre ton terminal** (ou lance la commande `source` ci-dessus) pour que `fnm`, `node` et `npm` soient disponibles.
+
+> **Pourquoi fnm ?** Il est dans la catégorie "Recommended (Official)" sur la page de téléchargement Node.js. Comme nvm, il installe Node dans ton répertoire personnel, donc tu n'as jamais besoin de `sudo` pour les installations npm globales — mais fnm est nettement plus rapide (écrit en Rust) et fonctionne de la même façon sur Windows, macOS et Linux.
+
+### Option B : utiliser le gestionnaire de paquets de ta distribution
+
+C'est plus rapide, mais cela peut installer une ancienne version de Node.js. **Vérifie la version après installation** — si elle est inférieure à v18, utilise plutôt l'option A.
+
+**Ubuntu / Debian :**
+
+```bash
+sudo apt update
+sudo apt install -y nodejs npm
+
+# Check the version
+node --version   # Must be v18 or higher
+```
+
+**Fedora :**
+
+```bash
+sudo dnf install -y nodejs npm
+```
+
+**Arch Linux :**
+
+```bash
+sudo pacman -S nodejs npm
+```
+
+### Option C : NodeSource (dernière LTS via apt, sans nvm)
+
+Pour les utilisateurs Ubuntu/Debian qui veulent la dernière LTS sans utiliser nvm :
+
+```bash
+curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
+sudo apt install -y nodejs
+```
+
+## Étape 2 : vérifier Node.js
+
+```bash
+node --version
+npm --version
+```
+
+Les deux doivent afficher des numéros de version. `node --version` doit afficher v18.x ou supérieur.
+
+## Étape 3 : installer Claude Code
+
+```bash
+npm install -g @anthropic-ai/claude-code
+```
+
+> **Erreur de permission ?**
+> - Si tu as utilisé **fnm** ou **nvm** : cela ne devrait pas arriver. Vérifie qu'il est actif (`which node` doit pointer vers un chemin dans ton répertoire personnel, pas `/usr/...`).
+> - Si tu as utilisé une installation système : utilise soit `sudo npm install -g @anthropic-ai/claude-code`, soit corrige les permissions du répertoire global npm :
+>   ```bash
+>   mkdir -p ~/.npm-global
+>   npm config set prefix '~/.npm-global'
+>   echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
+>   source ~/.bashrc
+>   ```
+
+## Étape 4 : vérifier Claude Code
+
+```bash
+claude --version
+```
+
+Tu devrais voir la version de Claude Code s'afficher. Retourne maintenant à [README.md](README.md) pour configurer l'authentification.
+
+---
+
+## Notes
+
+- **WSL (Windows Subsystem for Linux)** : ce guide fonctionne aussi dans WSL. Suis simplement ces étapes depuis ton terminal WSL.
+- **Problèmes de PATH** : si `claude` est introuvable après installation, assure-toi que le bin global npm est dans ton PATH. Lance `npm config get prefix` — le sous-répertoire `bin/` de ce chemin doit être dans ton PATH.
@@ -0,0 +1,32 @@
+# Configuration macOS
+
+[Retour au Jour 0](README.md)
+
+---
+
+**Terminal**
+- Ouvre Terminal (appuie sur `Cmd + Space`, tape "Terminal", puis Entrée)
+
+**Homebrew**
+- Vérifie si Homebrew est déjà installé :
+  ```bash
+  brew --version
+  ```
+- Si tu obtiens "command not found", installe d'abord Homebrew :
+  ```bash
+  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+  ```
+
+**Claude Code**
+- ```bash
+  brew install --cask claude-code
+  ```
+
+**Vérifier**
+- ```bash
+  claude --version
+  ```
+
+---
+
+Retourne maintenant à [README.md](README.md) pour configurer l'authentification.
@@ -0,0 +1,33 @@
+# Configuration Windows
+
+[Retour au Jour 0](README.md)
+
+---
+
+**Node.js**
+- Va sur [nodejs.org](https://nodejs.org)
+- Clique sur le bouton **"Download Node.js (LTS)"** — cela télécharge l'installeur `.msi`
+- Lance le fichier `.msi` et clique sur **Next** dans l'assistant
+- Accepte les valeurs par défaut, clique sur **Install**, puis attends la fin
+
+**Vérifier Node.js**
+- Ouvre un **nouveau** terminal (PowerShell ou Windows Terminal) et lance :
+  ```powershell
+  node --version
+  npm --version
+  ```
+
+**Claude Code**
+- ```powershell
+  npm install -g @anthropic-ai/claude-code
+  ```
+- Si tu obtiens une erreur de permission, lance ton terminal en tant qu'**Administrator** (clic droit > Run as administrator)
+
+**Vérifier**
+- ```powershell
+  claude --version
+  ```
+
+---
+
+Retourne maintenant à [README.md](README.md) pour configurer l'authentification.