
Claude Code 是 Anthropic 推出的编码代理工具,能自主阅读整个项目、规划任务、编辑多文件、运行命令,并通过检查点安全迭代。下面基于官方文档和实际使用经验,对 12 个核心功能 进行详细拆解。每项包括:
- 功能定义与核心价值
- 实操案例(真实场景 + 预期效果)
- 详细操作步骤(从零开始,手把手指导)
掌握这些,你可以将 Claude Code 从简单聊天工具升级为可靠的“AI 开发同事”,显著提升效率并降低出错风险。
1. CLAUDE.md —— 项目专属“记忆文件”
定义与价值:项目根目录下的 CLAUDE.md 文件,Claude 每次会话启动时自动读取,包含编码规范、架构决策、项目结构等长期记忆,避免重复说明。
实操案例:在一个 React + TypeScript 项目中,你希望所有组件必须使用函数式组件、添加 PropTypes 检查、错误处理统一用 Sentry。把这些规则写进 CLAUDE.md 后,新会话中 Claude 自动遵守,无需每次提示,团队新人也能快速保持一致风格。
详细操作步骤:
- 在项目根目录打开终端,输入
claude启动 Claude Code。 - 输入
/init,Claude 会自动扫描项目并生成 CLAUDE.md 模板(包含构建命令、测试脚本等)。 - 编辑生成的
CLAUDE.md,添加自定义规则,例如:# 项目规范 - 始终使用 TypeScript 严格模式 - 新功能必须先写单元测试(Jest) - 所有 API 调用必须有错误边界和 loading 状态 - 优先使用 Tailwind CSS,避免内联样式 - 保存后,重启会话或新开会话,Claude 就会自动应用这些规则。
- 最佳实践:保持文件简洁(<200 行),团队共享 Git 提交;如果过大,可拆分成子目录的 CLAUDE.md(分层加载)。
2. Permissions(权限控制)—— 安全与速度的平衡器
定义与价值:控制 Claude 是否能修改文件、运行 Bash 命令等。默认需人工批准,防止意外删除或安装恶意包。
实操案例:在生产级后端项目中,你允许 Claude 运行测试和 lint,但禁止删除文件或 git push。设置后,Claude 可以安全地重构代码、修复 bug,而不会意外破坏仓库。
详细操作步骤:
- 在 Claude Code 会话中输入
/permissions,打开权限菜单。 - 选择模式(如 “delegate” 只允许团队工具,或自定义白名单)。
- 预批准安全操作:勾选 “运行 npm test”“执行 lint”“git commit”等;禁止 “rm -rf”“安装未知 npm 包”等高危项。
- 保存设置后,在后续任务中 Claude 会自动遵守。
- 进阶:对于一次性实验项目,可用
--dangerously-skip-permissions启动,但仅限本地测试环境。
3. Plan Mode(规划模式)—— 先想后做,避免浪费
定义与价值:只读模式,Claude 只能阅读文件、提问、制定详细步骤,不能修改代码。适合复杂任务,避免盲目编辑导致混乱。
实操案例:要为一个大型 Node.js API 添加用户认证模块(涉及 JWT、数据库、中间件)。直接编辑容易遗漏安全点;用 Plan Mode 先让 Claude 调研现有代码、列出 8 个实施步骤、风险评估,再人工审核通过后执行,节省大量返工时间。
详细操作步骤:
- 在会话中按 Shift + Tab(或两次)切换到 Plan Mode(界面会提示只读)。
- 输入任务描述,例如:“为这个 Express 项目添加 JWT 认证模块,包括注册、登录、中间件保护。调研现有路由和数据库 schema。”
- Claude 会自动启动探索子代理(Explore Subagent),读取代码并输出结构化计划(步骤、文件变更列表、测试点)。
- 人工审核计划(可编辑 plan.md),确认无误后切换回正常模式执行。
- 最佳实践:大型重构、新功能开发必用;结合子代理调研复杂部分。
4. Checkpoints(检查点)—— 随时回滚的“时光机”
定义与价值:每次重大编辑前自动快照项目状态,支持一键回滚,防止实验失败无法恢复。
实操案例:尝试用新架构重构一个模块(从类组件改 Hooks + Redux Toolkit)。改到一半发现性能问题,用 Checkpoints 回滚到初始状态,再尝试另一种方案,整个过程无需手动 git stash 或备份文件。
详细操作步骤:
- 正常使用 Claude Code 进行编辑(它会自动创建检查点)。
- 如果结果不理想,输入
/rewind打开检查点列表(显示时间戳 + 简要描述)。 - 选择目标快照,恢复指定文件或整个项目。
- 或者按 Esc 两次快速回滚最近变更。
- 注意:检查点仅覆盖文件编辑,不包括外部操作(如数据库变更);结合 Git 使用更安全。
5. Skills(技能)—— 可复用的“工作流模板”
定义与价值:把重复指令打包成 SKILL.md 文件,按需加载,避免每次重复长提示,保持上下文精简。
实操案例:创建一个 “code-review” 技能,包含安全检查、性能优化、代码风格审查清单。每次 PR 前只需说“使用 code-review 技能审查这个模块”,Claude 自动按模板执行,无需手动输入 500 字提示。
详细操作步骤:
- 在项目中创建
skills/目录(或~/.claude/skills/全局)。 - 新建
code-review.md,写入技能描述和详细指令(支持 frontmatter)。 - 示例内容:
--- name: code-review description: 进行全面代码审查 --- 你是资深安全工程师。请检查:SQL 注入、XSS、权限绕过;性能瓶颈;测试覆盖率。 - 在会话中直接说“使用 code-review 技能审查 user-service.ts” 或通过
/命令调用。 - 进阶:从社区或市场安装现成技能;技能可包含子代理调用。
6. Hooks(钩子)—— 自动执行的“确定性动作”
定义与价值:在工具调用前/后自动运行固定脚本,保证“每次变更后必须格式化、必须 lint”这类操作 100% 执行,不依赖 Claude 记忆。
实操案例:每次 Claude 编辑代码后,自动运行 prettier --write 和 eslint --fix,再运行单元测试。只有全部通过才允许提交,避免人工反复提醒。
详细操作步骤:
- 输入
/hooks或在.claude/hooks/配置。 - 定义触发点(如 before-edit、after-edit)和对应 shell 命令。
- 示例:after-edit 钩子运行
npm run lint:fix && npm test。 - 保存配置后,Claude 在工作流中自动触发。
- 最佳实践:用于必须发生的确定性任务(格式化、安全扫描);指导性规则仍放 CLAUDE.md。
7. MCP(Model Context Protocol)—— 外部工具扩展协议
定义与价值:开放协议,让 Claude 连接 Figma、GitHub、数据库、浏览器等外部服务,突破本地文件限制。
实操案例:连接 GitHub MCP 后,Claude 可直接读取 issue、创建 PR、同步设计稿到代码;或用浏览器 MCP 抓取最新 API 文档,实时更新集成。
详细操作步骤:
- 启动 MCP Server(社区有现成,如 GitHub、Figma、Playwright)。
- 在会话中输入
/mcp,查看并连接可用服务器。 - 配置权限后,Claude 可调用对应工具,例如:“用 GitHub MCP 创建一个新 PR,标题为 ‘Add auth module’”。
- 进阶:结合 Skills 或 Subagents 使用,实现全栈自动化。
8. Plugins(插件)—— 一键打包分发的工作流
定义与价值:将 Skills + Hooks + Subagents + MCP 打包成可安装插件,一条命令让团队成员完整复用你的配置。
实操案例:你花时间调好“企业级代码审查 + 自动测试 + 文档生成”插件,团队其他人只需 install 即可拥有相同工作流,统一开发规范。
详细操作步骤:
- 配置好相关 Skills、Hooks 等。
- 使用插件打包命令或市场工具生成插件文件。
- 发布到内部 Git 或 Claude 市场。
- 他人输入
/plugins install <插件名>即可使用。 - 最佳实践:适合团队标准化场景。
9. Context(上下文管理)+ 10. Compaction(自动压缩)
定义与价值:管理 ~20 万 Token 上下文,自动或手动压缩,只保留关键决策,避免长会话变慢或丢失信息。
实操案例:开发一个持续 2 周的大型功能,会话上下文膨胀。定期压缩后,Claude 仍记得核心架构决策,而非所有中间对话细节。
详细操作步骤:
- 输入
/context查看当前占用详情。 - 当上下文接近上限时,自动触发压缩(或手动
/compact [指令],如“保留所有架构决策和 API 规范”)。 - 重要知识及时写入 CLAUDE.md 永久保存。
- 最佳实践:长项目每 15-20 条消息总结一次,或新开会话。
11. Slash Commands(斜杠命令)—— 键盘快捷键
定义与价值:快速触发常用操作,如查看成本、清空会话、切换模型等。
实操案例:频繁检查费用(/usage)、手动压缩(/compact)、切换到 Opus 模型(/model opus),大幅减少输入时间。
详细操作步骤:
- 在会话中直接输入
/+ 命令,例如:/init生成 CLAUDE.md/rewind查看检查点/compact手动压缩/agents管理子代理
- 记住高频命令(/cost、/clear、/model 等),提升流畅度。
12. Subagents(子代理)—— 复杂任务的“多线程”处理
定义与价值:主代理将任务拆分给多个独立子会话,每个专注一个领域,完成后返回摘要,主上下文保持干净。
实操案例:重构认证系统时,让一个子代理调研现有代码、另一个审查安全、第三个生成测试用例,主代理只负责整合,最终输出高质量结果且上下文不爆炸。
详细操作步骤:
- 输入
/agents→Create agent。 - 定义子代理:名称、专属 Prompt、工具集、专注领域(例如 security-reviewer)。
- 示例:创建一个 “test-writer” 子代理,Prompt 为“只生成 Jest 测试,覆盖边缘 case”。
- 在任务中说“委托给 security-reviewer 子代理审查此代码”。
- 最佳实践:研究型、审查型任务交给子代理;可创建 Agent Teams 让子代理间相互通信。
总结与快速上手建议
- 立即开始:进入项目目录运行
claude,输入/init创建 CLAUDE.md,然后设置 Permissions。 - 推荐组合:基础(CLAUDE.md + Permissions + Plan Mode + Checkpoints)→ 标准化(Skills + Hooks + Plugins)→ 高级(Subagents + MCP)。
- 成本优化:优先用 Sonnet 处理常规任务,Plan Mode 或复杂规划时切换 Opus;定期 compact 并精简 CLAUDE.md。
- 注意事项:检查点不覆盖外部副作用,始终结合 Git 使用;权限设置从保守开始逐步放开。
这些功能组合使用后,Claude Code 能真正成为你的“AI 搭档”。建议亲手在小项目上把每个功能跑一遍,尤其是 Plan Mode + Checkpoints + Subagents 的组合,你会感受到开发体验的质的飞跃。
