Win11 + WSL 完全配置指南：从零搭建 AI 编程环境

Win11 + WSL 完全配置指南：从零搭建 AI 编程环境（Claude Code / Codex / Kimi Code）

适合纯小白的保姆级教程，从安装 WSL 到用 Claude Code 修改 GitHub 项目，一条龙搞定。

前言

想在 Windows 上获得原生 Linux 开发体验，同时用上 Claude Code、OpenAI Codex、Kimi Code 这些强大的 AI 编程工具？WSL（Windows Subsystem for Linux） 是最优解。本文带你从 0 到 1，完成 WSL 安装、环境配置、AI 工具部署，以及项目实战。

一、安装 WSL 和 Ubuntu

1.1 一键安装（推荐）

以管理员身份打开 PowerShell 或 Windows 终端，执行：

powershell 复制代码

wsl --install

这条命令会自动：

启用 WSL 和虚拟机平台
安装默认的 Ubuntu 发行版
安装完成后提示重启电脑

重启后，首次启动 Ubuntu 时会要求你设置 Linux 用户名和密码（注意：输入密码时不会显示字符，这是正常的）。

1.2 验证安装

重启后从开始菜单打开 Ubuntu，看到类似下面的提示符即成功：

bash 复制代码

username@hostname:~$

查看 WSL 版本（确认是 WSL 2）：

bash 复制代码

wsl -l -v

应显示 VERSION 2。Windows 11 默认就是 WSL 2，性能更好。

二、启动 WSL 的几种方式

方式	操作
开始菜单	搜索 `Ubuntu` 并打开
PowerShell	输入 `wsl` 或 `wsl -d Ubuntu`

判断标准 ：提示符是 用户名@主机名:~$ 就是 Linux；C:\Users> 就是 Windows。

三、基础环境配置

打开 Ubuntu 终端后，先更新系统：

bash 复制代码

sudo apt update && sudo apt upgrade -y

apt upgrade 后不需要重启 Windows，但建议重启一下 WSL 实例：

powershell 复制代码

wsl --shutdown

然后重新打开 Ubuntu 窗口即可。

四、安装开发环境（Git + Node.js）

4.1 安装 Git 和基础工具

bash 复制代码

sudo apt install -y git curl

验证：

bash 复制代码

git --version

4.2 安装 Node.js（24.x LTS）

Claude Code、Codex 都是基于 Node.js 的，必须安装。

bash 复制代码

# 添加 NodeSource 24.x 软件源
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -

# 安装 Node.js
sudo apt install -y nodejs

验证：

bash 复制代码

node -v   # 应显示 v24.x.x
npm -v    # 应显示 10.x.x 或更高

注意：setup_24.x 是配置软件源的脚本，不是安装命令本身。24.x 是 2026 年的最新 LTS 版本，推荐。

五、安装 AI 编程 CLI 工具

5.1 Claude Code（官方推荐安装方式）

bash 复制代码

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

这是 Anthropic 官方提供的脚本，会自动处理 Node 环境检查和安装。

验证：

bash 复制代码

claude --version

5.2 OpenAI Codex

bash 复制代码

curl -fsSL https://chatgpt.com/codex/install.sh | sh

验证：

bash 复制代码

codex --version

5.3 Kimi Code

bash 复制代码

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

验证：

bash 复制代码

kimi --version

六、Git 配置与 GitHub 认证

6.1 配置 Git 身份

bash 复制代码

git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub邮箱"

验证：

bash 复制代码

git config --global user.name
git config --global user.email

6.2 配置 SSH 密钥（推荐，长期稳定）

GitHub 已不支持密码直接推送，SSH 密钥是最安全、最方便的方式。

步骤 1：生成 SSH 密钥

bash 复制代码

ssh-keygen -t ed25519 -C "你的GitHub邮箱"

一路按回车（使用默认路径，不设置密码）。

步骤 2：复制公钥内容

bash 复制代码

cat ~/.ssh/id_ed25519.pub

复制输出的全部内容（以 ssh-ed25519 开头）。

步骤 3：添加到 GitHub

访问 https://github.com/settings/keys
点击 New SSH key
Title 随便填（如 WSL-Ubuntu）
Key 粘贴刚才复制的内容
点击 Add SSH key

