📋 阶段三：Claude Code CLI 核心斜杠命令全解

日常高频必备 | 逐条讲解用途、语法、最佳场景、使用禁忌

📑 本章目录
  1. 会话管理命令：/clear、/continue、/reset、/compact
  2. 文件与代码操作：/edit、/read、/write、/add-dir
  3. 工具调用与权限：/permissions、/tools、安全管控
  4. 辅助命令：/help、/status、/history、/undo、/cost
  5. Git 联动：/commit、代码变更分析、版本管理
  6. 配置与个性化：/config、/model、/theme
  7. 斜杠命令速查表
  8. 课后练习

3.1 会话管理命令

/clear — 清空上下文

用途：清空当前会话的对话历史（上下文），但保留项目结构记忆。

语法：/clear

最佳场景：

# 在交互模式中输入：
/clear

# 效果：
# 1. 对话历史被清空
# 2. Claude 重新加载项目文件结构
# 3. 上下文窗口恢复到初始状态
# 4. 之前的代码修改不会丢失（已写入文件）
⚠️ 注意：/clear 会丢失当前对话中的临时上下文（如未保存的讨论结论），但已写入磁盘的代码不会丢失。

/compact — 压缩上下文

用途：压缩当前会话上下文，将历史对话总结后释放空间。与 /clear 不同，/compact 会保留关键信息。

语法：/compact

最佳场景：

# 当上下文接近上限时，Claude 会提示
# 你也可以主动执行：
/compact

# 效果：
# 1. 对话历史被总结压缩
# 2. 关键决策和代码修改被保留
# 3. 释放约 60-80% 上下文空间

/continue — 续写

用途：让 Claude 继续上次被截断的输出。

语法：/continue

最佳场景：

# 当 Claude 输出被截断时，直接输入：
/continue

# 或简写：
/c

/reset — 重置会话

用途：完全重置当前会话，相当于退出后重新进入（但不用退出再进入）。

语法：/reset

# 完全重置会话
/reset

# 效果同：
# /exit → claude

3.2 文件与代码操作命令

/read — 读取文件

用途：让 Claude 读取指定文件内容。

语法：/read <文件路径>

# 读取单个文件
/read src/app.js

# 读取多个文件
/read src/app.js src/utils.js

# 读取通配符匹配的文件
/read src/**/*.js

# 读取并显示行号
/read src/app.js --lines 1-50
💡 技巧：在长对话中，如果 Claude 似乎"忘记"了某个文件内容，用 /read 主动让它重新读取，比描述"那个文件里有个函数叫xxx"更高效。

/edit — 编辑文件

用途：让 Claude 精确编辑文件中的指定内容。

语法：/edit <文件路径>，然后描述修改内容

# 方法一：直接描述修改
/edit src/app.js
# 然后在对话中描述：把第15行的 console.log 改成 logger.info

# 方法二：在对话中直接提修改需求
# "修改 src/config.js，把端口从 3000 改成 8080"
# Claude 会自动调用 Edit 工具

/write — 写入（创建/覆盖）文件

用途：让 Claude 创建新文件或覆盖已有文件。

语法：/write <文件路径>

# 创建新文件
/write src/new-component.js

# 然后在对话中描述文件内容
# 或直接给 Claude 指令："创建一个 React 组件的骨架"

# Claude 会调用 Write 工具，创建文件
🔴 注意：/write 会覆盖已有文件！操作前确认文件是否需要备份。

/add-dir — 添加目录到工作区

用途：将指定目录添加到 Claude 的工作区上下文。

语法：/add-dir <目录路径>

# 添加目录到上下文
/add-dir src/components

# 添加多个目录
/add-dir src/ tests/

# 这样 Claude 会读取该目录下的文件结构

3.3 工具调用与权限管控

工具调用开关原理

Claude Code CLI 有一组内置工具（Bash、Read、Write、Edit、WebSearch、WebFetch 等），每次使用这些工具时，CLI 会根据权限配置决定是否向用户请求授权。

权限模式：

/permissions — 权限管理

# 查看当前权限状态
/permissions

# 在交互模式中，当 Claude 请求权限时，你会看到类似：
# ┌──────────────────────────────────────────┐
# │  Allow Bash command?                     │
# │  npm test                                │
# │  [a] Allow once  [A] Always allow        │
# │  [n] Deny once   [N] Always deny         │
# └──────────────────────────────────────────┘
# 选择：
# a  - 仅本次允许
# A  - 始终允许（写入 settings.json）
# n  - 仅本次拒绝
# N  - 始终拒绝

配置工具权限（settings.json）

# === 推荐权限配置（安全且实用） ===
cat > ~/.claude/settings.json << 'EOF'
{
  "permissions": {
    "allow": [
      "Bash(git:status,git:diff,git:log,git:add,git:commit)",
      "Bash(npm:test,npm:run,npm:install,node:*)",
      "Bash(ls:*,cat:*,find:*,grep:*,wc:*)",
      "Bash(mkdir:*,cp:*,mv:*)",
      "Read(**)"
    ],
    "deny": [
      "Bash(rm:-rf:*,sudo:*,chmod:777:*)",
      "Bash(curl:*|bash, wget:*|bash)",
      "Bash(>: /dev/sda, dd:*)"
    ]
  }
}
EOF
⚠️ 权限最小化原则

