Claude Code 精华使用手册

适用版本：v0.3.0+ | 覆盖 VS Code 插件 + 终端版 | 2026 年 5 月最新

本手册只保留能直接提升开发效率 3-10 倍的核心操作，剔除所有无关功能。重点解决你最关心的：高缓存命中率、精准上下文控制、多任务并行、代码一致性四大痛点。

---

一、入门篇：5 分钟完成最优配置

1.1 安装与环境准备（必做）

1. VS Code 插件安装：搜索「Claude Dev」官方插件（认准 Anthropic 出品）

2. 终端版安装（推荐，功能更全）：

   # Windows PowerShell
   winget install Anthropic.Claude
   
   # macOS/Linux
   curl -sSL https://install.claude.com | sh

3. 添加环境变量：安装完成后重启终端，输入claude --version验证

4. 登录：输入claude login，浏览器打开授权页面完成登录

1.2 全局自定义指令（一次配置，终身受益）

这是提升代码生成准确率 60% 以上的关键，在插件设置中找到「Custom Instructions」，粘贴以下内容：

你是资深全栈工程师，严格遵守以下规则：
1. 代码风格：使用ES6+语法，TypeScript优先，函数式编程
2. 输出规范：先给核心思路，再给完整可运行代码，最后加关键注释
3. 错误处理：所有异步函数必须加try/catch，所有输入必须做验证
4. 命名规范：驼峰命名法，变量名见名知意，避免缩写
5. 不要解释基础语法，只讲关键逻辑和注意事项

1.3 基础操作（3 个核心动作）

操作	用法	场景
直接提问	输入自然语言指令	简单代码生成、问题解答
选中代码提问	选中代码后按Cmd+L(Mac)/Ctrl+L(Win)	代码解释、Bug 修复、优化
内联编辑	光标定位后按Cmd+I(Mac)/Ctrl+I(Win)	插入代码、修改代码

---

二、核心篇：掌握这 3 个功能，效率提升 5 倍

2.1 @引用系统：Claude Code 的 “眼睛”（必精通）

核心规则：用@精准引用上下文，永远不要复制粘贴代码。Claude 会自动读取引用内容，且不会污染缓存前缀。

完整引用语法

@文件路径          # 引用整个文件
@文件路径:函数名    # 引用文件中的某个函数
@文件路径:行号     # 引用文件中的某一行
@目录/             # 引用目录结构（不会读取所有文件）
@git:提交哈希      # 引用某个Git提交的代码
@terminal:输出     # 引用终端最近的输出

高频实战示例

# 修复指定文件的Bug
@src/components/PlanCard.vue 第45行的点击事件没反应，帮我修复

# 基于现有函数扩展功能
@src/utils/auth.js 中的verifyToken函数，添加过期时间验证

# 对比两个文件的差异
@old/Login.vue @new/Login.vue 对比这两个文件的修改内容，说明优缺点

# 引用终端报错
@terminal: 帮我分析这个报错的原因并给出修复方案

高级技巧

• 输入@后按Tab键自动补全文件路径，避免手动输入错误

• 多个文件用空格分隔：@a.js @b.js @c.js

• 常用文件写入CLAUDE.md，自动加入所有会话上下文

2.2 斜杠命令：一键调用内置能力

只记这8 个最常用的命令，其他可以用/help随时查看：

命令	功能	最佳使用场景
/help	显示所有可用命令	忘记命令时
/clear	清空当前会话上下文	切换任务时必用，避免上下文污染
/compact	压缩上下文（保留核心信息）	对话超过 5 轮，模型开始 “变笨” 时
/context	查看当前 Token 消耗分布	排查模型忽略约束的原因
/stats	查看个人使用统计	优化 Token 消耗和使用习惯
/model	切换模型	日常用 Sonnet，复杂任务用 Opus
/btw	并行提问	主任务运行时，临时问不相关问题
/bg	将任务移入后台	运行耗时任务（如重构、测试）时

2.3 快捷键：手指不离开键盘

必背快捷键（终端 + VS Code 通用）：

快捷键	功能
Ctrl+C	紧急中断当前任务（Claude 跑偏时）
Esc	停止当前操作（保留上下文）
Esc+Esc	打开检查点菜单（多文件操作失误的救命键）
Ctrl+G	打开外部编辑器编辑长提示词
Tab	自动补全命令、文件路径、代码建议
Ctrl+R	搜索历史命令
Ctrl+L	清屏

---

三、进阶篇：高手都在用的效率技巧

3.1 92% 缓存命中率终极方案（成本降低 90%）

Claude Code 的缓存是前缀完全匹配机制，只要前缀有一个字符不同，缓存就会全部失效。缓存命中的部分只收 10% 的费用，且响应速度提升 10 倍以上。

核心原则

不变的内容放最前面，可变的内容放最后面

标准高命中提示词结构

【固定前缀：永远一字不动，包括空格、标点、换行】
你是资深全栈工程师，基于我的小程序项目进行开发，严格遵守以下规则：
1. 保留原有全部功能不删减
2. 界面风格统一使用Tailwind CSS
3. 所有数据持久化到本地存储
4. 代码添加必要的注释

【项目级固定指令：写入CLAUDE.md，自动加入上下文】
@src/utils/helpers.ts - 通用工具函数
@src/types/index.ts - 类型定义
@tailwind.config.js - 样式配置

【可变内容：每次只修改这部分】
本次任务：帮我实现计划板块的删除功能，要求：
1. 每条计划右侧添加删除按钮
2. 点击删除弹出二次确认弹窗
3. 确认后从本地存储中删除数据

