最佳实践

从 Claude Code 中获益最多的开发者，不是那些输入"帮我做所有事情"的人，而是掌握了正确使用方式的人。

核心认知

上下文窗口会快速填满，性能随填充而下降。 所有最佳实践都围绕这个约束展开。

给 Claude 验证工作的方式

不要只说"修复 bug"，要说"修复后运行测试确认通过"。提供验证标准让 Claude 自我检查：

实现用户注册功能，确保：
1. 所有字段有输入验证
2. 密码强度检查通过
3. 现有测试全部通过
4. 新增的测试覆盖正常和异常路径

提供具体的上下文

范围限定

在 src/api/auth.ts 中添加 JWT token 刷新逻辑

指向源码

参考 src/utils/cache.ts 的缓存模式，给 UserService 添加缓存层

描述症状

用户点击"保存"按钮后页面卡住 3 秒，检查 network 面板发现 POST /api/data 超时

提供丰富内容

方式	示例
@ 引用文件	@src/auth.ts 这个文件的登录逻辑有 bug
粘贴图片	直接粘贴截图/设计稿
给 URL	参考 https://docs.example.com/api 的规范
管道输入	`git diff
让 Claude 自己获取	读取 src/ 下所有测试文件，分析覆盖率

配置好环境

1. 编写有效的 CLAUDE.md：保持 200 行以内，具体可验证，使用 @path 导入额外文件
2. 配置权限：使用 Auto mode 或白名单减少确认弹窗
3. 添加 CLI 工具：确保项目工具链可用
4. 连接 MCP 服务器：扩展 Claude 的能力边界
5. 配置 Hooks：自动格式化、自动检查
6. 使用 Skills：为重复任务创建可复用的提示

管理会话

操作	方法
方向偏了	Esc Esc 回退
上下文太长	/compact 压缩
需要附带指令	/btw 记住使用 strict 模式
需要子任务	委派给子代理，保护主上下文
完全卡住	/clear 从头开始

常见失败模式

厨房水槽会话

把太多不相关的任务塞进一个会话。每个会话应该有一个清晰的主题。

反复纠正

同一方向反复纠正 Claude 超过 3 次，说明应该 /clear 重新开始，换一种方式描述需求。

CLAUDE.md

200 行以上的 CLAUDE.md 会消耗大量上下文。用 @path 导入和 .claude/rules/ 分组来保持精简。

信任但不验证

AI 生成的代码需要像审查人类代码一样审查。使用 /context 检查上下文占用，确保 Claude 有足够空间思考。

无限探索

让 Claude 无止境地搜索代码库而不采取行动。设定明确的目标和边界。

提示

从 Claude Code 中获益最多的开发者是那些学会了何时使用计划模式、如何构建提示、何时调用 ultrathink、以及如何设置 hooks 在错误发生前捕获它们的人。AI 是一个杠杆，这些实践帮助你找到正确的着力点。