第二章 五分钟快速上手

一、动手前的 3 分钟准备

我们先确认你不会在动手之后才发现"哎呀少了什么东西"。这一节你大概花不到三分钟就能过完，但少了它，后面任何一步都可能卡住。

1.1 你需要什么

把电脑搬出来，对照下面这张表过一遍：

本章不强制你已经有 Claude 账号。装好程序后再去注册也来得及，注册流程在 第三章 里有图文版。本章会把"安装"和"登录"分两步走，确保你不会卡在某一步上。

"我电脑能不能跑"的快速自查

担心自己电脑不行的，对照下面这张表过一遍：

如果你只有手机或平板，建议直接选方式四（云服务器一键部署），云端跑 Claude Code，手机端用任何 SSH 客户端（如 Termius、JuiceSSH）连过去就能用。

1.2 不会打开"终端"怎么办

如果你过去从来没用过"终端"这个词，先记住怎么打开它。后面所有命令都是在这个黑窗口里输入的，跑一两次你就习惯了。

macOS（苹果电脑）

1. 按住键盘上的 Command（⌘）键，再按一下 空格 键。
2. 屏幕中间会弹出一个搜索框（叫 Spotlight）。
3. 输入英文 terminal，按 回车。
4. 弹出一个白色（或黑色）的窗口，光标在闪。这就是终端。

Windows 10 / 11

1. 按一下键盘左下角的 Win 键（带 Windows 标志的那颗）。
2. 直接打字 powershell。
3. 在搜索结果里点 "Windows PowerShell"，回车。
4. 弹出一个深蓝色（或黑色）的窗口。这就是终端。

强烈建议：去微软商店搜一下 "Windows Terminal"，免费下载安装一个，体验比自带 PowerShell 好很多倍（可以分屏、复制粘贴更方便、配色更好看）。本书后面 Windows 截图都用 Windows Terminal。

Linux

按 Ctrl + Alt + T 直接打开终端。或者在应用菜单里找"Terminal"或"终端"。

打开后你会看到一个有光标在闪烁的窗口，类似这样：

macOS：

cassius@MacBook-Pro ~ %

Windows PowerShell：

PS C:\Users\cassius>

Linux：

cassius@ubuntu:~$

最前面那一长串叫"提示符"，告诉你当前是哪个用户、在哪个目录。你不需要管它，光标后面才是你输入的地方。

怎么"复制粘贴一条命令"

这是本书 100% 的同学都会用到的技能，先教一遍：

1. 把鼠标移到本书的代码块上方，部分阅读器右上角会出现"复制"按钮，点一下；没有按钮就用鼠标选中代码块里的文字，按 Cmd+C（macOS）或 Ctrl+C（Windows / Linux）。
2. 切换到刚才打开的终端窗口。
3. 在终端里粘贴：
   • macOS：Cmd + V
   • Windows Terminal：Ctrl + V
   • 老版 PowerShell / cmd：右键单击空白处 即粘贴
   • Linux：Ctrl + Shift + V（注意是加 Shift，普通的 Ctrl+V 在终端里不工作）
4. 按一下 回车（Enter），等命令跑完。

命令前面如果你看到 $ 或 >，那是表示"这是一行命令"的提示符，复制时不要带这个符号。本书的代码块里已经默认去掉了，你直接复制即可。

"为什么非要用终端，不能图形界面吗"

这是几乎所有第一次接触 Claude Code 的同学都会问的问题。我直接回答：

• Claude Code 的"对话界面"本质上就是在终端里跑的图形界面——它有颜色、有边框、有滚动条、能用方向键和快捷键，体验跟微信聊天框其实没什么差别。
• 之所以不做"独立 App 窗口"，是因为 Claude Code 要随时调用你的 shell（比如跑 git、ls、mkdir），如果用独立 App 反而要写一堆胶水代码把 shell 包装进去，直接住在终端里反而更轻、更稳、更快。
• Anthropic 官方有桌面客户端 Claude Desktop，那个是给"想纯聊天"的人用的，没有 Code 那种 Agent 能力。两者是不同的产品。
• 如果你真的特别恨终端，可以用 VS Code 的 Claude Code 扩展（第八章会讲），那就是带 GUI 的版本，本质上还是套了一层皮的同一个程序。

记住一条朴素的真理：终端不可怕，可怕的是"自己手敲命令容易打错"。本书所有命令都给了"复制粘贴版"，你不需要手敲一个字符。

1.3 检查 Node.js 是否就绪

Node.js 是一个跑 JavaScript 程序的运行环境。Claude Code 的部分安装方式（比如 npm 全局安装）需要它，部分方式（原生一键脚本）不需要。

先跑这一条，确认你电脑上有没有 Node.js：

node -v

回车，你会看到三种结果：

如果你打算用本章的"原生一键脚本"安装 Claude Code，这一步可以先跳过——一键脚本完全不依赖 Node.js。但是装一个 Node 对后面有用，建议你顺手装上。

用 nvm 一步装好 Node

最省心的办法是用 nvm（Node Version Manager），它能让你随时切换 Node 版本，而且不会污染系统。

macOS / Linux：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

跑完之后关掉终端再重新开一个（让 nvm 加载到环境变量里），然后：

nvm install 20
nvm use 20

Windows：

去 nvm-windows 发布页 下载 nvm-setup.exe，双击安装，安装完打开新的 PowerShell：

nvm install 20.11.0
nvm use 20.11.0

国内镜像加速

国内直接装 Node 经常会卡在下载上，给 nvm 加镜像，速度能快十倍：

export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

如果是 Windows 版的 nvm，编辑 C:\Users\你的用户名\AppData\Roaming\nvm\settings.txt，加入两行：

node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/

然后再跑 nvm install 20，速度会快很多。

顺便把 npm 的源也换成国内镜像，后面装其他东西都会快：

npm config set registry https://registry.npmmirror.com

再次确认：

node -v
npm -v

应该看到类似：

v20.11.0
10.2.4

看到版本号，就 OK 了。

1.4 关于"科学上网"的友善提醒

我得提前打个预防针：Claude Code 是 Anthropic 出的，Anthropic 的官方域名（claude.ai、anthropic.com）在国内大多数家庭宽带和移动网络下是直接打不开的。

但是，这并不意味着你必须先翻墙才能开始。本章会区分清楚每一步对网络的要求：

最朴素的建议：

