2.1 代码生成与优化

代码生成的核心原则

Claude Code 生成代码的质量很大程度上取决于你提供的提示词质量。掌握以下几个原则，可以显著提升生成效果：

具体化（Be Specific）

模糊的指令会导致不理想的代码。好的指令应该包含：

• 目标文件名：明确告诉 Claude 要修改哪个文件
• 边界情况：说明需要处理的特殊场景
• 预期行为：描述代码应该产生什么结果

效果差： "写一个排序函数"
效果好： "在 src/utils/sort.ts 中添加一个快速排序函数，输入是 number 数组，输出排序后的数组，支持升序和降序两种模式，用参数 desc?: boolean 控制"

引用现有模式（Reference Existing Patterns）

让 Claude 参考项目中已有的代码风格：

"参考 src/components/Button.tsx 的实现方式，在 src/components/ 下创建 Card.tsx 组件"

这样 Claude 会保持一致的代码风格、命名规范和结构。

提供验证方式（Provide Verification）

告诉 Claude 如何验证代码是否正确：

• 运行特定测试命令
• 预期输出示例
• 截图或 UI 描述

"写完这个函数后，运行 npm test -- --grep sort 验证" 或 "确保在浏览器中打开 /dashboard 时不报 console 错误"

常用代码生成场景

生成代码片段

在 src/utils/format.ts 中添加一个日期格式化函数，
输入 Date 对象，输出格式如 '2024-01-15 14:30' 的字符串。
参考同文件中现有函数的风格。

生成完整模块

在 src/api/ 下创建一个用户认证模块，包含：
- login(username, password) 登录函数
- logout() 登出函数
- getCurrentUser() 获取当前用户信息
使用 Fetch API，参考同目录下 auth.ts 的错误处理方式。

添加测试用例

为 src/utils/format.ts 中的日期格式化函数编写单元测试，
覆盖：正常日期、null 输入、undefined 输入、跨年边界。
测试框架使用 Jest，参考 __tests__/format.test.ts 的写法。

代码优化

Claude Code 也可以帮你优化现有代码：

性能优化

分析 src/utils/heavy.ts 中的 calculate() 函数，
找出性能瓶颈并给出优化建议。
特别关注循环和递归调用。

代码可读性优化

简化 src/components/OldWidget.tsx 的 JSX 结构，
提取重复的 JSX 为子组件，保持功能不变。

类型安全增强

将 src/utils/data.ts 中的 any 类型全部替换为具体类型，
定义必要的接口和类型别名。

上下文管理与 Token 优化

当项目较大或对话较长时，Claude 的上下文会逐渐填满。可以使用以下方式管理：

减少上下文消耗的习惯

• 完成一个任务后开启新会话，而不是在一个会话里做多个不相关的任务
• 使用 @filename#10-20 引用文件的特定行，而不是整文件
• 用 @dirname? 列出目录而非让 Claude 遍历
• 将构建输出和测试结果灌入上下文，而不是让 Claude 自己去运行

典型工作流示例

cd /path/to/project
claude

# 1. 了解项目
→ 给我一个项目结构概览

# 2. 理解特定模块
→ 解释 src/utils/auth.js 的逻辑

# 3. 生成或修改代码
→ 在 src/utils/ 中添加一个 JWT 刷新函数

# 4. 运行验证
→ 运行 npm test 确认没有破坏现有功能

# 5. 提交变更
→ 用一个有意义的 commit 信息提交这些修改

限制与注意事项

• Claude 会读取你当前工作目录及子目录下的所有文件，无法访问目录之外的内容
• Claude 对外部编辑保持敏感——如果文件在工具调用之间被外部修改，下次读取时会获取最新内容
• 对于大型复杂重构，建议先用计划模式（Ctrl+G）探索和规划，再执行