玩转ClaudeCode：ClaudeCode安装教程（Windows+Linux+MacOS）

Windows 环境安装 Claude Code

一、安装 WSL 环境

1. 确认 Windows 功能已开启

打开 “控制面板 → 程序 → 启用或关闭 Windows 功能”

勾选 “适用于 Linux 的 Windows 子系统” 和 “虚拟机平台”
在这里插入图片描述

点“确定”后重启电脑。

开机后，管理员模式打开 Terminal, 启用 WSL 和支撑 WSL2 所需的虚拟机平台组件。

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

在这里插入图片描述

再次重启电脑。

2. 更新和升级 WSL2 内核

下载安装包：从微软官方网站下载 WSL2 Linux 内核更新包
安装完成后，在 Terminal（管理员）中运行：

wsl --update
wsl --set-default-version 2

如果你还没安装任何 Linux 发行版，可以直接运行：

wsl --install

3. 检查 WSL 发行版状态

在 Terminal（管理员）里输入：

wsl --list --verbose

可以看到已经安装的 Linux 发行版：

NAME                   STATE           VERSION
Ubuntu                 Stopped         2
docker-desktop         Stopped         2
docker-desktop-data    Stopped         2

如果你还没安装任何 Linux 发行版，可以直接运行：

wsl --install

这会自动安装 Ubuntu 并设置 WSL2 为默认。

在这里插入图片描述

WSL 环境搭建好之后，按需选择下面两种安装方式。

二、WSL 环境直接安装 Claude Code

1. 获取 Claude Code 账号

访问 Claude Code 中国镜像站，完成账户注册。

输入邀请码 DZFW8J，获得价值100$的使用额度。

2. 一键安装 Claude Code

启动 WSL 环境，执行一键安装脚本：

curl -fsSL https://www.aicodemirror.com/resource/install/install.sh | bash

在这里插入图片描述
安装成功后，我们切换到需要使用 Claude Code 的项目，启动 Claude Code。

cd /workspace/project
claude

首次登陆需要输入验证码：
在这里插入图片描述
这里需要复制url到浏览器打开，输入我们刚刚注册的账号密码即可。

验证码输入回终端，完成登录验证。

后续只要 cd 到你想要操作的项目目录下，输入 claude 即可使用。
在这里插入图片描述

三、Docker 环境安装 Claude Code

1. 官网下载安装 Docker Desktop

从 Docker 官网下载并安装最新版。
安装过程中勾选 “Use WSL 2 based engine”，并完成向导重启。

在这里插入图片描述

2. Docker Engine 配置镜像源

打开 Docker Desktop，进入设置页面 (齿轮图标) ，编辑 Docker Engine 为下面内容：

{"builder": {"gc": {"defaultKeepStorage": "20GB","enabled": true}},"dns": ["8.8.8.8","8.8.4.4"],"experimental": false,"features": {"buildkit": true},"insecure-registries": ["https://hub.atguigu.com"],"registry-mirrors": ["https://docker.mirrors.ustc.edu.cn","https://registry.docker-cn.com","http://hub-mirror.c.163.com","https://cr.console.aliyun.com/","https://mirror.ccs.tencentyun.com"]
}

在这里插入图片描述

3. Docker Desktop 与 WSL 集成

打开设置的 Resources 页面。

打开 WSL integration 页面，勾选 Enable integration with my default WSL distro 选项。

在这里插入图片描述

然后检查 Advanced 页面内是否提示：You are using the WSL 2 backend。显示这个说明我们已经集成上了 WSL。

这里要求已安装至少一个 Linux 发行版（如 Ubuntu），如果没有安装，需要参考 环境准备 完成安装。

4. 创建 Claude Code 开发环境镜像

我们需要创建一个目录作为Docker的运行目录（如 D:\Tools\Docker\my-dev），然后在运行目录下面创建一个 Dockerfile 文件。通过编写 Dockerfile，可以在镜像里预装编译器、依赖包、工具链等，一次构建、随处可复用。

Dockerfile 文件内容：

