上游 HTTP 404 cc-switch

Quick fix

升级 cc-switch 移除 NVIDIA 请求的 ?beta=true 参数；Kimi 不支持 Codex 的 Responses API，需改用 Claude Code 或本地转换。

Symptom

报错原文复制

[codex] [FWD-003] Provider Kimi For Coding 请求失败: 上游 HTTP 404: The requested resource was not found

Cause

该问题包含两种不同的 404 触发场景： 1. NVIDIA 供应商（Claude Code）：在 cc-switch v3.10.3 中，为了适配 Claude 的新特性，程序会在请求 URL 后追加 `?beta=true` 参数。但 NVIDIA 的 API 服务器严格遵循标准 OpenAI 路径，无法识别该参数，直接返回 404。 2. Kimi For Coding 供应商（Codex）：Codex 默认请求 Responses API（`/v1/responses`），但 Kimi 官方仅支持 `chat/completions` 和 `messages` 接口。cc-switch 将请求直接转发至 `/responses`，导致协议不兼容并返回 404。

Fix

1. 1

   针对 NVIDIA 的 404 问题，请升级 cc-switch 到最新版本。维护者已在后续更新中移除了对严格 OpenAI 兼容端点追加 `?beta=true` 的逻辑。

2. 2

   针对 Kimi For Coding 的 404 问题，由于 Kimi 官方不支持 Responses API，建议在 cc-switch 中将应用切换为 Claude Code。

3. 3

   如果必须在 Codex 中使用 Kimi，需要在 Codex 前部署一个本地适配层，将 `/v1/responses` 请求转换为 Kimi 支持的 `/v1/chat/completions` 格式。

Affected Versions

ToolClaude Code / Codex

Version3.10.3 - 3.12.3

PlatformsWindowsmacOS

Source Issues

本页汇总自 2 个真实 issue

• #1051使用NV的api会404
• #1763Codex + Kimi For Coding 下会请求 /responses 并返回 404，建议增加兼容转换

FAQ

开启本地代理或全局代理（如 Clash Verge）能解决 NVIDIA 的 404 错误吗？

不能。该错误是因为 cc-switch 修改了请求 URL（添加了 `?beta=true`），与网络代理设置无关，即使 `curl` 直连正常，通过旧版 cc-switch 代理依然会 404。

Codex 搭配 Kimi For Coding 是官方支持的组合吗？

不是。Kimi 官方文档明确说明其套餐不支持 Responses 接口，仅支持 chat 和 messages 接口，因此直接在 cc-switch 中搭配 Codex 使用会因协议不兼容而报错。

相关问题

Nvidia 检查失败: Not found (404)升级 cc-switch 至 v3.16.3 或更高版本，新版已将测速改为轻量级 HTTP 探测，修复了 NVIDIA 接口误报 404 的问题。2 issues mergedBash(...) Waiting... Claude Code降级 Claude Code 至 v2.1.104 或 v2.0.64（需管理员权限），或切换至阿里云百炼等兼容 provider，因 Nvidia 模型无法正确解析 tool use 格式。1 issues mergedInvalid schema for function升级 cc-switch 至 v3.18.0+，修复 Codex 工具参数缺失 type: object 导致的上游 400 报错。5 issues merged