步骤 4：测试连接

bash 复制代码

ssh -T git@github.com

看到 Hi xxx! You've successfully authenticated... 即成功。

步骤 5：克隆项目改用 SSH 地址

bash 复制代码

git clone git@github.com:你的用户名/你的项目.git

注意：GitHub 仓库页面的 SSH 地址和 HTTPS 地址不同，确保复制的是 SSH 地址。

七、项目操作：克隆新项目 vs 访问 Windows 项目

7.1 方案 A：从 GitHub 克隆新项目（推荐）

bash 复制代码

# 1. 在主目录创建项目文件夹
mkdir ~/projects && cd ~/projects

# 2. 克隆仓库（使用 SSH 地址）
git clone git@github.com:你的用户名/你的项目.git

# 3. 进入项目并启动 AI 工具
cd 你的项目
claude

7.2 方案 B：直接访问 Windows 现有项目

WSL 中 Windows 磁盘挂载在 /mnt/ 下：

Windows 路径	WSL 路径
`C:\Users\你的用户名\project`	`/mnt/c/Users/你的用户名/project`
`D:\code`	`/mnt/d/code`

直接访问：

bash 复制代码

cd /mnt/c/Users/你的用户名/你的项目
claude

缺点：通过 /mnt/c/ 访问性能较差，Git 操作偶尔有权限问题。

7.3 方案 C：复制到 WSL（性能最佳）

bash 复制代码

# 从 Windows 复制到 WSL 自己的文件系统
cp -r /mnt/c/Users/你的用户名/你的项目 ~/你的项目

# 以后直接操作
cd ~/你的项目
claude

优点：速度快、权限正常、Git 不报错。

缺点：Windows 侧访问需通过 \\wsl$\Ubuntu\home\用户名\。

八、WSL 目录结构速查

记住这几个路径就够了：

路径	含义	类比 Windows
`~` 或 `/home/你的用户名`	你的主目录	`C:\Users\你的用户名`
`~/projects`	推荐的项目存放处	自建
`/mnt/c/`	Windows C 盘	`C:\`
`/usr/bin/`	安装的软件	`C:\Program Files\`

常用命令：

bash 复制代码

pwd        # 查看当前位置
ls         # 列出文件
mkdir xxx  # 创建文件夹
cd xxx     # 进入文件夹

九、最佳工作流：VS Code + WSL

如果你用 VS Code，这是最强组合：

Windows 上 安装 VS Code，扩展商店搜索安装 WSL（Microsoft 官方发布）
WSL 终端里 进入项目目录，执行：
bash 复制代码
```
code .
```
VS Code 自动连接到 WSL，你在 Windows 上写代码，AI 工具在 WSL 终端里运行。

这样：

✅ 编辑器在 Windows，体验最好
✅ 代码执行在 WSL，性能最好
✅ 终端工具（claude / codex / kimi）在 Linux 环境，兼容最佳

十、小白速查表

我想做	命令
打开 WSL	开始菜单 → Ubuntu
更新系统	`sudo apt update && sudo apt upgrade -y`
创建并进入文件夹	`mkdir project && cd project`
克隆项目（SSH）	`git clone git@github.com:用户名/项目.git`
启动 Claude Code	`claude`
启动 Codex	`codex`
启动 Kimi Code	`kimi`
退出 AI 工具	`exit` 或 `Ctrl+C`
查看改动	`git status` / `git diff`
提交代码	`git add . && git commit -m "说明"`
推送到 GitHub	`git push`
退出 WSL	`exit`

结语

现在你已经拥有了一套完整的 Windows + WSL + AI 编程环境。核心逻辑是：WSL 提供 Linux 环境，Windows 提供编辑器，AI 工具在 Linux 里跑，项目文件放在 WSL 文件系统中性能最佳。

如果遇到报错，优先检查：

是否在 WSL 终端里（不是 Windows PowerShell）
Node.js 版本是否 24.x（node -v）
API Key 是否已配置（echo $ANTHROPIC_API_KEY）
SSH 密钥是否已添加到 GitHub（ssh -T git@github.com）

祝编码愉快！