WSL 手动部署 Claude Code

安装步骤

PowerShell 安装（Windows PowerShell）

Win11 自带 PowerShell 版本为 5，为了更好的兼容性，建议安装最新版本。

winget install --id Microsoft.PowerShell --accept-package-agreements --accept-source-agreements

1. 安装之后可以运行开始中的 PowerShell 7 直接启动，推荐在终端中启动有更多设置+多窗口+后续WSL集成
2. 有时候需要管理员权限需要 右键-以管理员身份运行，也可以在终端中设置启动默认为管理员权限
3. 如果有了新版本进入 PowerShell 之后会有提示，使用下面命令升级：

winget upgrade --id Microsoft.PowerShell --accept-package-agreements --accept-source-agreements

WSL 准备（Windows PowerShell）

1. 安装 WSL 的 Ubuntu 26.04 系统（文件装 C:\wsl\u26claude，需提前 mkdir C:\wsl；WSL 2.5+ 支持 --location，换 D 盘改 --location D:\wsl\u26claude 即可）：

wsl --install -d Ubuntu-26.04 --location C:\wsl\u26claude --name u26claude

2. 检查可安装版本：

wsl --list --online

3. 安装或导入（2选1）：

wsl --install Ubuntu-26.04 --location C:\wsl\u26claudec2 --name u26claudec2

wsl --install Ubuntu-26.04 --location D:\wsl\u26claudec2 --name u26claudec2

wsl --import u26claudec2 c:\wsl\u26claudec2 u26_ccconfigready_20260403.tar

4. 配置 .wslconfig 让 WSL 可以上网。
在 Windows 的 %USERPROFILE% 目录下创建或编辑 .wslconfig：

[wsl2]
networkingMode=mirrored
dnsTunneling=true
autoProxy=true
firewall=true
memory=8GB

注意：如果后补配置，搞定后需要 wsl --shutdown 先停止 WSL 服务。

非必要环节

导出已安装的分发：

wsl --export u26claudec u26_ccconfigready_20260403.tar

删除已安装的分发：

wsl --unregister u26claudec5

系统初始化（Ubuntu）

进入后会让你设置用户名密码，默认目录为 /home/username。

首先升级系统包并清理冗余：

sudo apt update && sudo apt upgrade -y && sudo apt autoremove -y

mkdir git

切换环境（Windows PowerShell）

关闭系统后，到终端设置中，选择刚安好的 Ubuntu 发行版，启动目录后面加上 /git 作为 Claude Code 主目录（和 memory 有关）。

另外在终端设置中，选中你的环境，勾选以管理员身份运行此配置文件。点击外观字体改为 Consolas，否则可能由于 Ubuntu 字体没有会有报警。

安装 Claude Code（Ubuntu）

curl -fsSL https://claude.ai/install.sh | bash

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

如果配置较好，经验丰富可以考虑使用 cc-switch 配置，下载 CC-Switch-v3.12.2-Linux-x86_64.deb 安装：

安装（可能会报缺依赖）📋 复制

sudo dpkg -i CC-Switch-v3.12.2-Linux-x86_64.deb

修复依赖📋 复制

sudo apt install -f

拉取配置库（Ubuntu）

由于目前库是 private，需要安装 gh 库还要进行验证和检查。建议步骤如下：

1. 将启动脚本复制到 Ubuntu 系统中。脚本根据实际情况制定，围绕拉取 git 库的内容，需自主完成。
2. 增加执行权限并运行：

chmod +x initgit.sh

./initgit.sh

备注：如果是公开仓库可以直接拉取：
git clone https://github.com/super2017/claude-config.git

初始化 Claude Code（Ubuntu）

由于 Claude Code 需要订阅才可以使用，使用第三方订阅需要跳过初始化并修改为本地验证（使用官方订阅可跳过）。拉取后在 git 目录下执行以下操作：

初始化 CC 环境

chmod +x ./ccconfig/ubuntuinit.sh

./ccconfig/ubuntuinit.sh

安装 CC 基础插件

chmod +x ./ccconfig/claudeinit.sh

./ccconfig/claudeinit.sh

使用

至此安装完成，终端中选择你的 Linux 发行版，输入 claude 进入即可使用。

进入后输入 hookstatus，Claude 会运行已经配置好的 MCP 调用脚本检查状态，输出都正常则可以正常工作，若有问题可以直接对话让 CC 修复。