3.4 辅助命令

/help — 帮助

# 查看所有可用斜杠命令
/help

# 查看特定命令帮助
/help commit

# 查看配置帮助
/help config

/status — 查看当前状态

# 查看当前会话状态
/status

# 显示信息包括：
# - 当前模型
# - 项目目录
# - 上下文使用量
# - 会话持续时间
# - 权限配置摘要

/cost — 查看 Token 消耗

# 查看当前会话的 token 消耗
/cost

# 输出示例：
# Tokens used: 45,230 / 200,000 (22.6%)
# Input: 38,100 | Output: 7,130
# Estimated cost: $0.34

/history — 会话历史

# 查看近期会话历史
/history

# 查看完整历史
/history --all

# 搜索特定会话
/history --search "React component"

/undo — 回退修改

# 回退最近一次文件修改
/undo

# 回退指定次数的修改
/undo 3

# 注意：
# - /undo 只能回退 Claude 在当前会话中做的修改
# - 不覆盖 git，/undo 回退的是 Claude 工具调用产生的更改
# - 对于重大修改，建议用 git 管理版本

/checkpoint — 快照管理

# 创建当前状态的快照
/checkpoint

# 查看所有快照
/checkpoint --list

# 恢复到指定快照
/checkpoint --restore <snapshot-id>
💡 最佳实践：在让 Claude 做大规模重构前，先用 /checkpoint 创建快照。如果结果不理想，可以快速恢复。

3.5 Git 联动命令

/commit — 自动生成提交信息并提交

# === 自动分析变更并生成 commit message ===
/commit

# Claude 会：
# 1. 运行 git diff 分析变更
# 2. 生成规范的 commit message
# 3. 展示 message 供你确认
# 4. 确认后执行 git add + git commit

# === 仅生成 commit message（不提交） ===
# 在对话中说：
# "分析我的 git diff，生成一个 commit message"

# 或用管道命令：
git diff --staged | claude -p "生成一条规范的 commit message"

Git 工作流示例

# === Claude Code CLI 中的 Git 操作流程 ===

# 1. 查看当前状态
git status
# 或让 Claude 帮你查看：输入 "查看 git 状态"

# 2. 让 Claude 分析 diff
# "分析 git diff，总结主要改动"

# 3. 生成 commit message
# "基于这些改动，生成一条 conventional commit 格式的提交信息"

# 4. 执行提交（需要授权 Bash 权限）
# "帮我提交这些改动" 或 /commit

Git 权限推荐配置

"Bash(git:status,git:diff,git:log,git:add,git:commit,git:branch,git:checkout)"

注意不要允许 git push --force、git reset --hard 等危险操作。

3.6 配置与个性化命令

/config — 配置管理

# 查看当前配置
/config

# 修改配置项
/config set theme dark
/config set model claude-sonnet-4-6

# 查看特定配置
/config get model

/model — 切换模型

# 查看当前模型
/model

# 切换模型
/model opus    # 切换到 Opus（最强）
/model sonnet  # 切换到 Sonnet（默认）
/model haiku   # 切换到 Haiku（最快）

/theme — 主题设置

# 设置主题
/theme dark    # 暗色主题
/theme light   # 亮色主题

3.7 斜杠命令速查表

命令简写功能使用频率
/help-查看帮助信息⭐
/clear-清空对话上下文⭐⭐⭐⭐
/compact-压缩上下文，保留关键信息⭐⭐⭐
/continue/c续写被截断的输出⭐⭐
/reset-完全重置当前会话⭐⭐
/exit-退出 Claude Code CLI⭐⭐⭐⭐
/read-读取指定文件⭐⭐⭐
/edit-编辑指定文件⭐⭐⭐⭐
/write-创建/覆盖文件⭐⭐⭐⭐
/add-dir-添加目录到上下文⭐⭐
/permissions-查看/管理权限⭐⭐
/status-查看当前会话状态⭐⭐
/cost-查看 token 消耗⭐⭐⭐
/history-查看会话历史⭐
/undo-撤销最近修改⭐⭐⭐
/checkpoint-创建/恢复快照⭐⭐
/commit-自动生成 commit 并提交⭐⭐⭐⭐
/config-查看/修改配置⭐⭐
/model-切换 AI 模型⭐⭐
/theme-切换主题⭐
/upgrade-升级 CLI 版本⭐
/doctor-环境诊断⭐

3.8 课后练习

  1. 会话管理练习：启动 Claude，进行 10 轮对话，然后用 /clear 清空，观察 Claude 是否"失忆"
  2. 上下文压缩：进行 20+ 轮对话后，使用 /compact，观察上下文使用量的变化
  3. 文件操作练习：创建测试项目，练习 /read、/edit、/write 三个命令
  4. 权限配置：编辑 settings.json，设置不同级别的权限，测试权限提示的变化
  5. Git 联动：修改代码后使用 /commit，对比 Claude 生成的 message 与你手写的差异
  6. 快照恢复：创建快照 → 修改多个文件 → 恢复到快照，验证恢复效果
  7. 模型切换：用 /model 切换不同模型，对比同一问题的回答质量
  8. 命令速查：不看文档，默写出至少 10 个斜杠命令及其用途