Claude Code 新手教程：2026 年 5 月掌握 AI 编程

通过这份新手教程学习 Claude Code：掌握终端中的 AI 编程、分步操作方法、实用技巧与语音提示词。

作者：Allan Guo
发布于：2026-06-11
原文：https://willowvoice.com/blog/claude-code-tutorial-for-beginners

Claude Code 在终端中运行，能够自主处理多步骤任务；但要启动这些任务，你仍然需要输入详细的提示词，描述重构目标、边界情况和约束条件。键入这些上下文需要时间，说出来却只需几秒。语音速度大约是打字的三倍，而且这种差距会在每次会话中不断累积。如果你第一次学习这份 Claude Code 教程，最快的掌握方式，就是别再逐字敲提示词，改为直接说出来。

内容概要：

• Claude Code 在终端中运行，可以自主处理横跨整个代码库的多步骤任务。
• 在 Mac、Linux 或 Windows 上，使用 Anthropic 原生安装程序只需一条命令即可安装。
• 在项目根目录添加 CLAUDE.md，让 Claude 从第一条提示词开始就了解技术栈和代码风格。
• 计划模式会在执行前展示具体步骤；多数新手先从这里开始，熟悉后再切换到自动模式。
• 说出提示词比打字快约三倍；语音听写工具能够以 200 毫秒延迟转写，还能学习代码库中的专用词汇。

Claude Code 是什么，为什么它对开发者很重要

Claude Code 是 Anthropic 推出的一款智能体式编程助手，在终端中运行。它与 IDE 插件或聊天界面不同，可以直接在你的环境中读取文件、运行命令和修改代码，无需每一步都由人手把手指导。

它与 GitHub Copilot 等工具真正的区别在于自主性。Claude Code 接到一项多步骤任务后，会规划解决方法，并横跨代码库执行。你只需描述目标，它会自行处理原本需要手动完成的各个步骤。

到了 2026 年，这种转变十分重要。开发者正在从补全型 AI 转向能够端到端接管完整工作流的工具。

在 Windows、Mac 和 Linux 上安装 Claude Code

大多数系统只需一条命令就能运行 Claude Code。前提是安装 Node.js 18 或更高版本，CLI 本身可以免费安装。完整源代码位于 Claude Code GitHub 仓库。如需完整技术规格，请查阅官方 Claude API 文档。

Mac 和 Linux

打开终端并运行安装命令。

安装完成后，输入 claude 启动。系统会要求通过浏览器登录 Anthropic 账户。如果需要查看版本历史和发行说明，可以访问官方的 @anthropic-ai/claude-code npm 软件包页面。

Windows

有两种方式。最快的是使用 PowerShell 安装脚本，在 PowerShell 中运行后，脚本会自动完成安装。也可以在已经安装 Node.js 的情况下使用同一条 npm install -g @anthropic-ai/claude-code 命令；Windows 10 和 Windows 11 都支持。无论采用哪种方法，完成后都要打开一个新的终端窗口，输入 claude 确认安装成功。

Claude Code 的界面选择：终端、网页、桌面端和 IDE

Claude Code 能运行的地方比多数新手想象得更多。提前了解哪一种界面适合自己的工作流，可以省去大量试错。

在终端中输入 claude 启动的 CLI，是完成智能体任务、多文件修改和 Shell 命令时能力最完整的选择。Claude 可以读取整个代码库、运行命令，并自主串联多个步骤。Claude.ai 网页版适合快速提问和在浏览器中输入提示词；anthropic.com 提供的桌面应用则无需终端即可使用图形界面。VS Code 和 JetBrains 扩展的体验更接近 Copilot，适合在不离开代码的情况下获得编辑器内建议。轻量使用时，网页版和桌面端已经足够，但它们无法运行终端版本所擅长的深度智能体工作流。

第一次 Claude Code 会话：基本命令与工作流程

进入项目文件夹，然后启动会话。

Claude 会读取当前目录中的上下文，等待你的第一条提示词。开始之前，值得先了解几个斜杠命令：

• /help：列出可用命令和快捷键，快速查看 Claude Code 支持哪些能力。
• /login：会话过程中凭据过期时，重新进行身份验证。
• /clear：需要干净上下文时，重置对话。
• /status：显示当前 Token 用量，方便掌握会话进度。

进入会话后，直接用自然语言说明需求即可。例如，“为 api.js 中的 fetch 函数添加错误处理”不需要任何特殊语法。

能让所有工作加速的习惯

是否具体，是高效会话与低效会话之间的分界线。“修复我的代码”这种含糊要求只会产生含糊结果；“当用户对象为空时，auth.js 中的登录函数会抛出空引用错误”则给了 Claude Code 足够的上下文，使它能够精准行动，减少来回确认，更快得到可用代码。

理解 CLAUDE.md：让 Claude 适应你的代码库

CLAUDE.md 是放在项目根目录中的纯文本文件。Claude 会在每次会话开始时读取它，因此在你输入第一条提示词前，就已经了解项目约定。

适合写入其中的信息包括：

• 语言版本和框架，例如 Python 3.11、Node 20
• 命名规则和格式偏好等代码风格
• 各模块职责等架构说明
• 应该使用或避免的库
• 项目遵循的测试模式

没有 CLAUDE.md 时，Claude 只能猜测技术栈；有了它，Claude 从第一次回答起就能贴合代码库，不必反复说明要求。

使用 touch CLAUDE.md 创建文件，然后直接用自然语言编写，例如：“本项目使用 TypeScript 严格模式；使用 Zod 进行验证；每个 API 路由都必须包含错误处理。”这些上下文会自动贯穿整个会话，Claude 也不会再反复询问本不该询问的澄清问题。

计划模式与自动模式：控制 Claude 的工作方式

