内容来源：Julián Úsuga Ortiz。https://julianusor.github.io/blog/how-to-use-claude-code/
原题：How to Use Claude Code
原发布时间：2026-02-10
一份 Claude Code 实用指南，涵盖斜杠命令、子智能体、Hooks、Skills 与并行工作流；2026 年 4 月更新，聚焦真正重要的命令。
兼容性说明（核对日期：2026-07-20）：本指南反映的是 2026 年 4 月更新时的状态，而 Claude Code 的命令与配置仍在持续变化。当前命令参考建议使用
/code-review ultra；原文中的/ultrareview仍可作为别名使用。请根据当前 Skills 和 Hooks 参考文档，核实 MCP 路径、子智能体行为，尤其是$CLAUDE_FILEHook 示例。下文保留原始正文及旧版文档链接。
引言
本指南介绍 Claude Code 日常工作中杠杆效应最高的部分：斜杠命令、子智能体、Skills 和 Hooks。它面向已经安装 Claude Code，并希望超越基础提示词用法的读者。
2026 年 4 月的更新反映了工具自身的变化：内置斜杠命令变多了；Hooks 如今是强制执行自动化行为的正确方式；/loop 与 /schedule 还带来了本文最初发布时并不存在的周期任务和远程工作流。
核心概念
记忆
用于跨会话持久保存上下文的 Markdown 文件。每个项目都在 ~/.claude/projects/<project>/memory/ 下拥有独立目录，并通过 MEMORY.md 建立索引。Claude 会在会话开始时自动读取记忆，并在学到值得长期保存的内容时写入新记忆。
Skills
为重复任务封装的提示词和指令。内置 Skills 包括 /init、/review、/security-review、/loop 和 /schedule。自定义 Skills 放在 ~/.claude/skills/<name>/SKILL.md，可以通过 /<name> 调用。
子智能体
通过 Agent 工具在后台启动的独立 Claude 实例。它们拥有自己的上下文窗口和工具白名单。子智能体尤其适合调研与探索：工具产生的噪声不会进入父对话。
Hooks
由运行框架响应事件（工具调用、提交提示词、会话开始、停止）而执行的 Shell 命令。Hooks 是唯一能够强制执行自动化行为的方式——Claude 自身无法保证“从现在开始始终执行 X”，但 Hook 可以。
MCP 服务器
通过模型上下文协议连接的外部工具服务器。用户级配置位于 ~/.claude/mcp.json，项目级配置位于 .mcp.json。Claude 正是通过 MCP 访问 Gmail、Slack、数据库、内部 API 等外部系统。
真正值得记住的斜杠命令
下面这些命令值得记住。在 CLI 中输入 /help 可以查看完整列表——实际命令比这里更多，但其中大多数很少有用。
设置与会话管理
| 命令 | 作用 |
|---|---|
/init |
为当前仓库生成 CLAUDE.md，每个项目运行一次。 |
/clear |
丢弃对话历史，从头开始。 |
/compact |
总结长对话以释放上下文；它会保留意图，因此比 /clear 更节省成本。 |
/cost |
显示当前会话的 Token 用量和费用。 |
/model |
切换模型（例如 Opus 4.7 ↔ Sonnet 4.6 ↔ Haiku 4.5）。 |
/fast |
切换快速模式（Opus 4.6 快速变体——模型相同，输出更快）。 |
/config |
打开设置界面，调整主题、默认模型等。 |
代码审查与质量
| 命令 | 作用 |
|---|---|
/review |
审查 Pull Request。在仓库内运行；可以传入 PR 编号，也可以省略以审查当前分支。 |
/security-review |
对待提交变更进行有针对性的安全检查，捕捉注入、身份验证缺口和密钥泄漏。 |
/ultrareview |
多智能体云端审查（收费）。只能由用户触发，Claude 无法替你启动。 |
自动化与调度
| 命令 | 作用 |
|---|---|
/loop <interval> <prompt> |
按固定间隔重复运行提示词，默认为 10 分钟。适合“每 5 分钟检查一次部署”之类的任务。 |
/schedule |
创建、列出或删除远程 Cron 智能体。它们按照时间表在 Anthropic 基础设施上运行。 |
配置
| 命令 | 作用 |
|---|---|
/permissions |
添加、删除工具权限，或在用户设置与项目设置之间移动权限。 |
/hooks |
查看已配置的 Hooks。真正添加 Hook 仍需编辑 settings.json。 |
/agents |
管理自定义子智能体。 |
/mcp |
管理 MCP 服务器连接。 |
! 前缀
在 Shell 命令前输入 !，即可在会话中直接运行。输出会进入对话，因此 Claude 能够看到。
! git log --oneline -20
! gcloud auth login
这适合把交互式命令的结果交给 Claude，例如身份验证流程或任何会弹出提示的问题。
子智能体
子智能体通过 Agent 工具启动。它们在后台运行，完成后返回一条汇总消息。
| 类型 | 用例 |
|---|---|
general-purpose |
多步骤调研和实现，并且不希望过程噪声进入上下文。 |
Explore |
快速探索代码库：通过 Glob、Grep 和读取文件回答“X 如何工作？” |
Plan |
在进行复杂变更之前规划架构，返回分步骤计划，而非代码。 |
你也可以在 ~/.claude/agents/<name>.md 中定义自定义子智能体，为它们指定系统提示词、工具白名单和模型。定义之后，它们会成为可传给 Agent 的 subagent_type。
Fork 与 subagent_type
调用 Agent 时不提供 subagent_type，会创建一个 Fork——复制当前 Claude 以及完整对话上下文。Fork 共享提示词缓存，因此成本较低。如果受托工作需要知道你掌握的全部信息，就使用 Fork；如果任务专业性较强，而且干净的上下文更合适，就使用带类型的子智能体。
Hooks：让行为真正固定下来
如果你曾告诉 Claude“从现在开始，每次提交前都要运行 Linter”，却眼看它两条消息之后就忘记，那么你需要 Hook。
Hooks 位于 ~/.claude/settings.json（用户级）或 .claude/settings.json（项目级）。可用事件包括：
• UserPromptSubmit——发送消息时触发，可以注入上下文。
• PreToolUse / PostToolUse——在特定工具调用之前或之后触发，可以阻止操作或添加说明。
• SessionStart——会话开始时触发一次。
• Stop——Claude 完成回答时触发，适合发送通知。
示例：每次执行 Edit 或 Write 后运行 prettier --write。
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [{ "type": "command", "command": "prettier --write \"$CLAUDE_FILE\"" }]
}
]
}
}
执行这些命令的是运行框架，不是 Claude，因此不会被忘记。
规划模式
按 Shift+Tab 切换规划模式。在这种模式下，Claude 可以读取和分析，却无法编辑、写入或运行会产生副作用的工具。它最终会给出一份计划，等你批准后再退出。任何不希望 Claude 立即开始编写代码的工作，都适合使用这种模式。
Skills
Skills 是可复用、带命名空间的提示词包，通过 /<skill-name> 调用。下面几项值得了解：
• /init——编写一份描述仓库的 CLAUDE.md。
• /review 和 /security-review——见上文。
• /loop 和 /schedule——见上文。
• /simplify——检查已变更代码的冗余和质量问题，再进行修复。
• /fewer-permission-prompts——扫描会话记录，找出反复批准的只读命令，再把它们加入项目白名单。
• /update-config——安全地修改 settings.json（权限、环境变量、Hooks）。
自定义 Skills 是 ~/.claude/skills/<name>/ 中的 SKILL.md 文件。Frontmatter 声明触发条件，正文则是 Skill 触发时由运行框架加载的提示词。
如何为子智能体编写有效提示词
子智能体开始时对你的对话一无所知（除非它是 Fork）。应当像向刚刚加入工作的同事一样向它交代背景：
1、目标——用一句话说明预期结果。
2、背景——已经尝试或排除了什么，以及这件事为什么重要。
3、范围——哪些内容包含在内、哪些不包含，以及其他智能体负责什么。
4、交付物——准确说明希望它以什么格式返回。如果想要简洁回答，就明确写出来，例如“不超过 200 字”。
命令式的简短提示词只会带来浅薄的工作。该花的 Token 要花在上下文上。
案例：三个智能体并行工作
本文最初版本介绍了并行运行三个智能体——分别负责内容、品牌和代码。这个模式仍然有效，但到了 2026 年，更应该严格判断什么时候才值得并行：
• 并行处理彼此独立的工作。 三个智能体分别读取代码库的三个不同部分：可以。
• 不要并行处理相互依赖的工作。 “一个智能体编写 Schema，另一个编写依赖该 Schema 的迁移”：不行。第二个智能体开始时看到的内容会过时。
• 如果单个 Fork 更快，就不要并行。 如果任务主要是阅读，最后只需综合一次，一个 Fork 会胜过三个需要手动合并结果的智能体。
一个很实用的判断方法是：如果你很难写出三条互不引用的提示词，那么你面对的不是三项并行任务，而是一项顺序任务。
一套合理的默认工作流
1、加入仓库时运行一次 /init。
2、遇到任何复杂任务，先使用规划模式（Shift+Tab）。
3、把调研和探索交给子智能体（使用带 Explore 的 Agent 或 Fork）。
4、创建 PR 前运行 /review；如果涉及身份验证、输入处理或密钥，再运行 /security-review。
5、为那些每次会话都要提醒 Claude 的事项设置 Hooks。
6、在长会话中使用 /cost 和 /compact 控制成本。
资源
• Claude Code 文档——官方文档
• Skills——构建与使用 Skills
• Hooks——完整事件列表与示例
• MCP 协议——模型上下文协议规范
• Claude Code GitHub——Issue 与源代码
结论
投入越多，Claude Code 带来的回报就越大。第一个小时，你只是在与它聊天；第二个小时，你会开始配置 Hooks、编写自定义 Skills，并把子智能体串联起来。等到添加了一份 CLAUDE.md、三个 Hooks 和一项自定义 Skill，这个工具就不再像助手，而更像一套工作环境。
先从 /init 和一个 Hook 开始。剩下的能力，遇到摩擦时再逐步添加。
