WSL 安装和配置指南
本文档介绍如何在 Windows 11 上安装和配置 WSL (Windows Subsystem for Linux)，以及安装开发工具。

1. 启用 Windows 功能

1.1打开 Windows 功能设置

1. 按 Win + R 打开运行窗口
2. 输入 optionalfeatures 或 控制面板\程序\启用或关闭 Windows 功能
3. 点击确定
   

1.2 启用必要功能

在"启用或关闭 Windows 功能"窗口中，勾选以下选项：

• 适用于 Linux 的 Windows 子系统 (WSL)
• 虚拟机平台 (如果可用)

[bsmessage type="common" color="red" title="注意"]Windows 11 可能只显示部分选项，这是正常的。[/bsmessage]
勾选后点击确定，系统可能需要重启。

2. 设置 WSL 版本和安装 Linux

2.1 设置 WSL 默认版本
打开 PowerShell 或命令提示符（管理员权限），执行：

# 设置默认版本为 WSL2
wsl --set-default-version 2

2.2 查看可用的 Linux 发行版

# 查看可用的 Linux 发行版
wsl --list --online

2.3 安装 Linux 发行版
选择一个发行版进行安装（推荐 Debian 或 Ubuntu）：

# 安装 Debian
wsl --install -d Debian
# 或者安装 Ubuntu
wsl --install -d Ubuntu

3. 用户配置

3.1 创建普通用户
如果首次进入发行版后是 root 用户，需要创建普通用户：

# 创建新用户（替换 your_username 为你的用户名）
adduser your_username
# 将用户添加到 sudo 组
usermod -aG sudo your_username

3.2 设置默认用户
编辑 WSL 配置文件：

sudo vim /etc/wsl.conf

在 /etc/wsl.conf 中添加以下内容：

[user]
default=your_username

保存后，在 Windows 中重启 WSL：

wsl --shutdown

4. 替换镜像源（加速下载）

4.1 备份原配置文件

sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak

4.2 编辑源列表

sudo nano /etc/apt/sources.list

4.3 替换为国内镜像源
对于 Debian，将内容替换为：

deb https://mirrors.aliyun.com/debian/ trixie main
deb-src https://mirrors.aliyun.com/debian/ trixie main

对于 Ubuntu，可使用：

#deb https://mirrors.aliyun.com/ubuntu/ jammy main restricted universe multiverse
#deb https://mirrors.aliyun.com/ubuntu/ jammy-updates main restricted universe multiverse

4.4 更新软件包

sudo apt update
sudo apt upgrade -y

4.5 测试网络（可选）

sudo apt install apache2 -y

5. Claude Code 安装

5.1 安装 Node.js

# 下载并安装 Node.js LTS 版本（Ubuntu/Debian）
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs

5.2 验证安装

node --version
npm --version

5.3 安装 Claude Code

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

5.4 设置环境变量

# 临时设置环境变量（当前会话有效）
export ANTHROPIC_AUTH_TOKEN=sk-你的token
export ANTHROPIC_BASE_URL=https://anyrouter.top

5.5 永久保存环境变量

echo 'export ANTHROPIC_AUTH_TOKEN=sk-你的token' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL=https://anyrouter.top' >> ~/.bashrc
source ~/.bashrc

5.6 使用 Claude Code

# 验证安装
claude --version
# 进入项目目录使用
cd your-project
claude

6. OpenAI Codex 安装

6.1 安装 Codex

npm i -g @openai/codex

6.2 创建配置目录

mkdir -p ~/.codex

6.3 创建配置文件

cat > ~/.codex/config.toml << 'EOF'
model = "gpt-5-codex"
model_provider = "anyrouter"
preferred_auth_method = "apikey"
[model_providers.anyrouter]
name = "Any Router"
base_url = "https://anyrouter.top/v1"
wire_api = "responses"
EOF

6.4 创建认证文件

cat > ~/.codex/auth.json << 'EOF'
{
"OPENAI_API_KEY": "你的KEY"
}
EOF

6.5 使用 Codex

# 验证安装
codex --version
# 进入项目目录使用
cd your-project
codex

7. 常用 WSL 命令

7.1 查看和管理发行版

# 查看已安装的发行版
wsl --list --verbose
# 停止 WSL
wsl --shutdown
# 设置默认发行版
wsl --set-default Ubuntu

7.2 导出/导入发行版（备份或迁移）

# 导出发行版
wsl --export Ubuntu ubuntu_backup.tar
# 导入发行版
wsl --import Ubuntu C:\wsl\ubuntu C:\wsl\ubuntu_backup.tar

7.3 其他常用命令

# 卸载发行版
wsl --unregister Ubuntu
# 查看 WSL 版本
wsl --version
# 进入指定发行版
wsl -d Debian

参考资料

本文档参考了以下资源：

• [Linux.do - WSL 安装讨论] 纯小白 WSL 入门教程（附CC和Codex配置）
• [Any Router 服务]https://anyrouter.top/

常见问题

Q: WSL 启动失败怎么办？
A: 尝试以下步骤：

1. 确认已启用 “适用于 Linux 的 Windows 子系统” 和 “虚拟机平台”
2. 检查 BIOS 是否启用了虚拟化技术 (Intel VT-x 或 AMD-V)
3. 运行 wsl --shutdown 后重新启动

Q: 如何更新 WSL？
A: 在 PowerShell 中运行：

wsl --update

Q: 如何在 Windows 和 WSL 之间访问文件？
A:

1. 在 WSL 中访问 Windows 文件：/mnt/c/Users/YourName/
2. 在 Windows 中访问 WSL 文件：\wsl$\Ubuntu\home\username\