Claude Code 接入第三方模型完整指南NVIDIA/OpenRouter/国内平台本文详细介绍如何通过 CC Switch 工具让 Claude Code 使用 NVIDIA NIM、OpenRouter、 SiliconFlow 等第三方模型服务大幅降低使用成本并获得更多模型选择。更新日期2026-04-05适用版本CC Switch v3.x, Claude Code 最新版前言Claude Code 是 Anthropic 官方推出的 AI 编程助手默认只能使用 Anthropic 官方 API。但很多开发者希望使用NVIDIA NIM等免费/低价模型使用OpenRouter聚合平台获取更多模型使用SiliconFlow等国内平台降低延迟本文将详细介绍如何通过CC Switch实现这一目标。免责声明本文仅作技术分享第三方 API 服务的使用需遵守各平台服务条款。API Key 请妥善保管避免泄露。目录简介与安装核心概念配置步骤常见提供商配置示例常见问题排查高级配置1. 简介与安装1.1 Claude Code 简介Claude Code是 Anthropic 官方推出的 AI 编程助手 CLI 工具基于 Claude 模型提供代码生成、调试、重构等功能。特点原生支持 Anthropic API 格式/v1/messages端点支持多模型切换Opus、Sonnet、Haiku支持扩展功能MCP、Skills需要 Claude Max/Pro/Team 或 API 账户1.2 Claude Code 安装Windows (PowerShell):# 使用 npm 安装 npm install -g anthropic-ai/claude-code # 或使用官方安装脚本 # 下载: https://github.com/anthropics/claude-code/releasesmacOS (Homebrew):brew install claude-codeLinux:npm install -g anthropic-ai/claude-code验证安装:claude --version1.3 CC Switch 简介CC Switch是一个跨平台的桌面应用用于管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等工具的配置。它提供50 预设提供商一键导入配置本地代理服务自动转换 API 格式OpenAI ↔ Anthropic故障转移自动切换备用提供商统一管理MCP、Skills、配置文件集中管理为什么需要 CC SwitchClaude Code 只支持 Anthropic API 格式但很多第三方提供商如 NVIDIA、OpenRouter使用 OpenAI 格式。CC Switch 的本地代理可以自动转换这两种格式让 Claude Code 能够使用任何兼容 OpenAI API 的模型。1.4 CC Switch 安装Windows:下载 MSI 安装包GitHub Releases或便携版 ZIPmacOS (Homebrew):brew tap farion1231/ccswitch brew install --cask cc-switchmacOS (手动):下载 DMGGitHub ReleasesLinux:# Debian/Ubuntu sudo dpkg -i CC-Switch-*.deb # Fedora/RHEL sudo rpm -i CC-Switch-*.rpm # Arch Linux (paru) paru -S cc-switch-bin2. 核心概念2.1 API 格式差异API 格式端点请求结构使用者Anthropic Messages/v1/messages{messages, model, max_tokens}Claude CodeOpenAI Chat Completions/v1/chat/completions{messages, model}OpenAI、NVIDIA、大多数第三方问题Claude Code 发送/v1/messages请求但 NVIDIA 等提供商只接受/v1/chat/completions。解决方案使用 CC Switch 本地代理进行格式转换。2.2 CC Switch 代理架构┌─────────────────┐ │ Claude Code │ │ (Anthropic格式) │ └─────────┬───────┘ │ POST /v1/messages ▼ ┌─────────────────┐ │ CC Switch 代理 │ ← 运行在 127.0.0.1:15721 │ (格式转换) │ └─────────┬───────┘ │ POST /v1/chat/completions (转换后) ▼ ┌─────────────────┐ │ 第三方提供商 │ │ (OpenAI格式) │ │ 如 NVIDIA NIM │ └─────────────────┘2.3 关键配置项配置项位置作用本地代理CC Switch → 代理面板启用格式转换服务应用接管CC Switch → 代理面板 → Claude让 Claude Code 流量经过代理提供商CC Switch → 供应商列表配置 API Key 和端点ANTHROPIC_BASE_URL~/.claude/settings.json指向代理地址3. 配置步骤步骤一安装并启动 CC Switch安装 CC Switch见上文启动 CC Switch 应用首次启动会导入现有配置作为默认提供商步骤二添加提供商在 CC Switch 主界面点击“添加供应商”从预设列表中选择目标提供商NVIDIA NIM使用 NVIDIA 的模型OpenRouter聚合多种模型SiliconFlow国内模型平台或选择“自定义”手动配置输入 API KeyNVIDIAbuild.nvidia.com/settings/api-keysOpenRouteropenrouter.ai/keysSiliconFlowcloud.siliconflow.cn点击“保存”步骤三启用本地代理关键⚠️这是最重要的一步不启用代理会导致 Claude Code 无法连接 OpenAI 格式的提供商。点击 CC Switch 主界面的“代理”按钮在代理面板中勾选“claude”应用接管确认服务地址为http://127.0.0.1:15721状态显示“使用中”点击“启动”或“重启”按钮步骤四切换到目标提供商在 CC Switch 主界面选择刚才添加的提供商点击“启用”按钮CC Switch 会自动修改~/.claude/settings.json步骤五验证配置检查配置文件是否正确# Windows type $HOME\.claude\settings.json # macOS/Linux cat ~/.claude/settings.json正确配置示例{ env: { ANTHROPIC_AUTH_TOKEN: PROXY_MANAGED, ANTHROPIC_BASE_URL: http://127.0.0.1:15721, CLAUDE_CODE_LANGUAGE: zh-CN } }关键检查点ANTHROPIC_BASE_URL应指向http://127.0.0.1:15721代理地址ANTHROPIC_AUTH_TOKEN应为PROXY_MANAGED代理管理认证不是直接的提供商 URL如https://integrate.api.nvidia.com/v1步骤六测试连接启动 Claude Code claude发送一条消息测试观察 CC Switch 代理面板总请求数应增加当前 Provider应显示目标提供商名称成功率应显示正常值4. 常见提供商配置示例4.1 NVIDIA NIM获取 API Key: build.nvidia.com/settings/api-keysCC Switch 预设: 选择 “Nvidia”支持的模型部分:模型 ID说明meta/llama-3.1-405b-instructLlama 3.1 405Bmeta/llama-3.1-70b-instructLlama 3.1 70Bnvidia/llama-3.1-nemotron-70b-instructNVIDIA 优化版mistralai/mistral-largeMistral Largegoogle/gemma-2-27bGemma 2 27B注意事项:NVIDIA API 使用 OpenAI 格式必须启用本地代理模型 ID 格式为厂商/模型名4.2 OpenRouter获取 API Key: openrouter.ai/keysCC Switch 预设: 选择 “OpenRouter”特点:聚合 100 模型支持自动故障转移价格透明常用模型:模型 ID说明anthropic/claude-3.5-sonnetClaude 3.5 Sonnetopenai/gpt-4oGPT-4ogoogle/gemini-pro-1.5Gemini Pro 1.5meta-llama/llama-3.1-405b-instructLlama 3.1 405B4.3 SiliconFlow国内用户推荐获取 API Key: cloud.siliconflow.cnCC Switch 预设: 选择 “SiliconFlow”特点:国内访问速度快支持主流国内外模型新用户有免费额度常用模型:模型 ID说明Qwen/Qwen2.5-72B-Instruct通义千问 72Bdeepseek-ai/DeepSeek-V3DeepSeek V3THUDM/glm-4-9b-chatGLM-4 9B4.4 自定义提供商如果预设列表中没有目标提供商可以手动添加选择“自定义”配置以下字段字段说明示例名称显示名称“我的API”Base URLAPI 端点https://api.example.com/v1API Key认证密钥sk-xxxAPI 格式选择格式openai_chat大多数第三方配置模型映射可选 { ANTHROPIC_DEFAULT_OPUS_MODEL: provider/model-name, ANTHROPIC_DEFAULT_SONNET_MODEL: provider/model-name, ANTHROPIC_DEFAULT_HAIKU_MODEL: provider/model-name }5. 常见问题排查问题 1Claude Code 报错 “模型不存在或无权访问”症状:Theres an issue with the selected model (xxx). It may not exist or you may not have access to it.原因: 未启用本地代理Claude Code 直接请求 OpenAI 格式端点解决方案:打开 CC Switch → 代理面板勾选“claude”应用接管确认代理服务状态为“使用中”检查~/.claude/settings.json中ANTHROPIC_BASE_URL是否为代理地址问题 2代理面板显示 “等待首次请求”症状: 发送消息后代理面板没有显示任何请求原因: Claude Code 配置未指向代理解决方案:检查~/.claude/settings.json确认ANTHROPIC_BASE_URL为http://127.0.0.1:15721如果不是手动修改或在 CC Switch 中重新启用提供商重启 Claude Code问题 3代理启动失败症状: 代理状态显示错误或无法启动原因: 端口被占用或权限问题解决方案:检查端口占用 netstat -ano | findstr 15721如果被占用在 CC Switch 代理设置中修改端口修改后点击“重启代理服务”问题 4请求成功率低症状: 代理面板显示成功率低于 100%可能原因:API Key 无效或过期模型 ID 不正确网络连接问题提供商服务不稳定解决方案:在 CC Switch 中验证 API Key检查模型 ID 是否正确不同提供商格式不同配置故障转移队列作为备用查看 CC Switch 日志~/.cc-switch/logs/cc-switch.log问题 5网络代理配置症状: CC Switch 无法访问提供商 API国内常见解决方案:在 CC Switch → 代理面板 →“全局出站代理”配置代理地址HTTP:http://127.0.0.1:7890SOCKS5:socks5://127.0.0.1:1080或在提供商编辑界面配置“单独网络代理”6. 高级配置6.1 故障转移配置当主提供商失败时自动切换到备用提供商在 CC Switch → 代理面板 →“自动故障转移”添加故障转移队列选择备用提供商设置优先级顺序配置熔断策略失败阈值连续失败多少次后切换恢复等待时间多久后尝试恢复主提供商6.2 整流器配置自动修复 API 请求中的兼容性问题在 CC Switch → 代理面板 →“整流器”启用整流器功能配置修复规则Thinking Budget 修复处理budget_tokens参数兼容性Thinking Signature 修复处理签名验证问题6.3 多应用管理CC Switch 支持同时管理多个 CLI 工具应用配置文件代理支持Claude Code~/.claude/settings.json✅Codex~/.codex/config.toml✅Gemini CLI~/.gemini/.env✅OpenCode~/.opencode/settings.json✅OpenClaw~/.openclaw/config.toml✅在代理面板勾选需要接管的应用即可。6.4 MCP 与 Skills 管理CC Switch 提供统一的 MCP 和 Skills 管理MCP 服务器点击“MCP”按钮添加服务器配置支持跨应用同步Skills点击“Skills”按钮从 GitHub 仓库一键安装支持自定义仓库管理6.5 会话管理CC Switch 可以浏览和恢复历史会话点击“Sessions”按钮浏览各应用的会话历史搜索和恢复历史对话附录配置文件参考Claude Code 配置文件位置系统路径WindowsC:\Users\用户名\.claude\settings.jsonmacOS~/.claude/settings.jsonLinux~/.claude/settings.jsonCC Switch 配置文件位置系统路径WindowsC:\Users\用户名\.cc-switch\macOS~/.cc-switch/Linux~/.cc-switch/CC Switch 文件结构:.cc-switch/ ├── cc-switch.db # SQLite 数据库提供商、配置 ├── settings.json # UI 设置代理开关、当前提供商 ├── logs/ │ └── cc-switch.log # 运行日志 ├── backups/ # 自动备份 └── skills/ # Skills 存储参考资料Claude Code 官方文档CC Switch GitHubCC Switch 用户手册NVIDIA NIM API 文档OpenRouter 文档
Claude Code 接入第三方模型完整指南
Claude Code 接入第三方模型完整指南NVIDIA/OpenRouter/国内平台本文详细介绍如何通过 CC Switch 工具让 Claude Code 使用 NVIDIA NIM、OpenRouter、 SiliconFlow 等第三方模型服务大幅降低使用成本并获得更多模型选择。更新日期2026-04-05适用版本CC Switch v3.x, Claude Code 最新版前言Claude Code 是 Anthropic 官方推出的 AI 编程助手默认只能使用 Anthropic 官方 API。但很多开发者希望使用NVIDIA NIM等免费/低价模型使用OpenRouter聚合平台获取更多模型使用SiliconFlow等国内平台降低延迟本文将详细介绍如何通过CC Switch实现这一目标。免责声明本文仅作技术分享第三方 API 服务的使用需遵守各平台服务条款。API Key 请妥善保管避免泄露。目录简介与安装核心概念配置步骤常见提供商配置示例常见问题排查高级配置1. 简介与安装1.1 Claude Code 简介Claude Code是 Anthropic 官方推出的 AI 编程助手 CLI 工具基于 Claude 模型提供代码生成、调试、重构等功能。特点原生支持 Anthropic API 格式/v1/messages端点支持多模型切换Opus、Sonnet、Haiku支持扩展功能MCP、Skills需要 Claude Max/Pro/Team 或 API 账户1.2 Claude Code 安装Windows (PowerShell):# 使用 npm 安装 npm install -g anthropic-ai/claude-code # 或使用官方安装脚本 # 下载: https://github.com/anthropics/claude-code/releasesmacOS (Homebrew):brew install claude-codeLinux:npm install -g anthropic-ai/claude-code验证安装:claude --version1.3 CC Switch 简介CC Switch是一个跨平台的桌面应用用于管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等工具的配置。它提供50 预设提供商一键导入配置本地代理服务自动转换 API 格式OpenAI ↔ Anthropic故障转移自动切换备用提供商统一管理MCP、Skills、配置文件集中管理为什么需要 CC SwitchClaude Code 只支持 Anthropic API 格式但很多第三方提供商如 NVIDIA、OpenRouter使用 OpenAI 格式。CC Switch 的本地代理可以自动转换这两种格式让 Claude Code 能够使用任何兼容 OpenAI API 的模型。1.4 CC Switch 安装Windows:下载 MSI 安装包GitHub Releases或便携版 ZIPmacOS (Homebrew):brew tap farion1231/ccswitch brew install --cask cc-switchmacOS (手动):下载 DMGGitHub ReleasesLinux:# Debian/Ubuntu sudo dpkg -i CC-Switch-*.deb # Fedora/RHEL sudo rpm -i CC-Switch-*.rpm # Arch Linux (paru) paru -S cc-switch-bin2. 核心概念2.1 API 格式差异API 格式端点请求结构使用者Anthropic Messages/v1/messages{messages, model, max_tokens}Claude CodeOpenAI Chat Completions/v1/chat/completions{messages, model}OpenAI、NVIDIA、大多数第三方问题Claude Code 发送/v1/messages请求但 NVIDIA 等提供商只接受/v1/chat/completions。解决方案使用 CC Switch 本地代理进行格式转换。2.2 CC Switch 代理架构┌─────────────────┐ │ Claude Code │ │ (Anthropic格式) │ └─────────┬───────┘ │ POST /v1/messages ▼ ┌─────────────────┐ │ CC Switch 代理 │ ← 运行在 127.0.0.1:15721 │ (格式转换) │ └─────────┬───────┘ │ POST /v1/chat/completions (转换后) ▼ ┌─────────────────┐ │ 第三方提供商 │ │ (OpenAI格式) │ │ 如 NVIDIA NIM │ └─────────────────┘2.3 关键配置项配置项位置作用本地代理CC Switch → 代理面板启用格式转换服务应用接管CC Switch → 代理面板 → Claude让 Claude Code 流量经过代理提供商CC Switch → 供应商列表配置 API Key 和端点ANTHROPIC_BASE_URL~/.claude/settings.json指向代理地址3. 配置步骤步骤一安装并启动 CC Switch安装 CC Switch见上文启动 CC Switch 应用首次启动会导入现有配置作为默认提供商步骤二添加提供商在 CC Switch 主界面点击“添加供应商”从预设列表中选择目标提供商NVIDIA NIM使用 NVIDIA 的模型OpenRouter聚合多种模型SiliconFlow国内模型平台或选择“自定义”手动配置输入 API KeyNVIDIAbuild.nvidia.com/settings/api-keysOpenRouteropenrouter.ai/keysSiliconFlowcloud.siliconflow.cn点击“保存”步骤三启用本地代理关键⚠️这是最重要的一步不启用代理会导致 Claude Code 无法连接 OpenAI 格式的提供商。点击 CC Switch 主界面的“代理”按钮在代理面板中勾选“claude”应用接管确认服务地址为http://127.0.0.1:15721状态显示“使用中”点击“启动”或“重启”按钮步骤四切换到目标提供商在 CC Switch 主界面选择刚才添加的提供商点击“启用”按钮CC Switch 会自动修改~/.claude/settings.json步骤五验证配置检查配置文件是否正确# Windows type $HOME\.claude\settings.json # macOS/Linux cat ~/.claude/settings.json正确配置示例{ env: { ANTHROPIC_AUTH_TOKEN: PROXY_MANAGED, ANTHROPIC_BASE_URL: http://127.0.0.1:15721, CLAUDE_CODE_LANGUAGE: zh-CN } }关键检查点ANTHROPIC_BASE_URL应指向http://127.0.0.1:15721代理地址ANTHROPIC_AUTH_TOKEN应为PROXY_MANAGED代理管理认证不是直接的提供商 URL如https://integrate.api.nvidia.com/v1步骤六测试连接启动 Claude Code claude发送一条消息测试观察 CC Switch 代理面板总请求数应增加当前 Provider应显示目标提供商名称成功率应显示正常值4. 常见提供商配置示例4.1 NVIDIA NIM获取 API Key: build.nvidia.com/settings/api-keysCC Switch 预设: 选择 “Nvidia”支持的模型部分:模型 ID说明meta/llama-3.1-405b-instructLlama 3.1 405Bmeta/llama-3.1-70b-instructLlama 3.1 70Bnvidia/llama-3.1-nemotron-70b-instructNVIDIA 优化版mistralai/mistral-largeMistral Largegoogle/gemma-2-27bGemma 2 27B注意事项:NVIDIA API 使用 OpenAI 格式必须启用本地代理模型 ID 格式为厂商/模型名4.2 OpenRouter获取 API Key: openrouter.ai/keysCC Switch 预设: 选择 “OpenRouter”特点:聚合 100 模型支持自动故障转移价格透明常用模型:模型 ID说明anthropic/claude-3.5-sonnetClaude 3.5 Sonnetopenai/gpt-4oGPT-4ogoogle/gemini-pro-1.5Gemini Pro 1.5meta-llama/llama-3.1-405b-instructLlama 3.1 405B4.3 SiliconFlow国内用户推荐获取 API Key: cloud.siliconflow.cnCC Switch 预设: 选择 “SiliconFlow”特点:国内访问速度快支持主流国内外模型新用户有免费额度常用模型:模型 ID说明Qwen/Qwen2.5-72B-Instruct通义千问 72Bdeepseek-ai/DeepSeek-V3DeepSeek V3THUDM/glm-4-9b-chatGLM-4 9B4.4 自定义提供商如果预设列表中没有目标提供商可以手动添加选择“自定义”配置以下字段字段说明示例名称显示名称“我的API”Base URLAPI 端点https://api.example.com/v1API Key认证密钥sk-xxxAPI 格式选择格式openai_chat大多数第三方配置模型映射可选 { ANTHROPIC_DEFAULT_OPUS_MODEL: provider/model-name, ANTHROPIC_DEFAULT_SONNET_MODEL: provider/model-name, ANTHROPIC_DEFAULT_HAIKU_MODEL: provider/model-name }5. 常见问题排查问题 1Claude Code 报错 “模型不存在或无权访问”症状:Theres an issue with the selected model (xxx). It may not exist or you may not have access to it.原因: 未启用本地代理Claude Code 直接请求 OpenAI 格式端点解决方案:打开 CC Switch → 代理面板勾选“claude”应用接管确认代理服务状态为“使用中”检查~/.claude/settings.json中ANTHROPIC_BASE_URL是否为代理地址问题 2代理面板显示 “等待首次请求”症状: 发送消息后代理面板没有显示任何请求原因: Claude Code 配置未指向代理解决方案:检查~/.claude/settings.json确认ANTHROPIC_BASE_URL为http://127.0.0.1:15721如果不是手动修改或在 CC Switch 中重新启用提供商重启 Claude Code问题 3代理启动失败症状: 代理状态显示错误或无法启动原因: 端口被占用或权限问题解决方案:检查端口占用 netstat -ano | findstr 15721如果被占用在 CC Switch 代理设置中修改端口修改后点击“重启代理服务”问题 4请求成功率低症状: 代理面板显示成功率低于 100%可能原因:API Key 无效或过期模型 ID 不正确网络连接问题提供商服务不稳定解决方案:在 CC Switch 中验证 API Key检查模型 ID 是否正确不同提供商格式不同配置故障转移队列作为备用查看 CC Switch 日志~/.cc-switch/logs/cc-switch.log问题 5网络代理配置症状: CC Switch 无法访问提供商 API国内常见解决方案:在 CC Switch → 代理面板 →“全局出站代理”配置代理地址HTTP:http://127.0.0.1:7890SOCKS5:socks5://127.0.0.1:1080或在提供商编辑界面配置“单独网络代理”6. 高级配置6.1 故障转移配置当主提供商失败时自动切换到备用提供商在 CC Switch → 代理面板 →“自动故障转移”添加故障转移队列选择备用提供商设置优先级顺序配置熔断策略失败阈值连续失败多少次后切换恢复等待时间多久后尝试恢复主提供商6.2 整流器配置自动修复 API 请求中的兼容性问题在 CC Switch → 代理面板 →“整流器”启用整流器功能配置修复规则Thinking Budget 修复处理budget_tokens参数兼容性Thinking Signature 修复处理签名验证问题6.3 多应用管理CC Switch 支持同时管理多个 CLI 工具应用配置文件代理支持Claude Code~/.claude/settings.json✅Codex~/.codex/config.toml✅Gemini CLI~/.gemini/.env✅OpenCode~/.opencode/settings.json✅OpenClaw~/.openclaw/config.toml✅在代理面板勾选需要接管的应用即可。6.4 MCP 与 Skills 管理CC Switch 提供统一的 MCP 和 Skills 管理MCP 服务器点击“MCP”按钮添加服务器配置支持跨应用同步Skills点击“Skills”按钮从 GitHub 仓库一键安装支持自定义仓库管理6.5 会话管理CC Switch 可以浏览和恢复历史会话点击“Sessions”按钮浏览各应用的会话历史搜索和恢复历史对话附录配置文件参考Claude Code 配置文件位置系统路径WindowsC:\Users\用户名\.claude\settings.jsonmacOS~/.claude/settings.jsonLinux~/.claude/settings.jsonCC Switch 配置文件位置系统路径WindowsC:\Users\用户名\.cc-switch\macOS~/.cc-switch/Linux~/.cc-switch/CC Switch 文件结构:.cc-switch/ ├── cc-switch.db # SQLite 数据库提供商、配置 ├── settings.json # UI 设置代理开关、当前提供商 ├── logs/ │ └── cc-switch.log # 运行日志 ├── backups/ # 自动备份 └── skills/ # Skills 存储参考资料Claude Code 官方文档CC Switch GitHubCC Switch 用户手册NVIDIA NIM API 文档OpenRouter 文档
