Day 2 / 7

高效对话技巧

如何与 Claude Code 进行高效沟通,提升开发效率

📖 预计阅读时间:25分钟🎯 难度:入门

会用工具和用好工具是两回事。Claude Code 的能力上限很高,但能发挥多少取决于你怎么跟它对话。今天我们聊聊如何高效沟通,让 AI 真正成为你的编程搭档。

一、好提示词的三个要素

跟 Claude Code 对话不是聊天,而是下达任务指令。一个好的提示词应该包含:

🎯

1. 明确的目标

告诉 AI 你想要什么结果,而不是怎么做。

❌ 不好的例子:

"帮我写个函数"

✅ 好的例子:

"创建一个函数,输入用户ID,返回该用户的所有订单,按时间倒序排列"

📍

2. 足够的上下文

提供必要的背景信息,让 AI 理解你的项目。

❌ 不好的例子:

"优化这个查询"

✅ 好的例子:

"优化 src/api/orders.ts 中的 getUserOrders 查询,现在查询 10万条数据需要 5秒,目标是 1秒内"

⚙️

3. 清晰的约束

说明技术栈、代码风格、性能要求等限制条件。

❌ 不好的例子:

"添加用户认证"

✅ 好的例子:

"使用 JWT 添加用户认证,token 有效期 7天,使用现有的 auth.ts 工具函数"

二、提示词模板

根据不同的任务类型,这里提供几个实用模板:

📝 创建新功能

claude "在 [文件路径] 中创建 [功能名称]
要求:
1. [具体需求1]
2. [具体需求2]
3. [具体需求3]
技术栈:[使用的库/框架]
参考:[现有代码位置]"

🐛 修复 Bug

claude "修复 [文件路径] 中的问题
问题描述:[具体现象]
预期行为:[应该怎样]
错误信息:[如果有的话]
复现步骤:[如何触发]"

♻️ 重构代码

claude "重构 [文件路径]
目标:[提升可读性/性能/可维护性]
保持:[不能改变的行为]
优化:[重点改进的地方]"

📚 添加文档

claude "为 [文件路径] 添加文档
包括:
- 函数/类的用途说明
- 参数和返回值类型
- 使用示例
- 注意事项
风格:[JSDoc/Python docstring/等]"

三、多轮对话的技巧

Claude Code 会记住对话上下文,善用这个特性可以大幅提升效率。

💡 技巧 1:渐进式细化

先让 AI 生成基础版本,再逐步提出改进要求。

第1轮:

"创建一个用户列表组件"

第2轮:

"添加搜索功能"

第3轮:

"添加分页,每页20条"

💡 技巧 2:引用之前的内容

用"刚才的"、"上面的"等词语引用上下文。

"把刚才的函数改成异步的"

"用同样的方式处理订单数据"

"按照上面的代码风格重写这个文件"

💡 技巧 3:分步执行复杂任务

把大任务拆成小步骤,逐个确认。

第1步:

"先创建数据模型"

第2步:

"再创建 API 接口"

第3步:

"最后创建前端组件"

四、实战场景

Claude Code 不只是编程工具。无论你是否会编程,都能用它来提升工作效率。让我们看两个实战场景。

💡 重要提示

即使你不会编程,Claude Code 也能帮你管理文件、整理项目、批量处理文档。下面的场景一就是为非程序员设计的。

场景一:文件和项目管理(非编程用户)

假设你的电脑上有一堆乱七八糟的文件,想要整理但不知道从何下手。Claude Code 可以帮你。

任务1:整理下载文件夹

把下载文件夹里的文件按类型分类到不同文件夹

claude "帮我整理 ~/Downloads 文件夹:
1. 把所有图片移动到 Downloads/图片/
2. 把所有PDF移动到 Downloads/文档/
3. 把所有视频移动到 Downloads/视频/
4. 其他文件保持不动
先告诉我会移动哪些文件,等我确认后再执行"

任务2:批量重命名文件

把旅行照片按日期重命名

claude "把 ~/Pictures/日本旅行/ 文件夹里的照片重命名:
格式:日本旅行_2024_01.jpg, 日本旅行_2024_02.jpg...
按文件创建时间排序"

