安装 Claude Code
Last updated on
把 Claude Code 真正装到电脑里，并确认命令能正常运行。先完成安装和版本检查，下一页再正式开始使用。
这一页只做一件事：把 Claude Code 装上去
前两页你已经完成了两件基础工作：
- 准备好了本地依赖和 API Key
- 用 CC Switch 把 Claude Code 的供应商链路切好了
所以这一页不再讲 Key 怎么来，也不再讲供应商怎么切换，而是专门解决：Claude Code 怎么安装，装完怎么确认它真的能运行。
安装前先确认你已经具备这两个条件
如果这两项还没完成，先不要急着往下装
这一页默认你已经完成前两页内容。
开始前，先确认下面两件事：
- 你的电脑里已经装好了
Node.js和npm - 你已经通过
CC Switch给Claude Code切好了一个可用供应商
如果这两项还没完成，先回去看：
先打开正确的终端
这一步开始，你要真正输入命令了
如果你是 Windows 用户，推荐优先使用 Windows Terminal。
如果你电脑里没有它，用 PowerShell 或 CMD 命令提示符 也可以。
对大多数新手来说，你只需要做到这一步：
- 按下 Windows 键
- 搜索
Windows Terminal、PowerShell或cmd - 打开其中任意一个终端窗口
如果你不知道选哪个，就优先选 Windows Terminal。
用 npm 安装 Claude Code
1. 在终端里运行安装命令
打开终端后，直接运行下面这条命令：
npm install -g @anthropic-ai/claude-code这条命令的意思可以简单理解为：
npm install：通过 npm 安装一个包-g：全局安装，让你在任意目录都能直接运行claude@anthropic-ai/claude-code：Claude Code 的包名
这里不要把命令拆开改着输
对小白来说，最稳的做法就是整条复制，整条运行。
不要自己删掉 -g，也不要把包名改成别的。
2. 等安装跑完，不要中途关终端
运行之后，终端里会开始输出安装过程。
这时候你要做的事情很简单：
- 先等它跑完
- 不要中途关闭终端窗口
- 如果终端还在不断输出内容，就继续等
正常情况下，安装结束后，终端会重新回到可以继续输入命令的状态。
什么状态说明安装大概率已经完成？
终端不再继续滚动安装日志，并且你可以再次输入新命令。
3. 立即检查版本号
安装完成后，不要直接默认它已经成功。
马上运行下面这条命令：
claude --version如果终端里正常输出版本号，就说明 Claude Code 已经安装到你的电脑里了。
你看到的版本号不一定和别人完全一样，这很正常。只要它能正常返回一个版本结果，而不是报错，就可以。
如果命令找不到，先怎么判断问题
最常见的安装问题，不是 Claude Code 本身坏了
更多时候，是 Node.js 没装好，或者 npm 的全局命令路径还没生效。
如果你运行：
claude --version结果提示“找不到命令”或类似意思，优先按这个顺序检查。
1. 先检查 Node.js 和 npm 还在不在
在同一个终端里运行：
node -v
npm -v如果这两条命令都能返回版本号，说明 Node.js 和 npm 还在。
如果这里就已经报错，那问题不在 Claude Code，而在你前面的依赖没有装完整。先回去补 准备工作。
2. 再重新运行一次安装命令
如果 node -v 和 npm -v 都正常，但 claude --version 不正常，可以再重新运行一次：
npm install -g @anthropic-ai/claude-code重新安装完成后，再试一次：
claude --version3. 仍然不行，就先关掉终端再打开一次
有些情况下，是当前终端还没有刷新到新的全局命令路径。
这时候最简单的处理方式就是：
- 把当前终端窗口关掉
- 重新打开 Windows Terminal、PowerShell 或 CMD
- 再次运行
claude --version
很多“明明装完了但命令还是找不到”的情况，到这里就会恢复正常。
这一步做完，什么状态算合格
满足下面这 3 条，就说明这一页已经完成了
- 你已经在终端里成功运行过
npm install -g @anthropic-ai/claude-code - 你已经运行过
claude --version claude --version能正常返回版本号，而不是报错
做到这里，安装这一步就完成了。
下一页继续看 使用 Claude Code。