（5千字总结）国内如何安装和使用 Claude Code 的保姆级教程 - 支持Mac和Windows用户

一句话总结：Claude Code 是一个全栈工程师。

Claude Code 在处理前端页面时，生成的UI和风格也好看！还可以直接让它模仿对应的其他官方的主题。（Claude Code 自带联网功能）

我也尝试让 Claude Code 重构历史悠久的屎山代码。代码库很复杂也很大，但是我稍微告诉它我想要重构的东西时，它能精准的懂我要重构的内容。

另外，有一种错觉，会感觉现在的 Cursor 变得又慢又傻，而 Claude Code 非常快和聪明。

先教大家在国内如何使用 Claude Code 工具先，只有自身去体验了才能感受到之间的区别有多大。

以下教程几乎一次性可过，如果遇到问题，可以直接通过Gemini、ChatGPT、Claude、Grok 等AI进行提问协助！

Claude Code 安装条件

教程大概5-10分钟就可以安装完毕，如果已经具备了Node环境的，直接开箱即用。

使用 Claude Code，您需要满足以下要求：

• 运行macOS 10.15+、Ubuntu 20.04+/Debian 10+ 操作系统。
• 如果您使用Windows，需要在WSL上部署安装。
• Node.js 18+

一、MacOS苹果电脑 和 Linux系统的安装教程

因为 Claude Code 是由 Node.js 开发的，所以我们需要先安装Node.js环境，可以通过以下的方式安装：

如果是 Ubuntu 或者 Debian 系统的话，安装命令如下：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt-get install -y nodejs

如果是 MasOS 系统的话，安装命令如下：

sudo xcode-select --install
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
sudo brew install node
node --version

上面两种方式都失败的情况下，那么可以直接上Node.js官网直接下载安装包安装：

https://nodejs.org/zh-cn/download

确认Node环境是否安装成功：

node --version
npm --version

如果输出对应的版本信息代表环境安装成功，请确保 Node.js 版本为 18.0以上或更高版本的。

Claude Code 安装教程（官方）

如果有官方的 Claude Pro 或者 Max 账号的伙伴，就可以直接使用 Claude Code，2025/06/02 开始，Pro 订阅用户可以使用 Claude Code 工具。

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

Claude Code 安装教程（推荐镜像）

首次体验的话，我建议直接使用 9.9 一杯瑞幸咖啡的费用的 Claude Code 镜像。

我使用的是 GAC Claude Code 镜像站，符合我们国内用户的场景，不用担心被封，无需魔法直接使用。

其实就是跟官方的 Claude Code 一样，改了 Claude Code 包的配置进行中转直连，源码我看了，目前 Claude Code 偷换不了模型，用的都是 Claude Max 账户。

首先注册 GAC Claude Code 中转站的账号，后面安装完工具后，需要进行授权。

GAC Claude Code 官网

接下来安装 Claude Code 镜像站，在你的终端上，执行下面3条指令：

cd ~
npm install -g https://gaccode.com/claudecode/install --registry=https://registry.npmmirror.com
claude --version

如果您先前安装过 Claude Code（官方），请您务必先通过以下命令卸载！！！ (会出现镜像冲突)

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

安装成功后，你可以创建一个文件夹存放你现在要做的项目，然后在文件夹目录下的终端输入以下命令直接运行 Claude Code 工具：

mkdir claude-demo
cd claude-demo
claude

在终端执行claude之后，会跳到 GAC Claude Code 镜像站上进行授权，所以记得先在镜像站官网登录。

如果执行后，你的终端是下面的情况，就是没有成功，需要进行订阅！！！

激活方式：GAC Claude Code 镜像站 -> 管理订阅 -> 使用兑换券

gaccode的兑换券的获取方式

如果你是首次使用时，GAC要求您验证订阅。您可通过出现的浏览器窗口登录以完成验证。

GAC Claude Code 直达获取兑换码

在这之后，您需要选择主题、并允许 Claude Code 访问所在目录文件。

恭喜您！您已经完成了 Claude Code的安装与部署啦～

二、Windows电脑安装教程

因为 Claude Code 官方就不支持 Windows系统，官方推荐使用Windows的WSL进行安装，就是在虚拟机进行部署安装。

而 WSL 安装之后，可以进行安装一个 Ubuntu 虚拟机然后进行部署安装 Claude Code。

什么是WSL？

