WSL 手动安装 Claude Code

安装步骤

PowerShell 安装（Windows PowerShell）

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

PowerShell 安装（2026-04 最新版本 7.6）

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

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

PowerShell 更新

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

WSL 准备（Windows PowerShell）

1. 安装 WSL 的 Ubuntu 24.04 系统：

安装 WSL 环境（安装后重启）

wsl --install

2. 检查可安装版本：

检查可安装版本

wsl --list --online

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

安装（默认位置）

wsl --install Ubuntu-24.04

安装（设定位置和名称）

wsl --install Ubuntu-24.04 --name u24claudec2 --location c:\wsl\u24claudec2

导入 .tar 包

wsl --import u24claudec2 c:\wsl\u24claudec2 u24_ccconfigready_20260403.tar

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

.wslconfig

[wsl2]
networkingMode=mirrored
dnsTunneling=true
autoProxy=true
firewall=true

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

非必要环节

导出已安装的分发：

导出分发

wsl --export u24claudec u24_ccconfigready_20260403.tar

删除已安装的分发：

删除分发

wsl --unregister u24claudec5

系统初始化（Ubuntu）

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

建立 git 目录便于管理

mkdir git

切换环境（Windows PowerShell）

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

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

安装 Claude Code（Ubuntu）

安装 Claude Code

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 库还要进行验证和检查。建议步骤如下：

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

赋权

chmod +x initgit.sh

运行（交互操作会要求登录 GitHub 并且授权）

./initgit.sh

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

初始化 Claude Code（Ubuntu）

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

初始化 CC 环境

赋权（如果执行报错运行此条后再尝试）

chmod +x ./ccconfig/ubuntuinit.sh

执行（中间需输入你的 LLM 信息）

./ccconfig/ubuntuinit.sh

安装 CC 基础插件

赋权

chmod +x ./ccconfig/claudeinit.sh

执行

./ccconfig/claudeinit.sh

使用

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

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

WSL 手动部署 Claude Code