not found(404) 添加Claude code桌面版模型api失败 - CC Switch

Quick fix

升级至 v3.16.3+ 以修复连通性检测误报，或忽略 404 直接测试实际调用。

Symptom

报错原文复制

not found(404)

Cause

在 cc-switch 中添加 Claude Desktop 自定义供应商连接英伟达 NIM 时，界面提示“接口地址不存在，请检查base url和api路径”并显示 not found(404)。这是因为 NVIDIA NIM 是 OpenAI 兼容端点（路径为 /v1/chat/completions），而 Claude Code/Desktop 走的是 Anthropic 格式（/v1/messages）。虽然 cc-switch 的代理会做格式转换，但在旧版本中，供应商连通性检测可能会因为协议不匹配或请求方式差异而收到 404 响应并判定失败。

从 v3.16.3 开始，供应商连通性检测改为轻量级可达性探测，不再发送真实的流式请求，任何 HTTP 响应都视为可达，理论上不会再因为 404 而判定失败。即使检测按钮仍可能报 404，真正切换使用时（经过代理）通常是正常的。

Fix

1. 1

   将 cc-switch 升级到最新版本（至少 v3.16.3 或更高），然后重新测试供应商连通性。

2. 2

   如果升级后检测仍失败，可以尝试忽略该错误，直接切换到该供应商进行实际对话测试。如果实际调用正常，则说明只是检测逻辑的问题，不影响使用。

Affected Versions

ToolClaude Code

Version>= 3.14.0, < 3.16.3

PlatformsWindows

Source Issues

本页汇总自 2 个真实 issue

• #2330NVIDIA的免费API，使用Claude Code+CCS，出现对话挂起或者bash running 挂起卡住现象
• #3424添加Claude code桌面版模型api失败

FAQ

为什么终端里可以成功调用，但桌面版不行？

终端（CLI）和桌面版（Desktop）可能使用了不同的配置或连接方式。此外，旧版本的连通性检测逻辑对非标准请求更敏感。升级到新版本后，检测逻辑已优化，通常能正确识别连通性。

NVIDIA NIM 是 OpenAI 兼容端点，为什么 Claude 能用？

cc-switch 的代理层负责将 Anthropic 格式的请求转换为 OpenAI 兼容格式发送给 NVIDIA NIM，并将响应转换回 Anthropic 格式返回给 Claude。因此，只要代理正常工作，即使底层 API 格式不同，也能实现互通。

如果升级后还是报 404，怎么办？

如果升级后连通性检测仍报 404，但实际对话或文件操作正常，则可以忽略该错误。这是检测逻辑的已知限制，不影响实际功能。如果实际调用也不通，请提供 base_url、完整报错以及触发错误的按钮（连通性检测还是模型测试）以便进一步排查。

相关问题

Bash(...) Waiting... Claude Code降级 Claude Code 至 v2.1.104 或 v2.0.64（需管理员权限），或切换至阿里云百炼等兼容 provider，因 Nvidia 模型无法正确解析 tool use 格式。1 issues mergedKMS: DRM_IOCTL_MODE_CREATE_DUMB failed: 权限不够在 Linux 运行 cc-switch 遇 DRM 权限报错白屏时，可通过设置环境变量禁用 WebKit 硬件加速、指定 NVIDIA 渲染或改用 CLI 版解决。2 issues mergedClaude Code无法调用工具 NVIDIA代理 - CC Switch修复NVIDIA免费通道模型不稳定，建议切换至deepseek-ai/deepseek-v4-flash等稳定提供商。2 issues merged