Claude Code 使用细节详解

基础教程：Claude Code 基础使用教程
进阶教程：Claude Code 进阶使用教程
本文是前两篇的细节补充，涵盖文件引用、临时查看、长任务处理、Prompt 缓存、Brainstorms、Hooks 等实用技巧。

一、文件引用技巧

1.1 拖拽文件快速引用

任务：让 Claude 读取本地文件

操作步骤：

1. 打开文件资源管理器，找到目标文件
2. 把文件直接拖拽到 Claude Code 的聊天窗口
3. 松开鼠标，文件路径会自动填入输入框
4. 补充你的指令，按回车发送

示例：

[拖拽文件后自动出现路径] 读取这个文件的内容，帮我总结要点

支持的文件类型：

• 文本文件：.txt、.md、.json、.csv
• 代码文件：.py、.js、.ts、.java、.c
• 配置文件：.yaml、.xml、.env
• Office 文件：.docx、.xlsx、.pdf（需要相关 skill 支持）

优势：

• 无需手动输入路径，避免打字错误
• 支持绝对路径和相对路径
• 可以同时拖拽多个文件

1.2 @ 符号引用文件(前提是claude对话框是在被引用文件的文件夹下打开的)

任务：在项目目录下快速引用文件

操作步骤：

1. 在 Claude Code 聊天窗口输入 @
2. 输入文件名或路径的一部分
3. Claude 会自动补全匹配的文件
4. 选择目标文件，按回车确认
5. 继续输入你的指令

示例：

@src/main.py 帮我分析这个文件的代码逻辑

@docs/report.md 根据这个文档生成摘要

使用场景：

• 项目目录下的文件引用
• 需要引用多个文件时
• 文件路径较长时

优势：

• 自动补全，无需记忆完整路径
• 只显示当前项目目录下的文件
• 支持模糊匹配

1.3 批量引用文件

任务：同时引用多个文件进行分析

方法 1：多次拖拽

[拖拽文件1] [拖拽文件2] [拖拽文件3] 对比这三个文件的差异

方法 2：使用 @ 符号

@file1.txt @file2.txt @file3.txt 把这三个文件的内容合并

方法 3：使用通配符

读取当前目录下所有 .txt 文件，统计每个文件的字数

方法 4：指定目录

读取 D:\Documents 下所有 .pdf 文件，提取关键信息

---

二、/btw 临时查看

2.1 什么是 /btw

/btw 是 "by the way" 的缩写，用于在主任务执行过程中临时插入一个问题或查看某些信息，不会中断当前任务。

2.2 使用场景

场景 1：执行长任务时临时查看

> 帮我分析这个 Excel 文件的数据趋势
[正在分析中...]
> /btw 这个文件有多少行数据？
[临时查看，不影响分析任务]
> 继续分析
[继续执行原任务]

场景 2：确认信息

> 帮我写一份合同
[正在生成中...]
> /btw 我们的公司全称是什么？
[临时查看记忆中的公司信息]
> 继续写合同
[继续执行原任务]

场景 3：检查文件状态

> 帮我批量重命名文件
[正在处理中...]
> /btw 桌面上有哪些文件？
[临时查看桌面文件]
> 继续重命名
[继续执行原任务]

按下ESC键后退出临时对话(相当是孙悟空打架时候开了个分身可以告诉你战况)

2.3 /btw vs /compact

功能	/btw	/compact
用途	临时查看，不改变主任务	压缩对话历史，释放 token
对主任务的影响	无影响，继续执行	暂停当前任务，压缩后继续
适用场景	执行中临时插入问题	对话变长、响应变慢时
Token 消耗	会消耗少量 token	节省 token

2.4 最佳实践

• 短问题用 /btw：如果只是临时查看一个简单信息，用 /btw
• 长对话用 /compact：如果对话已经超过 20 轮，用 /compact 压缩历史
• 不要频繁使用 /btw：每次 /btw 都会消耗少量 token，频繁使用会影响效率

---

三、Plan Mode 长任务处理

3.1 什么是 Plan Mode

Plan Mode 是 Claude Code 的一种工作模式，用于处理复杂、多步骤的任务。在 Plan Mode 下，Claude 会：

1. 先分析任务，制定执行计划
2. 逐步执行计划
3. 每完成一步，检查进度
4. 遇到问题时自动调整计划

3.2 使用场景

场景 1：复杂文档处理

> 帮我整理这份 50 页的合同，提取所有风险点，并生成修改建议

场景 2：数据分析任务

> 分析 D:\Data 下所有 Excel 文件，按部门统计销售趋势，生成可视化报告

场景 3：代码重构

> 重构这个项目的数据库层，从 MySQL 切换到 PostgreSQL，确保所有测试通过

场景 4：批量操作

> 把 D:\Photos 下所有照片按日期分类，重命名，并压缩到不同文件夹

3.3 如何进入 Plan Mode

方法 1：直接输入指令

> 进入 Plan Mode处理我的任务

