VS Code + Codex 在 WSL 中使用的正确姿势

一、背景问题

官方 Codex 扩展（openai.chatgpt）必须走 OAuth 登录。

扩展分为两类：

Local (Windows 本地)：安装在 Windows，登录成功。

Remote (WSL 环境)：登录需要在 Ubuntu 内部完成 → 会失败（403/回调错误）。

所以正确做法是：只在本地登录 Codex，用 UNC 路径访问 WSL 文件。

二、配置步骤

1. 确保 Codex 安装在本地

打开 VS Code（非 WSL 窗口，左下角不显示 WSL: …）。

扩展市场搜索 Codex – OpenAI’s coding agent。

确认 Uninstall、Disable 按钮可用 → 表示已安装在本地。

不要点击 “Install in WSL: MyUbuntu”。

2. 在本地完成 Codex 登录

本地窗口 → 扩展 → 点 Sign in。

浏览器跳转 → 登录 ChatGPT 账号 → 完成授权。

VS Code 右下角提示 “Signed in to OpenAI”。

3. 打开 WSL 项目（走 UNC 路径）

关闭 Remote-WSL 窗口（左下角 WSL: MyUbuntu → Close Remote Connection）。

在 Windows VS Code 窗口，File → Open Folder…。

输入 UNC 路径，例如：

\wsl.localhost\Ubuntu\home\wanglonglong\Learn_ROS2\SlowFast

（“Ubuntu”替换成你自己的发行版名，可在资源管理器输入 \wsl.localhost\ 查看）

如果提示 “Reopen in WSL”，选 Open Locally。

4. 验证 Codex 是否生效

打开一个 Python 文件。

输入注释：

function to calculate fibonacci numbers

按回车 → Codex 应该能自动补全。

说明本地 Codex 已经可以对 WSL 里的文件生效。

三、注意事项

不要在 Remote-WSL 再安装一份 Codex，否则会要求重复登录并失败。

如果 “Open Folder” 卡住：

临时禁用 Remote-WSL 扩展再打开。

或在命令行直接运行：

code --new-window “\wsl.localhost\Ubuntu\path\to\project”

本地登录只需一次，以后直接打开 UNC 路径即可。

四、总结

Codex 登录只能在本地完成。

文件仍可通过 UNC 路径访问 WSL → 本地 Codex 就能照常工作。

避免在 WSL 内重复安装/登录 Codex 扩展。