Skip to content

章节导航

从这一章开始,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,两种文件的语法千万不要混。

本教程为社区中文学习整理,非官方发布。Claude Code 属于 Anthropic。