Claude Code 项目初始化可以在 Claude Code 的交互界面中输入：
我们可以在一个已有的项目目录初始化，也可以新建一个。
我们可以先创建一个目录：
进入该目录：
创建一个测试文件 test.py，代码如下：
进入 Claude Code 的交互界面：
使用 /init 命令来初始化项目：
如果使用 VS Code，也可以在 VS Code 的 Claude Code 界面输入 /init:
Claude 会自动扫描你的代码库——读取 package.json、现有文档、配置文件以及代码结构，然后生成一份专属于你项目的 CLAUDE.md 文件。
Claude 整个过程无需手动操作，Claude 会自行分析并输出初始配置。
CLAUDE.md 文件
CLAUDE.md 是一个放在项目根目录的 Markdown 文件，Claude Code 在每次会话开始时都会自动读取。
CLAUDE.md 会成为 Claude 系统提示的一部分，使每次对话都能预先加载项目上下文，不再需要重复解释基本信息。
一份好的 CLAUDE.md 应该覆盖三个维度：
WHAT（是什么）：技术栈、项目结构，为 Claude 提供代码库的全局地图WHY（为什么）：项目的目的，各模块的功能与定位HOW（怎么做）：开发方式，例如使用 bun 而非 node，以及 Claude 如何验证改动是否正确 Humanlayer
以下是一份典型的 CLAUDE.md 结构示例：
初始化后的最佳实践
迭代优化，而非一次写死。
/init 命令适合快速入门，但真正的价值来自于随时间不断迭代，可以补充 Claude 无法自动推断的内容，例如分支命名规范、部署流程、Code Review 要求；同时删去不适用的通用建议。
提交到版本控制：将 CLAUDE.md 提交到 Git，这样整个团队都能从中受益，新成员可以通过让 Claude 解释代码库来快速上手。保持精简：内容要简洁且普遍适用。采用”渐进式披露”原则——不要把所有你想让 Claude 知道的内容都塞进去，而是告诉它如何查找重要信息，让它按需获取，避免撑爆上下文窗口。不要让 CLAUDE.md 替代 linter：在文件中写代码风格规范是最常见的误区之一。永远不要用 LLM 来做 linter 的工作——linter 更快、更便宜，而且是确定性的。代码风格约束只会让上下文窗口膨胀，降低 Claude 的指令遵从质量。
使用 # 快捷键持续更新
在对话中，随时用 # 前缀给 Claude 发送记忆指令：
这些补充会逐渐积累，形成一份真正反映团队实际工作方式的 CLAUDE.md。
验证初始化效果
初始化完成后，可以通过以下对话确认 Claude 是否正确理解了项目：
这个项目是做什么的？解释一下目录结构。项目用了哪些技术？运行测试的命令是什么？
相关链接
01.Claude Code 简介 | 02.Claude Code 安装与使用 | 03.Claude Code 如何工作 | 04.Claude Code API 配置 | 06.Claude Code 第一次使用