本地windows系统在vscode中配置远程Linux服务器codex终端的方法

目标：在远程Linux服务器的终端中安装类似Claude code交互界面的codex、且不影响其他调用国内大模型api的工具的正常使用

步骤：
0. 准备工作

• 拥有稳定的ladder（不一定要很贵或者延迟很小）；
• 在github下载完整的codex命令行终端安装包，含有不同系统适配版本的下载页面地址是https://github.com/openai/codex/releases/tag/rust-v0.164.0
  等页面加载完整后、在下方的资源中搜索带 codex-package- 前缀、 .tar.gz 后缀的完整包，而不是只有单个可执行文件的 codex- 包，比如博主需要安装在linux系统中，则选择codex-package-x86_64-unknown-linux-musl.tar.gz 
• 从本地电脑上传安装压缩包到服务器上，依次执行如下命令，实现在默认的用户主目录下解压缩、安装、建立软链接并确保安装目录在环境变量路径中、最终查看版本号确认已实现安装：

• mkdir -p ~/.local/lib/codex ~/.local/bin
  tar -xzf 上传的目录/codex-package-x86_64-unknown-linux-musl.tar.gz \
    -C ~/.local/lib/codex
  ln -s ~/.local/lib/codex/bin/codex ~/.local/bin/codex
  export PATH="$HOME/.local/bin:$PATH"
  codex --version

   到此步骤都不需要更改网络环境。

1. 打开本地代理软件和代理开关，选择规则模式
先确保本地代理能用，一般浏览器会直接使用本地代理，所以至少确保浏览器能访问外网
在代理软件中找到四位本地代理端口，一般是7890或者7897

2. 保持PowerShell 常驻 SSH 隧道打开

ssh -N -R 五位远程服务器监听端口:127.0.0.1:四位本地代理端口 ABC@远程服务器IP地址

也就是powershell的窗口一直挂着不关闭，远程服务器监听端口可以随意设置一个不用的端口，比如19999

 

3. 验证登录状态

如果之前已经在vscode中安装了codex插件并在**连接下成功登录、~/.codex/下一般会有auth.json这个包含登录信息的缓存、这里就不需要重新跳转网页登录；如没在该服务器上登录过，则需重新登录或者复制一份auth.json文件到~/.codex/下尝试绕开登录。

codex login status
codex login

 

4. 一些常用调试

• 在Linux服务器上验证使用代理时可以返回HTTP/2 200

curl -I --max-time 15 -x http://127.0.0.1:19999 https://www.google.com

• 远程服务器被断连或重启后，powershell的ssh连接会断开，需要重新执行powershell中的ssh命令，
  另外要在远程Linux服务器的终端重新设置代理环境变量、重启codex app-server，如下：
  以下设置在随便一个终端窗口设置即可，其余新的终端下运行codex会直接继承app-server已有的最新状态。

export HTTP_PROXY=http://127.0.0.1:四位本地代理端口
export HTTPS_PROXY=http://127.0.0.1:四位本地代理端口
codex app-server daemon restart

（空位）