这篇写给两类人：听说过 Claude Code，但还没装；或者装了，打开终端看到输入框，不知道第一句该说什么。
不用先读完十二篇正篇再来。下面是一条 30 分钟的直线：装（10 分钟）、登录（5 分钟）、第一次对话（10 分钟）、把 Git 交给它（5 分钟）。走完你会得到一个能干活的环境。
先搞清楚你在装什么
Claude Code 不是又一个聊天窗口。它装在终端里，直接在你的项目目录里干活：读文件、改代码、跑命令、提交 Git。所以它必须装在你写代码的那台机器上，并且要在项目目录里启动——这一点没做到，后面全是坑。
两个前提，缺一不可：
- 一个可用的账号：Claude 订阅（Pro / Max / Team / Enterprise），或者 Claude Console 的 API 账号。注意 claude.ai 的免费版不包含 Claude Code，这是新手最常见的误解；
- 身处 Anthropic 的支持地区。中国大陆目前不在支持地区名单内，出口 IP 改变不了这条要求——具体边界和处理方式写在番外《Claude 封号自救指南》里。
第 0–10 分钟：装
官方现在主推的是原生安装，一条命令，不需要预先装 Node.js。按你的系统选一条：
macOS、Linux、WSL：
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell：
irm https://claude.ai/install.ps1 | iexWindows CMD：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd几个实际会遇到的细节：
- 安装过程没有进度条，看起来像卡住了，其实在下载，等它结束。
- 装完开一个新终端窗口，运行
claude --version。正常会打印版本号，后面跟着(Claude Code)。 - 提示“找不到命令”，通常是安装目录还没进 PATH，官方故障排查页有对应步骤，照做即可；其他异常可以先跑
claude doctor，它会只读打印安装和配置诊断。 - Windows 原生环境建议装 Git for Windows：官方说明，没有它 Claude Code 会用 PowerShell 当 shell 工具，有它才能用 Bash 工具。
想用包管理器也行，官方给了两个备选：
| 方式 | 命令 | 更新 |
|---|---|---|
| Homebrew（macOS） | brew install --cask claude-code |
不自动更新，需 brew upgrade |
| WinGet（Windows） | winget install Anthropic.ClaudeCode |
不自动更新，需 winget upgrade |
Homebrew 有两个 cask：claude-code 跟稳定通道（通常比最新版晚一周左右，跳过有重大回归的版本），claude-code@latest 跟最新通道。原生安装则在后台自动更新。
网上很多教程让你先装 Node.js，再 npm install -g 全局安装。那条路官方仍然支持，但现在要求 Node.js 22 以上；原生安装更短，也不用额外维护 Node 环境——新手没必要绕远。
第 10–15 分钟：登录
第一次运行 claude，它会引导你登录。可用的账号类型官方列了几种，新手只需要分清前两种：
- Claude 订阅（Pro / Max / Team / Enterprise）：按月付费，Claude Code 使用包含在订阅额度里。有订阅就选这个。
- Claude Console（API）：预充值、按用量扣费，适合团队或需要精细控制成本的场景。
- 企业用户还可能走 Bedrock、Vertex AI、Foundry 或公司自建网关，按管理员给的说明接。
浏览器会弹出授权页，登录并确认后回到终端，就完成了。凭据会保存，下次不用再登。
两个容易踩的点：
- 如果你的环境里设过
ANTHROPIC_API_KEY环境变量，并且你在弹窗里同意使用它，Claude Code 会跳过登录，直接按这把 Key 计费。不知道自己有这把 Key 的人，先别设。 - 想换账号或重新认证，在会话里输入
/login。
第 15–25 分钟：第一次对话
先 cd 到项目，再启动。 这一条最容易被跳过，也最影响结果：
cd /path/to/your/project
claude启动后你会看到版本、当前模型和工作目录。第一句先别急着让它改代码，让它读——官方的入门建议就是先理解项目：
这个项目是做什么的？也可以用官方给的另外两句：
这个项目用了哪些技术？
解释一下目录结构它会自己去读相关文件，不需要你手动喂上下文。等你确认它理解得差不多，再让它做一个小改动：
在入口文件里加一个 hello world 函数第一次看到权限弹窗很正常——它在问“这个动作允许吗”。这里就是新手最该花两分钟理解的东西：Shift+Tab 是权限模式的换挡杆。
三档的用法，一句话版：
- default：名单之外的每个动作都问你。新手停在这里。
- acceptEdits：工作目录内的文件编辑免确认，写代码最顺手。你已经信任它在这个项目里改文件时切过去。
- plan：只读探索，连编辑权限都会被压住。要动大手术之前，先在 plan 里让它把方案讲清楚。
还有自动模式和一档跳过全部检查的 bypassPermissions，第 7 篇讲过细节；前 30 分钟里，知道前三档就够了。
会话里还有两个命令值得马上记住：/help 看当前可用的命令，/clear 清空对话重新开始（新任务开新会话，别在旧对话里越滚越长）。
顺手记几个快捷键：输入 / 看命令列表，Tab 补全，↑ 调历史，Shift+Tab 换权限模式。这些够你用一阵了。
第 25–30 分钟：把 Git 交给它
Claude Code 把 Git 操作变成了对话：
我改了哪些文件？
用一句话总结帮我提交也可以让它做更复杂的：开分支、看最近五次提交、帮着解冲突。建议保留一个习惯：提交前自己看一眼 diff。它写得对不对，最终是你签字。
最后记几个终端入口，比会话内命令更常用：
| 命令 | 作用 |
|---|---|
claude |
启动交互式会话 |
claude "任务" |
带着第一句提示启动 |
claude -p "问题" |
问一句就退出，适合脚本 |
claude -c |
继续当前目录最近一次对话 |
claude -r |
挑一个历史会话恢复 |
新手最常踩的三个坑
坑一：在错误的目录启动。 在主目录敲 claude，它会去读一堆和项目无关的文件，回答也会跑偏。先 cd 到项目根目录，再启动。
坑二：一上来就让它大改。 “把这个项目重构成微服务”这种开场，它会给你一个你无法验收的结果。先让它读，再让它小步改，每步都能验证。
坑三：一路按 yes。 不知道自己按的是什么权限、也不知道 Shift+Tab 能换挡，是新手最常见的安全隐患。花两分钟把上面三档搞清楚，比装十个插件都值。
30 分钟之后
你现在有了一个能干活的环境。接下来怎么走，按这个顺序最省力：
- 第 1 篇《认知开篇》——把“聊天机器人”和“终端里的 agent”这个认知差补齐，后面所有内容都建立在这上面；
- 第 2 篇《CLAUDE.md 与记忆系统》——让它记住你的项目规矩，这是回报率最高的十分钟；
- 第 8 篇《上下文管理》——会话变长后不至于越用越笨；
- 其余篇章按你当下的痛点取用，或者直接翻收官篇的 83 条速查表。
本文是《从 Vibe Coding 到 Agentic Engineering》系列的番外。正篇十二篇已收官，从第 1 篇读起，或直达第 12 篇。