🎯 最佳实践

编写清晰的提示

好的提示是获得好结果的关键。以下是编写有效提示的技巧:

具体而非模糊

❌ 不好的提示

"修复代码"

✅ 好的提示

"修复 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.md

CLAUDE.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 就不会浪费时间读取这些文件。

工作流建议

推荐的日常流程

  1. 开始工作前,让 Claude Code 了解当前状态
    1
    总结一下当前项目的状态,包括:最近的更改、未完成的功能、已知的问题。
  2. 处理任务时,分小步进行
    1
    现在让我实现 [具体功能],完成后再问我下一步。
  3. 定期提交和审查
    1
    审查最近的更改,确保没有问题,然后帮我生成提交信息。
  4. 结束工作时总结
    1
    总结今天完成的工作,更新项目文档。

💡 高级技巧

  • 使用 --resume 继续中断的会话
  • 使用 /compact 让 Claude 总结当前状态
  • 使用 /cost 查看 API 使用成本
  • 使用 /model 切换模型
  • 使用 /help 查看所有可用命令