问题描述：

WSL 安装和配置指南

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

1. 启用 Windows 功能

1.1 打开 Windows 功能设置

1. 按 Win + R 打开运行窗口

2. 输入 optionalfeatures 或 控制面板\程序\启用或关闭 Windows 功能

3. 点击确定
   image381×216 6.98 KB

1.2 启用必要功能

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

• 适用于 Linux 的 Windows 子系统 (WSL)

• 虚拟机平台 (如果可用)

注意: Windows 11 可能只显示部分选项，这是正常的。

勾选后点击确定，系统可能需要重启。

---

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:

• 在 WSL 中访问 Windows 文件：/mnt/c/Users/YourName/

• 在 Windows 中访问 WSL 文件：\\wsl$\Ubuntu\home\username\

---

最后更新时间: 2025-01-19

网友解答：

---

--【壹】--：

感谢佬友！已成功配置

---

--【贰】--：

image1079×662 13.4 KB
这咋整大佬

---

--【叁】--：

大佬在windows的wsl使用claude code有什么好处呢

---

--【肆】--：

佬,这是全整c盘了吗. 感觉内存不太够

---

--【伍】--：

感谢教程 佬这个怎么安装ccswich啊

---

--【陆】--：

感谢佬友分享，很详细

---

--【柒】--：

因为你的系统缺少 WSL 2 需要的内核组件

---

--【捌】--：

求助，为什么用的anyrouter的codex，总是显示unexpected status 403 Forbidden: {“error”:{“message”:“该令牌无权访问模型 gpt-5.1-codex-max (request id: 202512191608597519458707iTY38v6)”,“type”:“new_api_error”}}

---

--【玖】--：

感谢大佬教程

---

--【拾】--：

感谢分享

---

--【拾壹】--：

谢谢大佬

---

--【拾贰】--：

请问是Windows和wsl两个环境都装一遍CC codex吗

---

--【拾叁】--：

感谢大佬教程

---

--【拾肆】--：

感谢详细教程

---

--【拾伍】--：

无法连接到Anthropic的Claude服务，测试Anthropic连接

---

--【拾陆】--：

很详细，感谢佬友分享

---

--【拾柒】--：

感谢佬友分享，按照你的教程成功配置了

---

--【拾捌】--：

感谢大佬的教程

---

--【拾玖】--：

window10能安装吗？