WSL 安装和配置指南使用 Codex 使用 Claude Code

纯情 2025年 10月 24 日

阅读选项

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

1. 启用 Windows 功能

1.1打开 Windows 功能设置

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

打开 Windows 功能设置

1.2 启用必要功能

启用必要功能

在"启用或关闭 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: 尝试以下步骤：

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

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

wsl --update

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

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

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

1. 启用 Windows 功能

1.1打开 Windows 功能设置

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

打开 Windows 功能设置

1.2 启用必要功能

启用必要功能

在"启用或关闭 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: 尝试以下步骤：

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

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

wsl --update

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

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

WSL 安装和配置指南使用 Codex 使用 Claude Code

阅读选项

1. 启用 Windows 功能

2. 设置 WSL 版本和安装 Linux

3. 用户配置

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

5. Claude Code 安装

6. OpenAI Codex 安装

7. 常用 WSL 命令

参考资料

常见问题

1. 启用 Windows 功能

2. 设置 WSL 版本和安装 Linux

3. 用户配置

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

5. Claude Code 安装

6. OpenAI Codex 安装

7. 常用 WSL 命令

参考资料

常见问题

那年今日

微信分享二维码

随机文章

我用 GO 语言封装了一个机器学习框架，并实现了一个小型的 GPT 模型来对对联

价值3000元全新红娘交友系统定制版源码相亲交友小程序源码开源可二开免费分享

普通QQ号码点亮靓字升级靓号地址放出附带价格土豪们上吧

用 chatgpt 也用了一个多月了，谈谈自己对 chatgpt 的看法。

FBI关基项目重大事故，封闭社交网络用户数据遭黑客公布

2022年公务员考试课程

评论区(暂无评论)

我要评论

这里空空如也，快来评论吧~

WSL 安装和配置指南 使用 Codex 使用 Claude Code

阅读选项

1. 启用 Windows 功能

2. 设置 WSL 版本和安装 Linux

3. 用户配置

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

5. Claude Code 安装

6. OpenAI Codex 安装

7. 常用 WSL 命令

参考资料

常见问题

1. 启用 Windows 功能

2. 设置 WSL 版本和安装 Linux

3. 用户配置

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

5. Claude Code 安装

6. OpenAI Codex 安装

7. 常用 WSL 命令

参考资料

常见问题

那年今日

微信分享二维码

随机文章

我用 GO 语言封装了一个机器学习框架，并实现了一个小型的 GPT 模型来对对联

价值3000元全新红娘交友系统定制版源码相亲交友小程序源码开源可二开免费分享

普通QQ号码点亮靓字 升级靓号地址放出 附带价格 土豪们上吧

用 chatgpt 也用了一个多月了，谈谈自己对 chatgpt 的看法。

FBI关基项目重大事故，封闭社交网络用户数据遭黑客公布

2022年公务员考试课程

评论区(暂无评论)

我要评论

这里空空如也，快来评论吧~

WSL 安装和配置指南使用 Codex 使用 Claude Code

普通QQ号码点亮靓字升级靓号地址放出附带价格土豪们上吧