Claude Code 性能提效指南

整理自实际使用经验，涵盖模型选择、提示词优化、常用命令、常见问题与解决方案。

---

一、模型选择

模型	适用场景	特点
Sonnet 4.6（默认）	日常编码、调试、重构	速度快、性价比高
Opus 4.6	复杂架构设计、深度推理	推理更强，但较慢

切换方式：

• 命令行输入 /model 选择模型
• 输入 /fast 开启快速模式（同模型，输出更快）

经验： 先用 Sonnet 确认方向，复杂任务再切 Opus，避免不必要的等待。

---

二、常用命令速查

命令	作用
/clear	完全清空上下文，重新开始
/compact	压缩历史对话为摘要，保留关键进度
/compact [说明]	手动指定压缩时保留的内容
/plan	进入规划模式，先思考再执行
/status	查看当前上下文 token 使用量
/memory	查看或编辑跨会话持久记忆
/model	切换模型
/fast	切换快速模式
Esc	随时中断正在执行的任务

/compact 使用说明

/compact                        # 自动压缩，Claude 自行总结
/compact 保留当前任务：修复登录模块的 JWT bug，已完成用户表查询部分

何时使用：

回答开始跑偏？
├── 任务还在进行中 → /compact（保留进度）
└── 任务可以重来  → /clear（最干净）

经验规则： 上下文超过 50% 考虑 /compact，超过 80% 必须处理。

/plan 使用说明

Plan 模式让 Claude 先探索代码库、设计方案，再等你批准后执行，避免直接动手改错方向。

触发方式：

/plan                          # 手动进入规划模式

或者在任务描述中触发，Claude 会自动判断是否需要进入规划模式（涉及多文件、架构决策时）。

规划模式下 Claude 会做什么：

1. 用 Glob / Grep / Read 工具探索相关代码
2. 理解现有架构和模式
3. 设计实现方案，列出将要修改的文件和步骤
4. 把方案写入计划文件，等待你审批
5. 你批准后才开始执行

适合使用 Plan 的场景：

场景	示例
新功能开发	「添加用户认证模块」
多文件重构	「把 Redux 迁移到 Zustand」
架构决策	「选择缓存方案：Redis vs 内存」
需求不明确	「优化性能」（需要先探查瓶颈）

不需要 Plan 的场景：

• 单行 bug 修复
• 明确的小改动（改个变量名、加个 console.log）
• 纯查询/解释类问题

Plan 模式工作流：

你描述任务
    ↓
Claude 探索代码库（只读，不改动）
    ↓
Claude 输出方案：改哪些文件、怎么改、有哪些风险
    ↓
你审批（可要求调整方案）
    ↓
Claude 执行

经验： 复杂任务直接让 Claude 进入 Plan 模式，比事后返工节省更多时间。方案阶段发现方向错误成本极低。

---

三、提示词优化技巧

具体明确

❌ 模糊：「修复登录问题」

✅ 精确：「在 src/auth.ts 第42行修复 JWT 验证逻辑，错误信息是 TokenExpiredError」

提供完整上下文

• 直接粘贴报错信息和堆栈
• 提供项目结构 tree -L 2 输出
• 说明所用库的版本号（Claude 知识截止 2025年5月）

分解任务

• 大任务拆成小步骤，每步确认后再继续
• 超过3个文件的修改，先停下来规划

限定范围

只修改 src/auth.ts，不要动其他文件

---

四、工作流配置

CLAUDE.md 项目规范

在项目根目录的 CLAUDE.md 中写入规范，减少重复说明：

## 代码规范
- 使用 TypeScript strict 模式
- 缩进：2空格
- 命名：camelCase
- 测试框架：Jest
- 包管理：bun

## 工作规则
- 编写代码前先描述方案等待批准
- 修改超过3个文件时先拆分任务
- 删除代码前全局检索引用

预授权常用操作

在 settings.json 中配置，减少确认弹窗打断节奏：

{
  "permissions": {
    "allow": ["Bash(npm test:*)", "Read(**)", "Glob(**)", "Bash(bun run:*)"]
  }
}

跨会话记忆

记住：这个项目用 bun 而不是 npm

Claude 会写入持久记忆文件，下次会话自动加载。用 /memory 查看或编辑。

---

五、常见问题与解决方案

问题1：反复修改同一个 bug 但不成功

原因： 没有测试驱动，凭感觉改代码。

解决：

先写一个能复现 bug 的测试 → 再让 Claude 修复 → 直到测试通过

不要说「修复这个bug」，而是说「先写测试复现，再修复」。

---

问题2：思考过久、回答失焦或没有逻辑

原因： 上下文过长，Claude 处理历史信息时跑偏。

解决：

• 立即执行 /compact 压缩上下文
• 重新明确当前任务目标
• 必要时 /clear 重新开始

---

问题3：改了太多不相关的文件

原因： 任务描述太宽泛，Claude 过度「优化」。

解决：

• 明确指定文件范围：「只修改 src/auth.ts」
• CLAUDE.md 中加规则：超过3个文件先拆分任务

---

问题4：代码正确但跑不起来

常见原因	解决方法
依赖没安装	让 Claude 检查 package.json 并安装
路径假设错误	提供 tree -L 2 项目结构
环境变量缺失	提供 .env.example 内容
库版本过新（超出知识截止）	明确说明版本号或粘贴文档片段

---

问题5：不断询问确认、打断节奏

解决：

• settings.json 预授权常用操作（见上文配置章节）
• 或在开头明确说：「接下来的任务请自主完成，不需要每步确认」

---

问题6：多文件重构后引用断掉

原因： Claude 删除代码前没有全局检索引用。

解决： CLAUDE.md 中加规则，或手动触发：

删除前请先全局搜索该符号的所有引用，确认无引用再删除

---

问题7：生成代码风格与项目不一致

解决： 在 CLAUDE.md 中写明代码规范（见上文配置章节）。

---

问题8：Agent 子任务失控 / Token 消耗过大

解决：

• /status 随时监控 token 消耗
• Esc 随时中断任务
• 复杂任务先用 Sonnet 确认方向，再用 Opus 深入

---

问题9：跨会话记忆丢失

解决：

• 重要规则写入 CLAUDE.md（项目级，随代码库保存）
• 个人偏好说「记住：xxx」让 Claude 写入记忆文件
• 用 /memory 查看当前记忆内容

---

六、核心原则总结

上下文质量 > 模型能力

干净的上下文 + 精确的指令，比换更强的模型更有效。

1. 任务要具体 — 文件名、行号、报错信息都提供
2. 上下文要干净 — 定期 /compact 或 /clear
3. 规范要固化 — 写入 CLAUDE.md，不要每次重复
4. 大任务要拆分 — 超过3个文件先规划
5. 用测试驱动修复 — 先写测试，再改代码
6. 及时中断 — 方向错了立刻 Esc，不要等它跑完