AI Coding 开发环境搭建【Claude Code + CC Switch + VS Code】

〇、前言

为什么选择 Claude Code + CC Switch 这个组合？

这个组合不仅打破了单一模型的限制，还为开发者提供了一套完整、高效且高性价比的 AI 编程生产力方案。

其核心优点可以简单概括为以下四点：

1）极致的性价比与成本可控。 通过接入 DeepSeek 等第三方高性价比模型，日常重度使用的月费可轻松控制在百元以内，相比直接使用官方昂贵模型（如：Claude Opus）成本可降低 70% 以上。

2）告别繁琐配置的"零门槛"切换。 CC Switch 解决了多工具配置管理的混乱局面。开发者无需手动修改底层配置文件或编写复杂的转换脚本，只需通过可视化的图形界面即可一键导入配置并切换模型。

3）强大的模型能力与超长上下文支持。 组合中的第三方模型（如：DeepSeek V4 系列）具备原生 1M tokens 的超长上下文窗口，能够轻松容纳整个项目代码库，在进行跨文件重构、大型项目架构分析时不再受限。

4）**高可用性与统一的安全管理。**在稳定性方面，CC Switch 提供了本地代理和自动故障转移机制。当主供应商响应超时或返回错误时，系统能在毫秒级内自动切换到备用供应商，避免工作流中断。

本文就这个组合进行尝试部署，最终通过在 VS Code 中安装插件来实现大模型的调用，供参考。

一、Windows 上的安装与配置步骤

1.1 安装 Node.js

下载指定的版本 ，下载地址：https://nodejs.org/en/download。

注意：需要下载较新的版本，例如：v22、v24 等等，因为低版本可能不支持。LTS：长期支持（Long Term Support）。

然后，双击运行安装程序（nvm-setup.exe），一路"下一步"即可。

另外，如果需要兼容过往 v18 及以下版本的 Node.js 版本，那么就需要同时安装多个版本了。建议参考博主之前的文章，通过 nvm 工具安装多个版本 Node.js，轻松切换，链接地址：Windows 上同时安装多个 node 版本**。

复制代码

// 使用 nvm 工具切换 Node.js 版本
C:\Windows\system32>nvm use 24.18.0
Now using node v24.18.0 (64-bit)

C:\Windows\system32>nvm ls

  * 24.18.0 (Currently using 64-bit executable)
    14.18.0

C:\Windows\system32>node -v
v24.18.0

C:\Windows\system32>npm -v
11.16.0

1.2 安装并配置 CC Switch（核心代理与管理）

CC Switch 在这里扮演"中间人"角色，负责拦截 Claude Code 的请求，并将其转发给实际的大模型供应商（如：DeepSeek、OpenAI 等）。

目前推荐使用 v3.16.1 及以上的版本，以获得更稳定的性能和更完善的国产模型支持。

Windows 用户主要有两种格式可选，建议根据需求选择：

MSI 安装版（新手首选，推荐） 。例如：CC-Switch-v3.16.4-Windows.msi。更适合追求稳定、长期使用的用户。

ZIP 便携版（免安装）。例如：CC-Switch-v3.16.4-Windows-Portable.zip。该版本解压即用，不写入注册表，无残留，适合临时使用、多设备迁移或不想占用系统盘空间的用户。

下载地址：https://github.com/farion1231/cc-switch/releases#release-v3.16.5。

安装完成或者直接打开 CC Switch 主界面后，点击右上角的加号，来添加新的 Claude 供应商配置，然后保存就直接自动启用了。例如添加 DeepSeek 配置：

1.3 安装 Claude Code（CLI 终端工具）

1.3.1 详细的安装步骤

复制代码

// 【1】Windows 安装 Claude Code 必须满足两个条件：
//     Node.js > 18.0（npm 是安装依赖）
//     推荐使用 PowerShell
PS C:\Users\Administrator> node -v
v22.23.2
PS C:\Users\Administrator> npm -v
10.9.8
//    要求：
//    Node.js 版本 > 18.0（如：v20.15.1）附带的 npm 版本 > 9.0
// 【2】安装 Git for Windows（关键步骤）
// https://git-scm.com/download/win?spm=5176.28103460.0.0.39f22988QhrO6R
// 安装时必须勾选：
//     Add Git to PATH
//     Use Git and optional Unix tools in Windows command prompt
// 验证安装：
PS C:\Users\Administrator> git --version
git version 2.33.0.windows.2
// 【3】npm 全局安装
PS C:\Windows\system32> npm install -g @anthropic-ai/claude-code
added 2 packages in 1m
npm warn allow-scripts 1 package has install scripts not yet covered by allowScripts:
npm warn allow-scripts   @anthropic-ai/claude-code@2.1.218 (postinstall: node install.cjs)
npm warn allow-scripts
npm warn allow-scripts Run `npm approve-scripts --allow-scripts-pending` to review, or `npm approve-scripts <pkg>` to allow.
// 若遇【权限问题】，在 PowerShell 中执行：
PS C:\Users\Administrator> Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
执行策略更改
执行策略可帮助你防止执行不信任的脚本。更改执行策略可能会产生安全风险，如 https:/go.microsoft.com/fwlink/?LinkID=135170
中的 about_Execution_Policies 帮助主题所述。是否要更改执行策略?
[Y] 是(Y)  [A] 全是(A)  [N] 否(N)  [L] 全否(L)  [S] 暂停(S)  [?] 帮助 (默认值为"N"): A
// 【4】验证安装
PS C:\Users\Administrator> Claude --version
2.1.226 (Claude Code)
// 命令若无法识别，就重启 PowerShell 再试

