用了 Claude Code 几周后,大多数人会停留在「能用」的阶段。本文整理的 20 个技巧,能让你从「能用」升级到「真正高效」。
一、任务描述技巧(1-5)
技巧 1:给上下文,不只给命令
差:修复这个 bug
好:
这是一个 FastAPI 用户认证模块。当用户使用 Google OAuth 登录时,
第一次登录成功,但刷新 token 后第二次登录失败,报 401 错误。
错误日志:[粘贴日志]
请帮我找到根本原因并修复。
技巧 2:分解大任务
不要一次让 Claude 做太多事:
# 不好:一次性要求太多
重构整个 src/ 目录,加单元测试,更新文档,优化性能
# 好:分步骤
第一步:先分析 src/auth/ 模块的结构,告诉我哪里耦合最严重
(确认分析正确后再继续)
技巧 3:用「探索-规划-实现」三段式
第一步:探索代码库,了解现有架构(只读,不改动)
第二步:制定重构方案,列出具体步骤,我来确认
第三步:按确认的方案执行
技巧 4:指定输出格式
分析这段代码的安全问题,以此格式返回:
- 问题:[描述]
- 严重程度:HIGH/MEDIUM/LOW
- 位置:文件:行号
- 修复建议:[具体代码]
技巧 5:用否定句排除不想要的
重构这个函数,让它更简洁。
不要改变函数签名,不要引入新的依赖,不要修改注释。
二、上下文管理技巧(6-9)
技巧 6:主动使用 /compact
bash
/status # 查看上下文使用量
/compact # 压缩历史,保留关键信息一般规则:上下文超过 50% 就主动 /compact,避免后期响应质量下降。
技巧 7:用 /clear 重新开始而不是继续纠缠
当一个方向走偏了,不要试图纠正,直接:
bash
/clear
# 重新描述任务,这次说清楚之前踩过的坑技巧 8:让 Claude 先读文件再操作
先读取 src/auth/middleware.py 和 src/models/user.py,
理解现有结构后,再告诉我打算怎么修改(不要直接改)。
技巧 9:用 # 快速添加文件到上下文
# src/config.py 看一下这里的数据库配置,
# src/models/base.py 然后帮我优化连接池设置
三、CLAUDE.md 记忆技巧(10-12)
技巧 10:把常用规则放进 CLAUDE.md
markdown
## 代码规范
- Python:遵循 PEP 8,用 black 格式化
- 提交前必须跑 pytest tests/
- API 端点命名:kebab-case
## 项目结构
- 新功能放 src/features/
- 测试放对应的 tests/ 子目录
## 禁止事项
- 不要直接 push 到 main
- 不要修改 .env 文件技巧 11:CLAUDE.md 不要超过 150 行
超过 150 行 Claude 的遵从度会明显下降。精简规则,删除不重要的内容。
技巧 12:用层级 CLAUDE.md 管理大型项目
项目根目录/CLAUDE.md -> 全局规范
src/auth/CLAUDE.md -> 认证模块专属规则
src/api/CLAUDE.md -> API 层专属规则
Claude 会自动加载当前目录和父目录的所有 CLAUDE.md。
四、高效工作流技巧(13-17)
技巧 13:让 Claude 写测试再写实现(TDD 模式)
先写 tests/test_payment.py 的测试用例(覆盖成功/失败/边界情况),
不要写实现代码。我确认测试合理后,再写 src/payment.py 让测试通过。
技巧 14:Headless 模式批处理
bash
# 一次性处理多个文件
for f in src/**/*.py; do
claude -p "Add type hints to all functions in this file" < $f > ${f%.py}_typed.py
done技巧 15:用 Sub-Agents 并行执行
请用 3 个并行子任务完成以下工作:
1. 重构 src/auth/ 模块
2. 为 src/api/ 生成 OpenAPI 文档
3. 更新 tests/ 的测试覆盖率
三个任务互不依赖,可以同时进行。
技巧 16:Git 工作流技巧
完成每个功能模块后,帮我:
1. git add 相关文件(不要 add 测试数据)
2. 写一个规范的 commit message(格式:feat/fix/docs: 简要描述)
3. git commit
技巧 17:用 Hooks 自动化重复操作
json
// ~/.claude/settings.json
{
"hooks": {
"PostToolUse": [{
"matcher": "Write",
"hooks": [{"type": "command", "command": "npx prettier --write ${file}"}]
}]
}
}五、高级技巧(18-20)
技巧 18:让 Claude 自我验证
实现这个功能后,请:
1. 运行测试确认通过
2. 检查有没有引入新的 TypeScript 类型错误
3. 用 git diff 确认改动范围合理
如果有任何问题,自行修复后再告诉我完成了。
技巧 19:斜杠命令速查
bash
/help # 查看所有命令
/status # 查看上下文用量和账号状态
/compact # 压缩上下文
/clear # 清空历史
/model # 切换模型
/memory # 查看和编辑记忆
/hooks # 查看 Hooks 配置
/ide # 连接 IDE
/login # 重新登录
/config # 打开配置菜单技巧 20:Plan Mode 先规划再执行
bash
# 快捷键:Shift+Tab 切换到 Plan Mode
# 或在 Prompt 最后加:
# 先给我一个详细的执行计划,我确认后再实施Plan Mode 下 Claude 只会思考和规划,不会执行任何文件操作。适合大型重构前的方案确认。
速查卡片
| 场景 | 技巧 |
|---|---|
| Claude 理解错了 | /clear 重新描述 |
| 回复质量下降 | /compact 再继续 |
| 不想每次重复规则 | 写进 CLAUDE.md |
| 大任务并行 | 用 Sub-Agents |
| 大任务前确认方向 | Plan Mode |
| 自动格式化/检查 | 配置 Hooks |
来源:Claude Code Best Practices - Anthropic 官方文档