4.1 单文件开发实战

典型工作流

单文件开发是 Claude Code 最基础也最高效的使用场景，适合：

• 快速生成代码片段
• 一次性脚本编写
• 单文件调试和修改
• 代码片段解释和学习

完整工作流程

cd /path/to/project
claude

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

# 2. 针对特定文件工作
→ 解释 src/utils/format.ts 中 dateFormat 函数的逻辑

# 3. 编写或修改
→ 在 src/utils/format.ts 中添加一个时间戳转日期函数

# 4. 验证
→ 运行 npm test -- --grep format 验证

# 5. 提交
→ 提交这些修改，commit 信息为 "feat: 添加时间戳格式化函数"

文件引用语法

单文件开发时，准确引用文件可以让 Claude 快速定位：

常用场景

场景一：生成工具函数

在 src/utils/string.ts 中添加以下函数：
1. truncate(str, length) - 截断超长字符串，超过 length 显示省略号
2. camelToSnake(str) - 驼峰转下划线
3. snakeToCamel(str) - 下划线转驼峰

参考同文件中现有函数的代码风格。

场景二：解释代码逻辑

→ 详细解释 @auth/middleware.ts 中 JWT 验证的逻辑流程

场景三：快速调试

→ 这个函数报错了："Cannot read property 'map' of undefined"
帮我找出问题并修复

场景四：管道输入

# 直接在终端输入内容分析
cat /path/to/log.txt | claude -p "分析这个错误日志，找出主要问题"

# 一行命令模式
claude -p "把这个 JSON 格式化并美化输出"

一键模式（-p）

不需要进入交互会话时，使用 -p 参数直接输出结果：

claude -p "解释 @src/api/auth.ts 中间件的用途"
cat error.log | claude -p "这段错误日志的原因是什么"
claude -p "将这段 Python 代码翻译成 TypeScript" < input.py

会话恢复

单文件开发可能需要多次对话，可以使用会话恢复：

claude --continue              # 继续上一次会话
claude -r <session-id>          # 恢复指定会话
claude -c                       # 继续最近一次会话

提高效率的小技巧

• 每次只做一个任务，完成后开新会话，避免上下文混乱
• 把预期结果描述清楚（输入、输出、边界情况）
• 提供测试验证方式，让 Claude 帮你运行测试确认正确性
• 复杂任务先 Ctrl+G 进入计划模式，审核方案后再执行