Claude Code 使用手册

面向日常使用的工作台:Skills、Subagents、Slash Commands、CLAUDE.md、MCP、权限管理。不是安装说明,是让团队把 Claude Code 变成稳定工程能力的方法。

Skills Subagents Slash Commands MCP / Permissions

核心理念

Claude Code 的价值不是"更聪明",而是把理解架构、产品推演、前端体验和任务拆解的思考过程变成可重复调用的资产。

适合谁

研发团队日常使用、产品负责人做方案推演、技术管理者建立团队规范、需要固定工作流的团队。

掌握什么

CLAUDE.md 项目记忆、Skills 沉淀工作流、Subagents 分配专门角色、Slash Commands 高效操作。

初始化项目

/init

清理上下文

/clear

压缩上下文

/compact

代码评审

/review

01 日常使用路径

  1. 进入项目根目录,启动 claude
  2. 首次进入项目运行 /init,生成 CLAUDE.md
  3. 先问架构、约定和风险,再让它改代码。
  4. 需要固定流程时,用 Skill 或自定义 Slash Command 沉淀。
  5. 需要专门角色时用 Subagent,需要外部系统时接 MCP。
关键是让高频工作流程变成"可重复调用的资产",不是记更多命令。

02 常用 Slash Commands

命令日常用途使用时机
/init初始化项目记忆,生成 CLAUDE.md首次接入或规范变化时
/clear清理对话历史上下文混乱或切换任务时
/compact压缩上下文,保留关键决策长任务推进中
/agents创建和管理 Subagents需固定评审、测试、调试角色时
/memory编辑 CLAUDE.md 记忆补充约定、禁区、工作方式时
/permissions管理工具权限限制读取、执行或外部访问时
/mcp管理 MCP 连接连接 GitHub、数据库、文档源时
/review请求代码评审提交前检查风险、风格、测试缺口

03 Skills:把重复做法变成可调用能力

Skill 适合沉淀重复流程,比如"前端视觉审查""提交前检查""生成发布说明"。由 SKILL.md 文件描述触发条件和执行步骤。

什么时候用

  • 反复粘贴同一段工作方法。
  • 需要固定输出格式和检查清单。
  • 团队希望不同项目保持同一种工作方式。

放在哪里

  • 个人级:~/.claude/skills/<skill-name>/SKILL.md
  • 项目级:.claude/skills/<skill-name>/SKILL.md

04 Subagents:给复杂任务分配专门角色

带独立上下文、专门提示词和工具权限的 AI 角色。适合代码评审、测试修复、调试、文档生成。

Subagent适合任务注意事项
code-reviewer评审安全、可维护性、测试缺口先输出问题,不要顺手改大量文件
test-runner跑测试、定位失败权限限制在测试命令和相关目录
debugger分析错误日志、复现问题给足错误输出和复现步骤
docs-writer整理代码行为为文档明确读者是内部研发还是客户

05 CLAUDE.md:项目记忆不要写成百科

保存项目上下文、代码风格、常用命令、目录说明和禁区。不应变成百科。

建议内容

  • 项目目标和主要用户
  • 关键目录和边界
  • 常用开发、测试、构建命令
  • 代码风格和命名约定
  • 禁止触碰的文件、接口或配置

06 MCP、权限和 Hooks

落地建议

  1. 先从本地项目能力开始,不要一开始就接太多外部系统。
  2. 涉及生产、密钥、客户数据的目录,优先配置 deny 规则。
  3. Hooks 适合自动格式化、阻止危险命令,但不要把复杂业务逻辑塞进去。
  4. MCP 连接内部系统前,明确权限、审计和数据边界。

07 日常提示词模板

理解项目

请先阅读项目结构,解释主要模块、数据流、关键风险,不要修改文件。

前端改版

先输出设计计划,覆盖信息层级、桌面端、移动端、交互状态和验收标准。等我确认后再改代码。

提交前评审

请从代码评审角度检查这次改动,优先列出 bug、回归风险、测试缺口和可维护性问题。

压缩上下文

/compact 保留当前目标、已做决策、未完成事项、关键文件和下一步验证方式。