一、会话控制三剑客：/clear、/compact、/exit

这三个命令构成了会话生命周期管理的基础，分别对应“重置”“保养”“结束”三个关键节点。

/clear —— 一键重启，彻底重置

作用：清空当前会话的全部对话历史，将上下文重置为初始状态，就像刚执行 claude-code 一样。

为什么需要它：

• 任务隔离：你刚完成一个复杂的数据分析任务，现在要做完全无关的前端组件开发。如果不清空，Claude 可能会“污染”地引用之前的 Python 代码来回答你的 React 问题。

• 修正跑偏：当对话经过几十轮后，模型可能因为长上下文中某些早期信息而产生固化的错误理解。用指令纠正往往不如 /clear 干净。

• 释放空间：虽不直接释放 token（因为上下文窗口机制的关系），但从逻辑上彻底清空了信息负重。

注意事项：

• 该操作不可逆，清除后无法恢复。

• 最佳实践：清空前先 /save 导出有价值的内容。

• 你也可以用自然语言说“忘记之前的所有内容，重新开始”，效果等同，但 /clear 更确定。

/compact —— 长会话的记忆压缩器

作用：对当前会话的历史进行智能压缩，将冗长对话提炼为关键摘要，从而释放被大量历史消息占用的 token 空间。

为什么它重要：
Claude 的上下文窗口有上限。当你连续对话数百轮，早期信息会逐渐被挤出窗口，导致模型“遗忘”你最初设定的角色、约束或关键决策。/compact 的作用就是把“完整历史”变成“精炼摘要”，在保留核心脉络的同时腾出空间。

实战场景：

• 你花了 60 轮调试一个分布式事务问题，前半段探索了多种失败路径。现在已锁定根因，需要继续深度分析。运行 /compact，Claude 会把历史压缩为“用户正在调试订单服务的分布式事务问题，已排除网络分区和锁超时，当前锁定在两阶段提交的协调者日志异常……”。

• 压缩后，后续对话基于这份摘要继续，token 消耗显著下降。

使用技巧：

• 执行前后各查一次 /cost，直观感受节省幅度。

• 不必频繁压缩，一般当感觉响应变慢或模型开始“犯糊涂”时执行一次即可。

• 压缩后摘要可能会丢失某些细节，重要信息建议在压缩前手动确认或记录。

/exit（或 /quit）—— 优雅退场

作用：关闭当前交互会话，返回终端 Shell。

与 Ctrl+D 或 Ctrl+C 的区别：功能基本一致，但 /exit 更语义化，适合脚本化操作或养成明确的结束习惯。

退场前建议的检查清单：

• /cost 确认本次会话消耗。

• /state 确认无未完成任务。

• /save 导出需要保留的对话。

• 然后 /exit。

---

二、信息查看五件套：/help、/cost、/status、/state、/workspace

这类命令不改变任何状态，只是让你“看见”当前会话的运行全景。它们是做决策前的信息基础。

/help —— 随身命令字典

最简单却最容易被忽略。输入 /help 即可获得当前版本支持的全部命令列表。当你记不清某个命令的准确写法，或想探索是否有新命令时，这是第一站。

技巧：版本更新后，先跑一次 /help 看看有没有新增能力。

/cost —— 你的 AI 账单仪表盘

作用：显示当前会话已消耗的 token 数量（区分 prompt token 和 completion token）及预估 API 费用。

示例输出：

Tokens: 45,230 (prompt: 32,000, completion: 13,230)
Estimated cost: $0.27

核心使用场景：

• 预算监控：个人开发者防止收到意外高额账单的最后一道防线。每半小时查一次，心里有数。

• 评估压缩效果：/compact 前后对比，看节省了多少。

• 单任务成本核算：任务开始前记下数字，结束后再查，得出精确的单次 AI 成本，有助于项目定价。

/status —— 环境与版本快照

作用：显示 Claude Code 的版本号、当前模型、连接状态、会话 ID 等信息。

与 /state 的区别：/status 偏向“工具本身的状态”，/state 偏向“当前任务内容的状态”。

场景：向同事报告“我用的是 Claude Code v1.2.3 + Sonnet 模型”时，直接贴 /status 输出。遇到连接错误时也是第一诊断依据。

/state —— 任务进行中的动态快照

作用：展示此刻正在做什么——当前激活的计划、任务进度、已加载文件、最近执行的动作。

典型输出：

