Claude Code 安装并接入 VScode：用 CC Switch 与 ollama 双通道配置指南

1. 为什么要在 VScode 里折腾 Claude CodeClaude Code 是 Anthropic 推出的命令行编程助手能直接在终端里读代码、改文件、跑命令但它默认只认官方账号。国内开发者想用要么走官方订阅要么接第三方兼容接口要么干脆接本地模型。VScode 作为主力编辑器如果能把它接进来写代码时随手唤起一个能读整个项目的 AI体验比网页版强不少。这篇聚焦一件事把 Claude Code 装好然后在 VScode 里跑通。路径给两条一条是 CC Switch 做多模型切换一条是 ollama 跑本地模型。两条路都给出可复制的配置片段以及连接成功和失败回退的验证动作。适合已经装过 Node.js、想省事接入的开发者也适合想用本地模型不花钱跑通流程的人。前置条件就两个Node.js 18 以上、Git。Node.js 版本太低会在安装阶段直接报错建议先node -v确认一下。下面从环境准备开始一步步来。2. 环境准备与 Claude Code 安装2.1 Node.js 与 Git 检查打开终端先确认版本node -v npm -v git --versionNode.js 建议 18 LTS 或 20 LTS。如果版本低于 18去 Node.js 官网下 LTS 包重装装完重启终端。Git 在 Windows 上装完会自动带上 Git Bash后面 Claude Code 调用 git 命令时不会报找不到。Windows 用户注意安装 Claude Code 时要用管理员身份打开终端否则全局包写入权限会失败。2.2 安装 Claude Codenpm install -g anthropic-ai/claude-code装完验证claude --version出现版本号就说明装好了。如果报command not found检查 npm 全局路径有没有加进 PATHnpm config get prefix把这个路径加到系统环境变量里重启终端再试。2.3 跳过首次引导第一次运行claude会提示登录验证。如果暂时不接官方账号可以先跳过引导。找到用户目录下的.claude.jsonWindowsC:\Users\你的用户名\.claude.jsonmacOS/Linux~/.claude.json用文本编辑器打开在最后一个字段后面加一行注意上一行末尾补逗号hasCompletedOnboarding: true保存后回到终端再输入claude就不会卡在登录页了。这一步只是跳过引导不代表已经连上模型模型接入在下面两节。3. 通道一CC Switch 配置多模型切换3.1 CC Switch 是什么CC Switch 是一个 Claude Code 的配置切换工具图形界面能把不同厂商的 API Key 存成配置一键切换。它本身不提供模型只是帮你管理ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN这两个环境变量。对于要在官方、第三方兼容接口、本地模型之间来回切的人比手动改环境变量省事。去 GitHub 的 releases 页面下载对应系统的安装包双击安装一路下一步即可。装完打开右上角有个用来添加配置。3.2 添加一个兼容接口配置以接入 TaoToken 为例在 CC Switch 里新建配置填三个关键字段字段值名称taotokenBase URLhttps://taotoken.net/apiAPI Key在控制台创建的 KeyAPI Key 的创建入口在控制台的 API Keys 页面登录后新建一个复制出来填进去。保存后 CC Switch 会把这个配置写进 Claude Code 读取的环境变量里。注意Base URL 末尾不要带斜杠带斜杠有些版本会拼出双斜杠导致 404。3.3 在终端里验证切换配置保存后回到终端claude如果之前跳过引导成功这次不会再让你登录。输入斜杠命令/model会列出当前可用的模型选一个回车。然后随便发一句「你好帮我看看当前目录有哪些文件」能正常回复就说明通道打通了。如果提示余额或额度问题换一个模型再试或者去控制台确认 Key 的额度状态。这一步的验证动作很简单能对话就是成功报 401 就是 Key 错报 404 就是 Base URL 错。4. 通道二ollama 本地模型对接4.1 安装 ollama 并拉模型ollama 官网下载安装包装完确认服务在跑ollama --version ollama list拉一个模型比如ollama pull qwen2.5-coder:7b模型大小按机器显存选7B 大概 5GB 左右16GB 内存的机器能跑。拉完ollama list能看到模型名。4.2 用 ollama 启动 Claude Codeollama 新版本提供了直接启动 Claude Code 的命令ollama launch claude回车后会问是否继续选 yes。然后进入 Claude Code 界面输入/model选择刚拉下来的本地模型。发一条消息测试能回复就说明本地通道通了。4.3 手动配置环境变量如果ollama launch claude不生效可以手动设环境变量。Windows 在系统环境变量里加macOS/Linux 在~/.zshrc或~/.bashrc里加export ANTHROPIC_BASE_URLhttp://localhost:11434 export ANTHROPIC_AUTH_TOKENollamaANTHROPIC_AUTH_TOKEN随便填一个字符串就行ollama 本地服务不校验。设完重启终端再跑claude。注意ollama 默认端口是 11434如果被占用改端口后这里也要同步改。5. VScode 插件接入与联调5.1 安装官方插件打开 VScode扩展市场搜claude code for vscode认准发布者是 Anthropic 的那个。装完侧边栏会出现 Claude Code 图标。5.2 配置环境变量让插件读到插件读取的是系统环境变量不是终端里临时 export 的。所以要把上面那两组变量写进系统环境变量变量名变量值说明ANTHROPIC_BASE_URLhttp://localhost:11434指向 ollama 本地服务ANTHROPIC_AUTH_TOKENollama本地服务不校验随意填如果走 CC Switch 通道CC Switch 会自己管理这两个变量不用手动加。改完环境变量必须完全退出 VScode 再重开只关窗口不算。5.3 验证对话重开 VScode新建一个空文件夹打开点侧边栏 Claude Code 图标。如果还提示登录说明环境变量没生效检查是不是加到了用户变量而不是系统变量或者路径写错。能进对话界面后输入一句让它写个函数比如「写一个 Python 快速排序」能返回代码就成功了。5.4 回退方案如果插件死活连不上本地 ollama回退到 CC Switch在 CC Switch 里加一个指向 ollama 的配置Base URL 填http://localhost:11434Key 填ollama然后在 VScode 里通过 CC Switch 切换。这样插件读到的还是 CC Switch 写好的变量绕开手动配置。6. 常见报错排查claude: command not foundnpm 全局路径没进 PATH。跑npm config get prefix拿到路径加进系统环境变量重启终端。401 UnauthorizedAPI Key 错或过期。去控制台重新建一个确认复制时没带空格。404 Not FoundBase URL 写错常见是末尾多了斜杠或少了/api。对照文档改。ECONNREFUSED 127.0.0.1:11434ollama 服务没启动。跑ollama serve或重启 ollama 应用。VScode 插件一直提示登录环境变量没被 VScode 读到。完全退出 VScode 重开或者用 CC Switch 接管配置。模型回复乱码或截断本地模型上下文窗口小长对话容易截断。换大一点的模型或者精简提问。ollama launch claude报未知命令ollama 版本太旧升级到最新版再试或者直接用手动环境变量方式。7. 后续怎么用两条通道跑通后日常用起来其实很直接。写代码时在 VScode 侧边栏唤起 Claude Code让它读当前文件、改函数、写测试。本地模型适合不联网、不花钱的场景兼容接口适合需要更强模型的时候。CC Switch 的价值在于切换成本低改个配置点一下就行不用来回改环境变量。如果后面要长期在项目里用建议把 API Key 管理好别硬编码进代码。控制台里可以建多个 Key 分别给不同项目用方便排查和回收。接入文档里有更细的参数说明遇到配置问题可以先翻一遍。