Claude Code 与 cc-switch 安装配置指南

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

nvm install 18
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

或者下载 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) 为例，其速率限制与账户累计充值金额挂钩：