这是主要的 Claude Code 快速入门指南。你不需要先看功能概览。 你只需要养成四个习惯,让 AI 代理保持高效,同时避免它们滑向 自信的胡言乱语。

1. 语音输入

最主要的提速方式是对着电脑说话。Claude Code 之所以有用,是因为你 可以比打字或手动编辑更快地解释意图、约束条件、权衡和修正。

先设置好操作系统级语音转文字:macOS Dictation、Windows 语音键入,或者 一条可靠的 Linux 转录路径,能把内容粘贴到你的终端或编辑器中。然后 把清理规则写入你的全局 CLAUDE.md,这样语音提示就能当作语音提示来处理:

  • 除非另有说明,否则将消息视为语音转文字。
  • 删除填充词、假开头、重复词和明显的转录错误。
  • 原样保留粘贴的代码、日志、文件路径、堆栈跟踪、引用的文本和命令。

我的体会是,仓库级别的上下文文件可能应该保持更短、更具体,并且理想情况下是分层的(例如,“如果你做 x,请查看这个其他上下文文件 y.md,否则忽略它”)。

2. 并行工作

不要把一次对话当作唯一的工作通道。当你想尝试多种方法而不污染同一个检出目录时,使用 Git worktrees:

git worktree add ../project-a -b try/a
git worktree add ../project-b -b try/b

使用子代理处理有边界的并行任务:审查计划、排查失败的可能原因、比较方法、编写有针对性的冒烟测试、或通过截图检查 UI。

关键在于比较,而不是产生更多代码。让代理生成候选答案,然后 在合并某一路径之前比较差异、失败模式、测试覆盖率和可维护性。

3. 测试驱动开发

首先定义通过的标准。在实现之前,要求提供能够证明任务完成的 测试、检查、评估、截图或验收标准。

使其成为明确的 TDD:

  • 对于逻辑,先编写或命名单元测试。
  • 对于工作流,定义集成测试或冒烟测试。
  • 对于 UI,要求进行浏览器渲染检查和截图。
  • 对于模型行为,创建评估用例。
  • 对于数据转换,锁定测试数据和预期输出。

除非被真正的测试强制约束,否则 AI 代理会写出看似合理的垃圾。“能跑” 还不够。标准是:它是否通过了对该任务真正重要的质量指标?

4. 先做计划

在编码之前使用规划模式,特别是对于新项目、迁移、 架构变更、不明确的数据契约或任何回滚代价高昂的事情。

在让 Claude Code 写代码之前,请它先拷问你:

  • 最小的有用版本是什么?
  • 什么应该改变,什么应该保持不变?
  • 哪些契约、文件和命令很重要?
  • 哪些测试能证明成功?
  • 可能的失败模式是什么?
  • 回滚路径是什么?

好的计划让实现变得平淡无奇:限定范围的文件、明确的测试、已知的 风险,以及清晰的停止点。

元建议

关于 AI 代理,有一点你要明白:你可以问它们如何更好地使用 AI 本身。 对于困难的任务,问问 Claude Code 如何在该任务上更好地使用 Claude Code: 应该提供什么上下文、先写哪些测试、使用哪些子代理,以及 注意哪些失败模式。