结论先说
/init是自动扫描代码库生成起始CLAUDE.md的引导命令:它会读取包管理配置、构建脚本、目录结构以及已有的 Cursor / Copilot 规则文件,汇总出一份项目指令初稿。- 已有
CLAUDE.md时不会粗暴覆盖:如果根目录已经存在该文件,/init会对比当前代码库审阅旧内容,向你提出增删改进建议并等待确认。 - 生成完第一件事不是提交,而是删减:官方建议单份
CLAUDE.md控制在 200 行以内;凡是 Claude 读代码自己就能看懂的目录列表和通用常识都该删掉。 - 不要每次开新会话都跑一遍
/init:生成好的CLAUDE.md以后每次启动都会自动加载,反复跑/init只会白白消耗扫描代码库的大量 Token。 - Claude Code 订阅与高配额开通入口:国内无境外卡可通过本站 iOS 免上号自助卡密开通 Claude Pro 会员 或 5 倍以上额度的 Claude Max 会员,完整档位选型见 Claude Code 订阅说明页。

图:本站根据 Claude Code 官方文档:How Claude remembers your project 整理的示意图
本文根据 Claude Code 官方文档《How Claude remembers your project》《Best practices for Claude Code》《Commands》整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Anthropic 官方网站。
适用于谁
- 搜「claude code /init 命令」「/init 生成 claude.md」,想知道敲下这条斜杠命令后它在后台读了什么、改了什么的人;
- 仓库里本来已经有了一份手写的
CLAUDE.md或.cursorrules,担心运行/init会把旧规则直接清空覆盖的开发者; - 运行完
/init得到两三百行说明后直接提交进仓库,结果发现每次对话额度掉得飞快、指令遵循度反而下降的人。
如果你刚接手一个陌生遗留工程,想看从只读摸底到小步重构的完整接手流程,可配合阅读 Claude Code 接手老项目:先读懂代码库、用 /init 生成 CLAUDE.md。
一、敲下 /init 后,Claude Code 到底扫描了什么
进入项目根目录启动 claude,在输入框敲入 /init 回车后,智能体会发起一轮只读探索循环,重点采集三类信息:
- 构建、测试与检查脚本:读取
package.json、pyproject.toml、Cargo.toml、Makefile、Dockerfile以及.github/workflows等流水线配置,提取安装依赖、本地启动、类型检查和运行单元测试的准确命令。 - 目录分工与核心链路:抽样查看
README.md与src/顶层模块入口,总结前后端分层、数据库 ORM 位置或路由约定。 - 已有其他 AI 工具的规则资产:官方文档说明,如果仓库里已经配过 Cursor 规则(
.cursor/rules/或.cursorrules)或 GitHub Copilot 指令(.github/copilot-instructions.md),/init会主动读取并把适用的项目约束吸纳进生成的草稿里。
如果你想在初始化时顺带引导配置技能(Skills)和钩子(Hooks),官方还提供了新版交互式开关:先在终端设置环境变量 CLAUDE_CODE_NEW_INIT=1 再启动运行 /init,它会分阶段询问你要创建哪些项目配置。
二、生成草稿后必做的四项人工精修