Session State:
  Model: claude-sonnet
  Active plan: Refactor payment module (step 3/5)
  Pending tasks: 2
  Files loaded: src/payment/*, src/models/order.js
  Last action: Run npm test (passed)
  Token usage: 34,200 / 200,000

不可替代的场景：

• 中断续接：被会议打断半小时，回来后 /state 直接告诉你刚才在哪儿、下一步是什么。

• 团队交接：把 /state 输出贴给同事，对方秒懂你的 AI 协作进度。

• 异常诊断：当 Claude 回答变得怪异时，先看 /state 是否有不该存在的文件或卡住的任务。

/workspace —— 审计 AI 的视野

作用：列出当前会话已加载的所有文件和目录。

为什么必需：
Claude 的回答完全基于它的“所见”。当你发现它开始引用不该引用的文件，或忽略了你认为它应该看到的文件时，/workspace 能立刻帮你找出原因。它是对 /add 和 /drop 操作的必要审计。

---

三、上下文管理四件套：/add、/drop、/init、/config

这类命令让你在会话中动态控制 Claude 的“视野范围”，是精细化上下文工程的核心工具。

/add <路径> —— 动态扩展视野

作用：在不重启会话的情况下，将新的文件或目录加载到当前上下文中。

支持的形式：

• /add src/services/auth.js（单文件）

• /add src/api/（整个目录）

• /add src/**/*.test.js（glob 模式，按版本支持）

核心策略：
启动时只加载核心模块，保持上下文精简。当问题延伸到新模块时，用 /add 按需引入。这比一开始就塞入整个仓库高效得多。

/drop <路径> —— 精准排除干扰

作用：从当前会话的上下文中移除某个已加载的文件或目录。

场景：

• Claude 开始频繁引用旧版代码，而你已不再需要它关注那里。

• 某测试文件干扰了生产代码的分析。

• 加载了过多文件后发现模型响应质量下降，需要收缩范围。

与 /clear 的分工：/drop 是精准手术，/clear 是全身重置。

/init —— 项目级配置向导

作用：在当前项目根目录生成或更新 .claude/settings.json，以交互问答方式设定默认模型、忽略路径、系统级自定义指令等。

为什么重要：
这是“一次配置，长期受益”的命令。执行后，每次在该项目下启动 Claude Code，它都会自动套用这些预设，无需重复指定。

团队协作建议：
将 .claude/ 目录（去除敏感信息）提交到版本控制，全团队共享统一的 AI 行为基线。

/config —— 会话内的热调面板

作用：在对话中途动态调整 Claude Code 的行为参数，无需退出或重启。

常用操作：

• /config model opus —— 切换模型。

• /config temperature 0.2 —— 让输出更确定、更严谨。

• /config ignore node_modules,dist —— 临时排除某些路径。

• /config system "你是资深安全审计师" —— 动态修改系统提示词（部分版本支持）。

• /config show —— 查看当前全部配置。

场景：
你发现 Claude 的回答过于“发散”，立刻 /config temperature 0.2 收紧。或者即将处理敏感代码，临时 ignore 无关目录以提升安全性。

---

四、任务与规划双核心：/task、/plan

这两个命令是 Claude Code 从“对话工具”升维为“项目管理代理”的关键，让 AI 能处理复杂、多步骤的工程任务。

/task —— 子任务拆解与追踪系统

作用：在大型目标中创建、管理、追踪多个子任务，让 Claude 逐项执行并汇报进度。

完整子命令集：

写法	效果
/task add "为 auth 模块写单元测试"	创建新任务
/task list	列出所有任务及状态（todo / in_progress / done）
/task start 1	开始执行第 1 号任务
/task done 1	标记第 1 号任务为完成
/task remove 2	删除某任务
/task clear	清空全部任务

实战流：
“重构支付模块”这种大需求，先让 Claude 拆解为 8 个子任务。然后 /task add 逐条录入，再命令它“按顺序执行任务列表”。每完成一项它会自动标记 done 并汇报。你随时 /task list 就能看到进度条式的完成情况。

核心价值：

• 防止长对话中迷失方向。

• 可中途插入紧急任务而不打乱原有计划。

• 进度可量化、可审计。

/plan —— 行动前的安全审查网

作用：要求 Claude 在动手修改任何代码或执行命令之前，先生成一份详细的执行计划，并停留在计划阶段等待你的确认。在你批准前，它不会执行任何实际操作。