• 如果你有靠谱的代理：本章按部就班来，跑完一遍体验最完整。
• 如果你没有代理也没打算装：本章用方式三（npm + 国内镜像）装好程序，第三章选"国内中转"或"Claude Code Router"方案，完全不需要任何代理就能跑起来。
• 如果你连代理是什么都不想了解：本章只装、不登录，等读完第三章再统一处理登录。

本章下面所有步骤会标清楚"需要 / 不需要代理"。请放心。

一句话理解"代理"和"中转"的区别

新手最容易混淆这两个词，简单区分一下：

简单说：代理是"全网走海外"，中转是"只走 Anthropic 走海外"。两者能解决同一个问题（让你能用 Claude），但成本、稳定性、隐私模型都不同。

• 如果你已经常年在用 VPN 看 YouTube / 上 GitHub，那"代理"对你来说就是"现成的"。
• 如果你只是为了用 Claude Code，中转方式更划算：不用维护代理、不用担心被封、按量付费、稳定性高。

第三章会把两条路的优劣详细对比。本章你只要知道"两个名词不一样"就够了。

二、安装 Claude Code（四种方式，按场景推荐）

Claude Code 有四种安装方式，没有"哪种最好"，只有"哪种最适合你"。下面这张表先给你一个总览，对号入座：

没有特殊判断的话，直接看方式一。如果方式一在国内卡住下载不下来，跳到方式三。

一个朴素的建议：装 Claude Code 是一次性的事，不要为了"选最好"而花半小时纠结。任何一种方式装上去都能正常工作，将来想换随时能换。我个人见过最多的"卡住"，不是哪种方式不行，而是同学在四种方式之间反复横跳，结果一种都没装成。

方式一：原生安装脚本（推荐 90% 用户）

这是 Anthropic 官方主推的方式。脚本会自动检测你的系统类型、下载对应的二进制文件、放到合适的目录、加好 PATH 环境变量、并启用后台自动更新。完全不依赖 Node.js，体验最丝滑。

macOS / Linux：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell（推荐）：

irm https://claude.ai/install.ps1 | iex

Windows CMD（如果你打不开 PowerShell）：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

跑完之后，你会看到类似这样的输出：

Installing Claude Code...
✓ Detected platform: darwin-arm64
✓ Downloading claude 2.5.4...
✓ Installing to /Users/cassius/.local/bin/claude
✓ Adding /Users/cassius/.local/bin to PATH (~/.zshrc)
✓ Background updates enabled

Done! Open a new terminal and run `claude` to get started.

重点看最后两件事：

1. 它告诉你 claude 命令被装到了 ~/.local/bin/（macOS / Linux）或 %USERPROFILE%\.local\bin\（Windows）。
2. 它给你加了 PATH 环境变量，但当前窗口还没生效，要"开一个新终端"才能用。

所以关掉当前终端，再开一个新的，跳到本节最末尾的"验证安装"。

自带后台自动更新是什么意思

原生安装的最大优点是后台自动更新。它会在你每次开新终端时悄悄检查一下有没有新版本，有就静默升级，你完全不用管，永远是最新版。

如果你不想要这个行为，可以关掉：

claude config set autoUpdates false

关掉之后，要手动升级时就跑：

claude update

国内用户的 tip

如果 curl 卡在 "Downloading claude 2.5.x..." 一动不动超过 30 秒，说明你的网络访问 claude.ai 的 CDN 不畅。三个选择：

1. 挂上代理工具，再重新跑一次。
2. 换个网络（比如用手机热点）再试。
3. 跳到方式三，用 npm + 国内镜像装。

方式二：包管理器（适合熟悉 brew / winget 的用户）

如果你已经习惯了用 Homebrew（macOS）或 WinGet（Windows）管软件，可以直接装：

macOS（Homebrew）：

brew install --cask claude-code

注意是 --cask，因为 Claude Code 是个独立的命令行 App，不是函数库。

Windows（WinGet）：

winget install Anthropic.ClaudeCode

包 ID 是 Anthropic.ClaudeCode，建议照抄。

缺点：不会自动更新

包管理器装的版本不会自动更新，需要你定期手动跑：

brew upgrade --cask claude-code

或者：

winget upgrade Anthropic.ClaudeCode

如果你已经用 brew bundle 或 Brewfile 管理软件，把 claude-code 加进去即可，跟你管理其他软件一致。

小心区分：brew install claude-code（不带 --cask）会装错版本，请务必带 --cask。

方式三：npm 全局安装（前端开发者首选）

如果你已经在用 Node，且喜欢 npm 的工具链：

npm install -g @anthropic-ai/claude-code

国内加速（强烈推荐）：

npm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com

注意：包名是 @anthropic-ai/claude-code，不是 claude-code，也不是 anthropic。复制时小心别少了 @anthropic-ai/ 这个前缀，少了就装错了。

如果遇到 EACCES: permission denied 报错，千万不要加 sudo。这种报错的正确修法在本章末尾"报错 3"里讲。

为什么前端开发者选这个

• 已经有了 Node 和 npm 工具链，安装一行命令即可。
• 可以在不同 Node 版本下分别装，方便测试。
• 可以走 npmmirror 镜像，国内速度飞快。
• 升级一行命令：npm update -g @anthropic-ai/claude-code。

装错了 / 想换一种方式怎么办

很多人会担心："我先用 npm 装了，后来想换原生一键脚本，是不是要先卸载再重装？"

答案是：可以直接装新的，老的会被自然覆盖。Claude Code 的命令名都叫 claude，新版本会接管这个命令。但为了干净，建议先卸载老版本：

注意：卸载安装方式不会动你 ~/.claude/ 里的配置和登录信息。所以"换一种方式装"不会让你重新登录、重新写 CLAUDE.md。

要彻底重置回出厂状态：卸载之后再 rm -rf ~/.claude/（macOS / Linux）或 Remove-Item -Recurse -Force "$HOME\.claude"（Windows）。

方式四：云服务器一键部署（不想本机折腾）

如果你的电脑实在太老（比如 2014 年以前的机器），或者你根本不想在自己机器上折腾，可以租一台轻量云服务器，每月约 ¥20–¥50，云厂商已经做好了 Claude Code 的镜像，下单 3 分钟即可拥有一个"永远在线"的 Claude Code。

主流云厂商的现成方案：

适合谁

• 自己电脑配置太低（4GB 以下内存）。
• 经常出差，想在多台设备（家里 Mac、公司 Windows、平板）共用一份 Claude Code。
• 想让 Claude Code 24 小时跑后台任务（比如盯演唱会票、监控价格变化），本地电脑总要关机。
• 怕在本机搞坏配置，想要一个"沙箱式"的环境。

