一、装的是“身体”,不是“大脑”

Claude Code 是一个 Agent 框架——你把它当成一具身体,真正干活的“大脑”是后面接的模型。这一章只装身体,不接大脑。

为什么要分开装?因为很多人一听“Anthropic 封号”就劝退了——但封号封的是模型调用,跟装框架这件事一点关系都没有。没有海外手机号、没有 Visa、甚至没有魔法,框架照样装得上。这是国内能用上 Claude Code 的根本前提。

这一章只做一件事:把 Claude Code 装到你电脑上,让 claude --version 能输出版本号就齐活。后面两章会分别讲——怎么搞定 Anthropic 官方订阅,以及官方订阅不行时怎么接入国产模型。

二、三条安装路径,按你的情况挑

我给你三条路,按“上手门槛”从低到高排:

🌟 方案 1 让 AI IDE 帮你装
适合:没碰过命令行的所有人 · 不需要魔法
方案 2 Windows 用 WinGet、Mac 用 Homebrew
适合:用过终端、想自己动手 · 不需要魔法
方案 3 官方 curl / irm 一键脚本
适合:有稳定海外网络的老手 · 需要魔法

这是按“使用门槛”分的,不是按“哪个更好”。三条路装出来的 Claude Code 完全一样。拿不准——直接看第三节,让 AI IDE 代装,这是最不容易翻车的一条。

三、🌟 推荐方案:让 AI IDE 帮你装
3.1 为什么这招最稳

AI IDE(Trae / Qoder / CodeBuddy / Antigravity)本身就是智能体——它会读文档、会执行命令、会自己处理环境变量。而安装 Claude Code 拆开就是:

1
读一下官方安装文档
2
在终端里跑几条命令
3
遇到问题自己调

这三件事 AI IDE 全都会做。所以——把这活儿直接交给它就完事了。

3.2 三步搞定
第 1 步 装一个 AI IDE

如果上一集没装的话,先把 AI IDE 装上——本章以 Trae 为例(trae.cn,手机号验证码登录)。登录成功后,可以看到经典的三栏布局:

左侧:打开一个文件夹,相当于授权给 Trae 一个活动空间,可在这个空间内编辑文件
中间:内容预览区,AI 创建或修改文件都能实时看到
右侧:与 AI 的对话区域
第 2 步 把这段话原样贴进 Trae 的对话框
请帮我安装 Claude Code,官方文档在这里:
https://docs.anthropic.com/zh-CN/docs/claude-code/overview

安装完成后请告诉我怎么验证装好了。

按回车。

第 3 步 每次弹窗都点“运行”

接下来 Trae 会自动执行安装,整个过程大概 3-5 分钟。中间会弹几次确认窗:

“要执行命令 brew install / winget install 吗?” → 点运行
“要修改 PATH 环境变量吗?” → 点运行
“要创建 .bashrc 文件吗?” → 点运行

别怕,全都点运行。Trae 走的是标准安装流程,不会乱动你电脑别的东西。

3.3 装完做这一步
关闭 Trae,重新打开一次(让新的环境变量生效)
打开 Trae 的内置终端(通常在底部面板,或菜单 终端 → 新建终端)
输入 claude --version,回车

看到版本号(比如 Claude Code 1.0.x),就是装好了。

⚠️ 遇到报错怎么办?如果没显示版本号也不要慌。将报错信息选中,点击“添加到对话”发送到右侧 AI 对话框,告诉它“在终端输入 claude --version 报错了,请帮我处理”。让 Trae 解决后,再次重启 Trae 重新测试即可。
3.4 第二种方式:装官方插件(图形化)

如果不想让 AI 自动装,AI IDE(Trae 或 VSCode)还提供了一种图形化方式——装 Claude Code 官方插件。

打开 IDE → 左侧栏点拼图图标(“扩展”)→ 搜索框输入 claude → 第一条就是 Claude Code for VS Code(Anthropic 官方)→ 点 Install 装上。装好后在左侧栏或预览页右上角会有 Claude 图标,点击就能用。

⚠️ 注意:虽然插件安装很方便,但它不是最优解。功能最强大的还是通过终端(CLI)使用,后续高级用法都基于 CLI 演示,建议务必保证终端下能成功运行。
四、自己在终端里跑命令

上面说完了在 AI IDE 里安装,下面介绍直接在系统终端里安装。打开终端的方式有多种,任选一个:

Trae 的内置终端(顶部菜单 → 终端 → 新建终端)
VSCode 的内置终端
Windows 在任务栏搜索“终端”或 PowerShell 打开
Mac 在应用启动器搜索“终端”打开

