Claude Code : démarrer

À la fin de ce tutoriel : install Claude Code, auth Pro / Max / Team, première session Git lab, permissions, /init → CLAUDE.md minimal, prompts P0 (expliquer, edit, tests), garde-fous secrets / prompt injection / scope dépôt.

Niveau : Débutant → Intermédiaire · Temps estimé : 40–55 min · Versions cibles : Claude Code récent (installeur natif) · Git 2.x · terminal macOS / Linux / WSL · Dernière vérification : 2026-09-11

← Hub IA parcours DevOps 2026 · IA · → CLAUDE.md · Slash commands · MCP

Statut : prêt à publier (parent WP 5463 · /tutoriels/)

Prérequis

• [ ] Compte Claude Pro / Max / Team (free souvent insuffisant) — ~20 $/mois Pro ; vérifier pricing vendor
• [ ] Terminal macOS / Linux / WSL
• [ ] Git de lab — Git distributed VCS
• [ ] Dossier projet sans secrets (pas de .env prod)
• [ ] Navigateur pour l’auth au premier claude
• [ ] Coût : abonnement + tokens lab ; pas de cloud obligatoire

Vous restez responsable de chaque edit et commande shell proposée.

Ce que nous allons construire

Lab Claude Code : démarrer (P0 CLI)
  ├── Install : curl install.sh | bash  (ou brew cask)
  ├── Auth : Pro / Max / Team → claude --version
  ├── Repo ~/lab-claude-demarrer (Git init, README, petit script)
  ├── Session : claude  →  permissions consenties  →  /init
  ├── CLAUDE.md minimal (détail → page sœur)
  ├── Prompts P0 : expliquer · petit edit · lancer tests
  └── Garde-fous : secrets, prompt injection, scope dépôt

(Schéma — alt : « Claude Code agent terminal : install, auth, repo lab, CLAUDE.md, prompts P0 et sécurité ».)

Étape 1 — Qu’est-ce que Claude Code (agent terminal vs chat Claude.ai)

Claude.ai (chat / Projects) = navigateur. Claude Code = agent CLI : lit/édite des fichiers, propose du shell, enchaîne des tâches sous votre consentement.

Dimension	Chat Claude.ai	Claude Code (CLI)
Contexte	Collages / Projects	Arborescence Git réelle
Actions	Texte, Artifacts	Edits + shell
Boucle	Copier/coller	Agent propose → vous validez
Cible DevOps	Exploration	Lab repo, IaC, scripts, tests

Angle Elastic Hayway 2026 : junior terminal rapide ; vous restez senior (diffs, pas d’always-allow large, zéro secret). Voir Codex vs Claude Code, Claude vs Cursor vs Copilot.

En pratique : le chat explore ; Claude Code agit dans un dépôt (diff, test). Ne collez pas un prompt Claude.ai vers le CLI sans relire le cwd.

Étape 2 — Compte & plan

1. Plan Pro, Max ou Team (free rarement suffisant).
2. Budget : ~20 $/mois Pro — vérifier pricing vendor.
3. Séparez lab et prod (jamais le même dépôt avec secrets).

Sans plan adapté : lisez le reste, n’ouvrez pas de session sur un dépôt sensible.

Étape 3 — Installation + claude --version

Docs : code.claude.com / code.claude.com/docs.

Recommandé — installeur natif :

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

Option Homebrew (macOS) :

brew install --cask claude-code
claude --version

npm @anthropic-ai/claude-code existe encore ; le natif (curl/cask) est préféré. Au premier lancement : auth. Attendu : version + REPL depuis un projet.

Si claude est introuvable : rouvrez le shell, which claude. Sur WSL, installez dans WSL pour aligner Git/Python. Critère : session dans ~/lab-claude-demarrer, pas seulement un --version hors projet.

Étape 4 — Premier repo lab + première session

mkdir -p ~/lab-claude-demarrer && cd ~/lab-claude-demarrer
git init
printf '%sn' '# Lab Claude Code' 'Petit dépôt pour démarrer le CLI agent.' > README.md
cat > hello.py << 'EOF'
def greet(name: str) -> str:
    return f"Hello, {name}!"

if __name__ == "__main__":
    print(greet("DevOps"))
