用了大半年 Claude Code，我总结了 16 个实用技巧

前言

Hi～大家好呀。

我是清汤饺子，一个用 Claude Code 写了半年代码的普通前端工程师。

说实话，一开始我也用不太好，就觉得它跟其他 AI 编程工具差不多嘛，问问题、写代码，能有啥区别。

后来踩坑踩多了才发现，原来以前跟 AI 对话的方式，简直就是在浪费它的能力。

这篇文章呢，不是什么高大上的理论，就是我一路走过来总结的 16 个小技巧。都很实用，看完就能用～

---

第一部分：提示技巧

1. 给 Claude 验证方式（最高杠杆）

不知道你们有没有遇到过这种情况：AI 给你写了一段代码，看起来是对的，结果一跑，全是 bug。

其实这不是 AI 的问题啦～是你没有告诉它什么算"对"。

# ❌ 模糊
"实现一个验证邮箱的函数"

# ✅ 带验证
"编写 validateEmail 函数。测试用例：
- user@example.com → true
- invalid → false
- user@.com → false
实现后运行测试"

UI 更改也是一样的道理。告诉它用什么工具验证，它会自己打开浏览器测试，不对的话会自己改～

💡 心得：这一条是我踩坑最多的地方。之前每次让 AI 写代码都不给测试用例，结果来回改好几遍。加上验证方式后，效率直接翻倍。

---

2. 需求写得越具体越好

这个是最重要的技巧了，没有之一。

你要是跟 AI 说"帮我写个登录功能"，它也能写。但写出来的东西，你大概率要改很多次。

# ❌ 模糊
"帮我写个登录功能"

# ✅ 具体
"用 JWT 实现用户登录功能：
1. 登录接口 POST /api/login
2. 接收 email + password
3. 验证成功后返回 JWT token，有效期 7 天
4. 使用 jsonwebtoken 库
5. 参考 src/auth/ 的代码风格"

就多这么一小段话，能让你少改十次。

官方给的策略：

策略	之前	之后
限定任务范围	"为 foo.py 添加测试"	"为 foo.py 编写测试，涵盖用户已注销的边界情况。避免 mock。"
指向来源	"为什么这个 api 这么奇怪？"	"查看这个 api 的 git 历史，总结它是怎么形成的"
参考现有模式	"添加一个日历组件"	"参考现有组件的实现方式，按照同样的模式实现日历组件"

---

3. 让 Claude 采访你

有时候我们自己都没想清楚要什么呢。

这时候别急着让 AI 干活呀～先让它采访你。

我想xxx。请详细问我。
询问技术实现、用户界面/用户体验、边界情况及权衡取舍。避免问显而易见的问题，深入探讨难点部分。
持续提问直至完成，随后撰写SPEC.md文档。

它会问你一些你可能根本没考虑到的问题。把这些都想清楚了，再开始写代码，会顺利很多～

---

第二部分：工作流技巧

4. 先探索，再规划，最后编码

答应我，别一上来就让 AI 写代码好嘛～

先让它探索一下：读读代码，理解一下结构。 然后让它规划一下：列出要改哪些文件、怎么改。 最后才是实现。

官方推荐的四阶段 工作流 ：

1. 探索：进入 Plan Mode，让 Claude 只读分析
2. 规划 ：要求 Claude 创建详细计划，按 Ctrl+G 在编辑器中直接编辑计划
3. 实现：切回 Normal Mode 执行
4. 提交：让 Claude 创建 PR

切换方式： 按 Shift+Tab 或 Alt+M

---

5. 尽早且经常改正方向

AI 干活的过程中，如果你发现方向不对，要立刻说哦～

• Esc：在中途停止 Claude，可以重定向
• Esc + Esc 或 /rewind：回退到之前的状态
• /clear：不行就重来，别在错误的上下文里越走越远

小提示： 如果你在一个会话中对同一问题改正了 AI 两次以上，赶快跑 /clear 重开～

---

6. 用 Checkpoints 大胆尝试

Checkpoints（检查点） 是 Claude Code 的自动状态跟踪功能：

工作原理：

• 每次用户提示自动创建一个 checkpoint
• 捕获每次编辑前代码的状态
• 在会话之间持久存在，30 天后自动清理

回退方式：

• 按两次 Esc 或使用 /rewind 命令
• 可选择恢复：仅对话、仅代码、或两者都恢复

限制：

• 不跟踪 bash 命令的文件修改（如 rm、mv）
• 不跟踪外部手动更改
• 不是 Git 的替代品，是"本地撤销"功能

---

第三部分：上下文管理（省钱核心）

7. 积极管理 Context

这个可能是最容易被忽视的一个点了。

AI 是按 token 收费的哦。上下文越长，花钱越多。而且上下文太长的话，AI 的表现也会下降呢。

技巧 1：任务间清除

跑 /clear 清空上下文，换个任务从头开始。

技巧 2：用 /compact 压缩上下文

/compact Focus on code samples and API usage

让 AI 精简一下之前的内容，省 token～

技巧 3：用 / btw 快速提问

/btw 这个函数的参数类型是什么？

这个不计入对话历史，不花钱的～

