Claude Code 与 cc-switch 配置指南

1. 备份 npm 自定义配置（可选）：按 Win + R 输入 %AppData%\npm 打开文件夹，若存在 etc\npmrc 文件，复制到桌面备份；无该文件则直接跳过。
2. 卸载旧版 Node.js：打开「控制面板」→「程序和功能」，找到所有名称包含「Node.js」的程序，右键选择「卸载」并按提示完成。
3. 删除 Node/npm 残留文件夹：
   • 按 Win + R 输入 C:\Program Files\nodejs（或 C:\Program Files (x86)\nodejs），若文件夹存在则删除；
   • 再次按 Win + R 分别输入 %AppData%\npm 和 %AppData%\npm-cache，若文件夹存在则删除。
4. 下载 nvm-windows 1.2.2 安装包：打开 nvm-windows 1.2.2 发布页，下拉到「Assets」（资源）区域，点击 nvm-setup.exe 下载（新手推荐此一键安装包）。
5. 安装 nvm-windows：
   • 找到下载的 nvm-setup.exe 双击打开，弹出「用户账户控制」时点击「是」；
   • 勾选「I accept the agreement」→ 点击「Next」；
   • 保留默认安装路径（如 C:\Users\你的用户名\AppData\Roaming\nvm）→ 点击「Next」；
   • 保留 Node.js 符号链接默认路径（C:\Program Files\nodejs）→ 点击「Next」；
   • 点击「Install」开始安装，进度条完成后点击「Finish」。
6. 验证安装成功：以管理员身份打开 CMD/PowerShell，输入 nvm version，若输出 1.2.2 则安装成功。

使用 nvm 安装并切换到 Node.js 18：

# 安装 Node.js v18 的最新稳定版
nvm install 18
# 将当前会话的 Node.js 版本切换为 v18
nvm use 18

检查当前版本：打开终端（在 Windows 上是 CMD 或 PowerShell，在 Mac 上是 Terminal），输入以下命令：

node -v

2. 第一步：安装 Claude Code 命令行工具

Claude Code 是一个命令行界面 (CLI) 工具，用于在终端内与 AI 进行交互。

在终端中运行以下命令进行安装：

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

• npm 是 Node.js 的包管理器，该命令将从 npm 仓库下载并安装 claude-code。
• -g 参数代表'全局安装'，确保 claude 命令可以在系统的任何路径下被调用。

安装完成后，输入 claude 并回车，若显示 Claude Code 的欢迎界面，则表示安装成功。

3. 第二步：安装 cc-switch 模型管理工具

cc-switch 是一个图形化桌面应用，其核心功能是帮助用户管理并切换 Claude Code 所使用的后端 AI 模型。

请前往 cc-switch 的 GitHub 发布页面下载安装包：

• https://github.com/farion1231/cc-switch/releases

根据所用操作系统 (Windows, macOS) 下载对应的安装文件，并按常规流程完成安装。

Windows 用户
从 Releases 页面下载最新的 CC-Switch-v{version}-Windows.msi 安装程序或 CC-Switch-v{version}-Windows-Portable.zip 可移植版本。

macOS 用户

brew tap farion1231/ccswitch
brew install --cask cc-switch

brew upgrade --cask cc-switch

或者 下载 CC-Switch-v{version}-macOS.zip

Linux 用户
从 Releases 页面下载最新的 CC-Switch-v{version}-Linux.deb 软件包或 CC-Switch-v{version}-Linux.AppImage。

4. 第三步：获取 AI 模型的 API Key

API Key 是访问 AI 服务的凭证

API Key 是一串由 AI 服务提供商生成的唯一字符串，用于验证请求者的身份并进行计费。

以 Kimi (Moonshot) 为例，获取 API Key

配置 cc-switch 需要三项核心信息：

获取步骤如下：

1. 访问官网并注册：前往 月之暗面开放平台 并完成账户注册。
2. 定位到 API 密钥页面：登录后，在左侧菜单栏选择 "API 密钥管理"。
3. 创建新的 API Key：点击'+ 创建新的 Key'。系统将生成一个 Key。请立即复制并保存在安全的位置，该 Key 的完整内容只会在创建时显示一次。

5. 第四步：在 cc-switch 中配置 AI 模型

此步骤将获取到的 Kimi API 信息录入 cc-switch。

1. 打开 cc-switch 应用。
2. 点击 '添加供应商' 按钮。
3. 在弹出的窗口中，依次填入信息：
   • 供应商名称：填入自定义的名称，例如 Kimi Moonshot。
   • 官网地址：填入 Kimi 的 API 地址 https://api.moonshot.cn。
   • API Key：粘贴已复制的密钥。
4. 点击 '添加'。

完成后，此 Kimi 配置将显示在 cc-switch 的供应商列表中。

6. 第五步：激活配置并进行验证

配置完成后，需将其激活，以使 Claude Code 工具生效。

1. 在 cc-switch 列表中，选中刚添加的 Kimi Moonshot 配置。
2. 点击 '切换' 按钮。

当界面状态显示'已切换到 Kimi Moonshot'时，cc-switch 已成功修改 Claude Code 的底层配置文件。这个配置文件位于用户主目录下的 .claude/settings.json，其内容已被更新为 Kimi 的 API 地址和 Key。

7. 第六步：在实际项目中使用

所有配置已完成，现在可以在开发工作流中调用 AI。

在该文件夹内启动 Claude Code：

claude

使用终端进入目标项目文件夹。例如：

cd path/to/your/project

8. 注意事项：理解并应对 API 频率限制

在使用 API 服务时，可能会遇到速率限制 (Rate Limit)，这是一种常见的服务保护机制。

速率限制的机制

服务商会根据账户等级，对单位时间内的请求次数 (RPM)、Token 处理量 (TPM) 等指标进行限制。以 Kimi (Moonshot AI) 为例，其速率限制与账户累计充值金额挂钩：