方法 2：描述复杂任务

> 帮我完成以下任务：
1. 读取所有 Excel 文件
2. 按部门分类
3. 计算每个部门的销售额
4. 生成图表
5. 输出报告

方法 3：按下shift+tab切换到plan mode

Claude 会自动识别这是一个复杂任务，进入 Plan Mode(建议手动让它进入)。

3.4 Plan Mode 的工作流程

1. 分析任务 → 制定计划
2. 执行第一步 → 检查结果
3. 执行第二步 → 检查结果
4. ... 逐步完成
5. 汇总结果 → 输出最终报告

3.5 退出 Plan Mode

> 退出 Plan Mode

或：

> 停止

3.6 Plan Mode 的优势

• 任务分解：自动将复杂任务拆分为多个小步骤
• 进度跟踪：每完成一步都会检查结果
• 错误处理：遇到问题时自动调整计划
• 资源优化：合理分配 token，避免一次性消耗过多

---

四、Prompt 缓存机制

4.1 什么是 Prompt 缓存

Prompt 缓存是 Claude Code 的一种优化机制，它会缓存你的对话历史和上下文，以便在后续对话中快速恢复，减少重复处理的时间和 token 消耗。

4.2 工作原理

第一次对话：
[用户输入] → [Claude 处理] → [输出结果] → [缓存对话历史]

后续对话：
[用户输入] → [加载缓存] → [Claude 处理] → [输出结果] → [更新缓存]

4.3 缓存的内容

• 对话历史（你和 Claude 的所有对话）
• 项目上下文（当前目录下的文件结构）
• 记忆信息（CLAUDE.md 中的内容）
• Skills 配置

4.4 如何利用缓存提高效率

场景 1：保持对话连续性

> 帮我分析 sales.xlsx 的数据
[分析完成]

> 再帮我按月份统计
[利用缓存，直接基于上一次分析继续]

场景 2：避免重复加载

> 读取 README.md
[读取完成]

> 这个项目是做什么的？
[利用缓存，直接基于 README 内容回答]

场景 3：快速切换任务

> 分析 Excel 数据
[分析完成]

> /btw 我的 CLAUDE.md 里写了什么？
[利用缓存，快速读取记忆信息]

4.5 缓存失效的情况

• 重启 Claude Code 后，缓存会清空
• 使用 /clear 清空对话后，缓存会重置
• 使用 /compact 压缩对话后，部分缓存会被清理
• 切换项目目录后，项目上下文缓存会更新

4.6 优化缓存的建议

• 保持对话连续性：尽量在一个对话中完成相关任务
• 避免频繁 /clear：除非真的需要重新开始
• 合理使用 /compact：在对话变长时使用，而不是每次都用
• 利用 /btw：临时查看信息时用 /btw，而不是中断当前任务

---

五、Brainstorms 使用(嘎嘎好用!好用到嘎嘎)

5.1 什么是 Brainstorms

Brainstorms 是 Claude Code 的内置 skill，用于头脑风暴。它可以帮助你：

• 生成创意想法
• 探索多种可能性
• 分析问题的不同角度
• 制定策略和方案

5.2 使用场景

场景 1：产品命名

> /brainstorms 帮我想几个产品名称，要求：简洁、易记、有科技感

场景 2：营销策略

> /brainstorms 我们要推广一款新手机，目标用户是年轻人，请想几个营销方案

场景 3：问题解决

> /brainstorms 我们的客户流失率很高，请分析可能的原因并提出解决方案

场景 4：创意写作

> /brainstorms 帮我想几个小说开头，要求：悬念、吸引人

5.3 调用方式

方法 1：直接调用

> /brainstorms 你的问题或需求

方法 2：结合上下文

> 读取 market_data.xlsx 的数据
> /brainstorms 根据这些数据，分析市场趋势并提出建议

方法 3：多轮对话

> /brainstorms 帮我想几个创业点子
[生成多个点子]
> /brainstorms 对第一个点子进行深入分析
[深入分析第一个点子]
> /brainstorms 制定这个点子的实施计划
[制定实施计划]

5.4 Brainstorms 的优势

• 多角度思考：从不同角度分析问题
• 创意激发：生成你可能没想到的想法
• 结构化输出：按分类或优先级组织结果
• 可操作性：提供具体的实施建议

5.5 使用技巧

• 明确需求：告诉 Claude 你需要什么类型的创意
• 设定约束：如字数限制、风格要求、目标用户等
• 迭代优化：对结果不满意时，让 Claude 进一步优化
• 结合数据：如果有数据支持，让 Claude 基于数据分析

---

六、Hooks 进阶使用(稍微有些难度,需要配置settings.json文件,可以直接拖拽settings.json到对话窗口让它调用skills帮你配置)

6.1 什么是 Hooks

Hooks 是 Claude Code 的一种自动化机制，允许你在特定事件发生时自动执行某些操作。类似"触发器"，当某个条件满足时，自动运行预定义的任务。

