Win11 WSL 完全配置指南从零搭建 AI 编程环境Claude Code / Codex / Kimi Code适合纯小白的保姆级教程从安装 WSL 到用 Claude Code 修改 GitHub 项目一条龙搞定。前言想在 Windows 上获得原生 Linux 开发体验同时用上 Claude Code、OpenAI Codex、Kimi Code 这些强大的 AI 编程工具WSLWindows Subsystem for Linux是最优解。本文带你从 0 到 1完成 WSL 安装、环境配置、AI 工具部署以及项目实战。一、安装 WSL 和 Ubuntu1.1 一键安装推荐以管理员身份打开 PowerShell 或 Windows 终端执行wsl--install这条命令会自动启用 WSL 和虚拟机平台安装默认的 Ubuntu 发行版安装完成后提示重启电脑重启后首次启动 Ubuntu 时会要求你设置Linux 用户名和密码注意输入密码时不会显示字符这是正常的。1.2 验证安装重启后从开始菜单打开Ubuntu看到类似下面的提示符即成功usernamehostname:~$查看 WSL 版本确认是 WSL 2wsl-l-v应显示VERSION 2。Windows 11 默认就是 WSL 2性能更好。二、启动 WSL 的几种方式方式操作开始菜单搜索Ubuntu并打开PowerShell输入wsl或wsl -d Ubuntu判断标准提示符是用户名主机名:~$就是 LinuxC:\Users就是 Windows。三、基础环境配置打开 Ubuntu 终端后先更新系统sudoaptupdatesudoaptupgrade-yapt upgrade后不需要重启 Windows但建议重启一下 WSL 实例wsl--shutdown然后重新打开 Ubuntu 窗口即可。四、安装开发环境Git Node.js4.1 安装 Git 和基础工具sudoaptinstall-ygitcurl验证git--version4.2 安装 Node.js24.x LTSClaude Code、Codex 都是基于 Node.js 的必须安装。# 添加 NodeSource 24.x 软件源curl-fsSLhttps://deb.nodesource.com/setup_24.x|sudo-Ebash-# 安装 Node.jssudoaptinstall-ynodejs验证node-v# 应显示 v24.x.xnpm-v# 应显示 10.x.x 或更高注意setup_24.x是配置软件源的脚本不是安装命令本身。24.x是 2026 年的最新 LTS 版本推荐。五、安装 AI 编程 CLI 工具5.1 Claude Code官方推荐安装方式curl-fsSLhttps://claude.ai/install.sh|bash这是 Anthropic 官方提供的脚本会自动处理 Node 环境检查和安装。验证claude--version5.2 OpenAI Codexcurl-fsSLhttps://chatgpt.com/codex/install.sh|sh验证codex--version5.3 Kimi Codecurl-fsSLhttps://code.kimi.com/kimi-code/install.sh|bash验证kimi--version六、Git 配置与 GitHub 认证6.1 配置 Git 身份gitconfig--globaluser.name你的GitHub用户名gitconfig--globaluser.email你的GitHub邮箱验证gitconfig--globaluser.namegitconfig--globaluser.email6.2 配置 SSH 密钥推荐长期稳定GitHub 已不支持密码直接推送SSH 密钥是最安全、最方便的方式。步骤 1生成 SSH 密钥ssh-keygen-ted25519-C你的GitHub邮箱一路按回车使用默认路径不设置密码。步骤 2复制公钥内容cat~/.ssh/id_ed25519.pub复制输出的全部内容以ssh-ed25519开头。步骤 3添加到 GitHub访问 https://github.com/settings/keys点击New SSH keyTitle 随便填如WSL-UbuntuKey 粘贴刚才复制的内容点击Add SSH key步骤 4测试连接ssh-Tgitgithub.com看到Hi xxx! Youve successfully authenticated...即成功。步骤 5克隆项目改用 SSH 地址gitclone gitgithub.com:你的用户名/你的项目.git注意GitHub 仓库页面的 SSH 地址和 HTTPS 地址不同确保复制的是 SSH 地址。七、项目操作克隆新项目 vs 访问 Windows 项目7.1 方案 A从 GitHub 克隆新项目推荐# 1. 在主目录创建项目文件夹mkdir~/projectscd~/projects# 2. 克隆仓库使用 SSH 地址gitclone gitgithub.com:你的用户名/你的项目.git# 3. 进入项目并启动 AI 工具cd你的项目 claude7.2 方案 B直接访问 Windows 现有项目WSL 中 Windows 磁盘挂载在/mnt/下Windows 路径WSL 路径C:\Users\你的用户名\project/mnt/c/Users/你的用户名/projectD:\code/mnt/d/code直接访问cd/mnt/c/Users/你的用户名/你的项目 claude缺点通过/mnt/c/访问性能较差Git 操作偶尔有权限问题。7.3 方案 C复制到 WSL性能最佳# 从 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\常用命令pwd# 查看当前位置ls# 列出文件mkdirxxx# 创建文件夹cdxxx# 进入文件夹九、最佳工作流VS Code WSL如果你用 VS Code这是最强组合Windows 上安装 VS Code扩展商店搜索安装WSLMicrosoft 官方发布WSL 终端里进入项目目录执行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克隆项目SSHgit clone gitgithub.com:用户名/项目.git启动 Claude Codeclaude启动 Codexcodex启动 Kimi Codekimi退出 AI 工具exit或CtrlC查看改动git status/git diff提交代码git add . git commit -m 说明推送到 GitHubgit push退出 WSLexit结语现在你已经拥有了一套完整的 Windows WSL AI 编程环境。核心逻辑是WSL 提供 Linux 环境Windows 提供编辑器AI 工具在 Linux 里跑项目文件放在 WSL 文件系统中性能最佳。如果遇到报错优先检查是否在 WSL 终端里不是 Windows PowerShellNode.js 版本是否 24.xnode -vAPI Key 是否已配置echo $ANTHROPIC_API_KEYSSH 密钥是否已添加到 GitHubssh -T gitgithub.com祝编码愉快
Win11 + WSL 完全配置指南：从零搭建 AI 编程环境
Win11 WSL 完全配置指南从零搭建 AI 编程环境Claude Code / Codex / Kimi Code适合纯小白的保姆级教程从安装 WSL 到用 Claude Code 修改 GitHub 项目一条龙搞定。前言想在 Windows 上获得原生 Linux 开发体验同时用上 Claude Code、OpenAI Codex、Kimi Code 这些强大的 AI 编程工具WSLWindows Subsystem for Linux是最优解。本文带你从 0 到 1完成 WSL 安装、环境配置、AI 工具部署以及项目实战。一、安装 WSL 和 Ubuntu1.1 一键安装推荐以管理员身份打开 PowerShell 或 Windows 终端执行wsl--install这条命令会自动启用 WSL 和虚拟机平台安装默认的 Ubuntu 发行版安装完成后提示重启电脑重启后首次启动 Ubuntu 时会要求你设置Linux 用户名和密码注意输入密码时不会显示字符这是正常的。1.2 验证安装重启后从开始菜单打开Ubuntu看到类似下面的提示符即成功usernamehostname:~$查看 WSL 版本确认是 WSL 2wsl-l-v应显示VERSION 2。Windows 11 默认就是 WSL 2性能更好。二、启动 WSL 的几种方式方式操作开始菜单搜索Ubuntu并打开PowerShell输入wsl或wsl -d Ubuntu判断标准提示符是用户名主机名:~$就是 LinuxC:\Users就是 Windows。三、基础环境配置打开 Ubuntu 终端后先更新系统sudoaptupdatesudoaptupgrade-yapt upgrade后不需要重启 Windows但建议重启一下 WSL 实例wsl--shutdown然后重新打开 Ubuntu 窗口即可。四、安装开发环境Git Node.js4.1 安装 Git 和基础工具sudoaptinstall-ygitcurl验证git--version4.2 安装 Node.js24.x LTSClaude Code、Codex 都是基于 Node.js 的必须安装。# 添加 NodeSource 24.x 软件源curl-fsSLhttps://deb.nodesource.com/setup_24.x|sudo-Ebash-# 安装 Node.jssudoaptinstall-ynodejs验证node-v# 应显示 v24.x.xnpm-v# 应显示 10.x.x 或更高注意setup_24.x是配置软件源的脚本不是安装命令本身。24.x是 2026 年的最新 LTS 版本推荐。五、安装 AI 编程 CLI 工具5.1 Claude Code官方推荐安装方式curl-fsSLhttps://claude.ai/install.sh|bash这是 Anthropic 官方提供的脚本会自动处理 Node 环境检查和安装。验证claude--version5.2 OpenAI Codexcurl-fsSLhttps://chatgpt.com/codex/install.sh|sh验证codex--version5.3 Kimi Codecurl-fsSLhttps://code.kimi.com/kimi-code/install.sh|bash验证kimi--version六、Git 配置与 GitHub 认证6.1 配置 Git 身份gitconfig--globaluser.name你的GitHub用户名gitconfig--globaluser.email你的GitHub邮箱验证gitconfig--globaluser.namegitconfig--globaluser.email6.2 配置 SSH 密钥推荐长期稳定GitHub 已不支持密码直接推送SSH 密钥是最安全、最方便的方式。步骤 1生成 SSH 密钥ssh-keygen-ted25519-C你的GitHub邮箱一路按回车使用默认路径不设置密码。步骤 2复制公钥内容cat~/.ssh/id_ed25519.pub复制输出的全部内容以ssh-ed25519开头。步骤 3添加到 GitHub访问 https://github.com/settings/keys点击New SSH keyTitle 随便填如WSL-UbuntuKey 粘贴刚才复制的内容点击Add SSH key步骤 4测试连接ssh-Tgitgithub.com看到Hi xxx! Youve successfully authenticated...即成功。步骤 5克隆项目改用 SSH 地址gitclone gitgithub.com:你的用户名/你的项目.git注意GitHub 仓库页面的 SSH 地址和 HTTPS 地址不同确保复制的是 SSH 地址。七、项目操作克隆新项目 vs 访问 Windows 项目7.1 方案 A从 GitHub 克隆新项目推荐# 1. 在主目录创建项目文件夹mkdir~/projectscd~/projects# 2. 克隆仓库使用 SSH 地址gitclone gitgithub.com:你的用户名/你的项目.git# 3. 进入项目并启动 AI 工具cd你的项目 claude7.2 方案 B直接访问 Windows 现有项目WSL 中 Windows 磁盘挂载在/mnt/下Windows 路径WSL 路径C:\Users\你的用户名\project/mnt/c/Users/你的用户名/projectD:\code/mnt/d/code直接访问cd/mnt/c/Users/你的用户名/你的项目 claude缺点通过/mnt/c/访问性能较差Git 操作偶尔有权限问题。7.3 方案 C复制到 WSL性能最佳# 从 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\常用命令pwd# 查看当前位置ls# 列出文件mkdirxxx# 创建文件夹cdxxx# 进入文件夹九、最佳工作流VS Code WSL如果你用 VS Code这是最强组合Windows 上安装 VS Code扩展商店搜索安装WSLMicrosoft 官方发布WSL 终端里进入项目目录执行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克隆项目SSHgit clone gitgithub.com:用户名/项目.git启动 Claude Codeclaude启动 Codexcodex启动 Kimi Codekimi退出 AI 工具exit或CtrlC查看改动git status/git diff提交代码git add . git commit -m 说明推送到 GitHubgit push退出 WSLexit结语现在你已经拥有了一套完整的 Windows WSL AI 编程环境。核心逻辑是WSL 提供 Linux 环境Windows 提供编辑器AI 工具在 Linux 里跑项目文件放在 WSL 文件系统中性能最佳。如果遇到报错优先检查是否在 WSL 终端里不是 Windows PowerShellNode.js 版本是否 24.xnode -vAPI Key 是否已配置echo $ANTHROPIC_API_KEYSSH 密钥是否已添加到 GitHubssh -T gitgithub.com祝编码愉快
