CC Switch 一键切换配置 + VS Code 安装 Claude Code 插件完整教程
适用版本2025/2026 平台Windows一、什么是 CC SwitchCC Switch 是一款开源的AI 编程工具供应商切换器由 Tauri 2.0Rust 后端构建跨平台支持 Windows、macOS、Linux。它可以帮助开发者在不同 API 供应商之间一键切换无需手动修改 Claude Code、Codex CLI、Gemini CLI 等工具的配置文件。GitHub 地址https://github.com/farion1231/cc-switch核心功能一览 一键切换供应商在 UI 中点击即可切换无需手改配置文件 用量查询直接在界面查看 API 调用量和余额 MCP 管理可视化配置 MCP Server内置常用模板 代理 故障转移内置代理服务与 Failover 机制保证可用性 系统托盘切换从托盘菜单直接切换无需打开主窗口⚡ 同步 VS Code 插件可将配置一键应用到 VS Code 的 Claude Code 扩展二、安装 CC SwitchWindows前往 GitHub Releases 页面下载以下版本CC-Switch-v3.15.0-Windows.msi— 安装版推荐 提示如果杀毒软件拦截请选择允许或暂时关闭实时防护。本软件开源安全可在 GitHub 查看全部源码。三、CC Switch 配置供应商启动 CC Switch 后我们开始添加 API 供应商。下面以deepseek供应商为例。步骤一使用 DeepSeek1 点击apikeys创建按APIkeyhttps://platform.deepseek.com/步骤二配置CC Switch1 打开 CC Switch进入Claude Code面板2 选择第一个Claude code点击「」按钮3 在添加新供应商中选择「deepseek」4 填写你的在deepseek中申请的API Key5 点击添加后在列表中找到该供应商点击「启用」五、在 VS Code 中安装 Claude Code 插件系统要求项目要求VS Code 版本近几年发布版本操作系统Windows 11安装步骤1 打开 VS Code2 按 Ctrl Shift XMacCmd Shift X打开扩展市场3 搜索Claude Code for VS Code发布者为Anthropic4 点击「Install」安装5 重新加载 VS Code如果提示的话首次启动与认证双击烟花图标使用时一定要启用cc switch否则出现登入界面六、常见问题与排错Q1闪电图标看不到确保 VS Code 版本 ≥ 1.98.0确保已打开至少一个文件Q3插件提示需要登录 Anthropic 账号确保再使用Claude Code for VS Code时也开启了cc switchQ3如果在对话时出现API Error: 400 Failed to deserialize the JSON body into the target type: messages[1].role: unknown variant system, expected user or assistant at line 1 column 517将Claude Code for VS Code插件回退几个版本试试我使用的是2.1.137 总结整个流程的核心思路是CC Switch 解决了国内用户无法直接使用 Claude 官方 API的痛点让你可以用 DeepSeek、硅基流动、智谱等国内供应商的 API 来驱动 Claude Code同时享受 VS Code 原生插件的完整体验。三步走一步到位安装 CC Switch → 配置第三方 API 供应商安装 Claude Code CLI → 验证配置安装 VS Code Claude Code 插件 → 开始 AI 编程✅ 最后提醒建议为每个项目创建一个CLAUDE.md文件在其中描述项目的编码规范、目录结构和约定Claude Code 会自动读取大幅提升生成代码的质量---✍️ 本文由 **手工** **Claude Code for VS Code** 共同完成