典型交互：

1. 你输入：/plan 重构 user.js 中的密码哈希逻辑

2. Claude 输出详细的步骤清单（分析现有逻辑→生成迁移代码→单元测试方案→兼容性检查……），但不执行。

3. 你审查后可以说：“批准，开始执行”或“修改第 3 步，保持旧哈希模块独立”。

为什么这是必需的安全网：

• 高风险操作：数据库迁移、批量重命名、配置变更，先在计划里推演一遍。

• 团队对齐：将计划复制给技术负责人确认后再执行，避免 AI 误解需求。

• 学习价值：即使不执行，计划本身就是一份高质量的技术方案参考。

---

五、模型与账户管理：/model、/login、/logout

/model —— 动态升降级大脑

作用：查看当前模型或切换模型。

写法：

• /model → 显示当前使用的模型。

• /model opus → 切换到 Claude Opus（深度推理）。

• /model sonnet → 切回 Sonnet（快速轻量）。

分级使用策略：
先用 Sonnet 做代码生成、草稿、日常问答，遇到复杂推理时执行 /model opus，解决问题后切回。在同一条会话中无缝升降级，无需重开窗口。

/login 与 /logout —— 账户凭证管理

场景：

• 在共享或临时机器上用完 Claude Code 后，执行 /logout 清除本地凭证。

• 切换 Anthropic 账户时，先登出再登入。

---

六、存档与诊断：/save、/doctor

/save <文件名> —— 对话的永久存档

作用：将当前完整会话记录导出为文件（通常为 Markdown 格式）。

核心场景：

• 知识沉淀：解决复杂 Bug 后，/save fix-xxx.md，自动形成技术文档。

• 团队分享：终端版没有一键分享链接，/save 后用任何方式发送给同事。

• 合规审计：需要记录 AI 辅助过程时，定期存档作为过程证据。

• 个人笔记：将高质量对话存入 Obsidian 或 Notion，构建私人 AI 知识库。

注意：/save 只保存 Claude Code 对话本身，不包含你执行的 Shell 命令的实际终端输出。如需完整记录，配合 script 命令使用。

/doctor —— 环境健康检查

作用：自动诊断 Claude Code 的运行环境，检查 Node.js 版本、网络连通性、API Key 有效性、配置文件语法，并给出修复建议。

场景：

• 初次安装后验证一切正常。

• 遇到莫名错误时优先运行 /doctor，可能直接定位问题，避免盲目排查。

---

七、综合实战：一个完整的复杂任务流

以下展示如何将这些命令串联成一个真实的、有节奏的工作流。

背景：你需要将旧支付模块迁移到新版本，涉及多个文件和数据库交互。

第一步：启动与初始化

claude-code --add-dir src/payment

进入后立即 /init，设定项目级默认模型为 Sonnet，忽略 node_modules。

第二步：制定蓝图

/plan 将 src/payment 下的旧支付模块迁移到 v2 API，保持向后兼容

Claude 生成 5 步计划。你审查后批准。

第三步：任务拆解

/task add "分析旧模块的接口定义"
/task add "编写 v2 适配层"
/task add "迁移单元测试"
/task add "集成测试验证"
/task add "生成迁移文档"

第四步：有序执行

/task start 1

执行过程中随时：

• /state 看进度。

• /cost 控预算。

• /workspace 审上下文。

第五步：途中调优

对话已超 80 轮，发现模型开始忘记最初的角色设定 → /compact。压缩后，需要深度分析一个并发安全问题 → /model opus。解决后 → /model sonnet 切回。

第六步：收尾归档

全部任务 done → /save payment-migration.md → /cost 确认总花费 → /exit。

---

八、核心心法

这些命令的背后，是一个统一的设计思想：让 AI 代理变得可预测、可审计、可控制。

• 自然语言负责表达“要什么”。

• 斜杠命令负责管理“怎么做的过程”——上下文、任务、计划、成本、状态。

你不需要死记硬背所有命令。日常操作中，大部分需求可以直接用自然语言表达（“把对话存起来”“看看刚才花了多少 token”），Claude Code 通常能自动理解并触发对应行为。但当需要精确、确定、无歧义的控制时（如压缩历史、切换模型、生成计划），这些斜杠命令就是你的精确手术刀。

把它们内化到肌肉记忆里，你的终端窗口就不再是一个聊天框，而是一个真正意义上的 AI 工程控制台。