怎么用

下单后，云厂商会给你一个公网 IP 和一个 Web 终端入口（基本都带）。在 Web 终端里直接跑 claude 即可。或者用 SSH 连上去：

ssh root@你的公网IP
claude

更进阶的玩法（用 mosh 保持长连接、用 tmux 让 Claude Code 永不掉线、用 Caddy 套域名加 HTTPS Web UI）会在 第九章 自动化与定时任务 里讲。

云方案最大的优点不是"省事"，而是它真的能 24 小时不间断。本机方案晚上一关电脑就停了，云方案永远在线。

我装完之后，下一步该做什么

四种方式都装完之后，下一步流程是一样的。下面这张"装完到能跑第一个任务"对照表，帮你确认每一步都到位：

这五步走通，就完成了"安装 → 跑通"的全过程。下面接着讲。

验证安装是否成功

无论你用了哪种方式，装完都跑这两条命令：

claude --version

看到类似这样：

claude 2.5.4 (native installation)

或者：

claude 2.5.4 (npm)

只要看到版本号在 2.5.x 及以上，就说明你装对了。

紧接着，跑那条非常重要的"体检命令"：

claude doctor

它会一次性检查你电脑上所有跟 Claude Code 相关的环境，输出大致是这样的：

Claude Code Doctor 2.5.4

Environment
  ✓ Operating system: darwin 24.1.0
  ✓ Architecture: arm64
  ✓ Shell: zsh
  ✓ Terminal: iTerm.app

Installation
  ✓ Binary location: /Users/cassius/.local/bin/claude
  ✓ Version: 2.5.4 (native, auto-update enabled)
  ✓ Node.js: not required for this installation
  ✓ PATH configured correctly

Authentication
  ⚠ Not logged in. Run `claude` to start the login flow.

Network
  ✓ DNS resolution: anthropic.com
  ✓ HTTPS connectivity: https://api.anthropic.com (217 ms)

Configuration
  ✓ Config dir: /Users/cassius/.claude
  ✓ Permissions: ok
  ⚠ No CLAUDE.md found in current directory (will use defaults)

Status: OK (2 warnings, 0 errors)

重点看每一段什么意思：

只要 Status 不是 errors，剩下的 warnings 大多是"还没登录"或"还没建项目配置"，跑下去会自然消失。

如果你看到 errors，把整段输出复制下来，去本章第七节"五个新手最容易踩的报错"里对照。

体检报告里那些"推荐操作"

claude doctor 不只会告诉你"哪里有问题"，它还会在最末尾给一段"建议操作"。新手最常见的几条建议：

• "Run claude to log in"：意思是你还没登录，跑一次 claude 走登录流程。
• "Run /init to create a CLAUDE.md"：意思是当前目录没有项目说明书，你可以跑 /init 一键生成。
• "Update available: 2.5.4 → 2.5.7"：意思是有新版本，跑 claude update 升级。原生安装的话，下次开新终端会自动升级，不用管。
• "Network: anthropic.com unreachable"：网络问题，参照报错 4 解决。

养成"装完就跑一次 doctor"的习惯——它会告诉你下一步该做什么，不用自己去文档里翻。

三、首次启动：选一种登录方式

环境通了，现在要让 Claude Code "认识"你的账号。本章只给最简版，让你跑通流程；详细的对比和省钱组合在 第三章 里有满满一章。

在终端里直接输入：

claude

回车。第一次启动，Claude Code 会把整个屏幕清空，弹出一个引导式的登录界面。它会问你"用哪种方式登录"，你只有三种主路径要选：

我应该选哪种？30 秒决策树

如果懒得看上面的表格，照着下面的"是 / 否"路径走一遍，就能选出最适合你的方案：

  你在国内吗？
      │
      ├─ 否（在海外或能稳定挂代理）
      │     │
      │     ├─ 一个月用 100 次以下 → 选 B (API Key 按量付费)
      │     ├─ 一个月用 100~1000 次 → 选 A (Claude Pro $20)
      │     └─ 重度全栈使用 → 选 A (Max 5x 或 20x)
      │
      └─ 是
            │
            ├─ 我想要"全套官方体验"，能搞定代理 → 选 A
            ├─ 我能接受"用国产模型代替"，要极省钱 → 选 C (Router)
            └─ 我想要"接近官方体验"但不想折腾代理 → 选 C (国内中转)

本章如果你只是想跑通流程：直接选你能搞定的那一种即可。本章不要求你算账，不需要你纠结"哪种最划算"。算账这件事，留给第三章。

下面三种各讲一遍最朴素的"5 分钟跑通版"。

方式 A：Claude Pro / Max 订阅（推荐普通人）

前提：你有 Claude Pro / Max 账号（没注册过的话先去 https://claude.com 注册并订阅，14 天免费试用全功能可用）；你的网络能打开 claude.ai。

启动 claude 后，在登录界面选第一项 "Claude Pro / Max"。Claude Code 会自动尝试打开你电脑上的默认浏览器，弹出 Anthropic 的授权页面。同时终端里会显示：

Opening your browser to https://claude.ai/oauth/authorize?...
If your browser does not open, paste this URL manually.

Waiting for authorization...

浏览器里你会看到三步：

1. 用邮箱（或 Google 账号）登录 Claude；
2. 弹出"授权 Claude Code 访问你的账户"的页面，点 "Authorize"（授权）；
3. 弹出 "Login successful, you can close this tab" 的提示。

回到终端，会立刻接着打印：

✓ Logged in as cassius@example.com
✓ Token saved to /Users/cassius/.claude/credentials.json
✓ Subscription: Claude Pro (trial, 13 days left)

Welcome to Claude Code!

30 秒搞定。

浏览器打不开的 fallback

国内用户最常见的情况是：浏览器打不开 claude.ai。这时 Claude Code 不会卡死，它会回退到"复制 URL 自己打开"的模式：

Could not open browser automatically.
Please visit this URL on a device that can access claude.ai:

  https://claude.ai/oauth/authorize?code=AbCdEf...

After authorizing, paste the verification code here:
> _

你把这串 URL 复制到能访问 claude.ai 的设备上（手机挂 VPN、能访问的电脑），登录授权后会拿到一串验证码，粘回终端，回车，就完成了。

如果连这个 fallback 都走不通，跳到方式 C。

方式 B：Anthropic API Key（按量付费）

