最新Claude Code安装连接VScode保姆级教程(CC Switch/Ollama)
一、安装Node.js与Git运行环境
前置依赖配置可参考本地部署指南,优先完成Node.js和Git的安装。这一步决定了后续环境能否正确运行,任何偏差都会导致流程中断。
二、全局安装Claude Code
1、以管理员权限打开终端,执行以下命令:
npm install -g @anthropic-ai/claude-code
2、验证安装是否成功,输入以下命令(显示版本号即表示安装成功):
claude --version
3、在命令行输入claude启动,系统会提示需要进行身份验证,说明程序已可正常运行:
4、跳过验证环节,直接修改配置文件。进入C盘用户目录,找到.claude.json文件:
5、用文本编辑器打开该文件,在末尾追加一行(注意上一行末尾需加逗号):
"hasCompletedOnboarding":true
6、返回命令行,再次输入claude,出现如下界面时选择yes并回车:
7、回车后系统会要求登录Claude账号(至此安装已基本完成。有账号可直接登录并连接Claude模型;无账号可跳过,进入下一步配置国内模型):
三、安装CC Switch代理工具
1、访问GitHub仓库获取安装包:https://github.com/farion1231/cc-switch/releases/tag/v3.12.3(向下滚动页面即可找到)
2、下载后的安装包显示如下:
3、双击运行,使用默认选项进行傻瓜式安装(中间可自定义安装目录):
4、安装完成后,点击右上角的+按钮添加模型:
四、通过CC Switch接入DeepSeek免费模型
1、打开DeepSeek官网(https://www.deepseek.com/),点击API开放平台:
2、在平台内创建API Key:
3、复制生成的API Key,打开CC Switch:
4、配置完成后,模型即添加成功:
五、Claude Code连接CC Switch代理模型
1、回到终端窗口,输入claude启动,此时会发现已不再要求登录。接着输入/model,选择第一个选项后回车:
2、选择DeepSeek的具体模型,回车确认:
3、系统提示余额不足(首次注册用户可领取免费额度;也可选择其他国内模型,例如智谱AI开放平台,首次注册同样提供免费额度):
六、Claude Code连接本地Ollama模型(以qwen3.5:27b为例)
1、首先安装Ollama并拉取所需模型(具体步骤参考本地部署教程)
2、打开CMD终端,执行以下命令:
ollama launch claude
3、回车后,选择yes:
4、输入/model:
5、选择qwen3.5:27b模型,发送消息后若能正常回复,即表示连接成功:
七、VSCode集成Claude Code
1、打开VSCode,在扩展市场搜索claude code for vscode并安装(注意认准官方版本标识:Anthropic):
2、创建一个空文件夹,用VSCode打开,点击Claude Code插件右上角的图标:
3、若出现以下情况,系统会提示需要登录:
4、此时需要配置Ollama的环境变量:
| 变量名 | 变量值 | 说明 |
|---|---|---|
| ANTHROPIC_BASE_URL | http://localhost:11434 | 指向Ollama本地服务地址(默认端口11434) |
| ANTHROPIC_AUTH_TOKEN | ollama | 伪造的认证Token(任意字符串均可) |
5、重新启动VSCode后,即可看到如下页面,可以开始编写代码:
6、若仍无法连接,可使用CC Switch连接Ollama模型,再通过CC Switch进行桥接:
7、打开VSCode,进入Claude Code页面:
8、选择模型,这里选本地模型:
9、输入问题开始对话,只要收到回复即表示连接成功:
八、Claude Code连接Ollama云端模型
至此,2026年最新版Claude Code安装及VSCode集成的完整指南已全部完成。整体流程并不复杂,核心在于准确配置环境变量与配置文件,其余步骤严格对照截图操作即可。无论选择通过CC Switch连接国内模型,还是直接对接本地Ollama,都能稳定运行。希望这份教程能显著缩短你的调试时间。




































