Skip to content
CC Switch WikiUnofficial Community Wiki

Upstream HTTP 404 cc-switch

Quick fix

Upgrade cc-switch to remove ?beta=true from NVIDIA requests. Kimi does not support Codex's Responses API; use Claude Code or a local adapter.

Symptom

Section titled “Symptom”
Error output
[codex] [FWD-003] Provider Kimi For Coding 请求失败: 上游 HTTP 404: The requested resource was not found
English translation

[codex] [FWD-003] Provider Kimi For Coding request failed: upstream HTTP 404: The requested resource was not found

Cause

Section titled “Cause”

There are two distinct 404 trigger scenarios: 1. NVIDIA provider (Claude Code): In cc-switch v3.10.3, the program appends `?beta=true` to the request URL for new Claude features. NVIDIA's API server follows the standard OpenAI path strictly and rejects this parameter with 404. 2. Kimi For Coding provider (Codex): Codex requests the Responses API (`/v1/responses`) by default, but Kimi officially supports only `chat/completions` and `messages`. cc-switch forwards the request directly to `/responses`, causing a protocol mismatch and 404.

Fix

Section titled “Fix”

  1. For the NVIDIA 404 issue, upgrade cc-switch to the latest version. Maintainers removed the logic that appends `?beta=true` to strict OpenAI-compatible endpoints.

  2. For the Kimi For Coding 404 issue, Kimi does not officially support the Responses API. Switch the application to Claude Code in cc-switch.

  3. If you must use Kimi with Codex, deploy a local adapter in front of Codex to convert `/v1/responses` requests into the `/v1/chat/completions` format supported by Kimi.

Affected Versions

Section titled “Affected Versions”
ToolClaude Code / Codex
Version3.10.3 - 3.12.3
PlatformsWindowsmacOS

Source Issues

Section titled “Source Issues”

This page is distilled from 2 real issues

FAQ

Section titled “FAQ”
Will enabling a local or global proxy such as Clash Verge fix the NVIDIA 404 error?
No. The error occurs because cc-switch modifies the request URL by adding `?beta=true`. It is unrelated to proxy settings. Even if direct `curl` works, an older cc-switch proxy still returns 404.
Is Codex with Kimi For Coding an officially supported combination?
No. Kimi's official documentation states that its plans do not support the Responses interface and only support the chat and messages interfaces. Using Codex directly with Kimi through cc-switch fails due to protocol incompatibility.
Section titled “Related problems”
Nvidia check failed: Not found (404)Upgrade cc-switch to v3.16.3+; new version uses lightweight HTTP probing, fixing NVIDIA interface false 404 errors.2 issues mergedBash(...) Waiting... Claude CodeDowngrade Claude Code to v2.1.104 or v2.0.64 (admin required), or switch to a compatible provider such as Alibaba Cloud Bailian.1 issues mergedInvalid schema for function 'codex_app__automation_update'Upgrade cc-switch to v3.18.0+ to fix upstream HTTP 400 errors caused by missing type: object in Codex tool parameters.5 issues merged

This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.