Windows / WSL CLI 教程

按 OpenAI 2026-03-26 的官方文档，Windows 上最稳的 CLI 路线是 WSL。如果你主要想要原生 Windows 体验，优先用 Codex App 桌面版。

官方当前结论：
1. 原生 Windows 桌面体验：优先 Codex App
2. Windows 上要跑 CLI：优先 WSL

1. 先装 WSL

在管理员 PowerShell 里执行：

wsl --install

装完后执行：

wsl

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
nvm install 22
npm install -g @openai/codex
codex --help

export YUNCE_API_KEY="sk-在这里填你的完整Token"

以你后台实际复制出来的完整令牌为准。
不要自己手动加删 sk-。

echo 'export YUNCE_API_KEY="sk-在这里填你的完整Token"' >> ~/.bashrc
source ~/.bashrc

在 WSL 里使用这个路径：

~/.codex/config.toml

下载这个示例配置后保存进去：

https://yunce.cloud/docs/codex/yunce-codex-config.example.toml

即使你走中转站，官方 CLI 首次进入产品时仍可能先要求你用 ChatGPT 账号或 OpenAI API key 完成登录。

codex -p yunce_gpt54

第一次输入：

reply exactly ok

默认主模型: gpt-5.4
快速/省一点: gpt-5.4-mini
代码能力优先备选: gpt-5.3-codex
旧兼容轻量档: gpt-5-codex-mini

可以试，但按 OpenAI 当前文档不属于最推荐路径。
如果你只是想在 Windows 本机稳定使用 Codex，优先桌面版。

[windows]
sandbox = "elevated"
sandbox_private_desktop = true