EOF
git add README.md hello.py && git commit -m "chore: scaffold lab Claude Code"
claude

Session scopée au dépôt. Pas depuis $HOME entier ni un monorepo prod non préparé.

Git est le filet de rollback : commit initial, puis git diff après chaque edit. Pas de claude depuis $HOME (configs, clés SSH). Lab dédié, zéro .env : plus petit périmètre pour le flux lire → proposer → valider → tester.

Étape 5 — Permissions / modes (consentir, pas always-allow dangereux)

Permissions pour lire, éditer, exécuter. Règles :

• Consentir au cas par cas (lire hello.py, petit edit, python hello.py).
• Refuser hors repo, curl inconnus, installs système larges.
• Pas d’always-allow shell global « pour aller plus vite ».
• Chaque OK = revue miniature (diff + commande).

Humain approuve ; agent propose.

Pensez gate CI : lire hello.py ≠ curl | bash ; python hello.py ≠ pip install global. Scope plus large → refusez. Always-allow shell = chmod 777 sur un job CI.

Étape 6 — /init + CLAUDE.md minimal

/init génère un starter CLAUDE.md. Gardez-le court :

# Lab Claude Code — démarrer

## Stack
- Python 3 ; pas de dépendances externes pour l’instant

## Commandes
- Run : `python hello.py`
- Tests : `python -m unittest discover -s . -v` (quand présents)

## Garde-fous
- Ne jamais committer de secrets / `.env`
- Pas de `curl | bash` non demandé
- Confirmation avant toute commande destructive

Détail : CLAUDE.md · slash commands.

Étape 7 — Premiers prompts P0

Expliquer

Lis hello.py et explique en FR (5 lignes max) greet et le point d’entrée.

Petit edit

Ajoute farewell(name) → "Bye, {name}!". Mets à jour __main__ (greet puis farewell). Montre le diff avant d’écrire.

Tests / run

Exécute python hello.py. Si tu proposes un test unitaire minimal, crée test_hello.py et lance python -m unittest -v.

Habitudes : intention claire, scope fichier, diff avant écriture, relire avant commit. Pont : Claude Code + Terraform.

Un bon prompt P0 nomme fichier, résultat, contrainte (diff avant write). « Améliore le projet » ouvre les edits massifs — recentrez sur hello.py.

Étape 8 — Sécurité de base

Risque	Contrôle P0
Secrets dans le prompt	Jamais clés / tokens / mots de passe
.env dans le repo	.gitignore ; lab propre dès le commit initial
Prompt injection (README / deps)	Dépôts trustés ; Prompt injection
Scope trop large	claude dans le repo lab, pas depuis /
Always-allow shell	Interdit en lab d’équipe
Fuite via commit	git diff / git status avant push

L’agent accélère ; il ne remplace pas secrets ni revue.

Lab

Checklist 20–30 min :

