Récemment, beaucoup d’amis m’ont demandé si je pouvais publier un tutoriel pour débutants sur Claude Code.
Ils veulent eux aussi utiliser le produit Agent le plus puissant du monde.
En réalité, beaucoup de gens ne réalisent pas que les produits Agent sont généralement composés d’un framework Agent et d’un modèle. Les modèles de Claude sont effectivement souvent bloqués en Chine et très difficiles à gérer ; je n’ai aucun moyen d’apprendre à tout le monde à résoudre ce problème.
Mais Claude Code ne sera pas bloqué ni rendu inutilisable, car c’est en fait un framework Agent qui peut être utilisé avec n’importe quel modèle.
Même si Anthropic peut être assez agaçant avec ses bannissements de comptes et son authentification par identité réelle, je dois admettre que le meilleur framework Agent au monde en ce moment est Claude Code.
C’est pourquoi je dis toujours : si tu peux le faire correctement du premier coup, fais-le. Je sais que des outils comme OpenClaw et Hermes Agent sont très populaires maintenant, mais je recommande toujours d’utiliser Claude Code. Même si tu ne peux pas utiliser les modèles natifs de Claude, l’associer à un modèle domestique donne d’excellents résultats.
En plus, tu n’as pas à t’inquiéter des bannissements de compte, des numéros de téléphone étrangers, des cartes Visa, ni même d’utiliser un VPN.
Alors aujourd’hui, voici un tutoriel complet pour débutants sur Claude Code, depuis le début. J’ai préparé des instructions pour Windows et Mac, avec et sans VPN, pour que chacun puisse suivre la partie qui le concerne.
Le processus d’installation suivant a été testé sur cinq ou six ordinateurs pendant tout un week-end par moi et mon équipe, avec des installations et désinstallations répétées.
Par exemple, dans les scénarios sans VPN, il existe d’autres méthodes d’installation comme npm ou l’utilisation de miroirs domestiques via curl. Ces méthodes fonctionnent, mais elles n’étaient pas assez stables sur différents ordinateurs lors de mes tests.
J’ai donc finalement choisi la méthode qui, selon moi, est la plus simple et la moins susceptible d’échouer, même sur un ordinateur très « propre ».
J’espère juste que tout le monde pourra utiliser avec succès le framework Agent le plus puissant du monde en suivant cet article.
Je vais expliquer chaque étape aussi clairement et en détail que possible. Cela risque d’être un peu long, alors soyez indulgents.
Bon, commençons.
I. Installation de Claude Code
1. Mac
Commençons par Mac. Les utilisateurs de Windows peuvent passer cette partie et trouver le tutoriel pour Windows ci-dessous.
Tout d’abord, trouve le Terminal dans tes Applications et ouvre-le.
Installons notre protagoniste du jour, Claude Code.
J’ai créé un tout nouveau compte macOS sur mon ordinateur, ce qui équivaut à un ordinateur propre, pour cette démonstration.
D’abord, parlons du cas avec un VPN.
La commande est juste une ligne :
Colle cette commande dans le terminal et appuie sur Entrée.
Attends un moment, et tu verras une installation réussie.
Bien qu’il soit installé, il pourrait t’afficher une invite ici.
Cela signifie que Claude Code est installé, mais que l’emplacement d’installation ~/.local/bin n’a pas été ajouté à ta variable d’environnement PATH, donc taper claude directement pourrait ne pas trouver la commande.
Il est dit que pour résoudre ce problème, exécute la commande fournie ci-dessous.
Si tu ne comprends pas, ce n’est pas grave. Fais simplement ce qu’il dit : copie cette longue commande echo qu’il t’a donnée dans le terminal et exécute-la.
Ensuite, tape claude --version. Si un numéro de version s’affiche, l’installation a réussi.
La situation avec un VPN est très simple, mais je sais que beaucoup d’étudiants n’en ont pas.
Donc, si tu n’as pas de VPN, nous pouvons l’installer via Homebrew.
Homebrew est le gestionnaire de paquets en ligne de commande le plus populaire sur macOS. Il te permet d’installer, mettre à jour et désinstaller divers logiciels et outils de développement avec une seule commande.
J’ai emprunté un nouvel ordinateur à un collègue ; il n’a pas de VPN et un environnement très propre.
Installons d’abord brew. Cela peut sembler compliqué, mais c’est en fait très simple si tu suis les étapes.
Colle la commande suivante dans la ligne de commande et appuie sur Entrée :
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.shhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh))"
Après l’invite, appuie simplement sur Entrée.
Ensuite, cela va tourner pendant un moment.
Attends patiemment quelques minutes. Quand il termine et dit que l’installation a réussi, c’est bon.
Ensuite, nous devons ajouter Homebrew aux variables de chemin pour que le terminal puisse trouver la commande lorsque nous l’utilisons.
Colle ces quelques lignes de commandes dans le terminal et exécute-les une fois.
Maintenant, nous pouvons utiliser Homebrew pour gérer les paquets Mac.
Ensuite, utilise la commande suivante pour installer Claude Code. Comme l’éditeur pourrait formater automatiquement certains textes, un copier-coller direct pourrait provoquer des erreurs. Veuillez le taper manuellement ou demander à Claude de corriger le format avant de le coller dans le terminal :
brew install --cask claude-code@latest
La vitesse d’installation ici est un peu lente ; tu peux faire une pause et revenir quand c’est terminé.
Une fois le message de succès affiché, tape claude dans le terminal, et tu verras le petit crabe.
Cependant, il indiquera qu’il est inutilisable pour l’instant. Tu peux ignorer cela ; je vais t’apprendre à connecter un modèle dans un instant.
Maintenant que nous avons couvert Mac, parlons de Windows séparément. C’est légèrement différent. Les utilisateurs de Mac qui ont terminé peuvent passer cette partie.
2. Windows
Passons à Windows.
J’ai utilisé une machine Windows fraîchement réinitialisée pour l’installer.
Comme Claude Code exécute des commandes en interne via Git Bash sur Windows, tu dois d’abord installer Git pour utiliser Claude Code sur Windows.
Donc, première étape : installer Git.
Les amis qui l’ont déjà installé peuvent passer cette étape.
Utilise WinGet pour l’installer. C’est le gestionnaire de paquets officiel de Windows, que l’on peut considérer comme la version Windows de Homebrew.
Cherche « Terminal » dans la barre des tâches et ouvre-le.
Colle la commande suivante dans le terminal. L’installation sera beaucoup plus rapide si tu n’utilises pas de VPN ici.
winget install Git.Git
Une fois terminé, il affichera une installation réussie.
Une fois Git installé, comme d’habitude, parlons du cas avec un VPN.
Pour les amis avec un VPN, nous utilisons toujours la commande d’installation native officielle.
Colle la commande dans le terminal :
Attends un moment, et ce sera installé.
Très pratique.
Si tu n’as pas de VPN, nous devons utiliser WinGet pour l’installer.
Exécute cette commande dans le terminal :
winget install Anthropic.ClaudeCode
Après une installation réussie, tu peux aussi taper claude pour voir qu’il a été installé.
À ce stade, théoriquement, taper claude dans le terminal devrait t’amener à la page Claude Code.
Mais.
Nous n’avons installé que le framework ; nous ne lui avons pas encore donné de « cerveau », donc il n’est pas utilisable.
Ensuite, nous devons connecter son cerveau.
II. Connexion du modèle
Si tu as un compte Claude, connecte-toi directement. Je n’entrerai pas dans les détails ici.
Parce que théoriquement, si tu as déjà un compte Claude, tu ne lirais pas ce tutoriel pour débutants…
Donc, pour garantir que tous les amis domestiques puissent l’utiliser, je vais prendre le modèle domestique GLM-5.1 comme exemple.
GLM-5.1 est actuellement le modèle domestique que j’ai utilisé et qui se rapproche le plus de l’expérience Claude Opus 4.6.
Bien sûr, si tu n’as pas suivi leur plan de codage, MiniMax M2.7 et K2.5 sont également bons. Le code K2.6 devrait bientôt sortir, et je pense que Kimi va aussi faire un bond en avant ; je recommande de garder un œil dessus.
Concernant GLM-5.1, Zhipu fournit officiellement une commande en une ligne pour l’installer, c’est très simple :
Cependant, pour faciliter la connexion à d’autres modèles et le changement libre, je vais t’apprendre une méthode plus universelle : utiliser CC Switch.
Encore une fois, divisé en Mac et Windows.
1. Mac
Sur Mac, l’installation ne nécessite que deux commandes. La deuxième commande pourrait également générer une erreur si elle est copiée-collée directement à cause du formatage. Veuillez la taper manuellement ou demander à Claude de la corriger avant de la coller :
brew tap farion1231/ccswitch
brew install --cask cc-switch
Colle dans le terminal et appuie sur Entrée.
Une fois installé, c’est bon.
2. Windows
Pour Windows, je recommande de télécharger directement le package d’installation depuis le lien ci-dessous :
https://github.com/farion1231/cc-switch/releases
Si tu ne peux pas accéder à GitHub, j’ai également préparé un package d’installation local. Réponds « cc » dans les coulisses du compte officiel, et il t’enverra automatiquement le lien de téléchargement.
Après le téléchargement, double-clique pour l’exécuter, et tu peux cliquer sur « Suivant » jusqu’à la fin de l’installation.
Les opérations suivantes sont les mêmes pour Mac et Windows, je ne vais donc pas les séparer.
Après l’installation, ouvre-le.
Tu peux voir que cet outil n’est pas seulement pour Claude Code ; Codex et Xiaolongxia peuvent également l’utiliser.
Comme nous ne l’avons pas encore configuré, il n’y a actuellement que des configurations de modèle Claude officielles.
Sous la colonne Claude, clique sur le signe plus dans le coin supérieur droit pour ajouter une nouvelle configuration de modèle.
Ensuite, sélectionne le modèle que tu souhaites utiliser. Ici, j’ai choisi la version domestique GLM.
Ensuite, tu n’as besoin de remplir que deux parties : la clé API (si tu ne sais pas ce qu’est une clé API, tu peux demander à n’importe quelle IA à laquelle tu as accès, elle t’aidera) et la configuration du modèle. Tout le reste sera rempli automatiquement.
Après l’avoir rempli, clique sur « Ajouter » dans le coin inférieur droit.
Il basculera vers le modèle que nous avons configuré.
À ce stade, l’installation de Claude Code et la connexion de GLM-5.1 sont terminées.
III. Démarrage de Claude Code
Retourne dans le terminal, tape claude et appuie sur Entrée.
Tu peux maintenant démarrer Claude Code normalement.
Pour la première utilisation, il y aura quelques paramètres d’initialisation.
Par exemple, le mode de couleur. Il y a un aperçu du code sous les modes ; choisis selon ta préférence et appuie sur Entrée.
Si tu veux le changer plus tard, exécute /theme dans Claude Code.
Ensuite, l’invite de sécurité.
Deux points principaux :
L’un est que Claude peut faire des erreurs. Tu dois vérifier le code qu’il génère et les commandes qu’il veut exécuter avant de les laisser passer.
L’autre est de n’utiliser Claude Code que dans des bases de code auxquelles tu fais confiance pour éviter les attaques par injection d’invites.
Appuie sur Entrée pour passer à l’étape suivante.
Il demande si nous voulons utiliser les paramètres du terminal de Claude Code.
Ici, utilise simplement les paramètres de terminal recommandés.
En fait, il veut t’aider à activer deux choses :
Les touches de raccourci pour effectuer des sauts de ligne dans le terminal.
L’autre est la cloche visuelle, une notification visuelle.
C’est-à-dire que lorsque Claude termine une tâche ou a besoin de ta confirmation, la fenêtre du terminal clignotera et l’icône du Dock sautera pour te le rappeler.
La dernière étape consiste à confirmer si le répertoire actuel peut être considéré comme fiable.
Sélectionne « Oui » et appuie sur Entrée.
Nous sommes enfin arrivés à l’interface de dialogue de Claude Code connecté à GLM-5.1.
Si tu souhaites changer de modèle plus tard, configure-les dans CC Switch et utilise /model dans Claude Code pour basculer.
À ce stade, toutes les opérations d’installation et de connexion sont terminées.
Pour une utilisation future, tape simplement claude dans le terminal.
Je recommande d’utiliser la commande suivante, surtout pendant le développement, sinon cliquer sur « Autoriser » à plusieurs reprises te fera remettre en question tes choix de vie :
claude --dangerously-skip-permissions
Lorsque nous le démarrons, en raison de la conception du contexte, nous devons le démarrer dans un dossier pour le garder contraint et concentré, plutôt que de démarrer Claude Code directement dans le répertoire racine.
J’ai divisé mes répertoires ; « Documents » est l’endroit où je fais de la création de connaissances.
Il y a aussi un dossier « code », qui contient divers produits que j’ai développés moi-même.
Démarrer Claude Code pour un dossier spécifique dans la ligne de commande est également très simple.
C’est la commande cd, qui est la même pour Mac et Windows.
Par exemple, si je veux entrer dans le dossier « Base de connaissances » pour créer du contenu :
Ouvre le terminal, tape cd, puis n’oublie pas d’appuyer une fois sur la barre d’espace, puis fais glisser ton dossier directement dedans.
Appuie sur Entrée, et tu es entré dans ce dossier.
Ensuite, utilise la commande pour démarrer Claude Code.
Tu entreras dans ce dossier, et il travaillera uniquement dans ce dossier par défaut, lisant tous les fichiers qu’il contient.
Cela entraîne en fait moins de pollution du contexte et plus de concentration – en d’autres termes, c’est plus intelligent.
IV. Rédaction de CLAUDE.md
Après avoir appris à le démarrer, tu peux officiellement commencer le dialogue et le laisser travailler.
Mais il y a une habitude standard et très importante que tu dois mettre en place avant une utilisation approfondie. Ne tombe pas dans les vieux pièges que j’ai connus : définis d’abord ton fichier CLAUDE.md.
À mon avis, c’est même la première chose à faire après avoir appris à démarrer Claude Code.
Avant d’entrer dans le style d’écriture spécifique, laisse-moi expliquer ce qu’est CLAUDE.md.
Cette chose n’est pas qu’un simple fichier ; c’est un système de contraintes hiérarchiques descendant.
Comme cette image que j’ai utilisée précédemment.
Après l’installation, les deux couches que nous devons gérer sont le CLAUDE.md global et le CLAUDE.md du projet.
Le CLAUDE.md global est placé dans le répertoire racine de Claude Code dans le répertoire personnel de l’utilisateur : ~/.claude/CLAUDE.md.
Dès que tu ouvres Claude Code, quel que soit le projet dans lequel tu entres, il sera automatiquement chargé et suivi.
C’est sa spécification de plus haut niveau.
Il résout des problèmes comme qui tu es, tes principes de travail, et comment tu veux qu’il collabore avec toi.
Le CLAUDE.md au niveau du projet est placé dans le répertoire racine de chaque projet : project_directory/CLAUDE.md.
Il n’est chargé que lorsque tu ouvres ce projet.
Il résout le problème de la manière dont ce projet spécifique doit être réalisé et des accords particuliers à ce niveau.
Parlons d’abord du CLAUDE.md global, qui est la première chose à régler. Mais beaucoup de gens ne savent pas quoi écrire, comment l’écrire, combien de temps il doit faire, ni où le mettre. Pour les non-développeurs, je vais partager mon expérience.
En ce qui concerne la longueur, CLAUDE.md n’est pas meilleur s’il est plus long ; au contraire, il doit être aussi concis que possible.
Si ton CLAUDE.md est trop long, il ignorera simplement le contenu de la seconde moitié.
La ligne rouge spécifique est la suivante : au-delà de 80 lignes, Claude commence à manquer certains contenus. Au maximum, ne dépasse jamais 200 lignes.
Dans un article précédent, je t’ai montré ce qu’il y a dans mon fichier CLAUDE.md global.
En me basant sur mon contenu, j’ai itéré et préparé un modèle pour toi.
Il contient des éléments que je pense qu’un bon CLAUDE.md global devrait avoir.
Tu n’as qu’à écrire ton propre contenu dans la section « À propos de moi » ; le reste peut être réutilisé directement.
À propos de moi [Ton nom / identité / parcours professionnel, si tu n’es pas programmeur, tu dois le préciser]. J’utilise Claude Code pour [Usage spécifique 1] et [Usage spécifique 2].
Principes de réflexion : Toutes les décisions partent de l’essence du problème, ne copie pas simplement parce que « c’est la convention ». Reviens au problème lui-même : Que faut-il résoudre ? Quel est le chemin le plus direct ? Comment serait-ce conçu à partir de zéro ? Ne flatte pas. Ne fais pas l’éloge de mes idées, ne dis pas « c’est une très bonne question », n’ajoute pas « bien sûr » au début. Donne-moi de vrais jugements ; s’il y a un problème avec le plan, signale-le directement. Si tu trouves une meilleure façon, dis-le directement sans attendre que je te le demande.
Contraintes d’abord : Que ce soit un projet de développement ou un projet de gestion des connaissances, la première étape est toujours d’établir des règles : écris d’abord CLAUDE.md pour les nouveaux projets, et définis des conventions structurelles pour les nouveaux répertoires (quoi mettre où, comment nommer, quand nettoyer). Ne travaille pas dans un espace de travail sans spécifications. Pour les projets avec des spécifications existantes, respecte strictement les accords de leur CLAUDE.md. Lorsque tu ajustes des spécifications, modifie d’abord le document, puis la pratique, pas l’inverse.
Style de communication - Par défaut en français, utilise l’anglais pour le code, les commandes et les noms de variables - Conclusion d’abord, puis raisons, ne prépare pas le terrain avec du contexte - Face à des exigences vagues, donne d’abord le plan le plus raisonnable, puis demande si des ajustements sont nécessaires - Ne demande pas « es-tu sûr de vouloir faire cela » sauf si cela touche aux lignes rouges ci-dessous
Limites autonomes (Lignes rouges, demande-moi d’abord) Les opérations suivantes doivent s’arrêter et me demander même en mode d’acceptation automatique : - Supprimer des fichiers, répertoires ou l’historique git - Modifier .env, les clés, les jetons, les configurations CI/CD - Modifications du schéma de base de données ou migrations de données - git push, git rebase, git reset --hard, force push - Installation de nouvelles dépendances globales ou modification de configurations système - Publication publique (npm publish, déploiement en production, publication d’articles, etc.)
Discipline générale d’ingénierie - Exécute activement une vérification après les modifications (voir le CLAUDE.md de chaque projet pour les commandes spécifiques), ne te contente pas de modifier sans vérifier - Ne commente pas les erreurs ni n’ajoute de marqueurs de contournement juste pour faire fonctionner le code ; trouve la cause racine - Les clés, jetons et mots de passe n’entrent pas dans le code, les commits ou les journaux - Avant des modifications majeures, fournis un plan en mode Plan ; ne procède qu’après ma confirmation
Environ 30 lignes au total, divisées en six parties.
Ces six blocs ont une caractéristique commune : ils sont universels pour tous les projets.
Une fois le CLAUDE.md global défini, nous avons nos spécifications de plus haut niveau.
Quant à la couche suivante, le CLAUDE.md du projet.
Prends-moi comme exemple.
J’utilise principalement Claude Code pour le développement et la gestion des connaissances.
Par exemple, il y a un CLAUDE.md dans mon répertoire code/my. Son rôle est principalement dû au fait que les choses que je code souvent dans le dossier my sont souvent ponctuelles ou expérimentales, donc en fait très petites, donc je suis vraiment trop paresseux pour créer un nouveau dossier sous my à chaque fois.
Donc ma pratique courante actuelle est de faire un cd directement dans le dossier my pour démarrer, puis de commencer joyeusement à énoncer mes exigences pour m’aider à coder. Avec ce fichier CLAUDE.md, il jugera par lui-même s’il s’agit d’un nouveau produit. Si c’est le cas, il créera directement un nouveau dossier pour commencer, de sorte que toute la gestion des fichiers devienne organisée.
Et tu n’as même pas besoin d’écrire ce fichier toi-même. Ouvre simplement ce dossier et discute avec Claude Code. Discute directement de tes exigences et des choses qui t’importent avec lui, et laisse-le t’en écrire un.
J’ai également travaillé dur avec mon Claude Code ces derniers jours pour établir diverses spécifications et organiser les différents « tas de merde » de code que j’avais laissés avant.
Si tu n’as rien sur ton ordinateur pour le moment, c’est encore plus pratique.
C’est l’une des raisons pour lesquelles j’ai toujours insisté sur les contraintes d’abord et les spécifications d’abord.
Une fois les contraintes définies, tu peux vraiment commencer à jouer.
Quant aux compétences, plugins, commandes courantes et fonctions.
Je ne vais pas les développer ici. J’ai écrit de nombreux articles connexes ; les amis intéressés peuvent rechercher les mots-clés correspondants.
Derniers mots
J’ai enfin terminé ce tutoriel pour débutants sur Claude Code, qui était attendu depuis longtemps.
Claude Code est l’« outil de fin d’études » de l’ère actuelle de l’IA que je te recommande.
Tu n’as pas besoin d’utiliser tous ces Agents compliqués. Utilise bien Claude Code, et tu ressentiras vraiment ce qu’est l’Agent le plus puissant.
J’espère que tout le monde pourra créer avec joie.
Et réaliser des œuvres qui vous appartiennent dans cette ère.
Vos propres œuvres.
