Codex 连接远程服务器 踩坑记录OpenAI Codex App桌面客户端原生支持SSH远程项目不推荐VSCode Codex插件Remote‑SSH存在兼容性bug工作原理本地Codex App读取本机~/.ssh/configSSH连接远程Linux服务器在远端启动 codex‑server /codex‑code‑mode‑host。文件读写、Shell命令、Agent执行全部运行在远程服务器UI 交互走本地远程 codex 服务仍然会发出鉴权、token 刷新网络请求内网隔离环境必须依靠 SSH‑R 隧道代理三步速通步骤1打开本地代理你得有个靠谱的梯子步骤2电脑按Win输入cmd打开命令提示符界面#SSH反向代理连接注意替换登录用户名和远程服务器IPssh-R 7123:127.0.0.1:7890-o ServerAliveInterval30 user_namehost_IP#执行下面两行代码添加远程环境变量export http_proxyhttp://127.0.0.1:7123 export https_proxyhttp://127.0.0.1:7123#检查代理是否成功能输出模型信息表示成功curl-I--max-time 20 https://api.openai.com/v1/models重要规则-R 远程端口:本机地址:本机代理端口顺序不可颠倒。如果不用反向代理无法使用ChatGPT见Bug1一般代理常用的端口是7890但往往常用的端口容易存在占用见Bug2所以这里特地将远程端口换成不常用端口比如7123设置的远程环境变量如http_proxyhttp://127.0.0.1:7123要跟前面填写的远程端口7123保持一致我的Linux系统是Ubuntu18.04其自带curl版本老旧不识别ALL_PROXY环境变量需使用http_proxy和https_proxy确保本地计算机已成功连接代理并且本地端口为7890代理软件中可以设置本地PowerShell登录后窗口保持打开不能关闭步骤3远程服务器下载Codex-CLI并登录账号# 创建codex目录mkdir-p~/.codex/bincd~/.codex/bin# 下载最新 codex linux‑x86_64 musl 版本wgethttps://mirror.ghproxy.com/https://github.com/openai/codex/releases/latest/download/codex-x86_64-unknown-linux-musl.tar.gz# 下载最新 codex-code-mode-host linux‑x86_64 musl 版本wgethttps://mirror.ghproxy.com/https://github.com/openai/codex/releases/latest/download/codex-code-mode-host-x86_64-unknown-linux-musl.tar.gz# 解压tar-zxvfcodex-x86_64-unknown-linux-musl.tar.gztar-zxvfcodex-code-mode-host-x86_64-unknown-linux-musl.tar.gz# 重命名二进制mvcodex-x86_64-unknown-linux-musl codexmvcodex-code-mode-host-x86_64-unknown-linux-musl.tar.gz codex-code-mode-hostchmodx codexchmodx codex-code-mode-host# 把目录加入PATHechoexport PATH$HOME/.codex/bin:$PATH~/.bashrcsource~/.bashrc# 验证codex--version# 登录ChatGPT账户或者输入APIcodex login --device-auth重要规则如果下载失败见Bug3比如Unable to establish SSL connection报错可以手动下载文件到本地然后上传到~/.codex/bin目录下两个文件都需要刚开始我只下了codex结果报错见Bug5)验证成功后登录账号或API享用步骤4打开Codex App桌面客户端 – 设置 – 连接 – SSH – 添加添加远程服务器连接成功即代表Codex原生支持SSH远程项目。本次踩坑关键Bug与解决方案Bug1内网服务器无法直连OpenAIFailed to connect to api.openai.com port 443需要SSH反向隧道做代理现象远程服务器访问OpenAI接口超时/失败方案本地Windows开启代理使用ssh -R反向端口转发将本机代理隧道映射到远程服务器Bug2远程端口转发失败remote port forwarding failed for listen port xxx现象远程端口被其他进程占用SSH‑R绑定失败方案更换空闲高位端口如7123不要强行复用被占用端口。Bug3服务器无法访问github镜像wget下载Codex包失败Connecting to github.com (github.com)|20.205.243.166|:443...或Unable to establish SSL connection现象服务器网络受限无法下载release压缩包方案本地浏览器下载tar.gz使用scp上传至远程服务器离线部署。Bug4Code Mode报错codex-code-mode-host: host executable was not found现象只有codex主程序缺少配套sidecar二进制方案同时下载两个release包codex-x86_64-unknown-linux-musl.tar.gz、codex-code-mode-host-x86_64-unknown-linux-musl.tar.gz将两个程序解压放到同一个目录~/.codex/bin/赋予执行权限。