Utilisation de base de Claude Code
Ce chapitre présente les fonctionnalités principales les plus couramment utilisées au quotidien avec Claude Code, notamment comment converser avec Claude, lire et modifier du code, exécuter des commandes, gérer des fichiers, ainsi que quelques astuces pratiques qui peuvent grandement améliorer l'efficacité.
Méthodes de conversation de base
1. Mode interactif (le plus couramment utilisé)
Démarrez Claude Code dans le répertoire du projet, et une fois en mode interactif, vous pouvez directement saisir des questions ou des instructions :
cd /path/to/your/project claude
En mode interactif, saisissez simplement le langage naturel directement—aucun formatage spécial n'est requis :
What does this project do?
帮我找出 src/auth.ts 里的 bug
给 UserService 添加一个 getUserById 方法
utiliser@Vous pouvez également spécifier des fichiers. Par exemple, nous avons un test.html dans le répertoire claude-test.

Nous pouvons saisir claude-test:
cd claude-test
Demandez ensuite:
@test.html 这个文件是干嘛的

2. Mode de tâche ponctuelle
Si vous avez seulement besoin d'exécuter une seule tâche et que vous n'avez pas besoin d'entrer en mode interactif, vous pouvez ajouter directement la description de la tâche après la commande:
claude "解释一下 package.json 里的 scripts 字段"
Il se termine automatiquement après l'exécution, ce qui le rend adapté à une utilisation dans des scripts shell ou pour des requêtes rapides.
3. Mode de requête unique (-p)
Utilisez la-pparamètre pour exécuter une requête unique. La réponse de Claude est directement affichée dans le terminal, ce qui le rend adapté pour être combiné avec d'autres commandes:
claude -p "这段代码有什么问题" < src/utils.ts
# 将 Claude 的分析结果保存到文件 claude -p "分析项目依赖的安全风险" > security-report.md
4. Continuer la conversation précédente (-c)
Claude Code enregistre l'historique des conversations. Utilisez le-cparamètre pour continuer la conversation inachevée la plus récente dans le répertoire courant, sans avoir besoin de reconstruire le contexte:
claude -c
Comprendre et analyser le code
1. Comprendre la situation globale du projet
Lorsque vous arrivez pour la première fois dans un projet que vous ne connaissez pas, vous pouvez demander à Claude d'effectuer une analyse globale :
What is the architecture of this project?
What main technologies and dependencies does the project use?
Please introduce the project's directory structure.
Claude Code lira automatiquement les fichiers du projet pour les analyser.Vous n'avez pas besoin de préciser manuellement quels fichiers lire.Il déterminera de lui-même quel contenu doit être examiné.
2. Analyser un fichier ou un module spécifique
解释一下 src/middleware/auth.ts 的工作原理
UserRepository 类里有哪些方法?分别是做什么的?
这个 SQL 查询语句是什么意思?
3. Suivre les chaînes d'appels du code
When a user logs in, what is the code execution flow? List everything from the entry point to the database.
findUserByEmail 这个函数在哪里被调用?
Which database table does the data from this interface ultimately end up in?
4. Comprendre une logique complexe
What does this recursive function mean? Can you give an example to illustrate?
为什么这里要用 useCallback?不用会怎样?
What format of strings can this regular expression match?
Modifier du code
1. Ajouter une nouvelle fonctionnalité
Décrivez la fonctionnalité dont vous avez besoin, et Claude trouvera le bon endroit et l'implémentera :
在 UserService 里添加一个 updatePassword 方法,需要验证旧密码
给登录接口添加请求频率限制,同一 IP 每分钟最多 5 次
创建一个 formatCurrency 工具函数,支持传入货币代码参数
2. Corriger un bug
Décrivez les symptômes du problème, et Claude localisera la cause et proposera une correction :
After the user logs out, refreshing the page still shows the logged-in state. Help me find the cause and fix it.
This function errors when the input is an empty array. Fix it.
控制台报错 "Cannot read properties of undefined (reading 'map')",帮我定位并修复
3. Refactoriser du code
把这个 500 行的组件拆分成更小的子组件
将 callback 风格的异步代码改为 async/await
These functions contain a lot of duplicate code. Help me extract it into a common utility function.
4. Examiner les modifications
Claude Code affiche le diff avant chaque modification de fichier pour votre relecture. Vous pouvez en discuter après que Claude propose des modifications :
Don't change the code yet. Just tell me how you plan to modify it.
There's a problem with your previous modification: it doesn't handle concurrency. Start over.
这个方案可以,但把函数名改成 validateUserCredentials
Claude Code affiche les modifications et demande votre confirmation avant d’effectuer la moindre modification de fichier. Vous pouvez choisir deAccepter (oui)、Rejeter (non), ou continuer à discuter avant de confirmer. Ne vous sentez pas obligé d’accepter toutes les modifications d’un coup—regardez d’abord, et confirmez seulement lorsque vous êtes satisfait.
Exécution de commandes et de tests
1. Laissez Claude exécuter des commandes
Claude Code peut exécuter des commandes directement dans le terminal. Vous pouvez décrire ce que vous voulez faire en langage naturel :
Run the tests and see if any fail.
安装 dayjs 这个依赖
Build the project and see if there are any errors.
Claude, en fonction de la configuration du projet (commepackage.jsonles scripts dans, ouCLAUDE.mdles commandes dans) sélectionnera la commande correcte à exécuter.
2. Exécuter des tests spécifiques
运行 auth 模块的测试
Run all tests and generate a coverage report.
Why did this test fail? Help me fix it.
3. Afficher la sortie de commande
Claude traite la sortie de commande comme contexte et suggère directement les prochaines étapes en fonction de la sortie :
运行 npm run build,如果有报错帮我修复
跑一下 lint,把所有警告都修复掉
Opérations sur les fichiers
1. Créer de nouveaux fichiers
创建 src/utils/date.ts,实现日期格式化相关的工具函数
新建一个 Docker Compose 配置文件,包含 PostgreSQL 和 Redis 服务
创建 .github/workflows/ci.yml,配置 GitHub Actions 自动运行测试
2. Rechercher des fichiers et du contenu
Is there any code in the project that handles file uploads? Where is it?
哪些地方用到了 localStorage?
找出所有使用了 console.log 的文件
3. Modifications par lots
把所有文件里的 http://api.example.com 替换成 https://api.example.com
把 src/components/ 下所有组件的 PropTypes 改为 TypeScript 类型定义
给 src/api/ 目录下所有接口函数添加 JSDoc 注释
Opérations Git
Claude Code dispose d'une intégration Git profonde, vous permettant d'effectuer presque toutes les opérations Git en langage naturel.
1. Afficher les modifications
Which files did I change?
What does this change include?
最近 10 次提交都改了什么?
2. Commiter le code
Commit this change.
把这次的修改提交,commit 信息说明修复了登录验证的 bug
Claude génère automatiquement un message de commit approprié en fonction des modifications réelles. Vous pouvez également utiliser une commande rapide :
claude commit
3. Gestion des branches
新建一个 feature/user-profile 分支
切换到 develop 分支
把 main 分支的最新改动合并进来
4. Résoudre une fusion
Help me resolve the merge conflict.
This file has conflicts. Help me check which version is correct.
Conseils de gestion du contexte
1. Spécifier manuellement les fichiers
Utiliser@file pathsyntaxe pour indiquer explicitement à Claude quel fichier référencer, en évitant les suppositions :
参考 @src/types/user.ts 里的类型定义,给 UserService 添加类型注解
对照 @docs/api-spec.md 里的规范,检查接口实现是否符合要求
2. Effacer le contexte
Si la conversation dure depuis longtemps, ou si vous êtes passé à une tâche complètement différente, il est recommandé d'effacer le contexte et de recommencer :
/clear
Après l'effacement, la « mémoire » de Claude revient à son état initial, et la nouvelle session n'est pas affectée par le contenu de la conversation précédente.
3. Compresser le contexte
Lorsque Claude semble commencer à « oublier » le contenu antérieur ou que la conversation devient très longue, vous pouvez compresser le contexte :
/compact
Cela amène Claude à résumer la conversation actuelle sous forme d'un résumé compact, libérant de l'espace de contexte tout en conservant les informations clés pour continuer à travailler.
4. Diviser les tâches raisonnablement
Ne décrivez pas une tâche complexe d'un seul coup ; la décomposer en plusieurs étapes et les réaliser séquentiellement fonctionne mieux :
❌ Mauvaise pratique : soumettre trop d'exigences à Claude en même temps :
Help me refactor the entire user module, including adding type annotations, splitting files, optimizing database queries, adding caching, writing tests, and updating documentation.
✅ Bonne pratique : diviser en étapes indépendantes dans un ordre logique :
第一步:"分析 src/user/ 目录的现有结构,告诉我有哪些问题" 第二步:"先给所有函数添加 TypeScript 类型注解" 第三步:"把超过 200 行的文件拆分成更小的模块" 第四步:"优化数据库查询,添加必要的索引"
Commandes slash courantes
En mode interactif, tapez/pour afficher une liste de toutes les commandes disponibles. Voici les commandes slash les plus couramment utilisées :
| Commande | Fonction | Cas d'utilisation |
|---|---|---|
/help |
Afficher toutes les commandes disponibles et leurs descriptions | Lorsque vous n'êtes pas sûr des fonctionnalités disponibles |
/clear |
Effacer l'historique de conversation et démarrer une nouvelle session | Lorsque vous passez à une nouvelle tâche |
/compact |
Compresser le contexte de conversation actuel pour libérer de l'espace | Lorsque la conversation est longue et que Claude commence à oublier |
/init |
Analyser le projet et générer un fichier CLAUDE.md | Lors de la première utilisation dans un nouveau projet |
/resume |
Sélectionner et reprendre une conversation précédente à partir de l'historique | Continuer une tâche laissée inachevée hier |
/undo |
Annuler la dernière modification de fichier | Lorsque les modifications de Claude ne sont pas correctes |
/redo |
Refaire la modification annulée | Lorsque, après avoir annulé, vous trouvez que l’original était meilleur |
/login |
Se connecter ou changer de compte | Lorsque vous devez passer à un autre compte |
/config |
Afficher et modifier la configuration | Ajuster les paramètres de comportement de Claude Code |
/cost |
Afficher l’utilisation des tokens pour cette session | Surveiller les coûts lors de l’utilisation d’un compte API |
Conseils pratiques
1. Laissez Claude analyser d’abord, puis passez à l’action
Pour les problèmes complexes, demandez d’abord à Claude son approche, et ne poursuivez qu’après avoir confirmé que la direction est correcte.
Don't modify the code. First analyze the possible causes of login failure and list your troubleshooting approach.
How do you plan to implement this feature? Describe the approach first, and I'll confirm before you write the code.
2. Fournissez les messages d’erreur et les journaux
Lorsque vous rencontrez une erreur, collez directement le message d'erreur dans la conversation. Claude localisera le problème en fonction du contenu de l'erreur :
运行时报了这个错误,帮我分析原因:
TypeError: Cannot read properties of null (reading 'userId')
at getUserProfile (src/services/user.ts:42:18)
at async ProfileController.getProfile (src/controllers/profile.ts:15:20)
3. Décrire les problèmes d'interface utilisateur avec des captures d'écran
Claude Code prend en charge l'entrée multimodale. Vous pouvez coller des captures d'écran directement dans la conversation pour décrire des problèmes liés à l'interface utilisateur :
[Paste screenshot] This button does not respond when clicked, but there are no errors in the console. Help me investigate.
[粘贴设计稿截图] 按照这个设计实现 Header 组件
4. Faites bon usage de « Continue »
Si la réponse de Claude est tronquée, ou si vous avez l'impression qu'il n'a pas fini de parler, dites simplement « continue » :
Continue.
Anything else?
Implement the remaining parts as well.
5. Demandez des explications sur les modifications
Pour les modifications importantes du code, vous pouvez demander à Claude d'expliquer la raison de chaque modification :
After making the changes, explain the purpose of each change to me.
这里为什么要用 Promise.allSettled 而不是 Promise.all?
6. Limitez le périmètre d'action de Claude
Lorsque vous ne voulez pas que Claude modifie arbitrairement d'autres fichiers, vous pouvez limiter explicitement le périmètre :
只修改 src/auth.ts 这一个文件,不要改其他地方
Only read the code, don't modify it. Help me analyze the performance bottleneck of this module.
Exemples de flux de travail courants
Flux de travail 1 : Comprendre rapidement un nouveau projet
Exemple
> Que fait ce projet ? Quelles technologies utilise-t-il ?
# Étape 2 : Comprendre la structure des répertoires
> Présentez la structure des répertoires du projet, en vous concentrant sur les modules principaux
# Étape 3 : Apprendre à l'exécuter
> Comment exécuter ce projet localement ?
# Étape 4 : Générer un fichier de description du projet
> Aidez-moi à générer un fichier CLAUDE.md résumant les informations clés du projet
Flux de travail 2 : Corriger un bug
Exemple
> Retour utilisateur : après modification des informations personnelles, le nom d'utilisateur en haut de la page ne se met pas à jour en temps réel
# Étape 2 : Demandez à Claude d'analyser la cause
> Analysez d'abord les causes possibles ; ne modifiez pas le code
# Étape 3 : Corriger après confirmation de l'approche
> La deuxième cause que vous avez mentionnée semble plus probable. Corrigez en suivant cette piste
# Étape 4 : Vérifier la correction
> Exécutez les tests pertinents pour confirmer que la correction est efficace
Flux de travail 3 : Ajouter une nouvelle fonctionnalité
Exemple
> Il faut ajouter un filtre par statut à la liste des commandes. Statuts : en attente de paiement, payé, expédié, terminé
# Étape 2 : Comprendre le code existant
> Examinez d'abord la structure du code existant pour les commandes
# Étape 3 : Implémenter la fonctionnalité
> Implémentez la fonctionnalité de filtre sans affecter les fonctionnalités existantes
# Étape 4 : Ajouter des tests
> Écrire des cas de test pour cette nouvelle fonctionnalité
# Étape 5 : Commiter le code
> Commiter cette modification
Flux de travail 4 : Revue de code
# 审查特定文件 > 帮我审查 src/payment/processor.ts 这个文件, > 重点关注错误处理、边界情况和安全风险 # 审查 git 改动 > 审查我这次的所有改动,看看有没有明显的问题 # 针对性检查 > 这段代码有没有 SQL 注入的风险?
Notes
À propos des modifications de fichiers :Claude Code affichera le diff et demandera une confirmation avant d'apporter des modifications.N'acceptez pas tout aveuglément, en particulier les modifications impliquant la logique centrale. Veuillez lire attentivement le contenu du diff avant de décider de l'accepter.
À propos des fichiers sensibles: DansCLAUDE.mdou.claude/settings.jsonmarquez clairement les fichiers que Claude n'est pas autorisé à lire ou à modifier (par ex.,.env, fichiers de clés) pour éviter une exposition accidentelle.
À propos des tâches volumineuses: N'accumulez pas trop de tâches inachevées dans une seule conversation ; cela peut facilement faire perdre sa concentration à Claude. Terminez une tâche avant d'en commencer une autre, ou utilisez/clearpour redémarrer.
À propos de la qualité du code: Le code généré par Claude n'est pas toujours la solution optimale. Pour les modules importants, après exécution, il est recommandé de faire une passe de revue de code, de comprendre le but de chaque modification et de s'assurer qu'il est conforme aux principes de conception du projet.
Autres extensions