Claude Code 安装保姆级教程：Win / Mac 全流程，从下载到跑出第一行响应

"很多人卡在第一步——不是 Claude Code 难，是没遇到一份说人话的安装教程。这篇，照着抄就行。"

一、安装前，先搞懂一件事：它靠什么"连上网"

Claude Code 本体只是一个跑在你电脑上的命令行程序。它要能干活，必须连上背后的大模型。这个过程靠三个关键配置：

💡 用官方订阅的话，登录一下就行，这三项自动配好。用国内直连 / 中转服务的话，需要手动把这三项填进环境变量——这也是本篇的重头戏。

三个对应的环境变量名（记牢，后面要填）：

ANTHROPIC_BASE_URL      ← 填中转地址（你的直连站会给你）ANTHROPIC_AUTH_TOKEN    ← 填你的密钥（sk- 开头那串）ANTHROPIC_MODEL         ← 填模型名（如 claude-sonnet-4-6，可选）

好，原理清楚后，开干。

二、Mac 系统安装全流程

Mac 是 Claude Code 最顺手的平台，三步搞定。

第 1 步：装 Node.js（已装可跳过）

Claude Code 需要 Node.js 18 及以上。打开"终端"，输入：

node -v

• • 如果显示 v18.x.x 或更高 → ✅ 已就绪，跳到第 2 步
• • 如果提示 command not found → 需要安装

推荐用 Homebrew 装 Node：

# 没装 Homebrew 的先装它/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"# 再装 Nodebrew install node

第 2 步：安装 Claude Code

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

⚠️ 注意：不要加 sudo。加了反而容易权限错乱。

装完验证一下：

claude --version

能显示版本号，说明安装成功 ✅

第 3 步：配置环境变量（用中转服务才需要）

打开（或创建）你的 shell 配置文件：

# 用 zsh（Mac 默认）的话nano ~/.zshrc

在文件末尾加上三行：

export ANTHROPIC_BASE_URL="你的中转地址"export ANTHROPIC_AUTH_TOKEN="你的密钥"export ANTHROPIC_MODEL="claude-sonnet-4-6"

保存退出后，让配置生效：

source ~/.zshrc

Mac 安装，到此结束。 🎉

三、Windows 系统安装全流程

Windows 稍微多两步，但跟着做也不会翻车。这里给两种方法，二选一。

方法 1（推荐）：Node.js + npm 安装

① 安装 Node.js

去官网 https://nodejs.org 下载 LTS 版本（左边那个大按钮），一路 Next 装完。

装完打开 PowerShell 验证：

node -vnpm -v

两个都能显示版本号即可。

② 安装 Claude Code

在 PowerShell 里输入：

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

③ 配置系统变量（关键，注意是"系统变量"不是"用户变量"）

这一步很多人踩坑。按这个路径操作：

右键"此电脑" → 属性 → 高级系统设置 → 环境变量→ 在下方"系统变量"区域 → 新建

新建三个系统变量：

⚠️ 为什么要建在"系统变量"而不是"用户变量"？ 因为 Claude Code 读取配置时，系统变量的优先级和覆盖性更稳，能避免"明明填了却读不到"的玄学问题。全部建在系统变量里，一劳永逸。

建完后，关掉所有终端窗口再重新打开（不重启终端，新变量不会生效）。

方法 2：用 Git Bash

如果你更习惯类 Linux 的命令行体验，推荐装 Git for Windows（自带 Git Bash）。

• • 下载地址：https://git-scm.com/download/win
• • 装完后，环境变量的写法和 Mac 一样，编辑 ~/.bashrc：

export ANTHROPIC_BASE_URL="你的中转地址"export ANTHROPIC_AUTH_TOKEN="你的密钥"export ANTHROPIC_MODEL="claude-sonnet-4-6"

然后 source ~/.bashrc 生效。

💡 怎么把 Git Bash 配到 Windows 自带终端里？打开"终端" → 设置（下拉箭头）→ 新建配置文件 → 命令行填 bash 或 Git Bash 的路径 → 设为默认。以后开终端就是 Git Bash。

四、在 VSCode / Cursor 里用 Claude Code

很多人喜欢在编辑器里直接调 Claude Code，边写边问。配置超简单：

1. 1. 打开 VSCode / Cursor
2. 2. 打开内置终端（快捷键 Ctrl + `）
3. 3. 把终端切换成 Git Bash（下拉箭头选默认配置文件）
4. 4. 在终端里直接敲 claude，就能用了

进阶技巧：运行 Claude Code 的"自动模式"

日常用 Claude Code，它每改一个文件、每跑一条命令都会停下来问你"确认吗？"——任务一多就很烦。

"自动模式"就是让它自动接受这些操作，不用一次次确认，一口气把活干完（俗称"狂飙模式"）。开启方式有两种：

• • 临时开启：在 Claude Code 里连按 Shift + Tab，循环切换到 acceptEdits（自动接受编辑）模式
• • 彻底放飞：启动时加参数

claude --dangerously-skip-permissions

⚠️ "彻底放飞"模式下它不再征求你同意就执行任何命令，只在可信的项目目录里用，别在生产环境或重要仓库里随手开。

五、第一次运行：跑出你的第一行响应

环境配好后，进入任意一个项目目录（或新建一个空文件夹），启动：

claude

第一次启动可能会让你确认一些信息。进入交互界面后，你会看到一个可以对话的输入框。试着跟它说：

你好，介绍一下你自己，并帮我看看当前目录下有哪些文件

如果它正常回复，并且能列出你目录里的文件——恭喜，Claude Code 已经在你电脑上跑起来了！ 🎉🎉

如果报错，先别慌，80% 的新手问题都在第六篇《排错篇》里，照着查基本能解决。

六、安装自检清单

跑起来后，用这几条命令做个体检，确认一切正常：

💡 强烈建议新装完后第一时间跑一次 claude doctor，它能自动诊断出绝大多数配置问题，比你自己瞎猜快十倍。

七、常见新手坑（提前避雷）

坑 1：填了环境变量，却提示"未授权 / 401"→ 九成是变量名拼错了，或者填在了"用户变量"里。核对三个变量名拼写，确认建在"系统变量"。

坑 2：claude 命令找不到（command not found）→ npm 全局安装的路径没加进 PATH。重启终端试试；还不行就手动把 npm 全局目录加进 PATH。

坑 3：能启动但一直转圈、没响应→ 多半是中转地址填错，或网络不通。第六篇排错篇有专门讲这个。

坑 4：之前装过官方版，现在切到中转站各种报错→ 官方版的登录信息和中转站的配置打架了。需要彻底清理一次，方法见第六篇。

写在最后

安装这关，说难不难，说简单也不简单——难在"没人把每一步拆开讲清楚"。

现在你跨过这道坎了。接下来，我们要把这个工具用"活"：怎么让它跑得更快、怎么引用文件、怎么切换模型、怎么压缩上下文省钱……