stream disconnected before completion Codex

Quick fix

升级 cc-switch 至 v3.14.0 或更高版本，以修复代理转发 hop-by-hop 响应头导致的连接断开问题。

Symptom

报错原文复制

stream disconnected before completion: error sending request for url (http://127.0.0.1:15721/v1/responses)

Cause

当使用 cc-switch 作为本地代理时，旧版本会将上游 API 返回的 hop-by-hop 响应头（如 Connection、Keep-Alive、Transfer-Encoding 等）原样转发给下游客户端。这会导致底层的 axum/hyper 服务器收到意外的请求头，从而直接断开连接，表现为 stream disconnected 或 Empty reply from server。该问题已在 v3.14.0 中通过自动剥离这些响应头修复。

Fix

1. 1

   将 cc-switch 升级到 v3.14.0 或更高版本。该版本包含了 Proxy Hop-by-Hop Header Stripping 更新，可自动处理导致断连的响应头。

Affected Versions

ToolCodex

Version< 3.14.0

PlatformsmacOS

Source Issues

本页汇总自 2 个真实 issue

• #1069cc-switch 代理实现的响应头处理问题？
• #5189stream disconnected before completion: error sending request for url (http://127.0.0.1:15721/v1/responses)

FAQ

为什么直连上游 API 正常，但走 cc-switch 代理就会报错？

直连时上游返回正常的 200 响应。但走旧版 cc-switch 代理时，它会将上游的 hop-by-hop 响应头原样转发，导致本地代理服务器（axum/hyper）报错并断开连接。升级至 v3.14.0 即可解决。

升级到 v3.14.0 后仍然遇到 stream disconnected 怎么办？

如果升级后问题依旧，请补充具体的上游提供商、API 格式以及最新的运行日志，以便进一步排查。

相关问题

401 Unauthorized: Incorrect API key provided切换到 OpenAI Official 或关闭代理后，需手动清空 ~/.codex/auth.json 中残留的第三方 OPENAI_API_KEY 并重启 Codex 以恢复官方 OAuth 登录。2 issues mergedapi failed deserialize json body into按错误类型回退 Claude Code、升级 cc-switch、关闭本地代理或停止发送不支持的字段。7 issues mergedCC Switch local proxy failed while handling升级 CC Switch 到最新版并重开 Codex 对话；旧会话历史中残留的非法 schema 或图片块会持续触发 400。43 issues merged