特点：

• 问题和答案是短暂的，出现在可关闭的覆盖层中
• 无工具访问，仅从已在上下文中的内容回答
• 重用父对话的 prompt cache，成本低

---

8. 用 Subagents 进行调查

当你需要分析整个代码库的时候，别让主对话去读。

创建一个 subagent，让它在独立的上下文里跑。最后给你汇报，不会弄脏主对话的～

内置 Subagents：

Subagent	用途
Explore	快速搜索代码库（只读）
Plan	规划模式的研究
General-purpose	复杂多步骤任务

适合前端项目的 Subagent 示例：

1. 组件审查者 - 审查 React/Vue 组件的最佳实践
2. 样式检查器 - 检查 CSS/Tailwind 一致性
3. 测试运行器 - 运行 Jest/Vitest 测试并报告失败

创建方式： 运行 /agents → 选择 Create new agent → 描述需求

---

第四部分：环境配置

9. CLAUDE.md：一次配置，终身受益

每次开新项目都要跟 AI 解释项目规范，是不是很累～

在项目根目录创建 CLAUDE.md，一次说清楚就好啦。

# 项目说明

## 技术栈
- React 18 + TypeScript
- Vite
- Tailwind CSS

## 代码规范
- 组件用函数式组件
- 用 TypeScript 类型
- 样式用 Tailwind

跑 /init 还可以自动生成哦～

保持简洁，500 行以内就可以啦。

💡 提示：专门指令可以移动到 skills 中按需加载，而不是全部放在 CLAUDE.md 里，这样可以保持基础上下文较小，减少令牌消耗。

---

10. 用 Hooks 保证操作必定执行

CLAUDE.md 里的指令，AI 可能会忘记。

但 Hooks 是确定性的，每次都会执行哦～

{
 "hooks": {
 "PostToolUse": [{
 "matcher": "Edit|Write",
 "hooks": [{
 "type": "command",
 "command": "eslint --fix $FILE"
 }]
 }]
 }
}

比如每次写完代码自动跑 lint，每次提交前自动检查～

---

11. 用 Skills 创建可复用工作流

有些工作流是重复的呀。

创建一个 Skill，一次定义，随时调用～

---
name: fix-issue
description: Fix a GitHub issue
disable-model-invocation: true
---

Analyze and fix: $ARGUMENTS.

1. Get issue details
2. Understand the problem
3. Search relevant files
4. Implement fix
5. Write and run tests
6. Commit and PR

调用：/fix-issue 1234

---

第五部分：扩展能力

12. 管道：融入工作流

用 -p 标志，AI 可以融入你的命令行工作流～

# 代码审查
git diff | claude -p "review these changes"

# 测试失败分析
npm test 2>&1 | claude -p "why did tests fail"

# 创建提交
claude -p "create commit" --allowedTools "Bash(git diff *),Bash(git commit *)"

获取结构化输出：

claude -p "summarize" --output-format json

---

13. MCP：连接外部世界

MCP 可以让 AI 读取你的邮件、日历、各种 SaaS 数据。

# HTTP 服务器
claude mcp add --transport http notion https://mcp.notion.com/mcp

# 本地 stdio
claude mcp add --transport stdio airtable -- npx -y airtable-mcp-server

管理：

claude mcp list
claude mcp remove github
/mcp

---

14. 用 Git Worktrees 并行开发

同时开多个 AI 会话处理不同任务？

用 worktree 隔离，每个会话有独立的代码副本，不会互相干扰～

claude --worktree feature-auth
claude --worktree bugfix-123

Git Worktrees 是 Git 的功能，用于在同一仓库中创建多个独立的工作目录。

在 Claude Code 中的用途：

• 让多个 Claude 会话并行工作，互不干扰
• 每个 worktree 有自己的文件和分支，但共享仓库历史

使用方法：

# 创建名为 "feature-auth" 的 worktree 并启动 Claude
claude --worktree feature-auth

# 自动生成随机名称
claude --worktree

特点：

• Worktree 创建在 <repo>/.claude/worktrees/<name>
• 退出时无更改会自动清理，有更改会提示保留或删除
• Subagent 也可使用 isolation: worktree 实现隔离

---

第六部分：会话管理

15. 命名和恢复会话

/rename auth-refactor
claude --resume auth-refactor

早命名，后续好找哦～

---

16. 调整扩展思考

简单任务可以关掉思考，复杂任务再打开～

方式	说明
努力级别	/model 里调：低、中、高 注意只有可支持模型且是订阅账号可用
ultrathink 关键字	提示里加 "ultrathink"
切换快捷键	Option+T

省钱小技巧： 简单任务别让它想太多啦～

---

写在最后

16 个技巧，说多不多，说少不少。

但最重要的是：看完一定要去用哦～

不然就白看啦～

一句话总结：Context Window 是最重要的资源，所有的技巧都围绕这一点。

希望这篇文章对你们有帮助呀～ 有问题欢迎来问我！

---

参考资料

• 最佳实践完整版
• 常见工作流程
• 成本优化
• Hooks 参考
• Skills 文档
• Subagents 文档
• MCP 配置