1.3.2 问题：无法将"claude"项识别为 cmdlet、函数、脚本文件或可运行程序的名称

在测试 claude 是否安装成功时，报错提示如下。

复制代码

PS C:\Users\Administrator> claude --version
claude : 无法将"claude"项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写，如果包括路径，请确保路径
正确，然后再试一次。
所在位置 行:1 字符: 1
+ claude --version
+ ~~~~~~
    + CategoryInfo          : ObjectNotFound: (claude:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

根据之前的安装步骤，npm 显示安装成功，但系统仍然找不到 claude 命令，那么接下来需要排查两个最常见的原因：环境变量路径和文件是否存在。

1）确认环境变量

确认 npm 的全局包安装在哪里，并检查这个路径是否已经添加到系统的环境变量中。

查看 npm 的全局安装路径：npm config get prefix，然后查看这个路径是否在系统环境变量 Path 中，没有就手动添加。

添加后，必须关闭并重新打开一个新的 PowerShell 窗口，更改才会生效。

2）确认 claude 的可执行文件是否存在

进入 npm 的全局安装目录（就是第一步中npm config get prefix输出的路径）。

在该目录下，查找是否存在名为 claude 或 claude.ps1 的文件。如果文件不存在：说明 npm install -g @anthropic-ai/claude-code 安装过程可能存在问题，或者该包并未正确创建命令行入口。

需要先卸载再重新安装：

复制代码

npm uninstall -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code

最后，如果以上两步都无法解决问题，可以使用一个最直接的方法：在启动 PowerShell 时临时绕过执行策略。

使用以下命令来启动一个新的 PowerShell 会话，然后在该会话中运行 claude 命令：pwsh -ExecutionPolicy Bypass。这个命令会启动一个新的 PowerShell 窗口，并且在该窗口会话中，所有脚本的执行都会被允许。如果此时 claude --version可以正常运行，那么就 100% 确定是执行策略的问题。

1.4 在 VS Code 中安装 Claude Code for VS Code 插件

注意：这个插件对 VS Code 的版本是有要求的，Requirements：VS Code 1.98.0 or higher。

VS Code 的下载地址：https://code.visualstudio.com/Download?_exp_download=fb315fc982。

找到这个插件直接安装即可。

安装完成之后，IDE 开发区的右上角就会出现一个 Claude Code 的标志，单击即可打开主界面。

然后就可以输入需求详情，任由聪明的大模型尽情发挥。

这里会默认调用 CC-Switch 所启用的大模型，当想切换大模型时，直接在 CC-Switch 上点击启用即可，非常方便。

二、小小的总结

Claude Code + CC Switch 组合凭借其显著优势，成为 AI 编程领域的优质解决方案。它具有较低的开发成本，CC Switch 彻底摆脱了繁琐的底层设置，超长上下文窗口解决了传统模型在复杂项目中的局限性，自动故障转移机制为持续开发提供了可靠保障。

**在安装配置过程中，需重点关注各工具的版本兼容性，如：Node.js、VS Code 的版本要求，以及 Git for Windows 的正确安装选项。**针对 Claude Code 命令无法识别等常见问题，按照环境变量检查、文件存在性验证、执行策略调整的步骤逐一排查，可有效解决安装障碍。

最终，通过在 VS Code 中集成插件，实现了便捷的大模型调用，结合 CC Switch 的灵活切换功能，构建了一套高效的 AI 编程工作环境。无论是日常代码编写、调试，还是大型项目的架构设计，该组合都能显著提升开发效率，值得广泛推广和应用。

类别	关键信息
核心优势	性价比高（成本降 70%+）、零门槛切换、1M tokens 长上下文、自动故障转移
必备工具	Node.js（>18.0）、CC Switch（≥v3.16.1）、Claude Code CLI、VS Code（≥1.98.0）
安装要点	Git for Windows 需勾选 PATH 选项；PowerShell 需处理执行策略权限
使用特点	VS Code 插件一键调用，CC Switch 可视化切换模型，适配大型项目开发