前提：你已经在 https://console.anthropic.com 注册了开发者账号，绑定了信用卡，并在 "API Keys" 页面创建了一个 key（一串以 sk-ant- 开头的字符串，只显示一次，复制好）。

启动 claude，在登录界面选 "API Key"，会让你粘贴：

Paste your Anthropic API key (starts with sk-ant-):
> _

把刚才复制的 key 整段粘贴进去，回车。看到：

✓ API key validated
✓ Saved to /Users/cassius/.claude/credentials.json
✓ Default model: claude-sonnet-4-5

Ready to chat.

就 OK 了。

注意：API Key 是按 token 用量计费的，每说一句话都会扣钱。建议先去 console 把"月预算上限"设成 $10 或 $20，这样不会一觉醒来欠了一千美刀。第三章会详细教怎么估账单。

方式 C：国内中转方式（设置环境变量）

前提：你已经在某个国内中转服务商那里买了一个 token（中转服务商列表第三章会给）。中转服务商会给你两样东西：

• 一个 base URL（类似 https://api.example-relay.com）
• 一个 auth token（类似 sk-xxxxxxxxxxxxxxxx）

不要在 Claude Code 里粘贴 API Key，而是在启动前设置两个环境变量，让 Claude Code 把请求转发到中转。

macOS / Linux：

打开 ~/.zshrc（如果你用 bash 就是 ~/.bashrc），在末尾加两行：

export ANTHROPIC_BASE_URL="https://api.example-relay.com"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxx"

把上面的 URL 和 token 换成你中转服务商给你的。然后让配置生效：

source ~/.zshrc

Windows PowerShell（永久生效）：

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.example-relay.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxxxxxxxxxxxxxxx", "User")

然后关掉当前 PowerShell 窗口，开一个新的，让环境变量生效。

设置完之后跑：

claude

启动时它会跳过登录界面，直接拿环境变量里的 token 去请求中转，看到 > 提示符就说明通了。

重要：ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 这两个变量名是 Claude Code 内置识别的，不要打错字、不要加引号外的空格。

中转 endpoint 长什么样

国内主流的几家中转服务商，给你的 endpoint 大致是这种格式：

https://api.<服务商域名>.com

或者带版本号：

https://api.<服务商域名>.com/v1

注意末尾——绝大多数中转服务不需要你在 URL 末尾自己加 /v1 或 /messages 之类的路径，Claude Code 会按官方协议自动拼接。如果你不确定，先按服务商文档给的填，跑通了就别动。

三种登录方式各自的"坑"

这一步如何检查"我登录成功了吗"

无论你走的是 A、B、C 哪种方式，验证登录成功的方法都一样。在终端跑：

claude doctor

看 Authentication 那一段：

Authentication
  ✓ Logged in as cassius@example.com (Pro)
  ✓ Token valid until 2026-05-20

或者：

Authentication
  ✓ Using API key (sk-ant-...***)
  ✓ Default model: claude-sonnet-4-5

或者：

Authentication
  ✓ Using ANTHROPIC_BASE_URL: https://api.example-relay.com
  ✓ Token: sk-xxx***

只要 Authentication 这一段是 ✓，就算登录成功了。

如果还是 ⚠ "Not logged in"，去本章第七节"五个新手最容易踩的报错"里对照"报错 4"。

四、了解 Claude Code 的"家"

在你跑第一个任务之前，花 30 秒认识一下 Claude Code 把"家"安在哪儿。这个文件夹很重要——备份它就备份了一切，删除它就回到出厂状态。

家的位置：

macOS 默认隐藏以 . 开头的文件夹，按 Cmd + Shift + . 显示隐藏文件。Windows 在文件资源管理器顶部"查看"菜单里勾选"隐藏的项目"。

打开这个文件夹，里面通常有这些东西：

~/.claude/
├── settings.json          # 你的全局配置（默认模型、权限、UI 偏好）
├── credentials.json       # 登录凭证（不要外传！相当于密码）
├── CLAUDE.md              # 用户级"长期记忆"（默认空的）
├── commands/              # 你自定义的斜杠命令
├── skills/                # 你装的 Skills 扩展能力
├── hooks/                 # 生命周期钩子脚本
├── projects/              # 每个项目的会话历史
├── shell-snapshots/       # 你跑过的 shell 命令快照（便于回放）
└── plugins/               # 第三方插件

每一个文件夹的具体玩法本书后面有专章讲：

一句话总结：如果你换电脑、想搬家、想给同事发一份"我的 Claude 配置"，把整个 ~/.claude/ 打包就行。换台机器解压到同样位置，体验立刻还原。

注意：换机器迁移时，credentials.json 是和你账号绑定的 token，可以一起带过去；但项目级的路径配置要按新机器的实际路径修改。

settings.json 长什么样

这是 Claude Code 的"控制面板"，一个标准的 JSON 文件。新手暂时不需要手动改它，第三章和第四章会按需要教你修改某些字段。先认识一下大致长什么样：

{
  "defaultModel": "claude-sonnet-4-5",
  "fallbackModel": "claude-haiku-4-5",
  "autoUpdates": true,
  "telemetry": false,
  "permissionMode": "ask",
  "outputStyle": "concise",
  "ui": {
    "theme": "auto",
    "showLineNumbers": true,
    "fontFamily": "Menlo"
  },
  "shortcuts": {
    "interrupt": "Esc",
    "togglePlanMode": "Shift+Tab"
  }
}

挑几个普通人最常改的字段说一下：

改 settings.json 不用手动编辑，跑 claude config set <key> <value> 即可，比如 claude config set telemetry false。

备份这个目录的傻瓜版方法

每周备份一次"家"，能在你折腾坏配置的时候 30 秒内还原。备份方法不用复杂：

macOS / Linux（一行命令打包）：

tar -czf ~/Desktop/claude-backup-$(date +%Y%m%d).tar.gz -C ~ .claude

跑完桌面会出现一个 claude-backup-20260419.tar.gz 之类的压缩包，存到网盘或移动硬盘即可。

还原时（在新机器或重装后）：

tar -xzf ~/Desktop/claude-backup-20260419.tar.gz -C ~

Windows PowerShell：

Compress-Archive -Path "$HOME\.claude" -DestinationPath "$HOME\Desktop\claude-backup-$(Get-Date -Format yyyyMMdd).zip"

或者更简单，直接把 .claude 文件夹拖到 iCloud / OneDrive / 坚果云，自动云同步。换电脑后从云盘下载回来即可。