装好的 Claude Code 是全局的——之后无论在 IDE 内置终端还是系统终端里敲 claude,都能用,不需要重复安装。

五、Windows 手动安装
5.1 认识 PowerShell

在动手之前先了解一下 PowerShell:它是 Windows 上跑命令的终端工具,相当于 Mac 上的“终端”。打开方式:任务栏左下角搜索框输入“终端”或 PowerShell,点开即可。

5.2 前置:必须先装 Git ⚠️
⚠️ 这是 Windows 装 Claude Code 最容易踩的坑。Claude Code 在 Windows 上内部依赖 Git Bash 执行命令,所以装 Claude Code 之前必须先装 Git。漏了这步,装完也跑不起来。

如果你还没装过,打开终端,粘贴这行命令并回车:

winget install Git.Git
WinGet 是 Windows 官方的包管理器,相当于 Windows 版的 Homebrew。跑完看到 “Successfully installed” 就装好了。
5.3 没魔法 — 用 WinGet

Git 装好之后,继续在终端中运行:

winget install Anthropic.ClaudeCode

等终端显示 “Successfully installed” 就装好了。

验证一下:

claude --version

有版本号输出就 OK。再敲一下 claude,能进到 Claude Code 界面。界面里可能提示要登录或还没接模型,先别管,下一章再说。

5.4 有魔法 — irm 脚本

如果你有稳定的海外网络,PowerShell 跑这一行最快:

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

国内网络容易中断。装完同样用 claude --version 验证就行。

六、Mac 手动安装
注意:此段落只过步骤。Mac 老手照着敲就行;完全不熟的新手,建议回头走第三节的 AI IDE 代装,最稳。

先打开终端:在 应用程序 → 实用工具 里能找到,或按 Command + 空格 搜“终端”。

6.1 有魔法 — 一行 curl 搞定

如果有稳定的海外网络,Anthropic 官方的一键脚本最快:

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

装完它可能会提示 ~/.local/bin 没加到 PATH。把它给你的那一长串 echo / run 后面的命令复制到终端跑一遍,配置好环境变量,然后输入 claude --version 验证。

6.2 没魔法 — 用 Homebrew

如果国内网络,推荐使用 Homebrew,这是 macOS 上最流行的命令行包管理器。

第 1 步:安装 Homebrew

把这行原样贴到终端,回车:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

看到提示之后直接回车,输入 Mac 密码(无回显正常),耐心等几分钟,出现安装成功就装好了。

第 2 步:把 Homebrew 加到 PATH ⚠️ 别跳

装完之后终端会提示几行命令(通常包含 eval "$(/opt/homebrew/bin/brew shellenv)" 等)。把这几行一条条粘贴到终端跑一遍,让终端能找到 brew 命令。

第 3 步:装 Claude Code
brew install --cask claude-code

耐心等待安装完成。

第 4 步:验证
claude --version

有版本号输出就是装好了。再敲一下 claude,能看到 Claude Code 的小螃蟹欢迎界面。

七、装完报错怎么办?

装完输入 claude 报错、自己看不懂的——什么都别瞎搞,直接把报错原文截图或复制,丢给 AI IDE,让它帮你看。PATH 没配好、Git 没装、网络中断、命令找不到……这些坑 AI IDE 全都见过。给它报错它就能告诉你下一步敲什么。

💡 核心观念:别去搜索引擎!针对你当前环境给出的特定解法,比搜索引擎上的通用答案靠谱十倍。
八、本章小结

这一章就做一件事——把 Claude Code 框架装到你电脑上。本集重点:

1
安装路径选择:小白用 AI IDE 装最无脑,老手通过终端(Windows 用 WinGet,Mac 有魔法用 curl、没魔法用 Homebrew)装最快
2
CLI vs 插件:两者都能用,但 CLI 端功能最强大,是后续实操的核心
3
一次安装,全局通用:装好的 CLI 是全局的,Trae 内置终端、VSCode 终端、系统终端都能直接用

装好之后 claude --version 能看到版本号就齐活了。框架装好了,下一步给它接个能用的“大脑”(官方模型或国产模型)。

📌 本章关键词
Agent 框架:Claude Code 的本质,相当于身体;模型相当于大脑
终端(Terminal / PowerShell):跑命令的工具
WinGet:Windows 官方包管理器
Homebrew:Mac 包管理器,一条命令装软件
Git Bash:Windows 上 Claude Code 的运行依赖,装 CC 前必须先装 Git
claude --version:验证安装的万能命令
AI IDE 代装:解决报错最省心的方式
➡️ 下一章:第 05 章 Anthropic 官方订阅与登录