Claude Code 教程:从安装到第一个应用(2026 图文版)

Claude Code 是 Anthropic 推出的终端 AI 编程代理:用自然语言描述需求,它会自己规划、写代码、改 bug。这篇 Claude Code 新手教程把 Kevin Stratvert 的 15 分钟入门视频整理成 16 步图文攻略,每一步都配截图,并能回跳到视频里的对应时间点。 你会完整走一遍视频演示的工作流:用 npm 安装 Claude Code、在 VS Code 的 terminal 里启动、写出分条列点的需求清单而不是一句模糊愿望,再用 Shift+Tab 切到 plan mode,让 Claude 先提问(技术栈、存储、登录方式)再动手。然后看它从零搭出一个完整的 Office Chore Manager 应用:回答澄清问题、审阅实施计划、批准 npm install、用真实数据测试日历界面,并养成早提交的习惯,一条糟糕的 prompt 最多损失一次回滚。 后半部分讲的是拉开差距的习惯:用 CLAUDE.md 给 Claude 装上项目记忆——以及为什么结构化 prompt 比 /init 更好用;再用一句话 bug 报告验证记忆是否生效;最后在真实项目里谨慎开启 YOLO 模式(--dangerously-skip-permissions),做一个跨标签页实时同步的功能,用两个并排联动的浏览器窗口验收。16 步,一步一图,所有细节都来自视频本身。

来源与致谢

本教程的截图来自 Kevin Stratvert 的公开演示视频。每个步骤都链接到视频中的对应时间点,方便你对照学习。

Kevin Stratvert ↗