安全提醒：credentials.json 含登录 token，不要把这个文件夹上传到公共仓库（GitHub、Gitee）或群文件。第十章会教更安全的备份方式（用 GPG 加密备份）。

五、第一个任务：让 Claude Code 帮你整理下载文件夹

到了见证奇迹的时刻。我们让 Claude Code 替你整理一下乱成一锅粥的下载文件夹。

强烈建议：第一次跑前，先在测试文件夹里验证一遍。新建一个 ~/test-downloads，里面随便扔几个不重要的文件（旧截图、PDF、安装包），让 Claude 在测试文件夹里跑通，再去对真正的下载文件夹动手。本节用 ~/Downloads 演示，你可以随时换成自己的测试目录。

步骤 1：进入下载文件夹

在终端里跑：

cd ~/Downloads

Windows PowerShell：

cd $HOME\Downloads

cd 就是 "change directory"（切换目录）的缩写。跑完之后你的提示符会变成：

cassius@MacBook-Pro Downloads %

最后那个 Downloads 表示你现在站在下载文件夹里。

步骤 2：启动 Claude Code

claude

回车。等几秒，会看到一个干净的对话窗口：

 Welcome to Claude Code v2.5.4
 Working directory: /Users/cassius/Downloads
 Model: claude-sonnet-4-5

 Tip: Type /help for commands, /quit to exit, or just ask me anything.

> _

那个闪烁的 > _ 就是输入框，跟微信聊天框完全一样。

重点：注意第二行 Working directory 显示的就是你当前所在的目录。Claude 会默认在这个目录下读写文件，所以一定要先 cd 到对的地方再启动。

步骤 3：把这段话原样复制粘贴进去

下面这段提示词是本章的核心，原样复制：

请帮我整理一下当前文件夹（也就是 ~/Downloads）。

要求：
1. 按文件类型分类：图片、视频、文档、压缩包、安装包、其他，每类一个子文件夹。
2. 超过 30 天没有访问过的文件，统一移到「归档」子文件夹。
3. 同名文件不要覆盖，加 (1)(2) 之类的后缀。
4. 整理完给我一份简短的报告：每类各多少个文件、总共节省了多少空间。

执行前请先把你的整理计划告诉我，等我说"OK"再动手。

按回车（部分终端是 Esc + Enter 换行后再回车，根据提示来）。

步骤 4：看 Claude 一步步展开

接下来的 30 到 60 秒，你会看到一行行内容滚出来。我用文字描述每个阶段（实际终端里带颜色和动画）：

第一阶段：列出文件夹内容

我先看看你的当前文件夹里有什么。

⏺ Bash(ls -la ~/Downloads | head -50)
  ⎿ total 4729864
     drwx------@ 187 cassius staff   5984 Apr 18 22:14 .
     drwx------+  53 cassius staff   1696 Apr 19 09:33 ..
     -rw-r--r--@   1 cassius staff  3.2M Mar 12 14:22 IMG_0931.HEIC
     -rw-r--r--@   1 cassius staff  1.1G Apr  2 16:08 macOS-Sequoia.dmg
     ... (省略 180+ 行)

第二阶段：识别文件类型

⏺ Glob(*.{jpg,png,heic,gif,webp})
  ⎿ Found 43 files

⏺ Glob(*.{mp4,mov,mkv,avi})
  ⎿ Found 6 files

⏺ Glob(*.{pdf,docx,xlsx,pptx,txt,md})
  ⎿ Found 71 files

⏺ Bash(find ~/Downloads -maxdepth 1 -type f -atime +30 | wc -l)
  ⎿ 68

我识别到 187 个文件，按你的规则分组如下:
  - 图片（.png .jpg .heic .gif .webp）：43 个
  - 视频（.mp4 .mov .mkv .avi）：6 个
  - 文档（.pdf .docx .xlsx .pptx .txt .md）：71 个
  - 压缩包（.zip .tar.gz .rar .7z）：22 个
  - 安装包（.dmg .pkg .exe .msi .deb .rpm）：14 个
  - 其他：31 个

  其中超过 30 天未访问：68 个，准备移到「归档」。

第三阶段：给你整理计划，问要不要执行

计划如下：
1. 在 ~/Downloads 下创建 7 个子文件夹：
   图片/ 视频/ 文档/ 压缩包/ 安装包/ 其他/ 归档/
2. 按类型 mv 每个文件到对应文件夹（同名加 (1)(2) 后缀）。
3. 把 68 个 30 天未访问的文件最终移到 归档/ 子文件夹（不再按类型分）。
4. 整理后预计释放 0 字节（mv 不删除任何文件）。

我会先 dry-run 列出所有 mv 命令给你预览，再实际执行。
是否开始？(yes / no / 让我修改计划)

第四阶段：你确认

在 > 后面输入 yes 或 y：

yes

回车。

小贴士：如果 Claude 在某一步停住等你确认，但你又想中途打断它（比如发现思路不对），随时按 Esc 键即可立刻中断。它会停下，把当前进度告诉你，然后等你下一步指令。

第五阶段：执行

你会看到一行一行 Bash(mv ...) 在屏幕上滚过：

⏺ Bash(mkdir -p 图片 视频 文档 压缩包 安装包 其他 归档)
  ⎿ (no output)

⏺ Bash(mv "IMG_0931.HEIC" "图片/IMG_0931.HEIC")
  ⎿ (no output)

⏺ Bash(mv "macOS-Sequoia.dmg" "安装包/macOS-Sequoia.dmg")
  ⎿ (no output)

... (省略 180+ 行)

整个过程通常 5 到 15 秒。

第六阶段：生成报告

✅ 整理完成。报告如下：

| 分类 | 文件数 | 总大小 |
| --- | --- | --- |
| 图片  | 43 | 268 MB |
| 视频  | 6  | 1.4 GB |
| 文档  | 71 | 312 MB |
| 压缩包 | 22 | 891 MB |
| 安装包 | 14 | 4.2 GB |
| 其他  | 31 | 156 MB |
| 归档  | 68 | 1.8 GB |
| 总计   | 255 | 9.0 GB |

操作日志已保存到 ~/Downloads/.cleanup-2026-04-19.log，
如果想撤销，告诉我"撤销刚才的整理"，我会按日志逆序还原。

恭喜，你刚刚指挥了一个 AI 员工完成了一个真实的、对你有用的任务。

中途中断与撤销

记住几个救命的快捷键，这些会让你"敢于尝试"：