6.2 Hooks 的工作原理

事件发生 → 触发 Hook → 执行预定义任务 → 返回结果

示例：

当你输入 /compact 时 → 自动保存当前对话 → 压缩历史
当你启动 Claude Code 时 → 自动加载 CLAUDE.md → 应用记忆

6.3 使用场景

场景 1：自动保存对话

每次对话结束时，自动保存对话内容到桌面

场景 2：定时提醒

每小时提醒你休息一下，或者检查任务进度

场景 3：自动备份

每次修改 CLAUDE.md 时，自动备份到安全位置

场景 4：任务触发

当你输入"日报"时，自动生成日报模板

6.4 配置 Hooks

配置文件位置： C:\Users\你的用户名\.claude\hooks.json

基本格式：

{
  "hooks": [
    {
      "event": "事件类型",
      "action": "执行的操作",
      "condition": "触发条件（可选）"
    }
  ]
}

6.5 事件类型

事件类型	说明	示例
on-start	启动 Claude Code 时	加载配置、显示欢迎信息
on-exit	退出 Claude Code 时	保存对话、清理临时文件
on-command	执行特定命令时	自动保存、提醒
on-idle	空闲时	定时提醒、自动备份
on-error	发生错误时	记录日志、发送通知

6.6 详细配置示例

示例 1：自动保存对话

{
  "hooks": [
    {
      "event": "on-exit",
      "action": "save-conversation",
      "options": {
        "path": "D:\\Logs\\claude-conversations",
        "format": "markdown"
      }
    }
  ]
}

示例 2：定时提醒

{
  "hooks": [
    {
      "event": "on-idle",
      "action": "reminder",
      "options": {
        "interval": 3600,
        "message": "你已经工作了1小时，建议休息5分钟"
      }
    }
  ]
}

示例 3：自动备份 CLAUDE.md

{
  "hooks": [
    {
      "event": "on-command",
      "action": "backup",
      "options": {
        "source": "CLAUDE.md",
        "destination": "D:\\Backup\\claude-config"
      }
    }
  ]
}

示例 4：任务触发

{
  "hooks": [
    {
      "event": "on-command",
      "action": "template",
      "options": {
        "trigger": "日报",
        "template": "daily-report-template.md"
      }
    }
  ]
}

6.7 Hooks 的进阶用法

1. 条件触发

{
  "hooks": [
    {
      "event": "on-command",
      "action": "save-conversation",
      "condition": "conversation.length > 10",
      "options": {
        "path": "D:\\Logs\\long-conversations"
      }
    }
  ]
}

2. 多步骤 Hook

{
  "hooks": [
    {
      "event": "on-exit",
      "action": "chain",
      "steps": [
        {"action": "save-conversation"},
        {"action": "cleanup-temp-files"},
        {"action": "send-notification"}
      ]
    }
  ]
}

3. 自定义脚本

{
  "hooks": [
    {
      "event": "on-command",
      "action": "script",
      "options": {
        "path": "C:\\Users\\你的用户名\\.claude\\scripts\\custom-hook.py"
      }
    }
  ]
}

6.8 Hooks 的最佳实践

• 简洁原则：每个 Hook 只做一件事，避免过于复杂
• 错误处理：确保 Hook 执行失败时不会影响主任务
• 性能考虑：避免在 Hook 中执行耗时操作
• 日志记录：记录 Hook 的执行情况，便于排查问题
• 定期维护：定期检查和更新 Hook 配置

6.9 调试 Hooks

查看 Hook 日志：

> 查看 hooks 日志

测试 Hook：

> 测试 on-exit hook

禁用 Hook：

{
  "hooks": [
    {
      "event": "on-exit",
      "action": "save-conversation",
      "enabled": false
    }
  ]
}

---

七、总结

7.1 核心技巧回顾

技巧	用途	使用频率
拖拽文件	快速引用本地文件	高
@ 符号	项目目录下快速引用	高
/btw	临时查看，不中断任务	中
Plan Mode	处理复杂、多步骤任务	中
Prompt 缓存	提高效率，减少重复处理	自动
Brainstorms	头脑风暴，生成创意	中
Hooks	自动化任务，提高效率	低

7.2 使用建议

1. 先掌握基础：熟练使用拖拽和 @ 引用文件
2. 善用 /btw：执行长任务时用 /btw 临时查看
3. 复杂任务用 Plan Mode：多步骤任务不要硬扛
4. 利用缓存：保持对话连续性，避免频繁 /clear
5. 创意任务用 Brainstorms：需要创意时调用头脑风暴
6. 进阶用 Hooks：需要自动化时配置 Hooks

7.3 进阶学习路径

基础使用 → 文件引用 → /btw → Plan Mode → Prompt 缓存 → Brainstorms → Hooks

---

更多内容请访问官方文档: https://docs.anthropic.com/claude-code

最后更新：2026年6月5日CC BY-NC-SA 4.0