排查与支持

Codex 连接问题

一直 Reconnecting 1/5？先确认连接层，再配置代理、完全退出并验证。

诊断→确认代理→彻底重启→验证

1. 先确认问题

终端 · 查询版本与诊断能力

codex --version
codex doctor --help
codex doctor

支持该诊断命令的版本可输出安装、配置、认证及运行环境报告。如果显示未知命令，请先按当前客户端的官方说明更新或使用内置诊断。

如果报告或日志包含 Connectivity → websocket，观察是否出现 HTTP 101 Switching Protocols 或 websocket connected。这说明握手/连接阶段成功，仍需发送简单任务验证模型响应；不同版本的输出字段可能不同。

持续 Reconnecting 可能与 WSS/代理路径有关，也可能是认证、供应商配置或上游异常，不能仅凭重连提示确定原因。

2. 配置代理环境变量

先在 Clash / v2rayN 中确认实际 HTTP 或 mixed 监听端口。图中的 7890、10808 只是常见示例；若该端口仅支持 SOCKS，就不能直接填写成 http://。

PowerShell · 仅对当前会话及子进程生效

# 改成本机实际 HTTP / mixed 端口；不要填写 SOCKS 端口
$proxyPort = Read-Host "HTTP 代理端口"
if ($proxyPort -notmatch '^\d+$' -or [int]$proxyPort -lt 1 -or [int]$proxyPort -gt 65535) { throw "代理端口无效" }
$env:HTTP_PROXY = "http://127.0.0.1:$proxyPort"
$env:HTTPS_PROXY = $env:HTTP_PROXY
# Windows 环境变量名称不区分大小写，无需重复设置小写
$env:NO_PROXY = "127.0.0.1,localhost,::1"
# 从这个终端启动 CLI，才能继承以上变量
codex

关于 ~/.codex/.env

原图建议把下列变量写入 ~/.codex/.env。仅在确认当前客户端/启动器支持读取该文件时使用：不能假定所有 Codex Desktop、CLI 和 VS Code 版本都自动加载它。不要覆盖已有文件；合并需要的变量并按当前客户端文档验证。

.env 变量示例 · 需确认当前客户端支持

# 将 7890 改成本机代理软件的 HTTP / mixed 监听端口
HTTP_PROXY=http://127.0.0.1:7890
HTTPS_PROXY=http://127.0.0.1:7890
http_proxy=http://127.0.0.1:7890
https_proxy=http://127.0.0.1:7890
NO_PROXY=127.0.0.1,localhost,::1
no_proxy=127.0.0.1,localhost,::1

以上本地终端方法不会自动修改已运行的桌面应用环境。桌面端或扩展须使用其支持的代理设置/启动方式，并在重开后检查日志是否命中代理。

3. 完全退出后验证

确认代理软件在运行，端口与规则没有写错。
重新启动目标工具，再运行可用的诊断或查看客户端日志。
若使用 WebSocket，检查升级/连接是否成功，再发送一条简单任务。
检查皮皮虾调用记录，确认请求实际到达且返回正常。

4. 避免这些误区

supports_websockets = false 不是通用代理开关；它属于具体 model_providers.<id> 的传输能力配置。不要在不清楚供应商要求时盲目添加。
HTTP 101 不是“整条模型调用成功”，更不是速度保证。
TUN 影响范围较大，先排查应用配置与日志，再根据需要考虑；启用后仍需验证实际路径。
更改代理和端点时一次只改一项，避免失去对照。

带上这些信息再反馈

可复制的排查模板

【皮皮虾 AI 排查信息】
发生时间（含时区）：
工具及版本（Codex / Claude Code / 其他）：
操作系统：
正在使用的 URL：https://api.psydo.top
请求 User-Agent（应用名称/版本，不含密钥）：
模型名称：
所选分组：
Clash 是否开启、代理节点与日志截图（脱敏）：
渠道/公开服务状态及检测时间：
额度卡类型、剩余额度或余额状态：
Key 消费来源、独立限额是否耗尽（不要贴 Key）：
错误信息 / 状态码 / 请求 ID：
CCSwitch 已保存并启用：是 / 否
目标工具已完全退出并重开：是 / 否
已做过的测试与结果：

请勿提供 API Key、Cookie、代理订阅地址或完整私有对话。

诊断命令与配置字段参考：Codex CLI reference · Configuration reference。本教程结合平台排障图整理，具体日志与代理加载行为以当前客户端为准。

内容维护：2026-09-22 · 客户端界面可能随版本变化