Esc 是普通用户的安全网。你看到 Claude 走偏了、看到它要做你不想要的动作、或者你只是想换个思路，按一下 Esc 立刻让它停下，然后继续聊。

如果做完之后你后悔了，直接对它说：

> 撤销刚才的整理

它会读你刚才生成的日志文件，按逆序把所有 mv 操作反过来跑一遍，把文件还原到原位置。

如果它走偏了怎么办

新手最大的恐惧不是"它不会做"，而是"它做错了我不知道怎么办"。记住三个反应：

1. 第一反应：按 Esc 让它停下。不要慌、不要按 Ctrl+C 退出，只是 Esc。它会停在当前步，把进度告诉你。
2. 第二反应：纠正它。直接打字告诉它哪里错了，比如"你刚才把 PDF 当成压缩包了，请只把 .pdf 文件归到文档/，把 .zip / .tar.gz / .rar 归到压缩包/"。它会重新理解、修正。
3. 第三反应：让它撤销。如果错误已经造成（比如已经移了几个文件到错误位置），告诉它"刚才的整理有问题，请按日志撤销，然后重新规划"。它会按 mv 日志反向还原。

Claude Code 默认对所有"修改 / 删除"动作都会先告诉你计划再执行，所以"做错了"在 99% 的场景里都是可逆的。第十章会详细讲它的"三级权限"安全模型。

三个常见的"我以为它会出错但它没"

跑完上面的练习，新手常见的三个意外：

1. "它真的没删我东西吗？"——没有。它只跑了 mkdir 和 mv，本身不会删除任何文件。
2. "它怎么知道我下载文件夹的路径？"——它先读了你的环境变量 $HOME（macOS / Linux）或 %USERPROFILE%（Windows），然后拼出 Downloads 路径。
3. "它中途问我要确认了一下，是为什么？"——因为整理动作涉及"批量修改文件"，Claude Code 默认对这类操作开了"先问后做"的安全门。第十章会讲怎么把这个门打开 / 关掉。

整理完之后，再试三个任务热热身

如果"整理下载文件夹"跑通了，趁热打铁多试几个，让你对 Claude Code 的能力边界有更清晰的感觉。下面三个任务复制即用：

任务一：把桌面上所有截图按月份归档

请帮我把 ~/Desktop 下所有截图（文件名含 Screenshot、屏幕快照、CleanShot 关键词）
按"截图-YYYY-MM"分文件夹归档。
执行前请告诉我会动哪些文件，我确认后再开始。

任务二：找出我最大的 10 个文件

请帮我扫描 ~/Documents 下所有文件，
按大小排序，列出 Top 10 给我看。
不要做任何修改，只看不动。

任务三：清空所有 .DS_Store 等系统垃圾

请扫描 ~/Documents、~/Downloads、~/Desktop 三个目录，
找出所有 .DS_Store、Thumbs.db、._* 之类的系统垃圾文件。
列出文件总数和总占用空间给我看。
让我确认后，再统一删除。

跑这三个任务你会发现：Claude 总是先告诉你它要做什么，等你点头才动手。这就是它和 ChatGPT 最大的差别——它真的能动手，但默认不会乱动。

跑通这一个任务你已经超过 90% 的人

让我说一句可能听起来夸张但完全是事实的话：如果你刚才跟着这一节跑通了"整理下载文件夹"，你已经超过了 90% 听过 AI 但从没真正让 AI 替自己干过活的人。

绝大多数人对 AI 的认识停留在"打开网页 → 输入问题 → 看答案"这一步。Claude Code 让你在自己电脑上、对自己的真实文件、做出了真实的改动——这是从"消费者"变成"使用者"的关键一跳。

接下来你要做的不是"学更多功能"，而是把这种"指挥 AI 干活"的肌肉记忆养成习惯。第六章和第七章会给你 30 个生活和工作场景，每个都像今天这个一样，复制提示词就能跑。

六、给它"留一个家"——你的第一个 CLAUDE.md

跑通第一个任务，很多人就以为完事了，其实你还少做一步——告诉 Claude Code 你是谁、你的偏好是什么。否则下次再跑别的任务，它又得从零猜你想要什么。

这个"长期记忆"的载体，是一个叫 CLAUDE.md 的文件。

为什么这是最关键的一步

打个比方：你公司新来一位实习生，能力很强。但如果你每天给他派活时都不做任何说明，他每次都得从"老板姓什么、公司是做什么的、上次会议聊了什么、他自己的工作偏好"开始猜。这位实习生再聪明，效率也起不来。

而 CLAUDE.md 就是你给这位实习生写的"入职手册"。一次写好，他每次跟你工作都会先读一遍，自然就懂你了。

一个真实的对比：写没写 CLAUDE.md，差在哪儿

来看同一个任务"帮我整理本周的客户邮件"在两种情况下的差别：

没写 CLAUDE.md 时：

你：帮我整理一下本周的客户邮件，重点标出来。

Claude：好的。请问"本周"是指周一到周五还是包括周末？"客户邮件"是指收件人是客户的、还是发件人是客户的？要我用什么标准判断"重点"？是否要按客户分组？输出到哪个文件？

（它问了 5 个问题你才能开始）

写了 CLAUDE.md 之后：

你：帮我整理一下本周的客户邮件，重点标出来。

Claude：好的，按你 CLAUDE.md 里的偏好，我会：

1. 把"本周"理解为周一 0 点到现在；
2. 客户列表按你 CRM 里标记为"重要"的 12 家公司；
3. "重点"的判断标准用你之前定的"金额 > 10 万 / 关键词命中 / 直属上级抄送"三选一；
4. 输出到 ~/Documents/客户周报/2026-W16.md。

如有出入随时打断我，我现在开始扫邮件。

差别一目了然。CLAUDE.md 越完整，Claude 就越像一个"懂你的同事"，而不是一个"什么都要问的实习生"。

CLAUDE.md 一共有三层

优先级：个人级 > 项目级 > 用户级。三层会自动叠加，越具体的越优先。

写一份用户级 CLAUDE.md（强烈建议第一次就写）

打开 ~/.claude/CLAUDE.md（没有就新建一个），把下面这份模板贴进去，按自己情况改：

# 我的个人偏好（Claude 用户级记忆）

## 关于我
- 姓名：林小白
- 角色：互联网公司运营，偶尔写点 Python 脚本
- 时区：Asia/Shanghai
- 工作语言：默认中文，引用专有名词时保留英文原文

