在Windows中优雅使用VSCode+codex

发表于 阅读次数：

我的主力系统是最近在用 vscode + codex，主力系统是 windows。众所周知，codex 对 windows 的 ps 终端支持简直是一坨，连读取文件这样简单的命令都需要用户手动确认运行。为了使用 codex，我一度将开发主力更换到了 mac 上。

这个国庆趁着有空，在论坛内佬友的帮助下，研究了一下如何使用 WSL + codex，现在已经可以顺畅运行了。在这里为大家分享一下使用 vscode + wsl +codex 的具体过程。

1.1 安装 WSL2

安装默认的 wsl ubuntu。管理员模式打开终端，使用如下命令安装 WSL ubuntu：

1
wsl --install

默认安装到系统盘，如果你的系统盘空间不够，使用如下步骤将你的 wsl 迁移到其他盘：

  • 查看你的 wsl 分发版名称，这里以 Ubuntu 为例
1
wsl.exe --list --verbose
  • 关闭并备份这个分发版：
1
wsl --shutdown  wsl --export Ubuntu D:/export.tar
  • 解除当前分发版本的注册
1
wsl --unregister Ubuntu
  • 重新注册分发版本
1
wsl --import Ubuntu D:\export\ D:\export.tar --version 2

1.2 在 WSL 中换源并安装 codex

1.2.1 换清华源

默认安装的 ubuntu 版本应该是 2404，如果你在国内，可以用以下方式换成清华源来提升下载速度：

  • 备份原有文件
1
sudo cp /etc/apt/sources.list.d/ubuntu.sources  /etc/apt/sources.list.d/ubuntu.sources.bak
  • 打开 ubuntu.sources 文件，注释原有内容并添加如下内容
1
Types: deb URIs: http://mirrors.tuna.tsinghua.edu.cn/ubuntu/ Suites: noble noble-updates noble-security Components: main restricted universe multiverse Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg
  • 使用如下命令更新源：sudo apt-get update sudo apt-get upgrade

1.2.2 安装 codex

使用如下命令，安装 nodejs 和 npm：sudo apt install nodejs npm

验证是否安装成功（看到版本号）：node --version npm --version

安装 codex：npm install -g @openai/codex

同样验证是否安装成功：codex --version

1.3 设置 codex 验证

这里只针对使用三方中转的 codex 情况，官方验证不知道是不是这样操作：

在你的 WSL 根目录下（路径为 ~），创建 .codex 目录：mkdir .codex

此时，在 Windows 的文件资源管理器侧栏，可以找到 Linux 图标，这是 WSL 虚拟磁盘。进入其中的 Ubuntu/home/你的用户名 目录，可以找到这个 .codex 文件夹。将 Windows 中正在使用的 .codex 目录内的 config.toml 和 auth.json 两个文件复制过来。

1.4 启动 VSCode

在你的项目目录下打开终端，使用 wsl 命令切换到 wsl 环境，使用命令 code . 在 vscode 中打开此项目目录。你可以看到你的 vscode 在 wsl 模式中打开，切换到扩展侧边栏，你会发现包括 codex 扩展在内的多个扩展会有按钮提示 在WSL：Ubuntu中安装。点击你需要在 WSL 中使用的这些扩展按钮，然后你可以在 WSL 中直接使用 Vscode + codex，此时 codex 可以顺利使用 linux 命令读取和写入文件。