Claude Code : Guide complet pour débutants (avec modèles locaux)

Partez de zéro, installez Claude Code – qui comprend le langage naturel, écrit du code et travaille automatiquement – sur votre ordinateur, et utilisez-le pour créer votre premier produit fonctionnel.

Pour commencer

• Débutants complets : Suivez les chapitres 1 à 5 dans l’ordre. Une fois que vous aurez exécuté votre premier outil web, vous aurez officiellement commencé.
• En cas d’erreurs : Prenez une capture d’écran et donnez-la à Claude Code ou à Doubao. Décrivez « sur quelle étape je suis et quelle erreur je vois ». C’est 10 fois plus efficace que de chercher vous-même sur Google.

Chapitre 1 : Maîtriser les concepts de base

Si vous ne comprenez pas les diffusions en direct ou les manuels, ce n’est généralement pas parce que vous n’êtes pas intelligent, mais parce que les termes ne sont pas reliés. Ce chapitre décompose les mots qui reviendront souvent.

1.1 Trois concepts fondamentaux

1Modèle = Cerveau (Ne fait que réfléchir, n’a ni mains ni pieds)
2Chatbot = Cerveau + Bouche (Peut parler mais pas agir)
3Agent = Cerveau + Mains/Pieds + Boîte à outils (Peut parler et agir)

• Modèle : GPT, Claude, Gemini, DeepSeek, Doubao, Qwen, Kimi, GLM, MiniMax… ce sont des modèles, le « cerveau ».
• Chatbot : ChatGPT web, application Doubao, boîte de dialogue DeepSeek. Vous posez une question, il répond, mais vous devez faire le travail vous-même.
• Agent : Vous dites « aide-moi à construire un site web », et il crée des dossiers, écrit du code, l’exécute et le débogue sur votre ordinateur, pour finalement vous dire « c’est fait ». Claude Code est un Agent.

Le même modèle dans des outils différents a des capacités très différentes. Le même modèle Claude n’est qu’un chat dans un navigateur, mais dans Claude Code, il peut écrire du code tout seul.

1.2 Token, Contexte, Harnais

• Token : La plus petite unité que l’IA utilise pour comprendre le texte. 1 caractère chinois équivaut à environ 1-2 Tokens ; 1 mot anglais équivaut à environ 1 Token. Les Tokens sont votre « facture d’électricité ». Ne lésinez pas sur les Tokens pendant la phase d’apprentissage.
• Contexte : Tout ce qui fait partie de cette conversation. L’IA n’a pas de mémoire à long terme ; elle ne peut se référer qu’à ce qui se trouve sur son « bureau ».
• Fenêtre de contexte : La taille du « bureau » de chaque modèle. En 2026, les modèles grand public atteignent 1 million de Tokens (environ 700 000 à 800 000 mots).
• Pollution du contexte : Discuter de choses différentes dans une même fenêtre rend l’IA confuse. Une fenêtre pour une tâche ; ouvrez une nouvelle fenêtre pour un nouveau sujet.
• Harnais / Ingénierie du contexte : Ce n’est pas un logiciel, mais un ensemble de méthodes pour maîtriser l’IA – comment organiser l’information, gérer le contexte, guider l’IA et vérifier les résultats. Claude Code est excellent car son Harnais est le plus mature.

1.3 Qu’est-ce qu’une compétence ?

Une compétence est un manuel de procédures (SOP) pour Claude.

Les Big Mac de McDonald’s ont le même goût dans le monde entier non pas parce que chaque restaurant a un chef cuisinier, mais parce que chaque restaurant a un SOP. Une compétence est ce SOP pour Claude – elle définit « quoi faire en premier, quoi faire ensuite, quels outils utiliser et ce qui compte comme un succès ».

• Écrivez une fois, appelez-la à plusieurs reprises.
• Écrire votre propre SOP revient à « enseigner » votre expérience de travail à Claude ; il devient votre « employé virtuel ».

1.4 Trois modes de paiement

La solution la plus réaliste : Utilisez les API des modèles nationaux + cc-switch pour une commutation en un clic. Détails au chapitre 3.

1.5 Outils auxiliaires à connaître avant l’installation

1.6 MCP – Le « standard de prise » pour les Agents

MCP signifie Model Context Protocol.

Considérez-le comme un standard de prise – permettant aux Agents de se connecter à divers outils et sources de données externes (Feishu, bases de données, navigateurs, Xiaohongshu, WeChat, etc.).

Analogie :

• Un port USB vous permet de brancher des périphériques sur votre ordinateur ; branchez un haut-parleur, et l’ordinateur gagne la capacité de « jouer de la musique ».
• MCP vous permet de brancher des outils dans Claude Code ; branchez Tavily, et il gagne la capacité de « rechercher les tendances en temps réel » ; branchez xiaohongshu-mcp, et il peut « publier sur Xiaohongshu ».