## 我的电脑
- 系统：macOS 15.1（Apple Silicon）
- 终端：iTerm + zsh
- 常用编辑器：VS Code
- 常用工具：微信、Notion、飞书、Figma、Excel
- 下载文件夹路径：~/Downloads
- 个人项目根目录：~/Documents/projects

## 工作偏好
- 凡是会修改 / 删除文件、发邮件、发消息、调外部 API、改环境变量的操作，
  请先把计划告诉我，等我确认再执行。
- 输出风格：高效但礼貌，少废话，能用表格就用表格。
- 给我建议时，最多列 3 个方案，按推荐度排序。
- 我看不太懂代码，请用"做了什么 + 为什么"的句式解释，不要逐行注释代码。

## 安全红线
- 永远不要执行 `rm -rf /` 之类的破坏性命令。
- 不要把我的 API Key、密码、Token 写进任何会上传或共享的文件。
- 接触我的微信 / 邮箱 / 飞书数据时，默认按"只读"，写入前必须二次确认。

这就是你公司给新员工的"入职手册"——而 Claude Code 是那个永远记得你写过什么的员工。

怎么知道 CLAUDE.md 生效了

回到 Claude Code 交互界面，输入：

/memory

它会列出当前会话加载到的所有"长期记忆"，你应该能看到自己写的那份用户级 CLAUDE.md 已经被读进来了：

Loaded memory:
  ✓ User memory: ~/.claude/CLAUDE.md (1.2 KB)
  ✗ Project memory: not found in current directory
  ✗ Session memory: empty

Total context: 1.2 KB

如果它没读到，重启一次 Claude Code 即可。

用 /init 一键生成项目级 CLAUDE.md

如果你想在某个项目目录里给 Claude 生成一份项目级的 CLAUDE.md（项目说明书），不用自己动手写：进入项目目录，启动 Claude Code，跑：

/init

Claude 会自动扫描这个目录，识别它是什么类型（Node 项目？Python？纯文档？Excel 资料库？），自动生成一份 CLAUDE.md 草稿，类似这样：

# 项目：我的项目

## 项目类型
纯文档与资料目录，无构建脚本。

## 目录结构
- README.md       项目说明
- 资料/           原始资料
- 输出/           处理后的文件
- 脚本/           零散自动化脚本

## 工作约定
- 输出语言：中文
- 修改 `资料/` 下任何文件前请先和我确认
- 不要执行 `rm -rf`，删除请通过移动到 `回收站/` 实现

跑完之后这个文件就在 <项目目录>/CLAUDE.md 里，你随时可以编辑。

个人级 CLAUDE.local.md：放私密配置的口袋

如果你的项目目录是一个 git 仓库（要团队协作），那么项目级 CLAUDE.md 会被 git 跟踪，所有人都能看到。但有些东西你只想自己用：

• 你自己的 API Key（千万别提交！）
• 你的本地路径（"我的下载文件夹在 D 盘"）
• 你个人的工作偏好（"我中午 12 点到 14 点不接消息"）

这些放到 <项目目录>/.claude/CLAUDE.local.md 里。Claude Code 默认会把这个文件加进项目的 .gitignore，不会被提交。

模板示例：

# 我的私密配置（不要提交到 git）

## 我的本地路径
- 工作目录：~/Documents/work/this-project
- 输出目录：~/Documents/output

## 我的工作时间
- 工作日 9:00–18:00 在线
- 中午 12:00–13:30 不接长任务
- 周末完全不在

## 我的偏好语气
- 调试时给我详细日志
- 周报这种"对外"的东西，给我端庄一点的口吻

关于 CLAUDE.md 的进阶玩法（怎么用 @import 引入子文档、怎么按场景拆 CLAUDE.md、怎么和团队共享），第四章会专门讲。

七、五个新手最容易踩的报错

下面这五个报错，占了新手所有问题的 80% 以上。每个我都给"原因 + 一行解决"。把这一节加书签，将来卡住时直接翻回来。

报错 1：command not found: claude

原因：装是装了，但命令所在的目录没加到 PATH 环境变量。

解决（macOS / Linux）：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

如果你用 bash 而不是 zsh，把 ~/.zshrc 换成 ~/.bashrc。

解决（Windows）：

先关掉所有 PowerShell 窗口，开一个新的再试 claude --version。如果还不行，按 Win + R 输入 sysdm.cpl → "高级" → "环境变量"，在用户变量 PATH 里手动加一条 %USERPROFILE%\.local\bin。

实在搞不定，最简单的办法是用方式三 npm install -g @anthropic-ai/claude-code 重装一遍，npm 会自动把 PATH 处理好。

报错 2：Node version too low. Required >=18.0.0

原因：你装了 Node，但版本太老（v16 或更低）。Claude Code 的 npm 包要求 Node 18+。

解决：用本章第 1.3 节的 nvm 方式升级：

nvm install 20
nvm use 20
nvm alias default 20

最后一条 nvm alias default 20 是把 20 设为默认版本，下次开终端就自动用它。

升级完再装一次：

npm install -g @anthropic-ai/claude-code

报错 3：EACCES: permission denied（macOS / Linux）

原因：你用 sudo npm install -g 装了 Claude Code，导致 npm 全局目录变成了 root 所有，你自己反而读不了。

解决：先把那次错误的安装清理掉：

sudo npm uninstall -g @anthropic-ai/claude-code
sudo rm -rf ~/.claude

然后正确地装一次（推荐用一键脚本，根本不需要 npm）：

curl -fsSL https://claude.ai/install.sh | bash

如果你坚持要用 npm，把 npm 全局目录改到你自己的家目录里，然后再装：

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc && source ~/.zshrc
npm install -g @anthropic-ai/claude-code

铁律：以后不要再用 sudo 装 npm 全局包，无论是 Claude Code 还是别的。所有"权限不够"的报错都来自一开始的 sudo。

报错 4：Connection timeout 或 Network error

原因：99% 的概率是国内网络无法直连 anthropic.com，少部分是公司代理拦了。

解决（先确认是不是网络）：

curl -I https://api.anthropic.com

如果这条命令也卡住或者超时，那就是网络问题。三个选择：

1. 临时挂代理：把你的代理工具开起来，然后给 Claude Code 设代理：

   export HTTPS_PROXY=http://127.0.0.1:7890
   export HTTP_PROXY=http://127.0.0.1:7890
   claude
   

   端口换成你自己的代理端口。

2. 走国内中转：参照本章第三节"方式 C"，设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 环境变量，请求会走国内中转，完全不需要代理。