缓存失效的 5 个常见陷阱

1. ❌ 在固定前缀中加入动态内容（如时间、日期）

2. ❌ 调整固定前缀的顺序、增减空格、修改标点

3. ❌ 中途切换模型

4. ❌ 修改CLAUDE.md文件（会导致所有缓存失效）

5. ❌ 对话间隔超过 5 分钟（缓存超时）

3.2 上下文管理：避免模型 “变笨”

随着对话深入，上下文窗口会被填满，导致模型忽略之前的约束，甚至产生幻觉。

上下文优化技巧

1. 一个任务一个会话：切换功能时必须用/clear清空上下文，或新开一个会话

2. 定期压缩上下文：每 5 轮对话执行一次/compact

3. 精准引用：只引用需要的文件，不要引用整个项目

4. 查看上下文占用：用/context命令查看 Token 分布，卸载不必要的文件和工具

上下文溢出处理

当模型开始胡言乱语时，按以下步骤处理：

1. 执行/compact压缩上下文

2. 如果无效，执行/clear清空上下文

3. 重新发送固定前缀 + 当前任务

3.3 多任务并行：同时处理多个任务

Claude Code 支持同时运行多个后台任务，不用等一个任务完成再开始下一个。

多任务操作流程

1. 启动第一个任务：帮我重构用户登录模块

2. 按Ctrl+B将任务移入后台

3. 启动第二个任务：帮我生成README.md文档

4. 查看所有任务：按←左方向键打开 Agent View

5. 进入某个任务：选中任务按Enter

6. 返回总览：按←左方向键

Agent View 快捷键

快捷键	功能
Space	预览任务详情
Enter	进入任务对话
←	返回总览
Delete	删除任务

---

四、精通篇：打造专属开发助手

4.1 项目级指令 CLAUDE.md（团队协作必备）

在项目根目录创建CLAUDE.md文件，Claude 会自动读取并加入所有会话的上下文。这是统一团队代码规范、提高缓存命中率的最佳实践。

标准 CLAUDE.md 模板

# 项目配置
项目名称：个人计划小程序
技术栈：Vue 3 + TypeScript + Tailwind CSS + Pinia

## 代码规范
1. 使用Composition API，<script setup lang="ts">
2. 组件名使用PascalCase，文件名使用kebab-case
3. 所有接口定义在src/types目录下
4. 所有API请求封装在src/api目录下
5. 使用Pinia管理全局状态

## 关键文件
@src/types/index.ts - 全局类型定义
@src/utils/request.ts - 请求封装
@src/stores/plan.ts - 计划状态管理
@tailwind.config.js - 样式配置

## 注意事项
1. 所有日期使用dayjs处理
2. 所有本地存储使用localforage
3. 错误提示统一使用ElMessage
4. 不要修改原有功能的逻辑

4.2 自定义命令：一键执行重复任务

Claude Code 支持创建自定义命令，将常用的复杂指令封装成简单的斜杠命令。

创建项目级命令

1. 在项目根目录创建.claude/commands目录

2. 创建deploy.md文件，写入：

   执行项目部署流程：
   1. 运行npm run build构建项目
   2. 将dist目录上传到服务器
   3. 重启Nginx服务
   4. 验证部署是否成功

3. 使用命令：/project:deploy

创建用户级命令（所有项目通用）

1. 在用户目录创建~/.claude/commands目录

2. 创建security.md文件，写入：

   审查当前文件的安全漏洞：
   1. 检查SQL注入风险
   2. 检查XSS漏洞
   3. 检查敏感信息泄露
   4. 给出修复方案

3. 使用命令：/user:security

4.3 Git 全流程自然语言操作

Claude Code 对 Git 有深度集成，你几乎不需要手动敲任何 Git 命令。

常用 Git 操作示例

# 查看当前Git状态
帮我看看当前的Git状态，有哪些文件修改了

# 生成提交信息
帮我生成一个符合Conventional Commits规范的提交信息

# 提交代码
提交所有修改，提交信息：feat: 新增计划删除功能

# 拉取远程代码
拉取远程main分支的代码，并解决冲突

# 查看提交历史
帮我看看最近5次提交的内容

# 撤销最近一次提交
撤销最近一次提交，保留修改内容

---

五、避坑指南：90% 的人都会犯的错误

1. ❌ 不要复制粘贴代码到对话中，永远用@引用

2. ❌ 不要在一个会话中处理多个不相关的任务

3. ❌ 不要修改CLAUDE.md文件的内容，否则所有缓存失效

4. ❌ 不要在固定前缀中加入任何动态内容

5. ❌ 不要让上下文超过 10 轮对话，定期执行/compact或/clear

6. ✅ 多文件修改前先创建检查点，出错了用Esc+Esc回退

7. ✅ 接受代码前先看 Diff，确认修改内容符合预期

8. ✅ 重要任务完成后导出会话：/export session

---

六、快速参考表

核心命令

命令	功能
/help	显示帮助
/clear	清空上下文
/compact	压缩上下文
/context	查看 Token 分布
/stats	查看使用统计
/btw	并行提问
/bg	后台运行
/model	切换模型

核心快捷键

快捷键	功能
Ctrl+C	中断任务
Esc	停止操作
Esc+Esc	回退到检查点
Ctrl+G	外部编辑器
Tab	自动补全
Ctrl+R	搜索历史
←	打开 Agent View

@引用语法

语法	功能
@file.js	引用文件
@file.js:func	引用函数
@file.js:45	引用行号
@dir/	引用目录
@git:hash	引用 Git 提交
@terminal:	引用终端输出

本文由AI整理，使用命令前需验证。