Par défaut, Claude Code ne traite que les informations que vous lui donnez et ne recherche pas activement sur Internet. Vous avez besoin de MCP pour rechercher, lire des bases de données ou appeler des API externes.

1.7 Multimodal – L’IA fait plus que « lire du texte »

Modalité est le type d’information. Le texte est une modalité ; les images, le son et la vidéo en sont d’autres.

• Unimodal : Ne peut traiter que du texte.
• Multimodal : Peut traiter simultanément du texte, des images, de l’audio, de la vidéo, des fichiers et des écrans.

Prise en charge des modèles grand public en 2026 :

Entrée ≠ Sortie

Le fait que l’IA puisse « voir » une modalité ne signifie pas qu’elle puisse la « générer ».

• Images : Presque tous les grands modèles peuvent voir des images ; seuls certains peuvent les dessiner (GPT Image, Gemini, Doubao Seedance, Jimeng, Nano Banana, etc.).
• Vidéo : Gemini, Doubao et Kimi peuvent regarder une vidéo ; mais les LLM ne créent pas directement de vidéo ; ils utilisent des outils spécialisés (Wan, Seaweed Dance, Jimeng).

Forces des modèles :

Conseil pratique pour les débutants : Ne vous contentez pas de taper ; apprenez à envoyer des captures d’écran, des enregistrements et des vidéos directement à l’IA pour gagner en efficacité.

1.8 Paysage des outils IA (Qui est qui)

Un schéma pour dissiper la confusion entre les différents outils.

Outils Agent (Vous aident à travailler)
``text
Outils Agent
├── Ligne de commande (basé sur le terminal, le plus puissant)
│ ├── Claude Code —— Par Anthropic, actuellement le plus fort, star de ce guide
│ └── Codex CLI —— Par OpenAI, open source
│
├── GUI (interface visuelle, conviviale)
│ ├── Codex Desktop/Web —— Par OpenAI
│ ├── Claude Cowork —— Par Anthropic, pour les non-techniciens
│ ├── Trae Solo —— Par ByteDance, national, avec modes Code et MTC
│ ├── WorkBuddy —— Par Tencent, national, pour le travail de bureau non-développeur
│ └── Kiro —— Par AWS, IDE piloté par spécifications (fork de VS Code)
│
├── Autonome (Fonctionne en arrière-plan)
│ ├── OpenClaw —— Anciennement Clawdbot, open source, contrôle à distance via WeChat/TG
│ └── Hermes —— Par Nous Research, open source, mémoire persistante
│
└── Orchestration de workflows (Automatisation par assemblage)
└── COZE —— Par ByteDance, workflows par glisser-déposer
``

Outils Chatbot (Vous parlent)
``text
Chatbot
├── Étranger
│ ├── ChatGPT (modèle GPT)
│ ├── Claude.ai (modèle Claude)
│ ├── Gemini (modèle Google)
│ └── Grok (xAI/Elon Musk, pour les tâches liées à X)
│
└── National
├── Doubao (ByteDance)
├── DeepSeek (Rapport qualité-prix élevé)
├── Qwen (Alibaba)
├── Kimi (Moonshot AI)
├── WeChat Yuanbao (Tencent, données solides de l’écosystème WeChat)
└── GLM / Zhipu Qingyan (Zhipu AI)
``

Argot courant dans les commentaires :

1.9 Résumé en une phrase de la relation

1Vous (Humain)
2  ↕ Langage naturel
3Claude Code (Agent) —— Se connecte aux outils externes via MCP
4  ↕ Appelle
5Modèle (Claude / GLM / MiniMax / Kimi…)
6  ↕ Consomme
7Token (Facture d’électricité)

Chapitre 2 : Configuration de l’environnement

Installez 4 éléments dans l’ordre : Git → Node.js → VS Code → Claude Code.

2.1 Confirmer le type de puce

• Mac : Pomme -> À propos de ce Mac. M1/M2/M3/M4 est ARM ; Intel est x86_64.
• Windows : Clic droit sur « Ce PC » -> Propriétés. Intel/AMD est x86_64.

2.2 Installer Git

• Mac : Ouvrez Terminal, collez : /bin/zsh -c "$(curl -fsSL https://gitee.com/happyaicoder/HomebrewCN/raw/master/Homebrew.sh)". Vérifiez avec git --version.
• Windows : Téléchargez depuis https://git-scm.com/https://git-scm.com/). Utilisez les paramètres par défaut.

2.3 Installer Node.js (18+, 20 ou 22 recommandé)

• Mac : Collez : /bin/bash -c "$(curl -fsSL https://gitee.com/iamzhihuix/nvm-install-cn/raw/main/install.sh)". Vérifiez avec node -v.
• Windows : Téléchargez la version LTS depuis https://nodejs.org/https://nodejs.org/). Si npm -v échoue dans PowerShell, exécutez : Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser.