Claude Code 提供三种控制级别，分别适合不同的信任程度和任务复杂度。

• **手动模式：**Claude 在每个单独操作前请求批准，让你逐步检查。
• **计划模式：**Claude 先列出准备执行的全部步骤，得到许可后才真正运行。
• **自动模式：**Claude 从头到尾执行完整任务，中途不暂停等待输入。

多数新手应该从计划模式开始。执行前看到 Claude 准备采取的步骤，能够快速建立直觉。等这些模式变得可预测后，再切换到自动模式。对于生产代码库或任何敏感内容，手动模式能让你保持完整控制。

常见使用场景：Claude Code 最擅长什么

Claude Code 在下面几类工作中表现尤其出色。了解它的优势，有助于充分利用每次会话。

• **编写和重构代码：**读取现有文件并重写函数、在整个代码库中重命名变量，或者把类组件改写为 Hooks，全程无需手工复制粘贴。
• **调试：**粘贴错误信息，或者让 Claude Code 检查失败的测试；它会追踪根本原因、提出修复方案，并直接修改文件。
• **生成样板代码：**搭建新的 REST 端点、数据库迁移或 React 组件，只需几秒而不是几分钟。
• **编写测试：**读取实现后生成对应的单元测试或集成测试，并覆盖你可能遗漏的边界情况。
• **解释陌生代码：**询问某个函数的作用，获得自然语言讲解，从而大幅加快熟悉新仓库的速度。

Claude Code、Cursor 与 Windsurf 对比

三款工具都用 AI 提升开发速度，但它们所处的界面和最擅长的任务并不相同。

工具	界面	最适合的场景
Claude Code	终端 CLI	大规模重构、多文件架构、智能体式工作流
Cursor	IDE（VS Code 分支）	聚焦单个文件的编辑、行内补全、中等范围任务
Windsurf	IDE	迭代式构建、实时协作编程会话

当任务横跨整个代码库，或者需要自主串联多个步骤时，选择 Claude Code。Cursor 更适合编辑器内的聚焦工作，让 AI 建议紧贴正在编写的代码行。Windsurf则最适合在 IDE 中反复来回迭代。三者都无法彻底替代另外两款。许多开发者使用 Claude Code 处理繁重的架构工作，同时保留 Cursor 完成日常行内编辑。

价格与套餐：Pro、Max 和 API 选项

Claude Code 有三种计费路径，选错之后费用会迅速增加。

套餐	费用	最适合的用户
Pro	每月 20 美元	轻度用户、偶尔使用
Max（5x）	每月 100 美元	经常每天使用
Max（20x）	每月 200 美元	重度多实例工作流
API（按量付费）	每天约 6–12 美元	用量不可预测或集中爆发

多数在职开发者使用 Sonnet 4.6 时，每月支出约为 100 到 200 美元。稳定地每天使用 API，费用大约为每月 130 到 260 美元；如果并行运行多个智能体，费用还会快速上升。

只要开始每天持续使用 Claude Code，订阅通常就比 API 计费划算。如果只是偶尔使用，按量付费可以让成本与实际用量保持一致。

用 Willow 向 Claude Code 说出提示词

在多数 AI 编程工作流中，向 Claude Code 输入详细提示词是最慢的环节。把提示词说出来能快四倍：每分钟约 150 个英文单词，而打字只有 40 个。每次会话都会继续放大这种差距。

Willow 是一款语音听写工具，专门为此类场景打造。它会逐渐学习你的写作方式，成为最适合你个人的听写工具。按下快捷键，直接说出提示词，它会以 200 毫秒延迟完成转写。文章称它是目前速度最快的听写工具，可以让人保持心流，而不必等待文字跟上思维。面向企业团队，Willow 提供 SOC 2 和 HIPAA 合规能力，以及共享快捷短语、词典词条等协作功能。说话时，人们会自然提供更多上下文，包括为什么重构、需要处理哪些边界情况，以及方案必须遵守什么约束。Claude Code 因而获得更丰富的提示词，也更可能一次给出更好的结果。

提示词的质量决定输出的质量。打字迫使你压缩思路，讲话则让你完整表达。

财富 500 强企业中有 20% 的公司存在使用 Willow 向 Cursor、Windsurf 等 AI 工具输入提示词的开发者。可前往 willowvoice.com 试用。

常见问题

如何在 Windows 上免费安装 Claude Code

以管理员身份在 PowerShell 中运行 irm https://claude.ai/install.ps1；如果已经安装 Node.js，也可以执行 npm install -g @anthropic-ai/claude-code。两种方法都免费，并支持 Windows 10 和 Windows 11。

Claude Code 终端与 VS Code 扩展有什么区别

终端 CLI 提供完整的智能体能力：Claude 可以读取整个代码库、运行命令并自主串联多个步骤。VS Code 扩展更接近 Copilot，提供行内建议和侧边栏入口，但无法执行终端版本所擅长的同等深度工作流。

向 Claude Code 输入提示词的最快方式是什么

说出提示词比打字快约三倍：每分钟 150 个英文单词，而打字约为 40 个。语音还能让你自然地补充更多上下文，例如重构原因、边界情况和约束。Claude 获得更丰富的提示词后，更容易第一次就给出更好的结果。

高效使用 Claude Code 的最后建议

这份 Claude Code 教程介绍了核心基础，但真正的收益取决于你如何表达提示词。Claude Code 会承担繁重工作，让你专注于架构和逻辑。尽早建立 CLAUDE.md，选择与信任程度相匹配的控制模式，并交给它目标具体、约束明确的任务。配合 Willow 说出提示词，而不是逐字输入，可以更快地把想法变成第一次就能工作的代码。使用得越多，你也会越擅长以能够得到结果的方式描述问题。