命令字典
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
使用CLAUDE.md指南初始化项目
/init 是 Claude Code 会话内的 slash 命令，作用是为当前项目自动生成 CLAUDE.md 启动文件。执行后，Claude 会分析仓库结构，提取构建命令、测试指令和项目约定，写入一份 CLAUDE.md。
CLAUDE.md，/init 不会覆盖，而是提出改进建议。AGENTS.md（供其他 AI 工具使用），/init 会读取它并将相关内容并入生成的 CLAUDE.md；同理也会读取 .cursorrules、.devin/rules/ 和 .windsurfrules。CLAUDE_CODE_NEW_INIT=1 可解锁增强交互流，额外生成 skills 和 hooks 文件（见下节）。官方文档将 /init 定位于"项目第一次会话"阶段，之后再用 /memory 细化内容。
在任意 Claude Code 会话内，直接输入：
/init
Claude 扫描当前工作目录，生成或更新 CLAUDE.md（路径：./CLAUDE.md 或 ./.claude/CLAUDE.md）。
CLAUDE_CODE_NEW_INIT=1）# 单次启用
CLAUDE_CODE_NEW_INIT=1 claude
# 永久启用（写入 shell 配置）
export CLAUDE_CODE_NEW_INIT=1
启用后，在会话内运行 /init，将进入多阶段交互流：
生成的 CLAUDE.md 遵循核心原则：只写 Claude 自身无法推断的内容——package.json 依赖、文件夹结构、语言约定等 Claude 可自行推断的内容不会被写入，以节省 context。
CLAUDE.local.md）在增强交互流中选择"个人"选项时，/init 会创建 CLAUDE.local.md 并自动将其加入 .gitignore，避免个人偏好随代码提交共享。
| 配置项 | 说明 |
|---|---|
CLAUDE_CODE_NEW_INIT=1 | 环境变量，开启交互式多阶段初始化流 |
./CLAUDE.md 或 ./.claude/CLAUDE.md | /init 默认写入的项目级指令文件 |
CLAUDE.local.md | 个人私有偏好文件，不纳入版本控制 |
CLAUDE.md 文件大小建议：官方文档建议每个 CLAUDE.md 控制在 200 行以内。超长文件会消耗更多 context，且 Claude 的遵从度会下降。如内容过多，可使用 .claude/rules/ 目录按路径分拆，或用 @path/to/file 语法导入其他文件。
| 约束 | 说明 |
|---|---|
| 仅在会话内触发 | /init 是 slash 命令，必须在 Claude Code 交互会话中输入，不能作为 CLI 参数单独调用 |
| 已存在 CLAUDE.md 时不覆盖 | 检测到已有文件时，/init 转为建议模式，不自动覆盖 |
| CLAUDE.md 作为 context 而非强制执行 | 生成的文件通过 context window 影响 Claude 行为，而非硬约束；需强制执行的规则应用 hooks |
| 个人文件需手动 gitignore | 仅在增强交互流中选择"个人"选项时，/init 才自动处理 .gitignore；默认模式不处理 |
| 原语 | 由谁写入 | 触发时机 | 典型内容 |
|---|---|---|---|
/init 生成的 CLAUDE.md | Claude（你审核） | 首次初始化、重大重构后 | 构建命令、架构约定、必须知道的约束 |
/memory（auto memory） | Claude 自动积累 | Claude 自行判断是否值得记住,并非每次会话都写入 | 调试发现、偏好、build 命令 |
手动编辑 CLAUDE.md | 你 | 任意时机 | Claude 反复犯错的规则、团队标准 |
.claude/rules/*.md | 你 | 按路径按需加载 | 只对特定文件类型生效的细粒度规则 |
/init 是起点，/memory 和手动编辑是持续迭代机制。
AGENTS.md 或 .cursorrules 时，/init 自动将这些工具的规则整合进 CLAUDE.md，无需手动拷贝。/init 使 CLAUDE.md 反映新状态，而非手动 patch 旧内容。把 CLAUDE.md 当强制执行层：CLAUDE.md 是 context，不是配置约束。Claude 可能在某些情况下不遵循其中的指令，尤其是指令模糊或相互冲突时。需要在特定生命周期事件强制执行的操作（如提交前 lint），应改用 hooks。
文件过长导致遵从度下降：官方文档明确指出，超过 200 行的 CLAUDE.md 会降低 Claude 的遵从度。/init 生成的初稿可能需要你手动精简，删掉 Claude 能自行推断的内容。
/compact 后嵌套 CLAUDE.md 失效：项目根目录的 CLAUDE.md 在 /compact 后会重新从磁盘注入；但子目录中的 CLAUDE.md 不会自动重新注入，需等 Claude 下次读取该子目录中的文件时才会重新加载。
增强交互流未默认开启：CLAUDE_CODE_NEW_INIT=1 不是默认行为，需手动设置环境变量。不设置直接跑 /init 只会生成基础 CLAUDE.md，不会弹出 skills/hooks 选项。
现在可通过 Skill tool 发现和调用