章节导航
从这一章开始,Claude Code 不再是一个通用工具,而是变成你这个项目专属的助手,知道项目背景、遵循团队规范、自动跑该跑的检查、拒绝不该做的动作。
前三章讲的都是 Claude Code 自带的能力,命令、快捷键、settings 和权限模式,学完之后已经能干活。但真到具体项目里你会发现,光有通用能力还不够。同一个 Claude Code 在两个不同项目里应该表现得完全不一样,一个 Node.js 服务和一个 Rust CLI,代码规范、测试命令、部署脚本都不一样。把这些差异写进配置的过程,就叫项目化配置。
本章要讲的四件事都是让 Claude Code 认识你项目的手段,切入点不同,但目标一致,让 Claude Code 少问、少踩、少犯错。
阅读顺序
四节内容相互独立,但建议按下面顺序读,先把最常用的 CLAUDE.md 吃透,再依次上强度。
- CLAUDE.md 项目指令,讲项目根目录下这份 markdown 文件是怎么被 Claude Code 自动加载的,应该写什么、不该写什么,
/init命令怎么帮你自动生成第一版,以及为什么定期精简这份文件比不停往里加内容更重要。 - Hooks,介绍 PreToolUse、PostToolUse、UserPromptSubmit 等七类事件钩子。看完你会知道怎么在 Claude 每次动 Bash 之前拦一道,怎么让它每次改完文件顺手跑 prettier,怎么在会话开始时把项目状态推给它。
- Skills,讲 Skill 这种更聪明的扩展方式。Skill 是带 frontmatter 的 markdown 文件,Claude Code 会根据任务描述自动决定要不要用它。我们会拿一个 git-cleanup skill 做例子,顺便对比 Skill 和 slash 命令的边界。
- 细粒度权限,把第三章的权限模式细化到工具、命令、路径、域名四种粒度。看完这节你能写出团队共享的 settings.json,让 Claude 自动放行
git status但仍然拦截git push --force。
学完这一章你能拿到什么
三样东西。第一,你能给任何一个项目写出一份高质量的 CLAUDE.md,让新加入的 Claude 会话在第一条消息之前就已经知道项目在做什么、遵循什么规范。第二,你能用 Hooks 和 Skills 把团队里那些重复动作固化成自动流程,不用再靠人肉提醒 Claude。第三,你的 .claude/settings.json 会变成一份可以直接进 git 的团队资产,新同事 clone 项目、开 Claude Code,配置立刻生效。
小提示
本章示例里出现的 JSON 片段都可以直接抄进项目,但每次抄之前请对照自己的目录结构改一下路径。CLAUDE.md 是 markdown 格式,settings.json 是严格 JSON,两种文件的语法千万不要混。