Claude Code无法调用工具 NVIDIA代理 - CC Switch修复

Quick fix

NVIDIA免费通道模型不稳定，建议切换至deepseek-ai/deepseek-v4-flash等稳定提供商。

Symptom

报错原文复制

他无法正常调用工具

Cause

在通过 cc-switch 使用 NVIDIA 免费层级的代理时，多个模型（如 glm 系列、qwen 部分版本）存在严重的连接超时或流式响应异常问题。实测数据显示，部分模型首字节等待时间长达数十秒甚至直接超时（TimeoutError），导致 Claude Code 无法接收有效的 tool_calls 响应。此外，部分模型（如 kimi 系列）虽然能返回结果，但内容格式不符合 OpenAI 标准，造成解析失败。这并非 cc-switch 本身的 Bug，而是上游免费提供商的速率限制（TPM/TPD）或网络稳定性问题。虽然 PR #2557 尝试修复相关流式解析问题，但根本原因仍在于提供商侧的不稳定性。

值得注意的是，即使使用表现较好的 deepseek 模型，若遇到无法调用工具的情况，也可能受限于提供商的配额或临时网络波动。目前社区确认的稳定替代方案是切换到其他表现稳定的提供商。

Fix

1. 1

   在 cc-switch 配置中将提供商从 nvidia 切换为 deepseek 或其他稳定提供商（如 openai/gpt-oss-120b）。

2. 2

   如果必须使用 NVIDIA 通道，请确保选择的模型是已知稳定的（如 deepseek-ai/deepseek-v4-flash 或 deepseek-ai/deepseek-v4-pro），并避免使用 glm 或 qwen 等易超时的模型。

Affected Versions

ToolClaude Code

Version3.14.1

PlatformsmacOSLinux

Source Issues

本页汇总自 2 个真实 issue

• #2609用Claude code无法调用tool 代理商是Nvidia
• #2654Linux平台，可以给出NVIDIA接入ccs的教程吗？都不成功

FAQ

为什么我用了 deepseek-v4-flash 还是无法调用工具？

虽然 deepseek-v4-flash 在基准测试中表现稳定，但如果您的账户触发了提供商的速率限制（TPM/TPD），或者当前网络环境存在波动，仍可能导致调用失败。建议检查提供商状态或尝试重启 cc-switch 代理。

Linux 上点击开启代理按钮没反应怎么办？

这是 Linux 平台下 cc-switch UI 的已知交互问题，通常不影响底层代理功能。您可以尝试手动检查配置文件中的 proxy 设置，或通过命令行启动代理服务。

PR #2557 解决了这个问题吗？

PR #2557 针对部分流式解析和连接问题进行了修复，但 NVIDIA 免费通道的不稳定性主要源于上游提供商。即使应用了该 PR，部分模型仍可能出现超时或格式错误，因此官方建议优先使用更稳定的提供商。

相关问题

cc-switch DeepSeek 用量统计不准/余额查询失败升级到 v3.19.2 并重建 Codex 用量；余额查询需正确填写 {{apiKey}} 或代理。17 issues mergedANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY打开 `~/.claude/settings.json`，删除重复的 auth 环境变量，只保留当前供应商需要的 `ANTHROPIC_AUTH_TOKEN` 或 `ANTHROPIC_API_KEY`，保存后重启 Claude Code。4 issues mergedapi failed deserialize json body into按错误类型回退 Claude Code、升级 cc-switch、关闭本地代理或停止发送不支持的字段。7 issues merged