Windows WSL2 方案（Codex）
如果你想在 Windows 上使用 Linux 终端环境，或希望换一种方式安装 Codex，可以使用 WSL2 + Ubuntu 方案。
适用场景：你希望在 Windows 上使用 Linux 终端环境，或希望把 Codex 放在 Ubuntu 环境里安装与使用。这一页提供的是完整的 WSL2 路线。
你会用到的官方页面
开始前先确认
系统
建议 Windows 11，或已开启虚拟化能力的 Windows 10。
管理员 PowerShell
安装 WSL2 时，建议以管理员身份打开 PowerShell。
Codex Key
请先到 Key 管理 创建 Codex Key。后面的命令里会用到 你的Codex_API_KEY。
第一步：安装 WSL2
1
以管理员身份打开 PowerShell
开始菜单搜索 PowerShell，右键选择“以管理员身份运行”。
2
执行安装命令
wsl --install -d Ubuntu如果你的系统较新，通常执行这一条就够了。安装完成后按提示重启电脑。
3
重启后打开 Ubuntu
重启电脑后，在开始菜单里打开 Ubuntu，第一次会提示你设置 Linux 用户名和密码。
第二步：在 Ubuntu 里准备环境
下面所有命令都在 Ubuntu 终端里执行，不是在 Windows PowerShell 里执行。
sudo apt update
sudo apt install -y curl git build-essential第三步：安装 Node.js 22
推荐使用 nvm 安装，后续更容易升级和切换版本。
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
node -v
npm -v确认 node -v 已经是 22 或更高版本，再继续下一步。
第四步：安装 Codex CLI
npm install -g @openai/codex
codex -V如果你只想先确认是否安装成功，执行 codex -V 即可。
第五步：写入积木AI的 Codex 配置
把下面命令里的 你的Codex_API_KEY 替换成你在 Key 管理里创建的真实 Codex Key。
curl -fsSL https://code.jimuxyz.com/env_deploy/codex-deploy.sh | bash -s -- "你的Codex_API_KEY"执行后会自动写入 ~/.codex/auth.json 和 ~/.codex/config.toml。
第六步：开始使用
# 进入你的项目目录（可选）
cd your-project
# 启动 Codex
codex
# 如果想继承旧历史，但按当前新配置继续
codex fork --last如果你是第一次切到积木AI，先直接运行 codex 验证新配置即可。
如果遇到问题
wsl --install不可用：看微软官方旧版系统手动安装文档。node -v不是 22+：重新执行nvm install 22和nvm use 22。- 配置后仍不是积木AI：重新执行一次
codex-deploy.sh，并确认你替换的 Key 是真实值。 - 如果只是想看 Codex 在 Linux 环境里的常规说明，也可以直接进入 macOS / Linux Codex 使用说明。