还记得第 01 讲那个让你腿软的黑窗口吗?这一讲的主角最早就住在里面。Claude Code 是 Anthropic 官方出品的 AI 编程搭档:它能读懂你整个项目,帮你写、改、查、跑、提交,而不是只补全几行代码。现在它也不只在终端里——编辑器、桌面 App、网页上都能用。这一讲带你装好、登上、让它干第一件活。
- 你说需求,它动手
读项目、改文件、跑测试、提交
$ curl -fsSL https://claude.ai/install.sh | bash $ cd ~/my-site $ claude ✓ 第一次启动,浏览器里登录就行
一行装好,不用先装 Node.js
- 读代码
- 找原因
- 改文件
- 跑测试
- 问你要不要提交
修一个 bug,它这样走
- 大改动,先进计划模式
Shift + Tab 或 /plan:只看不改,方案对了再动手
它是什么
Claude Code = Claude 大模型 + 你的项目文件 + 能执行命令的手脚。它像一个坐在你旁边的资深开发,你说需求,它动手。
跟网页上聊天最大的不同:聊天 AI 给你一段代码让你自己贴;Claude Code 会自己去读文件、改代码、跑测试,做完再把结果给你看。它的几样招牌本事:
- 读懂整个项目——结构、依赖、各文件之间的关系,不用你一段段喂。
- 跨文件改动——一个需求牵扯五个文件,它一起改好。
- 执行命令——装依赖、跑测试、启服务,动手之前会征求你同意。
- Git 一条龙——看改动、写提交说明、开 PR。
- 能扩展——接 MCP 连外部工具,装 Skills 学新本事(实战篇会专门讲)。
选个入口
同一个 Claude Code,有好几个门。点你最顺手的那个:
- 终端
最原汁原味,功能最全。Mac 的「终端」、Windows 的 PowerShell 都行。不怕黑窗口就选它,下面的安装步骤就是给它的。
- VS Code
边看代码边聊。在 VS Code 扩展市场搜 Claude Code 安装,侧边栏直接对话,改动以对比视图展示,点接受才生效。JetBrains 系列也有插件(目前是测试版)。
- 桌面 App
不想碰命令行的首选。macOS 和 Windows 有正式版,图形界面里选文件夹就能开工,需要付费订阅。
- 网页版
电脑上什么都不装。打开 claude.ai/code,连上你的 GitHub 仓库,任务在云端跑,跑完给你改动。手机 App 里也能发起和查看。
三步装好
官方现在推荐「原生安装」:一行命令,不用先装 Node.js,装好后会自己在后台更新。以 Mac 为例:
# ① 安装(官方原生安装脚本) $ curl -fsSL https://claude.ai/install.sh | bash ✓ 安装完成 # ② 确认装好了:能显示版本号就行 $ claude --version # ③ 进入你的项目文件夹,启动 $ cd ~/my-site $ claude ? 第一次启动会打开浏览器,让你登录账号
不是 Mac?点你的系统看对应命令:
- macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash系统要求:macOS 13 以上;Ubuntu 20.04、Debian 10 以上。
- Windows
打开 PowerShell,粘贴:
irm https://claude.ai/install.ps1 | iex要求 Windows 10(1809)以上。也可以用
winget install Anthropic.ClaudeCode。- Homebrew
brew install --cask claude-code用 Homebrew 装的不会自动更新,隔段时间记得
brew upgrade。- npm(老办法)
npm install -g @anthropic-ai/claude-code这种方式需要 Node.js 22 以上,官方已经把它放进「高级选项」。新装的话,优先用上面的原生安装。
关于登录:第一次运行 claude,它会跳到浏览器让你登录。两条路二选一:
- 用 Claude 订阅登录——Pro、Max、Team、Enterprise 账号都能用,额度跟着订阅走。免费版 Claude 账号不包含 Claude Code。
- 用 API 登录——Claude Console 账号按用量计费;也可以按官方说明接第三方网关(实战篇「把模型接进任何工具」那一讲会细讲)。
进去以后想换账号,在对话框里输入 /login 就行。还没有订阅的,可以看看 Claude Pro / Max 订阅。
让它干第一件活
启动后就能用大白话交代任务了。下面演示的是一个典型过程——你说一句"修复登录接口 401 的问题,并补上单元测试",它会这样办:
> 修复登录接口返回 401 的问题,并补上单元测试 # 它先读代码和日志,再动手 ✓ 读了 auth.js、user.service.js 和最近的报错日志 ✓ 找到原因:token 过期时间的单位写错了(秒当成了毫秒) ✓ 改好了 2 个文件,新增 1 个测试文件 ✓ 跑测试:全部通过 ? 要我把这次改动提交,并写好提交说明吗?
注意它最后在问你。默认情况下,改文件、跑命令这类动作它都会先征求同意,你的代码你做主。
常用命令
在对话框里输入 / 就会弹出所有命令。新手先记住这几个:
| 命令 | 干什么 |
|---|---|
/init | 让它通读项目,生成一份 CLAUDE.md(项目说明书),以后每次都按它来 |
/plan | 进入计划模式:只看不改,先出方案,你点头了再动手 |
/model | 切换模型,难活用强的,简单活用快的 |
/clear | 清空对话,开始一个新任务 |
/compact | 把很长的对话压缩成摘要,省额度、不断片 |
/resume | 接着上次的对话继续 |
/review | 审查当前改动,挑问题 |
/usage | 看用量和额度 |
/mcp | 管理接入的外部工具(MCP) |
/help | 查看全部命令;装出问题了在终端跑 claude doctor 自检 |
还有一个快捷键值得记:Shift + Tab,在几种权限模式之间切换,计划模式也在里面。
你想让 Claude Code 先把修改方案讲清楚,确认没问题再动手改文件,应该怎么做?
- 输入
/test - 按 Shift + Tab 切到计划模式,或者输入
/plan - 在终端运行
claude login - 直接说"开始改",改坏了再说
计划模式下它只读不改,先出方案。/test 不是内置命令;claude login 也不是现在的登录方式,第一次启动会自动带你登录,进去以后用 /login。
四种权限模式
它能动你的文件、跑你的命令,所以"什么时候问你"很重要。按 Shift + Tab 在这几档之间切:
- 每步都问
最稳。改文件、跑命令前都停下来问你。刚上手、在重要项目里,就用这一档。
- 改文件不问
省点手。文件改动直接做,跑命令仍然问你。适合你已经信任它的思路、只想少点确认的时候。
- 计划模式
只看不改。先读代码、出方案,你同意了再切出去执行。大改动之前强烈建议先走一遍。
- 自动
最快。由它自己判断哪些操作可以直接做,风险高的仍会拦下来。新版默认会进这一档,第一次用的话,建议先切回"每步都问",熟了再放开。
让它记住你的规矩
每次都要重复"用中文回复、别动 config 目录、改完跑一下测试"?写进项目根目录的 CLAUDE.md,它每次开工前都会先读。最省事的办法是先跑 /init 让它起个草稿,再自己补几句:
# 项目说明 这是【一句话说清项目是干什么的】。 ## 常用命令 - 启动:【npm run dev】 - 测试:【npm test】 ## 规矩 - 回复用中文。 - 不要修改【config/ 目录】里的文件。 - 改完代码先跑测试,测试通过再告诉我结果。
这份说明书怎么写才管用,实战篇会单独讲一讲。
跟 Codex 怎么选
命令行编程助手里,官方出品、最常被拿来比较的就是 Claude Code 和下一讲的 Codex。差别主要在这几处:
| Claude Code | Codex | |
|---|---|---|
| 出品 | Anthropic | OpenAI |
| 模型 | Claude 系列 | GPT 系列 |
| 入口 | 终端、VS Code / JetBrains、桌面 App、网页、手机 | 终端、编辑器扩展、ChatGPT 桌面 App、云端 |
| 项目说明书 | CLAUDE.md | AGENTS.md |
| 登录 | Claude 订阅或 API | ChatGPT 账号或 API |
两个都好用,没有绝对的谁强谁弱。手上已经有哪家的订阅,就先用哪家;碰到一家搞不定的活,换另一家试试,常有惊喜。
课后动手
- 按你的系统装好 Claude Code,跑
claude --version能看到版本号。 - 新建一个空文件夹,进去启动
claude,让它"做一个显示今天日期的网页"。 - 在这个文件夹里跑一次
/init,看看它生成的 CLAUDE.md。 - 按 Shift + Tab 切到计划模式,让它"给这个页面加一个深色模式",先看方案再动手。
描述越清楚,结果越准;一次只交代一件事;大改动先规划再执行;动手前先用 Git 存一份。