最佳实践
提升 Claude Code 使用效率的实用技巧和最佳实践。
提示词技巧
明确具体
✗
帮我改一下代码✓
把 src/utils/format.ts 中的 formatDate 函数改成支持时区参数提供上下文
✗
这个报错了✓
运行 npm run build 时报错 TypeError: Cannot read properties of undefined at line 42指定范围
✗
优化一下项目✓
只优化 src/components/Header.tsx 的性能，不要改其他文件分步执行
✗
重写整个用户系统✓
先设计数据库 schema，然后写 API 路由，最后写前端组件项目管理
1
始终维护 CLAUDE.md
记录项目技术栈、开发命令、代码约定、关键决策等。Claude 每次会话都会加载，大幅减少重复解释。
2
使用 .gitignore 排除 AI 产物
将 Claude 生成的临时文件、报告等加入 .gitignore，避免污染代码库。
3
善用子代理处理复杂任务
多文件重构、跨包修改等任务，让 Claude 启动子代理并行处理，效率更高。
4
定期使用 /compact 压缩上下文
长对话后上下文会膨胀，使用 /compact 释放空间，保持响应速度。
安全注意事项
🔑
不要泄露密钥
不要将 API 密钥、密码等敏感信息粘贴到对话中。Claude 的对话记录可能存储在服务端。
🔍
审查 AI 生成的代码
Claude 可能引入安全漏洞（如 SQL 注入、XSS）。始终审查代码中的安全隐患。
🚫
谨慎使用 Auto 模式
Auto 模式会自动执行操作。对破坏性操作（删除、force push 等）保持警惕。
📝
先提交再修改
在执行大型重构前，先用 git commit 保存当前状态，以便随时回退。
效率提升
使用快捷键
- •Ctrl+C 中断操作
- •Ctrl+D 退出
- •↑↓ 浏览历史
配置白名单
- •常用只读命令免确认
- •git status 自动允许
- •Read/Glob/Grep 自动允许
合理使用模型
- •简单问题用 Haiku
- •日常开发用 Sonnet
- •复杂任务用 Opus
利用上下文
- •先 git diff 再提问
- •粘贴错误日志
- •提供相关代码片段
常见场景速查
| 场景 | 推荐做法 |
|---|---|
| 修复 bug | 先描述错误现象，再让 Claude 定位和修复 |
| 代码审查 | 使用 /review 命令自动审查变更 |
| 重构代码 | 先用 Plan 模式对齐方案，再执行 |
| 写新功能 | 先描述需求和接口，让 Claude 逐步实现 |
| 理解代码 | 让 Claude 解释特定文件或函数的逻辑 |
| 升级依赖 | 说明从哪个版本到哪个版本，让 Claude 处理 breaking changes |
| 文档查询 | 使用 /find-docs 获取最新文档 |
恭喜！你已经掌握了 Claude Code 的核心功能
从 概览 开始复习，或在项目中实践起来吧！