01 - Installation et premiers pas#

Trente minutes pour passer de "rien d'installe" a "Claude modifie mon code et lance mes tests".

Temps de lecture : 12 min | Niveau : Debutant

Ce que tu sauras faire apres#

• Installer Claude Code sur Windows (PowerShell ou CMD) et verifier que ca marche.
• Te connecter et savoir quel compte est reellement utilise.
• Lancer ta premiere session et lire l'interface sans te perdre.
• Utiliser les 3 facons de parler a Claude Code : interactif, une seule question, pipe.
• Demarrer proprement sur un projet existant avec /init.

1. Installer#

Sur Windows, en natif#

Ouvre PowerShell (ton prompt commence par PS C:\) et colle :

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

Si tu es dans CMD (le prompt commence par C:\ sans le PS) :

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Comment savoir ou tu es ? Regarde le debut de ta ligne. PS C:\Users\... = PowerShell. C:\Users\... = CMD. Si tu vois l'erreur The token '&&' is not a valid statement separator, tu as lance la commande CMD dans PowerShell. Si tu vois 'irm' is not recognized, c'est l'inverse.

Autre option sur Windows, avec le gestionnaire de paquets :

winget install Anthropic.ClaudeCode

Attention : les installations WinGet ne se mettent pas a jour toutes seules. Il faut lancer winget upgrade Anthropic.ClaudeCode de temps en temps. L'installation native, elle, se met a jour en tache de fond.

Verifier#

Ferme ton terminal, rouvre-en un neuf, puis :

claude --version

Tu dois voir un numero suivi de (Claude Code), par exemple 2.1.211 (Claude Code). Si le terminal repond que claude n'est pas reconnu, le dossier d'installation n'est pas encore dans ton PATH : la doc officielle a une section dediee (voir Sources).

Pour un diagnostic complet, sans demarrer de session :

claude doctor

Cette commande affiche l'etat de l'installation, les erreurs dans tes fichiers de reglages, et les avertissements avec des pistes de correction.

Specificite Windows importante : Git for Windows#

Sur Windows natif, Git for Windows est recommande. Pourquoi ? Parce qu'il fournit Git Bash, et Git Bash permet a Claude Code d'utiliser l'outil Bash (l'outil qui lance tes commandes shell).

• Sans Git for Windows : Claude Code passe par l'outil PowerShell.
• Avec Git for Windows : Claude Code utilise Git Bash pour l'outil Bash. Si Claude Code ne trouve pas Git Bash, tu lui indiques le chemin dans settings.json :

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Note le double antislash : c'est du JSON, il faut echapper les antislashs Windows.

Quand Git for Windows est installe, l'outil PowerShell reste disponible a cote de Bash. Il est actif par defaut pour les comptes claude.ai et Console.

Windows natif ou WSL ?#

En pratique, pour du data engineering avec Python, dbt et des clients cloud, les deux marchent. Si ton equipe deploie sur Linux, WSL 2 t'evite des surprises de chemins.

2. Se connecter#

Lance simplement :

claude

Au premier demarrage, Claude Code ouvre ton navigateur pour la connexion. Si la variable d'environnement ANTHROPIC_API_KEY est definie, Claude Code saute la connexion et te demande d'approuver cette cle a la place.

Pour changer de compte plus tard, tape /login dans la session. Pour te deconnecter, /logout.

Piege classique. Tu as un abonnement Claude Pro et une variable ANTHROPIC_API_KEY qui traine dans ton environnement. Claude Code utilise la cle API une fois que tu l'as approuvee, donc tu paies a l'appel au lieu d'utiliser ton abonnement. Verifie avec /status : la ligne t'indique quelle methode est active.

3. Ta premiere session#

Place-toi dans un projet et lance Claude Code :

cd C:\Users\Main\projets\mon-pipeline
claude

Au-dessus du prompt, tu vois trois informations : la version, le modele courant, et le dossier de travail. Tape /help pour la liste des commandes.

Premiere question : comprendre, pas modifier#

Ne demande pas tout de suite une modification. Commence par comprendre.

donne-moi un apercu de ce depot

Puis affine :

quelles technologies sont utilisees ici ?

ou est le point d'entree principal ?

explique la structure des dossiers

Claude lit les fichiers dont il a besoin. Tu n'as rien a lui donner a la main.

Exemples data, utiles des la premiere minute#

liste tous les modeles dbt du dossier models/ et dis-moi lesquels n'ont aucun test
declare dans les fichiers .yml