# 1. 基础镜像
FROM ubuntu:22.04# 关闭交互提示
ENV DEBIAN_FRONTEND=noninteractive# 3. 替换为国内 HTTP 源，避免 ca-certificates 未安装时的证书校验错误
RUN sed -i 's|http://.*.ubuntu.com|http://mirrors.aliyun.com|g' /etc/apt/sources.list \&& sed -i 's|http://security.ubuntu.com|http://mirrors.aliyun.com|g' /etc/apt/sources.list# 4. 更新索引并安装必备包（含 ca-certificates），遇到下载错误时重试 3 次并跳过缺失包
RUN apt-get update \&& apt-get install -y --no-install-recommends \ca-certificates \build-essential \git \curl \vim \python3 \python3-pip \nodejs \npm \--fix-missing \-o Acquire::Retries=3 \&& rm -rf /var/lib/apt/lists/*# 可选：更换回官方 HTTPS 源（此时已有 ca-certificates，可校验证书）
# RUN sed -i 's|http://mirrors.aliyun.com|https://archive.ubuntu.com|g' /etc/apt/sources.list# 4. 创建一个非 root 用户，避免容器内文件权限问题
ARG USERNAME=dev
ARG UID=1000
RUN useradd -m -u ${UID} -s /bin/bash ${USERNAME} \&& apt-get update \&& apt-get install -y sudo \&& echo "${USERNAME} ALL=(ALL) NOPASSWD:ALL" >> /etc/sudoers \&& rm -rf /var/lib/apt/lists/*# 5. 切换到普通用户
USER ${USERNAME}# 6. 工作目录
WORKDIR /workspace# 7. 默认启动 shell
CMD ["bash"]

接下来，我们来构建镜像。打开 Terminal 切到该目录：

mkdir D:\Tools\Docker\my-dev
cd D:\Tools\Docker\my-dev

这里我为了防止一次性构建时拉取 ubuntu:22.04 时间过长，所以先手动拉下来。

docker pull ubuntu:22.04

同理，node 环境也是。

docker pull node:18

然后构建镜像（给它起个易记的名字，比如 ubuntu-demo）：

docker build -t ubuntu-demo .

其中，-t ubuntu-demo 是给镜像命名，. 表示在当前目录作为构建上下文，Dockerfile 也在这里。

在这里插入图片描述

5. 启动 Claude Code 开发环境容器

将本地的 Claude 安装包目录、项目代码和其他工作目录挂到容器里：

docker run -it \--name claude-code \-v D:/Tools/Docker/ClaudeCode/Claude:/workspace/claude \-v D:/Tools/Docker/ClaudeCode/Code:/workspace/project \ubuntu-demo

进入容器后，验证 Node 与 npm，检查版本确保环境正常：

node --version
npm --version

6. 获取 Claude Code 账号

访问 Claude Code 中国镜像站，完成账户注册。

输入邀请码 DZFW8J，获得价值100$的使用额度。

7. 容器内安装 Claude Code

在容器内的控制台执行：

curl -fsSL https://www.aicodemirror.com/resource/install/install.sh | bash

在这里插入图片描述

8. 使用 Claude Code 进行开发

安装成功后，我们切换到需要使用 Claude Code 的项目，启动 Claude Code。

cd /workspace/project
claude

首次登陆需要输入验证码：
在这里插入图片描述
这里需要复制url到浏览器打开，输入我们刚刚注册的账号密码即可。

验证码输入回终端，完成登录验证。

后续只要 cd 到你想要操作的项目目录下，输入 claude 即可使用。

在这里插入图片描述

输入你的指令，点击回车，Claude Code会自动进行任务编排和操作。

在这里插入图片描述

Linux 环境安装 Claude Code

1. 获取 Claude Code 账号

访问 Claude Code 中国镜像站，完成账户注册。

输入邀请码 DZFW8J，获得价值100$的使用额度。

2. 一键安装 Claude Code

Claude Code 原生支持 Ubuntu 18.04+、CentOS 7+、Debian 10+、Fedora 30+，一键安装即可。

打开终端，执行一键安装脚本，等待自动安装完成。

curl -fsSL https://www.aicodemirror.com/resource/install/install.sh | bash

在这里插入图片描述

3. 使用 Claude Code 进行开发

安装完成后，您可以在任何项目目录中开始使用 Claude Code：

# 导航到您的项目
cd your-project-folder# 启动 Claude Code
claude

首次登陆需要输入验证码：
在这里插入图片描述
这里需要复制url到浏览器打开，输入我们刚刚注册的账号密码即可。

验证码输入回终端，完成登录验证。

后续只要 cd 到你想要操作的项目目录下，输入 claude 即可使用。
在这里插入图片描述
输入你的指令，点击回车，Claude Code会自动进行任务编排和操作。

在这里插入图片描述

MacOS 环境安装 Claude Code

1. 获取 Claude Code 账号

访问 Claude Code 中国镜像站，完成账户注册。

输入邀请码 DZFW8J，获得价值100$的使用额度。

2. 一键安装 Claude Code

Claude Code 原生支持 macOS 10.15+ 系统，一键安装即可。

打开终端，执行一键安装脚本，等待自动安装完成。

curl -fsSL https://www.aicodemirror.com/resource/install/install.sh | bash

3. 使用 Claude Code 进行开发

安装完成后，您可以在任何项目目录中开始使用 Claude Code：

# 导航到您的项目
cd your-project-folder# 启动 Claude Code
claude

首次登陆需要输入验证码：
在这里插入图片描述
这里需要复制url到浏览器打开，输入我们刚刚注册的账号密码即可。

验证码输入回终端，完成登录验证。

在这里插入图片描述

安装常见问题

① 之前安装过其他版本 Claude Code

之前安装过其他版本 Claude Code，请先直接全局卸载（在任意目录执行）

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

② 其他安装问题

访问 Claude Code 中国镜像站-最新安装教程，查看最新安装方法和常见安装问题的解答。

Claude Code 开发者交流社区

福利多多，立即加入 👇 👇 👇

Claude Code 中国开发者交流社区

期待与你的思维碰撞，共同奔赴AI开发的浪潮！