近期,部分使用 Cloudflare Proxy API (CPA) 的开发者发现,VS Code 版 Claude Code 扩展无法显示 AI 的思维链内容,而 CLI 版本则正常。经排查,这是由于 CPA 在 v7.2.112 版本更新中,调整了 Claude 协议向 Codex 协议转换的默认逻辑所致。
此前,CPA 会自动在转发的请求中插入 `”reasoning”: { “summary”: “auto” }` 参数以强制返回思考摘要。但新版取消了这一自动补全机制,转而完全依赖客户端传参。问题在于,VS Code 版本的 Claude Code 并未像其 CLI 同类那样,通过 `showThinkingSummaries` 设置主动发送该参数。这导致经由 CPA 中转的请求中缺少 `reasoning.summary` 字段,服务器无法返回可解析的思维链内容,最终在界面上表现为 Thinking 功能失效。
针对这一问题,社区提供了具体的配置修复方案。使用 CPA Manager Plus 的用户可通过可视化界面进行修正:进入“配置面板”下的“Payload配置”与“默认规则”,新增一条针对模型名称 `gpt-*`(覆盖所有 Codex GPT 模型)的规则。设置供应商类型为 Codex,来源协议为 Claude,并在 JSON 路径 `reasoning.summary` 处填入字符串值 `auto`。或者直接修改 YAML 配置文件,在 `payload.default` 中添加相应模型匹配与参数注入。该方法利用了 CPA 的默认值机制,仅在请求未携带该参数时自动补全,既恢复了 VS Code 中的思维链显示,又不影响未来客户端可能自行实现的参数传递逻辑。
事件分析
技术上,这体现了协议转换中间件(如 CPA)在生态中的关键作用:它不仅是流量通道,更是填补客户端与新协议特性之间鸿沟的桥梁。对于开发者而言,随着大模型推理特性的日益复杂(如 DeepSeek R1 或 Claude 3.7 Sonnet 的思维链),单纯依赖图形界面操作已不足以应对所有配置需求,掌握 YAML 等底层配置或 Payload 注入逻辑正变得日益重要。此类通过修改 Payload 默认值来修复显示问题的案例,未来可能会在更多模型特性更新时重演。
核心观点:中间代理层的参数补全能力是应对客户端协议滞后或差异的关键,开发者需提升对底层协议配置的掌控力。
原文链接:Linux.do