🎯 最佳实践
编写清晰的提示
好的提示是获得好结果的关键。以下是编写有效提示的技巧:
具体而非模糊
❌ 不好的提示
"修复代码"
✅ 好的提示
"修复 src/api/users.ts 中的 TypeScript 类型错误,用户 ID 应该是 string 而不是 number"
提供上下文
提供上下文的提示
1
2
3
4
5
6
7
8
9
我正在开发一个电商网站,使用 Next.js 14 + TypeScript + Prisma。
请帮我创建一个商品搜索功能:
1. 支持关键词搜索
2. 支持按分类筛选
3. 支持价格区间筛选
4. 分页显示结果
数据库模型在 prisma/schema.prisma 中。分步说明复杂任务
分步骤提示
1
2
3
4
5
6
7
8
9
请按以下步骤实现用户认证系统:
1. 首先创建用户模型 (使用 Prisma)
2. 实现注册 API (密码加密使用 bcrypt)
3. 实现登录 API (JWT 认证)
4. 创建认证中间件
5. 编写单元测试
每完成一步后,向我确认再继续下一步。项目结构建议
推荐的项目布局
推荐项目结构
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
my-project/
├── .claude/ # Claude Code 配置
│ └── settings.json
├── .mcp/ # MCP Server 配置
│ ├── database.json
│ └── github.json
├── CLAUDE.md # 项目说明给 Claude
├── src/
│ ├── components/
│ ├── lib/
│ ├── pages/
│ └── types/
├── tests/
├── package.json
└── README.mdCLAUDE.md 最佳实践
完整的 CLAUDE.md 示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# CLAUDE.md
## 项目背景
这是一个 [项目类型],主要功能是 [核心功能]。
## 技术栈
- 前端: React + TypeScript + Tailwind CSS
- 后端: Node.js + Express
- 数据库: PostgreSQL + Prisma
## 代码规范
- 使用 ESLint + Prettier
- 组件使用 PascalCase 命名
- 函数使用 camelCase 命名
- 常量使用 UPPER_SNAKE_CASE
## 禁止操作
- 不要修改数据库迁移文件
- 不要直接修改 .env 文件
- 不要安装新的依赖而不询问
## 测试要求
- 新功能必须添加单元测试
- API 端点必须添加集成测试
## 部署信息
- 开发环境: localhost:3000
- 生产环境: https://api.example.com调试技巧
让 Claude 解释代码
请求解释
1
2
3
4
5
请解释 src/utils/parser.ts 中的 parseData 函数:
1. 它的作用是什么?
2. 输入和输出是什么?
3. 有什么边界情况需要处理?
4. 当前实现有什么潜在问题?让 Claude 找 Bug
Bug 调试提示
1
2
3
4
5
6
7
我遇到了一个 bug:[描述问题]
期望行为: [期望的结果]
实际行为: [实际的结果]
相关代码在 src/features/auth.ts
请帮我找出问题并提供修复方案。性能问题诊断
性能分析提示
1
2
3
4
5
分析 src/api/search.ts 的性能问题:
1. 检查是否有 N+1 查询
2. 检查是否有不必要的数据库调用
3. 检查是否有内存泄漏风险
4. 提供优化建议安全考虑
⚠️ 安全警告
- • 不要让 Claude Code 访问敏感环境变量 (.env)
- • 不要在不受信任的项目中运行 Claude Code
- • 审查 Claude Code 生成的代码,特别是安全相关部分
- • 使用权限配置限制危险操作
安全配置示例
安全配置
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// .claude/settings.json
{
"security": {
"denyPatterns": [
".env*",
"**/secrets/**",
"**/credentials/**"
],
"denyCommands": [
"sudo",
"rm -rf /",
"curl * | bash"
],
"maxFileSize": 1048576
}
}性能优化建议
使用正确的模型
| 场景 | 推荐模型 |
|---|---|
| 快速代码补全 | claude-3-5-haiku |
| 日常编码任务 | claude-3-5-sonnet |
| 复杂重构 | claude-4-opus |
| 大型项目分析 | claude-4-opus (1M context) |
减少不必要的操作
优化提示
1
2
3
4
5
6
7
8
9
# 在 CLAUDE.md 中指定忽略的目录
## 忽略目录
- node_modules/
- .next/
- dist/
- build/
- *.min.js
这样 Claude Code 就不会浪费时间读取这些文件。工作流建议
推荐的日常流程
- 开始工作前,让 Claude Code 了解当前状态1
总结一下当前项目的状态,包括:最近的更改、未完成的功能、已知的问题。 - 处理任务时,分小步进行1
现在让我实现 [具体功能],完成后再问我下一步。 - 定期提交和审查1
审查最近的更改,确保没有问题,然后帮我生成提交信息。 - 结束工作时总结1
总结今天完成的工作,更新项目文档。
💡 高级技巧
- •使用
--resume继续中断的会话 - •使用
/compact让 Claude 总结当前状态 - •使用
/cost查看 API 使用成本 - •使用
/model切换模型 - •使用
/help查看所有可用命令