Initialisation de projet Claude Code
Vous pouvez initialiser un projet Claude Code en saisissant ce qui suit dans l'interface interactive de Claude Code :
/init
Nous pouvons initialiser dans un répertoire de projet existant, ou en créer un nouveau.
Nous pouvons d'abord créer un répertoire :
mkdir claude-example-test
Entrez dans ce répertoire :
cd claude-example-test
Créez un fichier de test test.py avec le code suivant :
print("Hello, Example!")
Entrez dans l'interface interactive de Claude Code :
claude
Utilisez la commande/init pour initialiser le projet :
/init

Si vous utilisez VS Code, vous pouvez également le saisir dans l'interface Claude Code de VS Code/init:

Claude analysera automatiquement votre base de code — en lisant package.json, la documentation existante, les fichiers de configuration et la structure du code — puis générera un fichier CLAUDE.md spécifiquement adapté à votre projet.
Claude L'ensemble du processus ne nécessite aucune opération manuelle ; Claude analysera et produira lui-même la configuration initiale.

Fichier CLAUDE.md
CLAUDE.md est un fichier Markdown placé dans le répertoire racine du projet. Claude Code le lit automatiquement au début de chaque session.
CLAUDE.md fait partie du prompt système de Claude, ce qui permet à chaque conversation de précharger le contexte du projet sans qu'il soit nécessaire d'expliquer à plusieurs reprises les informations de base.
Un bon CLAUDE.md doit couvrir trois dimensions :
- QUOI : Stack technique et structure du projet — fournissant à Claude une carte globale de la base de code
- POURQUOI : La finalité du projet, ainsi que la fonction et le positionnement de chaque module
- COMMENT : Les pratiques de développement, comme utiliser bun au lieu de node, et comment Claude vérifie si les modifications sont correctes Humanlayer
Voici un exemple de structure typique de CLAUDE.md :
# 项目名称 ## 项目概述 简述这个项目的目的和功能。 ## 技术栈 - Frontend: React + TypeScript - Backend: Node.js + Express - Database: PostgreSQL ## 目录结构 - `src/components/` - React 组件 - `src/api/` - API 层 - `tests/` - 测试文件 ## 常用命令 - 启动开发服务器:`pnpm dev` - 运行测试:`pnpm test` - 代码检查:`pnpm lint` ## 开发规范 - 使用 TypeScript strict 模式 - 优先使用 interface 而非 type - 禁止使用 any,使用 unknown 替代 ``` ### 文件位置与层级 项目的核心文件结构如下: ``` your-project/ ├── CLAUDE.md # 项目主记忆文件(团队共享) ├── .claude/ │ ├── settings.json # Hooks、权限、环境配置 │ ├── settings.local.json # 个人配置(建议加入 .gitignore) │ └── commands/ # 自定义斜杠命令 │ └── my-command.md └── .mcp.json # MCP 服务配置 ```
Bonnes pratiques après l'initialisation
Itérez et affinez, plutôt que de l'écrire une fois et de le laisser inchangé.
/initLa commande est idéale pour une intégration rapide, mais la véritable valeur vient de l'itération continue dans le temps. Vous pouvez ajouter du contenu que Claude ne peut pas déduire par lui-même, comme les conventions de nommage des branches, les processus de déploiement et les exigences de revue de code, tout en supprimant les conseils génériques qui ne s'appliquent pas.
Commitez dans le contrôle de version: Commitez le
CLAUDE.mdfichier dans Git, afin que toute l'équipe puisse en bénéficier. Les nouveaux membres peuvent rapidement se familiariser en demandant à Claude d'expliquer la base de code.-
Restez concis: Le contenu doit être bref et largement applicable. Adoptez le principe de "divulgation progressive"—n'entassez pas tout ce que vous voulez que Claude sache ; à la place, dites-luicomment trouver les informations importanteset laissez-le les récupérer à la demande, en évitant le débordement de la fenêtre de contexte.
-
Ne laissez pas CLAUDE.md remplacer le linter: Écrire des règles de style de code dans le fichier est l'une des erreurs les plus courantes. N'utilisez jamais un LLM pour faire le travail d'un linter—les linters sont plus rapides, moins chers et déterministes. Les contraintes de style de code ne font que gonfler la fenêtre de contexte et réduire la qualité du suivi des instructions de Claude.
Utilisation#Raccourcis clavier mis à jour en continu
Pendant une conversation, utilisez le#préfixe à tout moment pour envoyer des instructions de mémoire à Claude :
# 我们始终使用 pnpm,不用 npm # 所有组件必须包含单元测试
Ces ajouts s'accumulent progressivement, formant unCLAUDE.md。
Vérifier les résultats de l'initialisation
Une fois l'initialisation terminée, vous pouvez vérifier si Claude comprend correctement le projet grâce aux conversations suivantes :
- Que fait ce projet ?
- Expliquez la structure des répertoires.
- Quelles technologies le projet utilise-t-il ?
- Quelle est la commande pour exécuter les tests ?