本教程旨在帮助开发者通过 VS Code 结合 CC-Switch 工具,快速实现 Claude Code 对第三方模型(API)的无缝调用与灵活配置。

前言:先搞清楚几个角色

1. Claude Code 是什么

Claude Code 是 Anthropic 官方的编程 Agent 工具。

它可以:

1.读项目代码
2.改文件
3.执行命令
4.分析报错
5.帮你重构项目

正常情况下,它默认走 Claude 官方账号或 Anthropic Console API。


2. Claude Code for VSCode 是什么

Claude Code for VSCode 是 VSCode 里的 Claude Code 插件。

它本质上还是Claude Code,只不过把交互界面嵌入到了VSCode右侧面板里。

需要注意:

命令行里的 claude 和VSCode里的Claude Code插件,不一定读取同一套环境变量。

这是容易踩坑的原因之一。


3. cc-switch 是什么

cc-switch是一个Claude/Codex/Gemini等AI编程工具的供应商切换器。

它可以把:

Claude Code发出的Anthropic请求

转发到:

1.DeepSeek
2.SiliconFlow
3.OpenAI 兼容接口
4.其他第三方平台

它相当于一个中间层:

Claude Code
      ↓
CC-switch
      ↓
第三方API

一、安装 VS Code(若已安装,可跳过此步骤)


二、安装 cc-Switch

1. 访问 GitHub 开源仓库https://github.com/farion1231/cc-switch

2. 下载最新的发行版本(Release)

  • 进入仓库后,点击右侧的 Releases 区域,或直接访问链接:Releases 页面

  • 在最新版本的 Assets 列表中,选择对应的系统版本进行下载:

3. 执行安装: 打开刚才下载的 .msi 安装包(Installer 程序包),按照向导提示完成安装即可:

4. 启动程序: 安装完成后,打开 cc-Switch 客户端,准备后续配置:


三、在 VS Code 中安装 Claude Code 扩展

1. 打开扩展商店:在 VS Code 左侧活动栏中点击“扩展”图标(或使用快捷键 Ctrl+Shift+X)。

2. 搜索并安装扩展:在搜索框中输入 Claude Code 并点击安装。

3. 验证安装:扩展安装完成后,点击 VS Code 右侧边栏的 Claude Code 图标。若出现红框所示的侧边栏界面,即说明安装成功:


四、通过 cc-Switch 调用第三方模型

(1)原理解析

  • 为何使用 cc-Switch
    • 免去手动编辑复杂 settings.json 配置文件的繁琐。
    • 支持预存多套 API 方案,实现一键无缝切换。
    • 轻松接入各路中转站,完美适配各类第三方 API 聚合服务。
  • 核心机制
    • cc-Switch 在底层动态覆盖了 ANTHROPIC_BASE_URLANTHROPIC_API_KEY 这两个关键环境变量。它将 Claude Code 原本发往官方的请求,“拦截”并重定向至您配置的第三方接口,从而在底层实现模型的无缝替换。

(2)前置准备

① 获取调用凭证: 在开始配置前,需要从第三方平台获取以下信息(本文以硅基流动 (SiliconFlow) 为例,其他支持的模型或中转平台配置逻辑完全一致):

  • API Key(密钥)
  • Base URL(接口地址)
  • 模型名称

② 创建 API 密钥: 登录 硅基流动官网,在控制台生成您的 API 密钥:

③ 获取模型名称: 进入模型广场,选择您需要的模型,点击模型名称即可复制:

④ 确认 Base URL: 查阅官方 API 接口文档获取 Base URL。硅基流动的地址通常为 https://api.siliconflow.cn/(其他中转平台请参考其官方说明):

(3)本地环境配置指南

① 添加供应商: 回到 cc-Switch 客户端,点击添加新的服务供应商:
注意:新的cc-switch版本会有claude cli和claude desktop,使用的是第一个claude cli

② 填写配置信息

  • 按照下图指示进入配置页面:

  • 向下滚动页面,将刚才获取的凭证填入对应位置:

  • 其他高级配置可按需修改。最后请核对红框内的核心信息,确认无误后点击添加:

③ 启动 Vibe Coding: 重新打开 VS Code 中的 Claude Code 扩展。如果无需登录账号,直接跳转至对话窗口,即说明配置大功告成,您可以开始使用啦!

(4)远程环境(Remote - SSH)配置指南

① 开启本地代理服务: 在 cc-Switch 中开启本地代理,并务必记住生成的服务地址与端口:

② 验证代理状态

  • 点击上图步骤②中的图标,进入终端:

  • 在终端中执行以下指令。若弹出的文本文件中包含代理信息,说明代理开启成功。请复制红框中的内容备用:
1
notepad "%USERPROFILE%\.claude\settings.json"

③ 远程配置 Claude Code(需提前安装 VS Code 的 Remote - SSH 插件)

  • 编辑 VS Code 远程连接配置文件,添加 RemoteForward 参数进行端口转发,格式请参考下图:

  • 在远程服务器上安装 Claude Code 扩展:

  • 对远程扩展进行环境配置:

  • 将之前复制的代理地址与密钥填入空括号 [] 中,完成后的效果参考红框内容:

④ 完成配置并运行: 操作逻辑与本地运行一致。点击右侧边栏的 Claude Code 图标,若直接进入对话界面,说明远程配置成功。现在,尽情享受您的远程 Vibe Coding 体验吧!

五、Claude Code扩展使用

(1)权限模式

单击对话框的右下角

里面一共有5个模式

这里如果你想让 ai 自己全程开发,直接选择最后那个选项 — 绕过权限。
从 “yes”程序员变成“一键”程序员
这个还是慎用。
像我们一般的流程是 先单击“规划模式” 然后给出方案后,再执行,这样就能够生成的效果会更好些。

还有底部有一个“推理预算”
如果和我一样走国内 API(硅基流动/百炼等),Effort 档位要 更保守 使用。国内平台按输入+输出 token 计费,而 High/Max 档位的 thinking tokens 会计入输出费用。

官方数据显示 Max 比 Extra high 多耗近一倍 token 却只提升 3% 质量,在国内按量计费下这个性价比极低。建议日常默认 Medium,简单任务切 Low,遇到棘手 Bug 再临时拉高到 High,Max 档除非极难任务否则不建议开。

(2)撤销操作

vs code 如果ai生成的内容不中意,就可以直接来退回

在这两个选项,单击随机一个即可。

① Rewind code to here

代码回退,但还在当前对话里继续聊

单击 Rewind 来进行撤销退回即可

② Fork conversation and rewind code

代码回退,同时新开一个独立对话

(3)让ai查看特定文件

第一个是上传项目以外的文件

第二个是上传项目当中的文件

如果文件在当前项目里 ,直接空格一下,然后输入@ 符号即可快速调用。

通过以上四个部分的分享,相信你已经掌握了在VS Code中高效使用Claude Code的核心技巧。

六、CC-Switch 调用本地模型

在添加供应商时选择自定义配置,并编辑如下:

注意:

1.API Key可以任意填写。

2.请求地址为本地搭建大模型的URL,图中为llama搭建为例。

3.还有本地模型需要开启路由。