1. Mac 上 Remote SSH 连上后 Codex 却调不动模型问题到底出在哪VS Code 通过 Remote SSH 连到远程 Linux 主机之后Codex 插件在本地窗口里看着是装好了但一发起对话就转圈、报 NetworkError或者干脆提示模型不可用。这个现象在 Mac 上尤其常见因为本地是 macOS、远程是 Linux插件运行位置、网络出口、Key 读取路径三者很容易错位。Codex 插件本质上是一个跑在扩展宿主里的客户端它需要拿到一个可用的 API 地址和 Key才能把请求发出去。Remote SSH 场景下扩展可能被安装在远程侧也可能在本地侧而你的 Key 如果只写在本地 settings.json远程侧就读不到于是请求发不出去。这篇笔记面向的是已经在用 VS Code Remote SSH 做远程开发、并且希望把 Codex 接到统一 API 通道上的 Mac 用户。核心思路是不去反复重装插件而是先把 settings.json 骨架搭对把统一 Key 和 API 通道配好再用 SSH 端口转发和一条 curl 验证连通性最后按报错来源逐层排查。整套动作都可以复制粘贴不需要你理解 Electron 渲染细节。我试过在远程会话里直接改插件配置结果发现改的是远程侧的 settings本地窗口的 Codex 面板根本不读那份文件。踩过的坑就是配置写对了地方但写错了侧。所以下面会先把「配置该写在哪一侧」讲清楚再给可复制的片段。2. 前置准备TaoToken 统一 Key 与 API 通道在动 settings.json 之前先把 Key 和 API 地址准备好。TaoToken 的作用是提供一个统一的 API 入口你只需要一个 Key就能在 Codex、Claude Code、Coding Plan 等不同工具里复用同一套通道不用每个工具单独去配一套地址和凭证。对 Remote SSH 场景来说这一点很关键远程主机和本地 Mac 只要都能访问同一个 API 地址配置就可以保持一致排查时变量更少。你需要做两件事。第一在控制台创建一个 API Key建议单独建一个给 Codex 用方便后续按 Key 维度看调用情况。第二确认 API 基础地址Codex 这类工具通常要求填一个 base URLTaoToken 的 API 入口是https://taotoken.net/api注意这个地址不带任何查询参数直接作为 base URL 使用。创建 Key 的入口在控制台登录后进入 API Keys 页面新建即可。如果你还没注册可以先从官网进https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。注册和建 Key 的过程不复杂这里不展开重点放在配置和验证上。拿到 Key 之后先别急着写进 VS Code。打开 Mac 的终端用一条 curl 确认这个 Key 和地址在你的网络环境下是通的curl -sS https://taotoken.net/api/v1/models \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json | head -c 500如果返回一段包含模型列表的 JSON说明 Key 和通道本身没问题问题就锁定在 VS Code 或 Remote SSH 这一层。如果这条 curl 就失败那先解决网络和 Key 的问题别往下走。这一步是整个排查的分水岭能帮你省掉大量在插件里瞎试的时间。3. 可复制配置settings.json 骨架与 Remote SSH 端口转发3.1 先判断 Codex 扩展跑在哪一侧Remote SSH 连接成功后VS Code 左下角会显示SSH: 主机名。此时打开扩展面板看 Codex 插件旁边有没有「Install in SSH: 主机名」的按钮。如果有说明它当前只装在本地你需要决定装在哪一侧。推荐做法是装在远程侧因为远程主机通常才是你实际写代码、跑命令的地方Codex 要读的文件、要执行的上下文都在远程。判断方法在远程窗口里按CmdShiftP输入Extensions: Show Installed Extensions看 Codex 是否出现在列表里。如果只在本地窗口出现就在远程窗口重新装一次。3.2 settings.json 骨架配置要写在 Codex 实际运行的那一侧。如果你把扩展装在远程就编辑远程侧的 settings.json如果装在本地就编辑本地。打开方式CmdShiftP→Preferences: Open Remote Settings (JSON)或Preferences: Open User Settings (JSON)取决于你要改哪一侧。下面是一份可直接复制的骨架把sk-你的Key替换成你自己的{ codex.apiBaseUrl: https://taotoken.net/api, codex.apiKey: sk-你的Key, codex.model: gpt-4o-mini, codex.requestTimeout: 60000, codex.enableTelemetry: false, remote.SSH.connectTimeout: 60, remote.SSH.useLocalServer: true }几个参数说明。codex.apiBaseUrl指向 TaoToken 的 API 入口注意结尾不要多加斜杠也不要带/v1具体路径由插件自己拼接。codex.apiKey填你刚建的 Key。codex.model先填一个轻量模型做连通性验证等通了再换成你日常用的。codex.requestTimeout给到 60 秒远程链路偶尔抖动太短会误报超时。remote.SSH.connectTimeout调大一点避免连接阶段就断。注意不同版本的 Codex 插件配置项名称可能略有差异如果codex.apiBaseUrl不生效在设置界面搜索codex看实际键名以插件文档为准。上面这份骨架的价值在于结构键名按你装的版本微调。3.3 SSH 端口转发验证Remote SSH 本身会把远程的端口转发到本地但如果你怀疑是转发链路的问题可以手动加一条本地转发来验证。编辑 Mac 上的~/.ssh/config给目标主机加上Host my-remote HostName 192.168.1.100 User yourname LocalForward 8899 taotoken.net:443 ServerAliveInterval 30 ServerAliveCountMax 3LocalForward 8899 taotoken.net:443的意思是把本地的 8899 端口转发到taotoken.net的 443 端口。加完之后重新连接然后在 Mac 终端执行curl -sS https://localhost:8899/api/v1/models \ -H Authorization: Bearer sk-你的Key \ --resolve taotoken.net:8899:127.0.0.1 | head -c 300如果这条能通说明从本地到 API 地址的链路是好的问题在插件配置或扩展宿主。如果这条不通说明是网络出口层面的问题需要检查远程主机或本地 Mac 的出网策略。这一步能把「网络问题」和「配置问题」彻底分开。4. 验证请求从 curl 到 Codex 面板的成功结果配置写完先别急着在 Codex 面板里发消息。按顺序做三层验证每层都拿到明确结果再往下走。第一层远程主机上直接 curl。SSH 进远程主机执行curl -sS -o /dev/null -w %{http_code}\n https://taotoken.net/api/v1/models \ -H Authorization: Bearer sk-你的Key返回200说明远程主机出网正常、Key 有效。返回401是 Key 问题返回000或超时是网络问题。第二层在 VS Code 远程窗口里打开集成终端执行同样的 curl。这一步验证的是 VS Code 终端环境是否继承了正确的网络配置。如果远程主机 curl 通、VS Code 终端 curl 不通说明 VS Code 启动时的环境变量和登录 shell 不一致常见于代理相关变量没被继承。第三层打开 Codex 面板发一条最简单的消息比如「回复 ok」。如果前面两层都通这一层通常就能成功。成功时你会看到模型正常返回内容而不是转圈或 NetworkError。如果第三层失败但前两层都通打开CmdShiftP→Developer: Open Webview Developer Tools切到 Console 标签看具体报错。常见的是NetworkError后面跟一个地址如果那个地址不是taotoken.net说明插件还在用默认地址你的codex.apiBaseUrl没生效回去检查键名和配置写在哪一侧。5. 本篇常见错排查5.1 NetworkError 指向了非预期地址Console 里出现NetworkError https://chatgpt.com/...这类报错说明插件没有读取你配置的 base URL仍在走默认端点。原因通常是配置写在了本地侧而扩展跑在远程侧或者键名拼错。解决确认扩展运行侧在对应侧的 settings.json 里改改完Developer: Reload Window重载窗口。5.2 窗口无响应与 Codex 卡死如果出现The window is not responding先别重装。打开Help→Open Process Explorer看Window和Extension Host的 CPU。Window 飙到 100% 以上通常是 Electron 渲染层异常Extension Host 高则是某个插件死循环。最快的恢复动作是CmdShiftP→Developer: Reload Window多数情况重载即可恢复。如果重载后仍卡退出 VS Code在 Mac 终端执行open -a Visual Studio Code --args --disable-gpu这会禁用界面渲染的 GPU 加速用来验证是不是渲染层问题。注意这里禁的是 Electron 的界面 GPU跟远程主机上的 CUDA、PyTorch 训练完全无关python train.py或CUDA_VISIBLE_DEVICES0 python train.py的性能不受影响。5.3 监听器泄漏导致越用越卡Console 里如果出现potential listener LEAK detected并伴随几百个 listener说明有重复注册。这类问题往往和 WebView 或某个插件有关短期靠Developer: Reload Window缓解长期要定位是哪个插件。排查顺序先禁用 Codex 观察再禁用其他 AI 类插件最后看 Remote SSH 本身。不要一上来就回退 VS Code 版本。5.4 配置改了但没生效最常见的原因是改错了侧或者改完没重载窗口。Remote SSH 场景下本地 settings 和远程 settings 是两份文件插件读哪份取决于它装在哪。改完务必Developer: Reload Window让扩展宿主重新加载配置。6. 把 Key 和通道固定下来后续排查才有基准整套流程走下来你会发现真正花时间的不是配置本身而是「不知道问题在哪一层」。把 TaoToken 的统一 Key 和 API 地址固定下来之后你就有了一个稳定的基准curl 能通说明通道没问题curl 不通就别在插件里折腾。这个基准能让你每次排查都从确定的地方出发。如果你主要是在远程会话里做长期编码、跑 Agent 任务建议把 Key 和通道配置固化到远程侧的 settings并考虑用 Coding Plan 来管理调用额度避免临时 Key 过期导致远程任务中断。配置入口和额度管理都在控制台登录后可以按项目或按 Key 维度查看。对于需要频繁验证模型输出、对比不同模型效果的场景可以直接用模型对话页面快速试不用每次都回到 VS Code 里发消息。而接入相关的细节比如 base URL 的拼接规则、鉴权头的格式接入文档里有完整说明遇到键名或路径不确定时以文档为准。最后留一个实用习惯每次 Codex 出问题先保存现场。打开 Process Explorer 和 Webview Developer Tools把 CPU 占用和 Console 报错截图再执行Developer: Reload Window。因为重载之后关键日志通常会消失先截图能让你在问题复现时快速定位而不是靠记忆猜。