Claude Code 是一个 Agent 框架——你把它当成一具身体,真正干活的“大脑”是后面接的模型。这一章只装身体,不接大脑。
为什么要分开装?因为很多人一听“Anthropic 封号”就劝退了——但封号封的是模型调用,跟装框架这件事一点关系都没有。没有海外手机号、没有 Visa、甚至没有魔法,框架照样装得上。这是国内能用上 Claude Code 的根本前提。
这一章只做一件事:把 Claude Code 装到你电脑上,让 claude --version 能输出版本号就齐活。后面两章会分别讲——怎么搞定 Anthropic 官方订阅,以及官方订阅不行时怎么接入国产模型。
我给你三条路,按“上手门槛”从低到高排:
这是按“使用门槛”分的,不是按“哪个更好”。三条路装出来的 Claude Code 完全一样。拿不准——直接看第三节,让 AI IDE 代装,这是最不容易翻车的一条。
AI IDE(Trae / Qoder / CodeBuddy / Antigravity)本身就是智能体——它会读文档、会执行命令、会自己处理环境变量。而安装 Claude Code 拆开就是:
这三件事 AI IDE 全都会做。所以——把这活儿直接交给它就完事了。
如果上一集没装的话,先把 AI IDE 装上——本章以 Trae 为例(trae.cn,手机号验证码登录)。登录成功后,可以看到经典的三栏布局:
https://docs.anthropic.com/zh-CN/docs/claude-code/overview
安装完成后请告诉我怎么验证装好了。
按回车。
接下来 Trae 会自动执行安装,整个过程大概 3-5 分钟。中间会弹几次确认窗:
别怕,全都点运行。Trae 走的是标准安装流程,不会乱动你电脑别的东西。
claude --version,回车看到版本号(比如 Claude Code 1.0.x),就是装好了。
如果不想让 AI 自动装,AI IDE(Trae 或 VSCode)还提供了一种图形化方式——装 Claude Code 官方插件。
打开 IDE → 左侧栏点拼图图标(“扩展”)→ 搜索框输入 claude → 第一条就是 Claude Code for VS Code(Anthropic 官方)→ 点 Install 装上。装好后在左侧栏或预览页右上角会有 Claude 图标,点击就能用。
上面说完了在 AI IDE 里安装,下面介绍直接在系统终端里安装。打开终端的方式有多种,任选一个:
装好的 Claude Code 是全局的——之后无论在 IDE 内置终端还是系统终端里敲 claude,都能用,不需要重复安装。
在动手之前先了解一下 PowerShell:它是 Windows 上跑命令的终端工具,相当于 Mac 上的“终端”。打开方式:任务栏左下角搜索框输入“终端”或 PowerShell,点开即可。
如果你还没装过,打开终端,粘贴这行命令并回车:
Git 装好之后,继续在终端中运行:
等终端显示 “Successfully installed” 就装好了。
验证一下:
有版本号输出就 OK。再敲一下 claude,能进到 Claude Code 界面。界面里可能提示要登录或还没接模型,先别管,下一章再说。
如果你有稳定的海外网络,PowerShell 跑这一行最快:
国内网络容易中断。装完同样用 claude --version 验证就行。
先打开终端:在 应用程序 → 实用工具 里能找到,或按 Command + 空格 搜“终端”。
如果有稳定的海外网络,Anthropic 官方的一键脚本最快:
装完它可能会提示 ~/.local/bin 没加到 PATH。把它给你的那一长串 echo / run 后面的命令复制到终端跑一遍,配置好环境变量,然后输入 claude --version 验证。
如果国内网络,推荐使用 Homebrew,这是 macOS 上最流行的命令行包管理器。
把这行原样贴到终端,回车:
看到提示之后直接回车,输入 Mac 密码(无回显正常),耐心等几分钟,出现安装成功就装好了。
装完之后终端会提示几行命令(通常包含 eval "$(/opt/homebrew/bin/brew shellenv)" 等)。把这几行一条条粘贴到终端跑一遍,让终端能找到 brew 命令。
耐心等待安装完成。
有版本号输出就是装好了。再敲一下 claude,能看到 Claude Code 的小螃蟹欢迎界面。
装完输入 claude 报错、自己看不懂的——什么都别瞎搞,直接把报错原文截图或复制,丢给 AI IDE,让它帮你看。PATH 没配好、Git 没装、网络中断、命令找不到……这些坑 AI IDE 全都见过。给它报错它就能告诉你下一步敲什么。
这一章就做一件事——把 Claude Code 框架装到你电脑上。本集重点:
装好之后 claude --version 能看到版本号就齐活了。框架装好了,下一步给它接个能用的“大脑”(官方模型或国产模型)。