WSL（Windows Subsyetem for Linux，适用于 Linux 的 Windows 子系统），是 Microsoft 公司于 2016 年在 Windows 10 平台发布的一项功能，其使得用户可以在 Windows 操作系统上运行 ELF 格式的 Linux 可执行文件。

WSL下的Ubuntu虚拟机是可以和本地电脑的文件双向连通的哈，不用担心怎么编程和读取本地电脑的文件夹之类的！ 可以当成一个新的终端工具使用就行。

安装WSL，必须满足以下要求：

• Windows 11 或 Windows 10 21H2以上，专业版/工作站版/企业版（非家庭版，需支持Hyper-V）

• CPU 需支持且已在 BIOS/UEFI 中启用虚拟化

（1）按照以下步骤安装WSL：

安装之前需要打开虚拟化，否则过程会出现未知的错误。

打开路径：控制面板 -> 程序与功能 -> 打开或关闭 Windows 功能 启动以下功能：

• Virtual Machine Platform（虚拟机平台）
• Windows Subsystem for Linux Support（WSL）

下载和安装对应版本的 WSL， 选择您的系统版本，复制到浏览器进行下载 WSL 安装包:

• 64-Bit WSL-2.5.9.0 [推荐]

https://vip.123pan.cn/1831946356/links/wsl.2.5.9.0.x64.msi

• ARM64 WSL-2.5.9.0

https://vip.123pan.cn/1831946356/links/wsl.2.5.9.0.arm64.msi

• ARM64_MicrosoftStore WSL-2.5.9.0

https://vip.123pan.cn/1831946356/links/Microsoft.WSL_2.5.9.0_x64_ARM64.msixbundle

你也可以不用上面的安装包，直接访问 GitHub 安装最新的版本：

github.com/microsoft/W...

（2）安装虚拟机：

安装完WSL之后，你可以在微软应用商店中安装最新的Ubuntu 24.04 LTS 或者 通过以下命令安装：

wsl --install -d Ubuntu-24.04

如果执行后遇到包错的情况，无法链接之类的，是因为网络问题，可以开一下魔法，或者修改一下github的host本地dns的解析IP。（也可以问AI）

你也可通过 wsl -l -o 命令选择其他系统版本。

安装完 Ubuntu 之后，你可以在**终端（或PowerShell）**输入wsl访问安装的操作系统：

• 首次用需要设置用户名和密码：

如果您通过开始菜单的应用访问一次，直接关闭窗口而不输入用户名和密码，下次访问将使用root用户

• Windows将安装的操作系统虚拟机视作一个应用，如Ubuntu 24.04 LTS 会出现在你的开始菜单

（3）Windows的Claude Code 安装

安装完Ubuntu之后，你只需在CMD或者终端工具上，运行wsl就可以进入。

wsl

接着，就可以在wsl下面，进行运行和部署 Claude Code。 安装步骤跟上面的 Ubuntu 👆 系统 安装的流程一致。

请滑到文章开头的安装教程！

三、Claude Code 版本更新升级

如果官方的Claude Code包升级了，正常镜像也会隔天就同步更新。 GAC镜像也要跟官方一致的版本的话，就执行下面指令：

升级 GAC Claude Code 镜像版本：

sudo npm install -g https://gaccode.com/claudecode/install --registry=https://registry.npmmirror.com

Claude Code 可以读取图片、文件等功能，如果需要预览代码，直接使用IDE编辑器，VSCode 或者 Cursor之类的预览就行。 其他事情都交给 Claude Code 完成。

你也可以同时弄一下git进行版本控制，这样子也可以回退一些修改。不懂使用git的，你完全可以让claude教你，或者用其他AI辅助教你。

四、Claude Code 常见三个报错以及对应解决方案

（1）overloaded_error - 服务器过载

• 原因：Claude 服务器当前负载过高

• 解决方案：建议从 opus 切到 sonnet，或者放置一会，稍等再回来执行。

（2）timeout - 请求超时

• 原因：任务复杂度过高，处理时间超出限制 或者是启用 ultrathink 模式导致计算时间延长

• 解决方案：使用 Chain of Thought (CoT) 等提示技术优化请求或者手动 将复杂任务拆分为多个小任务。

• 预防措施：合理评估任务复杂度，提前做好任务分解

（3）tool_call_error - 工具调用错误

• 原因：Claude Code 内部代码逻辑异常
• 解决方案：首先尝试重新运行命令，若多次重试仍失败，使用 Ctrl+C 强制退出，重新启动 Claude Code 会话。

或者按esc+esc回退到最后一条好的消息，从那条消息起重试。esc是可以打断agent的指令。