3. 企业代理：跟你的运维要 HTTPS_PROXY 的地址，按上面同样的方式 export 就行。

第三章会把国内三种"能跑通"的方案一条一条讲透。

报错 5：No CLAUDE.md found

现象：跑 claude doctor 时看到：

Configuration
  ⚠ No CLAUDE.md found in current directory (will use defaults)

原因：当前目录没有项目级的 CLAUDE.md。这其实只是一个 warning，不是 error，可以忽略。

但如果你确实想让 Claude 在这个项目里有"长期记忆"，跑：

/init

它会自动扫描当前目录、生成一份 CLAUDE.md。或者你自己手写一份放到 <当前目录>/CLAUDE.md 也行。

小心区分：

• 用户级 CLAUDE.md：在 ~/.claude/CLAUDE.md，所有项目都加载。
• 项目级 CLAUDE.md：在项目根目录，只在那个项目里加载。
• 两者不冲突，会自动叠加。

报错 6 (彩蛋)：Authentication failed 或 401 Unauthorized

原因：登录凭证失效了。最常见的几种情况：

• Pro / Max 订阅的 token 默认 30 天过期，到期需要重登。
• API Key 被你在 console 里 revoke 掉了。
• 国内中转的 token 余额用完了。
• 账号被 Anthropic 风控 / 封禁。

解决：

claude logout
claude

logout 会清掉旧凭证，再跑 claude 会重新走一次登录流程。

如果是国内中转 token 余额问题，去服务商后台充值即可。

如果是被风控，看看注册邮箱有没有收到来自 Anthropic 的提醒邮件，按邮件里的指引申诉。

报错 7 (彩蛋)：Disk full 或写入失败

原因：你的硬盘空间不够了，或者 ~/.claude/projects/ 文件夹里堆了很多旧会话。

解决：先看一下 ~/.claude/ 占了多少空间：

du -sh ~/.claude/

如果超过 1GB，多半是 projects/ 里旧会话太多。可以清理：

claude /clear-history --older-than 30d

这条会清掉 30 天以前的会话历史。或者更暴力：

rm -rf ~/.claude/projects/*

把所有会话历史一次清空（不会影响 settings.json 和 CLAUDE.md）。

更全的报错对照表请看 第十一章 避坑指南。

八、你已经过关吗？自检清单

跑通本章你应该能做到下面 5 件事，请你亲手验证一下，全部打勾再翻下一章：

• 在终端运行 claude --version，看到 claude 2.5.x 之类的版本号；
• 在终端运行 claude doctor，Status 是 OK（warnings 可以有，但不能有 errors）；
• 至少完成一种登录方式（Pro 试用 / API Key / 国内中转任选其一），claude doctor 的 Authentication 段是 ✓；
• 完成"整理下载文件夹"的练习，看到了 5 到 7 步的执行过程和最终报告；
• 你的 ~/.claude/CLAUDE.md 里写了至少一段"关于我和我的偏好"。

全部打勾的恭喜你，已经迈过了 80% 普通用户的第一道门槛。可以开始读 第三章，把账单和成本聊清楚。

有任何一项卡住的，别硬刚，先去 第十一章 避坑指南 翻"报错对照表"，常见问题十有八九能找到答案。剩下的去社区提问，也很快有人回。

加分挑战（可选）

如果上面 5 项你都很轻松地过了，下面这 3 个加分项可以挑战一下，做完会让你对 Claude Code 的能力理解更深：

• 加分项 1：让 Claude 生成一份你电脑的"硬件 + 软件"快照报告（提示词参考："请扫描我的电脑，给我一份硬件配置和已安装关键软件的报告，输出 markdown 表格"）。
• 加分项 2：把本章读完后，你认为最有用的 3 个内容用自己的话写进 ~/.claude/CLAUDE.md 的"我学到的 Claude Code 技巧"小节，让 Claude 以后跟你工作时也"记得"它们。
• 加分项 3：尝试切到 Plan Mode（按 Shift + Tab），让 Claude 分析你的桌面，给一份"哪些是垃圾、哪些可归档、哪些应备份"的清单（不要让它真的动手），看看它的分析能力。

加分项不影响过关，做完 5 项你已经合格了。下一章见。

本章一图回顾

       ① 准备 (3 分钟)              ② 安装 (1 分钟)             ③ 登录 (30 秒)
   ┌───────────────────┐       ┌───────────────────┐       ┌───────────────────┐
   │ 终端能打开         │  →   │ 一键脚本 (推荐)   │  →   │ A. Pro/Max OAuth  │
   │ Node 18+ (可选)    │       │  / 包管理器       │       │ B. API Key        │
   │ 网络通畅 / 代理    │       │  / npm 全局       │       │ C. 国内中转 ENV   │
   │ ~/.claude/ 目录    │       │  / 云服务器       │       │ doctor 看 ✓ 即过  │
   └───────────────────┘       └───────────────────┘       └───────────────────┘
                                                                       │
                                                                       ↓
       ⑤ 留个家 (2 分钟)            ④ 第一个任务 (1 分钟)         核心动作
   ┌───────────────────┐       ┌───────────────────┐       ┌───────────────────┐
   │ ~/.claude/        │  ←    │ cd ~/Downloads    │  ←   │ "请帮我整理...    │
   │   CLAUDE.md       │       │ claude            │       │  执行前先告诉我"  │
   │ (个人偏好+红线)    │       │ 看 5-7 步过程     │       │ Esc 可中断        │
   │ /init 项目级      │       │ 拿到整理报告      │       │ /memory 看记忆    │
   └───────────────────┘       └───────────────────┘       └───────────────────┘
                                              │
                                              ↓
              过关 5 项打钩 → 进入 [第三章 登录与订阅，把成本压到 ¥30]

下章预告

工具能跑了，但你大概率还在用 14 天试用，或者还在为"国内怎么稳定登录"发愁。下一章 第三章 登录与订阅（如何用最少的钱跑起来） 会一次性把账单这件事讲透：

• Claude Pro / Max / Team / Enterprise 四种订阅各自适合谁，能省多少；
• 按量付费的 API Key 怎么开通、怎么估每月花多少；
• 国内三种"能跑通且最划算"的方案：直连代理、API 中转、Claude Code Router 路由；
• 一套"主大脑 + 廉价副脑"的省钱组合，让你月成本压到 ¥30 以内；
• 怎么设预算上限，不会一觉醒来发现账单上多了一千美刀。

读完第三章，你就能彻底告别试用，把 Claude Code 当成长期工具用下去。