1. [ ] Installer (curl -fsSL https://claude.ai/install.sh | bash ou brew install --cask claude-code)
2. [ ] claude --version + auth Pro / Max / Team
3. [ ] Créer ~/lab-claude-demarrer, git init, README + hello.py, commit
4. [ ] Lancer claude depuis ce répertoire
5. [ ] Consentir lecture / petit edit ; refuser hors repo
6. [ ] /init puis raccourcir CLAUDE.md (Stack / Commandes / Garde-fous)
7. [ ] Prompts expliquer → edit farewell → python hello.py
8. [ ] Optionnel : test_hello.py + python -m unittest -v
9. [ ] git status / git diff ; commit sans secrets
10. [ ] Règle perso : jamais always-allow shell sur ce poste

Critères de succès (lab)

• claude --version OK et session ouverte depuis ~/lab-claude-demarrer
• Au moins un refus de permission hors repo (preuve que le réflexe existe)
• CLAUDE.md ≤ ~1 page, sections Stack / Commandes / Garde-fous
• Diff farewell relu ; python hello.py (et test optionnel) verts
• git status propre, aucun secret dans l’historique

Si un critère échoue, corrigez avant monorepo ou Terraform. Succès = rituel (consentir, diff, tests) plus naturel que « Apply all ».

Erreurs fréquentes

Symptôme	Cause	Correctif
claude introuvable	PATH / install incomplète	Relancer natif ; rouvrir shell ; which claude
Auth refusée / session limitée	Plan free	Upgrader Pro/Max/Team ; vérifier pricing vendor (~20 $/mois Pro)
Agent hors sujet / verbeux	CLAUDE.md absent ou vague	/init + consignes vérifiables
Edit massif non voulu	Prompt flou + always-allow	Demander le diff ; permissions au cas par cas
Secret dans l’historique	Collage .env / clé	Rotation ; ne plus coller
Commande dangereuse	Scope large / injection	Refuser ; prompt injection
npm vs natif divergent	Habitude npm	Préférer curl/cask ; doc code.claude.com

Astuce : reproduisez hors agent (python hello.py) pour séparer bug d’outil et bug de prompt. Auth qui boucle : plan + popup. Cwd oublié : relancez claude dans le repo.

Quiz (5 questions)

1. Claude Code, c’est surtout :
– A. Un chat web uniquement
– B. Un agent CLI qui édite fichiers et lance des commandes sous consentement
– C. Un remplacement automatique de Git

2. Install recommandé (2026) :
– A. Uniquement un apt install inventé
– B. curl -fsSL https://claude.ai/install.sh | bash (ou brew cask)
– C. Obliger npm sans alternative

3. Permissions correctes :
– A. Always-allow shell global en lab
– B. Consentir au cas par cas ; l’humain valide diffs et commandes
– C. Apply prod sans revue

4. /init sert à :
– A. Supprimer le dépôt
– B. Générer un starter CLAUDE.md
– C. Publier sur WordPress

5. Règle secrets P0 :
– A. Coller la clé AWS dans le prompt
– B. Jamais coller de secrets ; repo lab sans .env prod
– C. Committer .env puis l’ignorer

Réponses : 1‑B · 2‑B · 3‑B · 4‑B · 5‑B

FAQ

Claude Code remplace-t-il Cursor ou Copilot ?
Non. Agent terminal complémentaire. Voir Claude vs Cursor vs Copilot et Codex vs Claude Code.

Le plan free suffit-il ?
En pratique non. Prévoir Pro / Max / Team ; ~20 $/mois Pro — vérifier pricing vendor.

Faut-il un CLAUDE.md long jour 1 ?
Non. Fichier court et vérifiable ; détail : CLAUDE.md.

Lancer Claude Code sur mon monorepo prod tout de suite ?
Déconseillé. Repo lab sans secrets d’abord, puis élargir.

Doc et pont IaC ?
code.claude.com / code.claude.com/docs. Pont : Claude Code + Terraform. MCP : Claude Code MCP.

Windows natif ou WSL ?
Pour un lab Git/Python cohérent, WSL (ou macOS/Linux). Installez Claude Code dans le même environnement que Git.

Points clés

• Claude Code = agent terminal (fichiers + shell), pas un simple chat
• Install : curl … install.sh | bash ou Homebrew cask ; npm secondaire
• Auth : Pro / Max / Team ; pricing à revalider vendor (~20 $/mois Pro)
• Première commande : claude dans le dépôt courant
• Permissions : consentir, jamais always-allow dangereux
• /init → CLAUDE.md minimal ; détail page sœur
• Prompts P0 : expliquer → edit → tests ; humain responsable des diffs
• Sécurité : pas de secrets collés, scope repo, prompt injection

Pour aller plus loin / Suite

1. CLAUDE.md · Slash commands · MCP
2. Codex vs Claude Code · Claude vs Cursor vs Copilot
3. Claude Code + Terraform · Prompt injection · Git
4. Hub IA parcours DevOps 2026 · IA

Maillage série IA Outils 2026

Hub	IA parcours 2026 · IA
→ Suite	CLAUDE.md · Slash · MCP
Comparer	Codex vs Claude Code · Claude vs Cursor vs Copilot
Pont / sécu	Terraform · Prompt injection · Git

---

Sources vérifiées (2026-09-11) : docs Claude Code (code.claude.com, code.claude.com/docs), install https://claude.ai/install.sh, Homebrew cask claude-code, npm @anthropic-ai/claude-code (natif préféré). Pricing Claude Pro ~20 $/mois — vérifier pricing vendor. Aucune clé réelle dans ce draft.