/init
为项目初始化一份 CLAUDE.md 指南。
/init 会分析当前仓库,生成一份初始的 CLAUDE.md,其中包含 Claude 在代码中发现的构建命令、测试方法和项目约定。如果已经存在 CLAUDE.md,该命令不会覆盖它,而是给出针对性的改进建议。
在此过程中,/init 会自动读取已有的 Cursor 规则(.cursor/rules/ 或 .cursorrules)和 Copilot 规则(.github/copilot-instructions.md),并将相关内容纳入生成的 CLAUDE.md。
设置环境变量 CLAUDE_CODE_NEW_INIT=1 后,则会运行一个交互式的多阶段流程:Claude 会询问需要配置哪些内容(CLAUDE.md、Skills、Hooks),通过子代理探索仓库,提出澄清问题,并在写入前展示方案供确认。在此模式下,/init 还会读取 AGENTS.md、.devin/rules/、.windsurf/rules/ 或 .windsurfrules 以及 .clinerules,并可以创建一份不纳入版本控制的私有文件 CLAUDE.local.md。自 2.1.108 版起,Claude 也可以在需要时通过 Skill 工具自行触发 /init。
✅ 什么时候用？
为新仓库准备 Claude Code
在刚克隆的项目中运行 /init,让 Claude 生成包含项目背景信息的初始 CLAUDE.md。
包含 Skills、Hooks 和 Memory 的完整配置
设置环境变量 CLAUDE_CODE_NEW_INIT=1 后启动 /init,以交互方式同时配置 Skills、Hooks 和个人 Memory 文件。
⛔ 什么时候不该用？
只想对已维护好的 CLAUDE.md 做一处针对性补充
根据文档,/init 不会覆盖已有的 CLAUDE.md,只会提出改进建议——但对于单一、明确的小改动来说,完整的分析流程仍是不必要的绕路。
更好的选择: 直接用 /memory 编辑 CLAUDE.md。
只想添加私有的、不纳入版本控制的偏好设置
个人偏好应放在被 gitignore 排除的 CLAUDE.local.md 中;如果没有设置 CLAUDE_CODE_NEW_INIT=1,/init 不会自动创建这个文件。
更好的选择: 手动创建 CLAUDE.local.md,并将其加入 .gitignore。
来源
- Claude Code 文档（官方） ↗ code.claude.com