2.4 Installer VS Code

Téléchargez depuis https://code.visualstudio.com/https://code.visualstudio.com/). Sous Windows, cochez « Ajouter au PATH » et « Ouvrir avec Code ».

2.5 Installer Claude Code

• Mac : npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com. Utilisez sudo si permission refusée.
• Windows : Exécutez PowerShell en tant qu’administrateur, puis : npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com.

2.6 Dépannage des erreurs courantes

Chapitre 3 : Configurer Claude Code avec des modèles nationaux

Claude Code est la coquille ; il a besoin d’un modèle (cerveau). Les modèles officiels Claude nécessitent une carte de crédit étrangère et risquent d’être bloqués. La solution la plus réaliste pour les utilisateurs nationaux est d’utiliser cc-switch avec des modèles nationaux.

3.1 Choisir un modèle

Recommandation débutant : Plan de codage MiniMax (29 RMB/mois).

3.2 Installer cc-switch

Téléchargez depuis GitHub ou le miroir Gitee.

3.3 Obtenir une clé API (Exemple : MiniMax)

1. Inscrivez-vous sur la plateforme MiniMax.
2. Achetez un plan de codage.
3. Copiez la clé du plan de codage (pas la clé API normale).

3.4 Configurer dans cc-switch

1. Ouvrez cc-switch, cliquez sur l’icône Claude.
2. Cliquez sur +, sélectionnez le fournisseur (par exemple MiniMax), collez la clé et cliquez sur Ajouter.
3. Survolez le modèle avec la souris et cliquez sur « Activer ».

3.5 Vérifier

Dans le terminal, tapez claude. Demandez : « Quel modèle es-tu ? » S’il répond MiniMax/GLM, vous êtes prêt.

Chapitre 4 : Opérations de base de Claude Code

4.1 Deux façons de démarrer

• Terminal : Ouvrez un dossier dans VS Code, ouvrez le terminal, tapez claude.
• Plugin : Installez l’extension « Claude Code » par Anthropic dans VS Code.

4.2 Raccourcis essentiels

4.3 Trois modes de travail

Le mode Plan est crucial – Claude réfléchit aux étapes avant d’agir. Utilisez-le pour les fonctionnalités complexes.

4.4 Normal vs. Réflexion approfondie (ultrathink)

4.5 Mode YOLO (Mains libres)

Ignore les invites de permission pour chaque modification de fichier. Utilisez : claude --dangerously-skip-permissions.

4.6 CLAUDE.md pour les préférences

Écrivez vos préférences dans un fichier CLAUDE.md à la racine de votre projet (par exemple, « Utilise le français pour les commentaires »).

Chapitre 5 : Construire un « outil de lecture précoce »

5.1 Créer le répertoire et le PRD

Créez prd.md dans VS Code avec les exigences pour une application HTML/JS qui génère des animaux emoji lorsque le volume du microphone dépasse un certain seuil.

5.2 Implémentation

Dans le terminal, exécutez claude --dangerously-skip-permissions et tapez : @prd.md implémente cette fonctionnalité.

5.3 Résultat

Ouvrez index.html dans un navigateur, autorisez l’accès au microphone et parlez pour voir apparaître des animaux.

Chapitre 6 : Maîtriser les compétences de workflow

Les compétences sont des SOP réutilisables. Une compétence comprend un SKILL.md (configuration), des scripts et des modèles.

6.2 Utiliser npx skills

Installez des compétences avec une seule commande : npx skills add jimliu/baoyu-skills. Sélectionnez la compétence et la cible (Claude Code).

6.3 Dépôts de compétences

6.5 Créer une compétence personnalisée : Auto-illustration

Utilisez l’API Nano Banana 2 d’APImart pour créer une compétence qui génère 3 illustrations de style dessin à la main pour tout article que vous écrivez.

6.6 Compétence vs MCP vs Hooks vs Plugin

• Compétence : Recette (Étapes pour le chef).
• MCP : Utilitaires (Eau/Électricité/Gaz pour la cuisine).

Chapitre 7 : Matériel et réseau

• Mac est meilleur pour l’IA grâce à la mémoire unifiée, mais Windows fonctionne très bien.
• Utilisez le mode TUN dans votre proxy (par exemple, clash.verge) si vous rencontrez des erreurs réseau avec MCP ou la génération d’images.

Annexe A : Aide-mémoire des commandes

claude, /skills list, /clear, /compact, /doctor, /model.

Annexe B : Erreurs courantes

Annexe C : Terminologie

Derniers mots

Mettez-vous d’abord en route, ensuite parlez de technique de conduite. Commencez par les chapitres 2 à 5. L’IA est un multiplicateur de productivité de 10 à 100 fois. Commencez aujourd’hui.