图:本站根据 Claude Code 官方文档:Best practices for Claude Code 整理的示意图
机器自动总结的初稿往往偏啰嗦,直接留着用每轮对话都会带着几千字背景计费。参考各技术栈成稿结构(详见 Claude Code 的 CLAUDE.md 模板:前端、后端、数据分析),按下面四条动手改一遍:
- 核准「只跑单个测试文件」的命令:
/init常只写出跑全量测试的npm test,全量跑一次要几分钟。务必改成支持传入单文件路径的命令(例如npx vitest run src/auth.test.ts或pytest tests/test_order.py -k test_pay),让智能体每次小步改完能秒级自检。 - 大刀砍掉目录树和框架套话:官方给出的去留标准很简单——「删掉这一行,Claude 会不会犯错?」像「
src/components存放前端组件」「使用 TypeScript 编写类型安全的代码」这类废话一律删掉。 - 补上代码里看不出来的「坑」:重点写进仓库历史包袱,例如「
src/api/v1是废弃兼容层只修不增,新接口一律写在src/api/v2」「改数据库表结构禁止直接手改旧迁移文件」。 - 把个人习惯和局部规则拆出去:你个人的中文回复偏好、提交信息格式放进用户级
~/.claude/CLAUDE.md(分工见 全局 CLAUDE.md 怎么配);只针对某几个子模块的细则挪进.claude/rules/目录并用paths:限定触发路径。
三、关于 /init 与日常维护的三个常见误区
- 误区一:完全空白的新文件夹先跑
/init。空目录里没有任何配置文件可供推断,跑出来全是空泛模板。正确顺序是先用脚手架(如create-next-app或uv init)搭好工程骨架、装好测试框架,再执行/init。 - 误区二:以为
CLAUDE.md会随着你平时改代码自动同步更新。CLAUDE.md是静态指令文件,不会在普通对话里自己改写(它与自动记忆MEMORY.md的本质区别见 CLAUDE.md 会自动更新吗、怎么更新)。只有当你大改了构建工具或目录架构时,才需要再跑一次/init让它对照现状提修订建议。 - 误区三:把几千字业务需求文档全塞进
CLAUDE.md。长篇接口契约和历史设计稿应单独放在docs/目录,在CLAUDE.md里只留一行路径指引让模型按需读取。
把根目录 CLAUDE.md 精简到百行左右后,不仅指令命中率更高,每次会话的固定上下文底噪也会明显下降,能让个人订阅的 5 小时滚动额度耐用不少;日常需要开通或续订官方订阅可查看本站 Claude Code 充值页 或 Claude Pro 方案。
常见问题
问:仓库里已经有同事维护好的 AGENTS.md,还要用 /init 重新生成一份吗?
答:不需要重写两套。可以让 CLAUDE.md 用 @AGENTS.md 语法直接导入共享规范,再在下面只补几行 Claude Code 专属工具或钩子说明即可。
问:怎么检查我的 CLAUDE.md 里有没有写过期失效的文件路径?
答:在会话里输入 /memory 可以核对当前加载了哪几份记忆文件;遇到规则臃肿或疑似前后矛盾时,也可以直接发提示词让 Claude 对照最新目录结构审查一遍 CLAUDE.md 里的失效路径。
问:/init 生成的文件应该提交进 Git 还是加进 .gitignore?
答:根目录 ./CLAUDE.md 面向全团队共享,应当提交进 Git;只属于你个人的本地调试备注请单独建 ./CLAUDE.local.md 并加进 .gitignore。
问:国内没有海外银行卡,怎么给 Claude Code 开通 Pro 或 Max 订阅?
答:可在 Claude Code 订阅页 选择走 iOS 订阅链路的 Claude Pro 自助卡密 或 Claude Max 充值,支持支付宝、微信支付与 AlipayHK,无需交出账号密码;若账号弹出身份核验也可查看 Claude KYC 认证人工协助(失败不收费,封号不在质保范围)。
相关教程
- Claude Code 接手老项目:先读懂代码库、用 /init 生成 CLAUDE.md
- 全局 CLAUDE.md 怎么配:~/.claude/CLAUDE.md 与项目指令分工
- CLAUDE.md 会自动更新吗、怎么更新:auto memory 和 CLAUDE.md 的区别
- Claude Code 的 CLAUDE.md 模板:前端、后端、数据分析各一份
参考资料
- Claude Code 官方文档:How Claude remembers your project — https://code.claude.com/docs/en/memory
- Claude Code 官方文档:Best practices for Claude Code — https://code.claude.com/docs/en/best-practices
- Claude Code 官方文档:Built-in commands(
/init说明) — https://code.claude.com/docs/en/commands
0 条评论
还没有评论,来抢沙发~