任务3:查找重复文件

找出电脑上的重复文件,释放空间

claude "扫描 ~/Documents 文件夹,找出所有重复的文件
按文件大小排序,列出重复文件的路径
不要删除,只是列出来让我确认"

任务4:批量处理文档

从多个文本文件中提取特定信息

claude "读取 ~/工作文档/ 下所有 .txt 文件
提取每个文件中的邮箱地址
汇总到一个 emails.txt 文件中,去重"

任务5:项目文件夹结构分析

了解一个项目的文件结构

claude "分析 ~/Projects/我的网站/ 的文件结构
生成一个目录树,标注每个文件夹的用途
保存到 structure.md 文件"

任务6:清理临时文件

安全地清理项目中的临时文件

claude "在当前项目中查找所有临时文件:
- .DS_Store
- Thumbs.db
- *.tmp
- *.log
列出找到的文件,询问我是否删除"

✨ 非程序员也能做的事

  • • 整理混乱的文件夹,按类型、日期、项目分类
  • • 批量重命名文件,统一命名规范
  • • 查找重复文件,释放磁盘空间
  • • 从多个文档中提取信息(邮箱、电话、关键词)
  • • 生成项目文档(目录结构、文件清单)
  • • 备份重要文件到指定位置
  • • 批量转换文件格式(需要安装相应工具)

⚠️ 安全提示

在让 Claude Code 操作文件前:

  • • 先让它"列出"或"分析",不要直接"删除"或"移动"
  • • 重要文件先备份
  • • 仔细审查 AI 的操作计划,确认后再执行
  • • 使用"先告诉我会做什么,等我确认后再执行"这样的表达

场景二:代码重构(编程用户)

假设你有一个 user.js 文件,代码混乱、没有注释、性能不佳。我们要用 Claude Code 来重构它。

第1轮:分析现状

claude "分析 src/user.js 的代码质量
重点关注:
1. 代码结构
2. 性能问题
3. 可维护性
给出具体的改进建议"

第2轮:重构代码

claude "按照刚才的建议重构 src/user.js
要求:
1. 拆分成多个小函数
2. 添加 JSDoc 注释
3. 优化数据库查询
4. 保持原有功能不变"

第3轮:添加测试

claude "为重构后的代码添加单元测试
使用 Jest 框架
覆盖主要功能和边界情况"

✨ 关键点

注意每一轮都在前一轮的基础上继续,Claude Code 会记住之前的所有操作和代码状态。这就是多轮对话的威力。

五、常见错误与避坑指南

❌ 错误 1:指令太模糊

"优化代码"、"改进性能"这种指令太宽泛,AI 不知道从何下手。

✅ 改进:明确指出要优化什么、目标是什么。

❌ 错误 2:一次要求太多

一口气提10个需求,AI 容易遗漏或理解错误。

✅ 改进:拆分成多轮对话,每次聚焦一个核心任务。

❌ 错误 3:不提供上下文

直接说"修复这个bug",但不说是哪个文件、什么问题。

✅ 改进:提供文件路径、错误信息、复现步骤。

❌ 错误 4:盲目接受结果

AI 生成的代码不一定完美,要审查、测试、调整。

✅ 改进:养成审查代码的习惯,发现问题及时反馈。

今日小结

你已经学会了:

  • 好提示词的三个要素:明确目标、足够上下文、清晰约束
  • 针对不同任务的提示词模板
  • 多轮对话的三个技巧:渐进式细化、引用上下文、分步执行
  • 通过实战案例掌握重构流程
  • 常见错误和避坑指南

明天预告

在 Day 3,我们将学习:

  • • Claude Code 的工具系统详解
  • • 如何让 AI 读取、编辑、执行文件
  • • 权限管理和安全设置
  • • 实战:构建一个完整的 CRUD 应用

🎓 加入云途AGI社群,获取更多学习资源

社群提供基础资源、答疑支持和陪伴式学习,帮助你更好地掌握 AI 工具

📚

基础资源

入门教程、工具指南、实战案例

💬

答疑支持

遇到问题随时提问,及时获得解答

🤝

陪伴式学习

与同行者一起成长,不再孤单学习