玩轉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開發的浪潮！