[Claude Code #1] 从 /init 和自动生成 CLAUDE.md 开始

Claude Code 的 /init 命令会分析代码库并自动生成 CLAUDE.md。本文整理了已有文件时的行为、迁移 Cursor 和 Copilot 规则、交互模式，以及生成后完善文件的标准。

SeokWoo Lee资深 iOS 软件工程师发布 2026年8月17日更新 2026年8月27日5 分钟阅读

[Claude Code #1] 从 /init 和自动生成 CLAUDE.md 开始封面图

把 AI 编程工具接入新项目后，你会不断重复相同的说明：构建命令是什么、如何运行测试、代码应遵循哪些规则。

Claude Code 会将这些说明保存到名为 CLAUDE.md 的文件中，并在每次会话中自动读取。问题是，从头手写这个文件其实相当令人犯难。

/init就是帮你跨过第一道门槛的命令。它会分析代码库，代你创建 CLAUDE.md 草稿。

这是逐一拆解 Claude Code 命令系列的第一篇。我们先从最常执行的命令开始。

/init 的作用

在会话输入框中输入 /init，Claude 就会开始扫描项目。

官方记忆文档这样说明这一过程：分析代码库，找出构建命令、测试方法和项目约定，再根据这些内容生成 CLAUDE.md。

生成结果大致如下。

# CLAUDE.md

## 构建和测试
- 开发服务器: pnpm dev
- 测试: pnpm test (提交前必须执行)

## 结构
- API 将处理程序放在 src/api/handlers/中
- 将共享类型集中到 src/lib/types.ts中

从 package.json 或 Makefile 中读取的信息会构成骨架。手动从头编写需要 30 分钟的草稿，几分钟就能生成。

如果你想了解 CLAUDE.md 是什么、为什么需要它，建议先阅读 Claude Code 规则与记忆整理文章。

已经存在 CLAUDE.md 时

再次运行 /init 也不会覆盖现有文件。

根据官方文档，如果文件已经存在，Claude 会提出改进建议，而不是覆盖文件。因此，即使项目已经进行了一段时间，运行它也很安全。

检查旧版 CLAUDE.md 时，可以定期运行它。它会提出反映期间变更的构建和测试流程的改进建议。

从其他 AI 工具迁移时

/init也会读取其他编程代理的规则文件。

目标包括 Cursor 的.cursor/rules/和.cursorrules，以及 GitHub Copilot 的.github/copilot-instructions.md。它会选择相关内容并融入新创建的 CLAUDE.md。

如果仓库已经使用 AGENTS.md，还有另一种方法。在 CLAUDE.md 中加入一行 @AGENTS.md，即可完整加载该文件。

@AGENTS.md

## Claude Code 专用指令
- src/billing/ 修改下面内容时，先使用计划模式

两个工具会读取相同的规则，因此不需要复制内容。

如果仓库原本使用 Codex CLI 或 Gemini CLI，可以使用单独的 /import 命令。它会一次性迁移从指令文件到 MCP 服务器、命令和技能的全部内容（v2.1.213 及以上）。

Claude Code /init 分析代码库并生成 CLAUDE.md 的流程图 — 这就是 /init 的执行流程。根据文件是否存在，流程会分为生成和提出改进建议两条路径。

开启交互式 /init

通过一个环境变量，就可以将 /init 切换为更细致的交互模式。

CLAUDE_CODE_NEW_INIT=1 claude

在该模式下，/init会先询问你想创建什么。你可以选择只创建 CLAUDE.md，或同时配置技能和钩子（在特定时机自动运行的脚本）。

接着，它会通过子代理探索代码库，并通过追问补齐缺失信息。写入文件前会先展示提案，因此可以审核后再应用。

该模式还会扩大读取规则文件的范围。AGENTS.md、.windsurf/rules/、.clinerules等其他工具的配置也会作为参考。

创建后先确认

生成完成后，试着运行 /context。

如果在 Memory files 项目中看到 CLAUDE.md，就说明已正常加载。如果没有，Claude 就没有读取该文件。

想打开并编辑文件时，使用 /memory 命令即可。它会在会话中直接用编辑器打开文件。

草稿只是草稿：完善标准

直接保留/init创建的文件会很可惜，因为其中缺少自动分析无法找到的知识。

官方文档也建议创建文件后补充“Claude 无法自行发现的指令”。例如为什么选择这种结构，以及需要避开哪些陷阱等背景信息。

完善时只要记住两条标准。

第一，目标是每个文件不超过 200 行。文件越长，消耗的上下文越多，指令遵循率也越低。

第二，使用可验证的句子。“保持代码整洁”远不如“使用 2 个空格缩进”容易被严格遵守。

像目录列表这种只看代码就能知道的内容可以删除。/doctor检查也可能找到这类冗余并建议删除（v2.1.206 及以上）。

如果想进一步了解必须保持简短的原因，为什么 CLAUDE.md 应该保持简短中有详细说明。

一只手用红笔完善 CLAUDE.md 草稿的插画，旁边写着 REFINE THE DRAFT — 把草稿完善到 200 行以内，是人的工作。

总结

/init是新项目开始使用 Claude Code 时首先要通过的关卡。

它会分析代码库，创建 CLAUDE.md 草稿；如果已有文件，还会提出改进建议。它还支持迁移 Cursor 和 Copilot 规则，因此更换工具时也很有用。

不过，草稿只是起点。补充自动分析无法找到的团队背景，并将其完善到 200 行以内，仍然是人的工作。

预定的下一篇Claude Code 第 2 篇将介绍/plan计划模式：在修改代码前先就设计达成共识。

来源与确认标准

Claude Code 官方文档 — How Claude remembers your project（Anthropic，2026-08-12 确认）