一、前言

很多人在第一次使用 Claude Code 时，会先去终端安装 Claude Code，再手动配置 API Key、Base URL 和模型名称。这个流程虽然可行，但对新手来说比较容易出错。

比如常见问题包括：

1. Node.js 环境没有装好；
2. Claude Code 安装命令执行失败；
3. API Key 填错；
4. Base URL 和注册链接混淆；
5. 模型名称不匹配；
6. 切换接口后终端没有生效。

如果你只是想快速搭建 Claude Code 的开发环境，其实可以先安装 CC Switch，然后通过 CC Switch 来管理 Claude Code 的安装、更新、诊断和 Provider 配置。

本文以 Windows 环境为例，记录一次从零开始配置 CC Switch、安装 Claude Code、接入 AICodeMirror 接口并完成测试的过程。

二、CC Switch 是什么

CC Switch 是一个 AI 编程工具配置管理器，主要用于统一管理 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode 等工具的 Provider 配置。

简单理解，它不是模型服务本身，也不是 API 平台，而是一个本地配置管理工具。

它可以帮助我们完成：

1. 安装和管理 Claude Code 等 CLI 工具；
2. 添加不同 Provider；
3. 切换 API 接口；
4. 管理模型名称；
5. 管理 MCP、Prompts 和 Skills；
6. 查看用量和调用记录；
7. 备份和恢复本地配置。

对于经常使用 AI 编程工具的开发者来说，CC Switch 可以减少手动修改配置文件的麻烦。

三、准备工作

在开始之前，需要准备以下内容：

1. 一台 Windows、macOS 或 Linux 电脑；
2. Node.js 环境；
3. CC Switch 安装包；
4. 一个可用的 API Key；
5. API Base URL；
6. 支持的模型名称。

本文使用的接口账号入口如下，仅用于获取测试所需账号：

AICodeMirror官方共享平台 - 中国用户专属AI编程助手

需要注意：这个地址是注册入口，不是 API Base URL。实际配置时，Base URL、API Key 和模型名称都需要进入平台后台查看。

四、第一步：安装 Node.js

Claude Code 这类 CLI 工具通常需要 Node.js 环境。因此，即使通过 CC Switch 安装 Claude Code，也建议先安装 Node.js。

打开 Node.js — 在任何地方运行 JavaScript，下载 LTS 版本并安装。

安装完成后，打开终端，输入：

node -v
npm -v

如果能正常显示版本号，说明 Node.js 安装成功。

五、第二步：安装 CC Switch

进入 CC Switch 官方网站 - AI 编程 CLI 统一管理工具下载页面，根据自己的系统选择安装包。

Windows 用户可以选择 .msi 安装包；
macOS 用户可以选择 .dmg 安装包；
Linux 用户可以选择 .deb、.rpm 或 AppImage 文件。

以 Windows 为例，下载完成后，双击安装包，按照提示完成安装即可。

六、第三步：首次打开 CC Switch

安装完成后，打开 CC Switch。

首次进入后，可以看到左侧有多个功能模块，例如：

1. Providers；
2. Apps；
3. MCP；
4. Prompts；
5. Skills；
6. Sessions；
7. Settings。

新手不需要一开始就配置所有功能，先完成 Claude Code 安装和 Provider 配置即可。

七、第四步：通过 CC Switch 安装 Claude Code

传统方式是先在终端里输入命令安装 Claude Code，例如：

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

但如果你使用的是新版 CC Switch，可以直接在 CC Switch 里管理 Claude Code。

操作流程如下：

1. 打开 CC Switch；
2. 进入 Settings；
3. 找到 About 或 Tools 管理区域；
4. 找到 Claude Code；
5. 点击 Install；
6. 等待安装完成；
7. 点击 Diagnose 检查环境是否正常。

安装完成后，CC Switch 会识别本机 Claude Code 状态。如果出现异常，可以根据诊断提示检查 Node.js、npm、环境变量或网络连接。

八、第五步：添加 AICodeMirror Provider

Claude Code 安装完成后，需要添加一个可用的 Provider。

这里以 AICodeMirror 接口为例。

进入 AICodeMirror官方共享平台 - 中国用户专属AI编程助手，找到以下信息：

1. API Base URL；
2. API Key；
3. 支持的模型名称；
4. 计费或调用记录页面。

 

九、第七步：测试 Claude Code 是否可用

打开终端，进入任意项目目录，输入：

claude

如果 Claude Code 正常启动，可以输入一个简单任务：

请用 Python 写一个二分查找函数，并解释时间复杂度。

如果模型正常返回内容，说明 CC Switch、Claude Code 和 Provider 配置已经基本成功。