新手图文教程
Claude Code 新手教程
从安装到交付：Claude Code 的每一步都以截图呈现，并附来源视频的精确时间戳回链。
共 15 步的图文教程，阅读约 5 分钟。每一步都可回跳到来源视频中的精确时刻。
速览
一条命令（或 npm）安装 Claude Code，用 Claude 订阅登录，在 VS Code 里打开它，然后在 plan 模式下起草第一个应用——让 Claude 在写代码之前先向你提问。用 /init 把项目规则写进 CLAUDE.md，尽早提交以便回滚，等你信任这套流程后再考虑绕过权限模式。下面是完整的逐步截图。
关于来源视频
本教程整理自 Kevin Stratvert 的新手教学视频，每一步都附有视频的精确时间戳，方便对照原片。
截图取自视频并署名原作者；文字部分为本站原创。步骤已于 2026 年 9 月对照视频核实。
安装 Claude Code 并登录
终端里一条命令装好 CLI，浏览器登录一次连接订阅。
- 1
打开安装页，复制脚本
在 Claude Code 主页点击复制按钮拿到安装脚本，在终端里运行。Windows 用户对应的是 PowerShell 版本——如果脚本装不顺，下面的 npm 方式是最稳妥的备选。
安装命令就挂在主页上，另有 Terminal 和 IDE 标签页。视频 0:22 处 - 2
确认已安装 Node.js
npm 安装方式依赖 Node。不确定是否装过的话，先去 nodejs.org 下载安装包，然后用 node -v 验证——能打印出版本号即可。
node -v 会打印已安装的版本，较新版本都可以。视频 1:00 处 - 3
运行 claude 并连接账号
输入 claude 回车。先选一个文字主题，再选择登录方式——Claude 订阅（Pro、Max、Team）或按 API 用量计费的 Anthropic Console 账号。浏览器授权完成后就会看到欢迎界面。
订阅或 Console：看到欢迎界面就说明已连接。视频 1:22 处 - 4
在 VS Code 里打开 Claude Code
纯终端也能用，但编辑器集成才是它的主场：在 VS Code 里打开项目，新建终端，输入 claude，按 1 信任当前目录。从此 Claude 能看到你打开的文件和改动。
同一个 CLI，但开始与编辑器共享上下文。视频 2:30 处
在 plan 模式下做第一个应用
让 Claude 在动手写代码之前先「面试」你。
- 5
用要点列表写需求，别只写一句话
模糊的提示词只能得到模糊的应用。把真实需求列成要点，再加上一句「ask me questions to clarify the requirements, engineering principles, hard constraints」，然后按住 Shift+Tab 直到页脚显示 plan mode。plan 模式下 Claude 只做调研和提问，不写代码。
要点式需求 + 主动提问技巧，在 plan 模式下使用。视频 3:28 处 - 6
回答 Claude 的澄清问题
plan 模式会返回带编号的问题——技术栈、存储、附加功能。用数字键作答，用左右方向键在问题间切换，回车提交。这轮问答正是把模糊想法变成可实施规格的关键。
React + Vite、本地存储——每个选择只需按一个键。视频 3:46 处 - 7
审阅实施计划
Claude 会产出一份计划：概述、关键功能、技术栈、数据模型、项目结构、实施步骤。逐条检查你不同意的决策——演示里就抓到了该用 TypeScript 却计划用 JavaScript 的地方。选择反馈选项，Claude 会重写计划。
数据模型、文件结构、分阶段步骤——写代码之前都能改。视频 4:42 处 - 8
批准计划并选择编辑模式
选项 1 自动接受所有改动，选项 2 逐文件确认。第一次用选手动批准更稳，但很快就会烦——只要坚持尽早提交、频繁提交，「自动接受 + git 分支」才是可持续的中间态。
自动接受还是逐个批准，由你决定。视频 5:35 处 - 9
在 Claude 执行命令时逐一审批
默认情况下 Claude 执行任何命令前都会询问：安装、构建、开发服务器。对可信的包安装，选第 2 项「在此文件夹中不再询问 npm install 命令」是合理默认。视频作者本人仍喜欢自己在另一个终端启动开发服务器。
逐条审批命令，也可以按文件夹设置「不再询问」。视频 6:05 处 - 10
实测它生成的应用
演示构建的是一个办公室家务管理应用：日历视图、团队成员、周期性家务。把真实 UI 点一遍——加一条家务、设为每周重复、看周视图。小 bug 往往就是在这里被发现的。
一个能跑的日历应用，接下来就该抓几个小 bug 了。视频 7:00 处
用 CLAUDE.md 给 Claude 做项目培训
一个文件，每次会话自动加载，教会 Claude 你的项目。
- 11
理解 CLAUDE.md 的三个层次
CLAUDE.md 会被注入每一次 Claude 会话，所以只放普遍适用的指令。三个层次：WHAT（技术栈、项目结构、关键文件）、WHY（每个组件的用途）、HOW（你希望 Claude 的工作方式——比如每次改动后跑测试）。
WHAT、WHY、HOW——每个 CLAUDE.md 都需要的三个层次。视频 8:42 处 - 12
用 /init 生成（再手动完善）
/init 会自动从代码库生成 CLAUDE.md。视频的诚实结论是：它默认给不出三层次结构，所以最好粘贴一段提示词，要求按 what/why/how 组织并使用渐进式披露——用索引指向更深入的 markdown 文件。
/init 几秒钟就能给出一份初始 CLAUDE.md。视频 9:20 处 - 13
添加团队规则——比如「先建分支」
像编辑普通文档一样修改生成的文件。演示里加了一行：开发新功能或修 bug 前先创建 git 分支。从此 Claude 会主动建分支——在让它自动接受改动之前，这正是你想要的保障。
新增的一条规则：功能和修复一律从分支开始。视频 10:42 处
提速，但要安全
绕过权限换速度，用 git 兜底。
- 14
搞懂 bypass permissions 是什么
用 claude --dangerously-skip-permissions 启动后，Claude 执行命令不再询问。视频的说法很实在：风险真实存在，但对可信的流程来说速度值得。不加这个参数也可以用 Shift+Tab 切换模式。
红色警告是真的——想清楚你在批准什么。视频 12:28 处 - 15
交付一次真正的架构改动
压轴演示：让家务在多个标签页之间实时同步。Claude 先探索、再给出三套方案（轮询、WebSocket、BroadcastChannel），然后在绕过模式开启的状态下无人值守地写出 WebSocket 服务器。两个浏览器并排验证同步生效——这就是 explore、plan、code、commit 循环的回报。
两个浏览器、同一份家务清单，改动同时出现。视频 14:06 处