先把 Claude Code 装起来

  1. 1

    打开 Claude Code 官网,复制安装命令

    Claude Code 的官方页面(claude.com/claude-code)直接给出可复制的安装命令:Mac 用 bash 一行命令,Windows 用 PowerShell(irm https://claude.ai/install.ps1 | iex)。视频作者用脚本时踩了坑,所以下一步改走他更推荐的 npm 安装。两条路二选一即可。

    Claude Code 官网页面,Built for tinkerers 标题下展示可一键复制的 irm claude.ai/install.ps1 PowerShell 安装命令
    官网首页:原生安装命令,点一下就能复制。视频 0:40 处
  2. 2

    先装 Node.js,再用 npm 安装 Claude Code

    如果原生脚本不顺利,先去 nodejs.org 装 Node.js,用 node -v 确认版本。接着运行 npm install -g @anthropic-ai/claude-code,看到“added 1 package in 1s”就说明装好了,任何终端里从此都有 claude 命令可用。

    Windows PowerShell 终端先后显示 node -v 返回 v24.12.0、npm install -g @anthropic-ai/claude-code 完成并提示 added 1 package in 1s
    npm 安装路线:验证 Node,再全局安装 claude-code 包。视频 1:12 处
  3. 3

    在 VS Code 的 terminal 里启动 Claude Code

    在任意终端输入 claude 就能启动,但作者的习惯是放进 VS Code:打开集成终端,在下拉菜单里选 Command Prompt,输入 claude 回车,按 1 信任当前目录。欢迎框里会出现“Run /init to create a CLAUDE.md”这类入门提示。

    VS Code 集成终端里运行 Claude Code,显示 v2 欢迎框和 Tips for getting started 入门提示面板
    Claude Code 跑在 VS Code 终端里,等待第一条 prompt。视频 2:30 处

像工程师一样交代需求,在 plan mode 里开工

  1. 4

    写一份分条列点的需求清单,别写一句模糊愿望

    别只写“帮我做个应用”。把硬性需求逐条列出:类似 Outlook 的日历视图、增删家务、按周期循环、指派给团队成员……结尾再加一句“Ask me questions to clarify the product requirements, technical requirements, engineering principles, and hard constraints”。用 Alt+Enter(Mac 是 Option+Enter)换行,不会误发送。

    Claude Code 输入框中列出办公室家务应用的逐条需求,并要求 Claude 先提问澄清再开始写代码
    视频里的完整 brief:五条需求加一句“先问我问题”。视频 2:56 处
  2. 5

    动手之前,先切到 plan mode

    按住 Shift 连按 Tab,直到输入框下方出现“plan mode on (shift+tab to cycle)”。plan mode 下 Claude 不会自动写代码:它先分析项目、跟你确认方案,第一步就走在正轨上。

    Claude Code 输入区下方高亮显示 plan mode on (shift+tab to cycle) 指示条,上方是已输入的项目需求
    plan mode 指示条:Claude 会先规划、先商量。视频 3:16 处
  3. 6

    回答 Claude 的澄清问题

    Claude 会抛出一份问卷,顶部有 Tech Stack、Data Storage、Authentication、Extra Features 几个标签页。用数字键选答案(比如 React 应用、无需登录),Tab 或方向键切题,全部确认后选 Submit。视频经验:这里答得越细,后面的计划越靠谱。

    Claude Code plan mode 问卷界面,显示 Tech Stack、Data Storage、Authentication、Extra Features 标签页和关于用户认证的数字选项
    plan mode 的问卷向导:选选项、切标签、提交。视频 3:48 处

生成、测试并提交你的第一个应用

  1. 7

    逐段审阅它交回的实施计划

    Claude 会给出完整的实施计划:技术栈(React 18 + Vite、TypeScript、状态管理、date-fns)、数据模型,以及标注好用途的组件文件树。重点盯它自作主张的部分——视频里作者就发现计划混进了 Vite、Tailwind 和 JavaScript,当场要求改回 TypeScript。

    Claude Code 为 Office Chore Management 应用生成的实施计划,展示带注释的组件文件树和实施步骤列表
    计划的“项目结构”一节:每个要创建的文件都写了用途。视频 4:44 处
  2. 8

    该批的工具调用就批,也可以设为不再询问

    执行 npm install 这类命令前,Claude 会问“Do you want to proceed?”,给出三个选项:同意;同意且不再为 npm install 命令询问;拒绝并告诉它该怎么做。作者对安全、常规的工具选第二项,让构建过程不被反复打断。

    Claude Code 权限确认框,询问是否继续运行 npm install,并列出三个数字批准选项
    npm install 审批:选 2 可放行后续的 npm 安装命令。视频 6:04 处
  3. 9

    用真实数据测试刚生成的应用

    编辑自动批准后,Claude 会把整个应用搭完。开发服务器建议自己在另一个终端里跑(npm run dev),然后实际点一遍 UI:添加团队成员,再建一条 Kitchen 分类、指派给 Kevin、每周循环的“Bake Cookies”家务,看它是否如约出现在周视图里。

    Office Chore Manager 的 Add Chore 弹窗,填有 Bake Cookies、Kitchen 分类、指派给 Kevin,并勾选 Recurring chore 复选框
    实测生成结果:一条会循环的家务指派。视频 6:56 处
  4. 10

    早提交、勤提交,随时能回滚

    每多写一条 prompt,就多一分引入回归的风险,所以好的状态要立刻提交。在 VS Code 的 Source Control 面板里暂存文件、填写提交信息、点 Commit 或 Publish Branch。记得一直在分支上工作,回滚到上一个可用状态只需一条命令。

    VS Code Source Control 面板显示 chore-app 已暂存文件、提交信息输入框和 Publish Branch 按钮,旁边终端里 Vite 开发服务器已启动
    安全网:继续迭代之前,先把能用的版本提交。视频 7:44 处

用 CLAUDE.md 给 Claude 装上项目记忆

  1. 11

    先搞懂 CLAUDE.md 为什么重要

    CLAUDE.md 的内容会注入每一次 Claude Code 会话:技术栈、每个组件的用途、你希望它的工作方式(跑测试、类型检查、先建分支)。视频引用的 Humanlayer 文章把它拆成 WHAT、WHY、HOW 三层,写的时候照着分层填即可。

    标题为 CLAUDE.md onboards Claude to your codebase 的博客文章,列出 WHAT、WHY、HOW 三层写作建议
    这套做法的出处:给每次会话准备的三层上下文。视频 8:44 处
  2. 12

    用 /init 或结构化 prompt 生成 CLAUDE.md

    最快的办法是输入 /init(Initialize a new CLAUDE.md file with codebase documentation),斜杠菜单会自动补全。但作者认为 /init 的产出太薄,更推荐粘贴一段覆盖 what/why/how 和渐进式披露原则的 prompt,让 CLAUDE.md 用索引指向更多 markdown 文件。

    VS Code 里 Claude Code 的斜杠命令菜单,init 选项高亮,说明为初始化新的 CLAUDE.md 文件
    输入 / 即可唤出 /init 和全部斜杠命令。视频 9:26 处
  3. 13

    用一句话 bug 报告验证记忆生效

    重启 Claude 后只描述现象:点日历添加家务时,时间对不上单元格。因为有了 CLAUDE.md,它已经认识这套技术栈,会先建修复分支再动手,最后给出根因分析——toISOString 把时间转成了 UTC,而输入框要本地时间——并列出所有改动的文件。

    Claude Code 的 bug 修复摘要,说明 ChoreForm.tsx 中 UTC 时区导致的根因,以及在 dateUtils 中新增 formatDateTimeLocal 辅助函数
    修复完成后 Claude 贴出的摘要:改了什么、为什么。视频 11:16 处

YOLO 模式提速,实战实时同步

  1. 14

    弄清 YOLO 模式的代价再打开

    用 --dangerously-skip-permissions 启动 claude(俗称 YOLO 模式),Claude 不再请求任何批准,命令直接执行。Claude Code 会先给出红色警告,要求你确认承担全部责任。作者的用法:在已经提交过的项目里、追求速度时才开,平时用 Shift+Tab 按会话切换。

    Claude Code 的 Bypass Permissions 模式红色警告界面,要求选择 Yes I accept 确认继续
    开启 YOLO 模式前必须接受的责任警告。视频 12:24 处
  2. 15

    大的架构改动,让 Claude 给出三个方案

    比如“家务变动要实时同步到其他标签页”这种大改动,作者回到 plan mode,要求 Claude 先读相关文件、给出三个方案。结果:LocalStorage events、BroadcastChannel API、WebSocket 后端,各附一句取舍说明。要方案再拍板,就是把普通 LLM 的 prompt 技巧用在写代码上。

    Claude Code plan mode 的选择题界面,列出 LocalStorage events、BroadcastChannel API、WebSocket backend 三种实时同步方案及取舍
    三个同步方案各有代价,视频最终选了 WebSocket。视频 13:08 处
  3. 16

    开两个浏览器窗口验收实时同步

    几分钟后 Claude 写完了 WebSocket 服务器。验收方式很直观:并排放两个浏览器窗口,在一边添加团队成员 Elizabeth 或新建“Feed the fish”家务,另一边立刻出现。剩下的,就是像对待队友的代码一样 review 它的产出。

    两个 Office Chore Manager 浏览器窗口并排显示同步后的同一张周日历,验证 WebSocket 实时更新生效
    回报时刻:一边改动,另一边秒级同步。视频 14:08 处

常见问题

继续探索