ouvre dags/ et explique-moi l'ordonnancement : quel DAG depend de quel autre, et sur
quelle frequence chacun tourne

4. Les trois facons de parler a Claude Code#

a) Mode interactif (le plus courant)#

claude

Tu discutes, tu vois ce que Claude fait, tu corriges au fil de l'eau.

Tu peux aussi donner le premier message directement :

claude "corrige l'erreur de compilation du modele fct_commandes"

b) Mode "une seule question" avec -p#

claude -p "explique ce que fait la fonction clean_orders dans src/transform.py"

Claude repond puis rend la main. Tres pratique dans un script.

c) En pipe, comme un outil Unix#

git log --oneline -20 | claude -p "resume ces 20 derniers commits"

tail -200 airflow/logs/dag_ventes.log | claude -p "identifie la cause de l'echec"

Reprendre une conversation#

5. Les raccourcis clavier a connaitre#

En debut de ligne, quatre caracteres ont un sens special :

Exemple concret du mode shell :

!dbt ls --resource-type model --output name

La liste des modeles arrive dans la conversation, et tu peux enchainer avec "maintenant classe-les par domaine metier".

6. Bien demarrer sur un projet existant : /init#

C'est la premiere chose a faire sur un depot que tu vas utiliser regulierement.

/init

Claude analyse ton depot et cree un fichier CLAUDE.md avec les commandes de build, les instructions de test et les conventions qu'il a detectees.

/init sait aussi recuperer la configuration d'autres agents : s'il trouve une configuration OpenAI Codex ou Google Gemini CLI, il te propose de la reprendre avec /import.

Il existe une variante interactive : mets la variable d'environnement CLAUDE_CODE_NEW_INIT a 1 avant de lancer /init. Le parcours couvre alors aussi les skills, les hooks et tes fichiers de memoire personnels, pas seulement le CLAUDE.md.

Un conseil : si ton CLAUDE.md devient trop gros, lance /doctor. Il propose de couper ce que Claude peut deduire du code tout seul.

Le fichier 02 explique en detail quoi mettre dans ce CLAUDE.md.

7. AVANT / APRES : ton premier vrai prompt#

AVANT (mauvais)

corrige le bug

Claude ne sait pas de quel bug tu parles. Il devine, il explore au hasard, il remplit ton contexte, et il propose quelque chose a cote.

APRES (bon)

Le DAG `dag_chargement_ventes` echoue depuis hier a la tache `load_to_bq`.
L'erreur exacte est :
"google.api_core.exceptions.BadRequest: 400 Provided Schema does not match Table
projet.dataset.ventes. Field montant_ht has changed type from FLOAT to STRING"

Regarde dags/dag_chargement_ventes.py et src/loaders/bigquery.py.
Ecris d'abord un test qui reproduit le probleme, puis corrige, puis relance le test.

Pourquoi c'est mieux ? Tu donnes quatre choses que Claude ne peut pas deviner : le symptome, le message d'erreur exact, l'endroit ou chercher, et ce que "corrige" veut dire concretement (un test qui passe).

Template pret a copier#

CONTEXTE : [PROJET_ET_TECHNO, par exemple "pipeline dbt sur BigQuery"]
SYMPTOME : [CE_QUI_NE_MARCHE_PAS]
COMMANDE POUR REPRODUIRE : [COMMANDE_EXACTE]
ERREUR EXACTE : [COLLER_LE_MESSAGE_ENTIER]
OU CHERCHER : [FICHIERS_OU_DOSSIERS]
DEFINITION DE "TERMINE" : [LE_TEST_X_PASSE / LA_COMMANDE_Y_RETOURNE_0]

A retenir#

• Sur Windows : irm https://claude.ai/install.ps1 | iex en PowerShell, puis claude --version dans un terminal neuf.
• Installe Git for Windows pour avoir l'outil Bash ; sinon Claude Code utilise PowerShell.
• claude = interactif, claude -p "..." = une seule reponse, | claude -p = en pipe.
• /init est la premiere commande a lancer sur un depot que tu vas garder.
• claude doctor diagnostique l'installation et les reglages sans demarrer de session.
• Un bon prompt donne le symptome, l'erreur exacte, l'endroit a regarder, et la definition de "termine".

Sources#

• Claude Code - Overview
• Claude Code - Quickstart
• Claude Code - Advanced setup
• Claude Code - Interactive mode
• Claude Code - CLI reference
• Claude Code - Authentication
• Claude Code - How Claude remembers your project
• Git for Windows - Telechargement

Liens verifies le 26 septembre 2026.