Claude Code + cc-switch 配置指南

优质文章学习记录

11 Apr 2026 — 8 min read

本指南旨在引导初次接触的用户，一步步完成 Claude Code 命令行工具 (CLI) 和 cc-switch 的安装与配置。完成配置后，用户即可在代码编辑器的终端中，通过简单的命令，调用 Kimi、GPT-4 或其他主流 AI 模型，辅助完成代码编写、解释和调试等任务。

核心结论：Claude Code 与 cc-switch 结合使用，可以显著提升编程工作的效率。

1. 准备工作：配置必需的 Node.js 环境
2. 第一步：安装 Claude Code 命令行工具
3. 第二步：安装 cc-switch 模型管理工具
4. 第三步：获取 AI 模型的 API Key
5. 第四步：在 cc-switch 中配置 AI 模型
6. 第五步：激活配置并进行验证
7. 第六步：在实际项目中使用
8. 注意事项：理解并应对 API 频率限制

1. 准备工作：配置必需的 Node.js 环境

Claude Code CLI 是一个基于 Node.js 的工具，其成功安装和运行严格依赖于系统中的 Node.js 版本。

为什么必须使用较新版本的 Node.js？

Claude Code 的开发者在其包配置中明确指定了所支持的 Node.js 最低版本。如果使用低于要求的版本进行安装，包管理器 (npm) 会无法正确处理依赖关系，并抛出一系列警告，最终导致安装失败或即使安装完成也无法运行。

例如，在 Node.js v14 的环境中尝试安装，会收到如下错误日志：

npm WARN notsup Unsupported engine for @anthropic-ai/[email protected]: wanted: {"node":">=18.0.0"}(current: {"node":"14.18.3","npm":"6.14.15"})npm WARN notsup Not compatible with your version of node/npm: @anthropic-ai/[email protected]

这行日志清晰地指出：claude-code 包要求 (wanted) Node.js 版本大于等于 18.0.0，但当前环境 (current) 的版本是 14.18.3，因此不兼容。忽略这些警告将导致后续使用时出现问题。

检查并安装正确的 Node.js 版本

确认版本要求：请确保输出的版本号为 v18.0.0 或更高。
安装与管理 (推荐使用 nvm)：如果版本不符，强烈建议使用 nvm (Node Version Manager) 来进行安装和版本管理。nvm 可以在同一台电脑上维护多个 Node.js 版本并轻松切换。完成切换后，再次运行 node -v 进行确认。
- 安装 nvm：
  - macOS / Linux: 参考 nvm-sh/nvm GitHub 官方指南。
  - Windows: 使用 nvm-windows（适配Windows的nvm版本），具体步骤如下（Node.js自带npm包管理器，旧版本Node/npm会与nvm管理的版本冲突，需先彻底清理）：
    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 install18# 将当前会话的 Node.js 版本切换为 v18 nvm use 18

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

node -v

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

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

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

npminstall -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 可移植版本。

masos用户

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 需要三项核心信息：

项目	说明	示例
供应商名称	自定义名称，用于在 `cc-switch` 中识别。	`Kimi Moonshot`
官网地址	AI 服务商提供的 API 服务器地址 (Endpoint)。	`https://api.moonshot.cn`
API Key	专属访问密钥。	`sk-xxxxxxxxxxxxxxxxxxxx`

获取步骤如下：

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

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

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

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

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

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

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

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

当界面状态显示“已切换到 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) 为例，其速率限制与账户累计充值金额挂钩：

用户等级	累计充值金额	并发	RPM (每分钟请求数)	TPM (每分钟Token数)	TPD (每天Token数)
Free	¥ 0	1	3	32,000	1,500,000
Tier1	¥ 50	50	200	128,000	10,000,000
Tier2	¥ 100	100	500	128,000	20,000,000
…	…	…	…	…	…

Go语言中的未来：从泛型到WebAssembly

Go语言中的未来：从泛型到WebAssembly 前言作为一个在小厂挣扎的Go后端老兵，我对Go语言未来的理解就一句话：能进化的绝不固步自封。想当年刚接触Go语言时，它还没有泛型，没有模块系统，甚至连错误处理都被人诟病。现在的Go语言已经今非昔比，泛型来了，模块系统完善了，错误处理也有了更多选择。今天就聊聊Go语言的未来发展，从泛型到WebAssembly，给大家一个能直接抄作业的方案。为什么需要关注Go语言的未来？我见过不少小团队，只关注当前的技术，不关心语言的发展趋势，结果技术栈逐渐落后。关注Go语言的未来能带来很多好处： * 提前准备：了解未来的特性，提前调整代码结构 * 技术选型：根据未来趋势，做出更合理的技术选型 * 职业发展：掌握最新技术，提升个人竞争力 * 项目规划：根据语言发展，制定更合理的项目规划泛型泛型是Go 1.18引入的重要特性，它能让我们编写更加通用的代码。基本用法 // 定义泛型函数 func Map[T, U any](s []T, f

打造你的专属 AI 旅行管家：基于 OpenAgents 的多智能体旅游助手实战

基于 OpenAgents 的多智能体旅游助手实战在大模型与智能体（Agent）技术快速发展的今天，构建一个能理解需求、协调任务、调用工具的 AI 助手已不再是遥不可及的梦想。传统的聊天机器人往往只能被动回答问题，而现代智能体系统则具备“主动性”——它能拆解复杂目标、调用多个子模块、甚至与外部服务交互，从而完成端到端的任务。本文将带你从零开始，利用 OpenAgents 这一开源框架，搭建一个由多个专业智能体协同工作的本地旅游小助手。这个系统不仅能根据用户一句话生成完整的旅行计划、推荐个性化景点，还能逐步扩展至查询实时天气、预订酒店、规划交通等实用功能，真正实现“一句话开启智能旅行”。一、本地启动智能体要运行基于 OpenAgents 的智能体系统，首先需要启动其核心网络服务。该服务负责管理所有 Agent 的注册、通信和协作，是整个多智能体生态的“中枢神经系统”。在终端中执行以下命令： openagents network start 首次运行时，OpenAgents 会自动打开浏览器，引导你完成初始化配置（

前端安全：别让你的应用变成黑客的游乐场

前端安全：别让你的应用变成黑客的游乐场毒舌时刻这代码写得跟网红滤镜似的——仅供参考。各位前端同行，咱们今天聊聊前端安全。别告诉我你还在写明文存储密码，那感觉就像把家门钥匙挂在门口——方便，但不安全。为什么你需要前端安全最近看到一个项目，登录表单直接把密码发送到服务器，没有任何加密。我就想问：你是在做应用还是在给黑客送大礼？反面教材 // 反面教材：不安全的登录 // components/LoginForm.jsx export default function LoginForm() { const [username, setUsername] = useState(''); const [password, setPassword] = useState(''); const handleSubmit = async (e) => { e.preventDefault(); // 直接发送明文密码 const response = await

【Js逆向 python】Web JS 逆向全体系详细解释

Web JS 逆向全体系内容互联网技术安全提示与职业操守做渗透测试，必须严格遵守以下原则： 1. 合法授权：仅在书面授权的范围内使用逆向技术，禁止未授权测试； 2. 最小影响：避免使用高风险参数（如sqlmap工具的 --risk=3、--os-shell），防止目标服务崩溃； 3. 数据保护：枚举到的敏感数据（如用户密码）需严格保密，测试后立即删除； 4. 留痕清理：测试结束后，协助目标清除测试留下的日志、文件等痕迹。免责声明 1. 本文所述所有渗透测试技术、工具、命令及实战案例，仅适用于已获得目标系统 / 网络所有者书面授权的测试场景（如企业内部安全评估、甲方委托的红队测试、个人合法拥有的实验环境）。 2. 任何组织或个人若未取得明确书面授权，擅自将本文内容用于对第三方系统 / 网络的扫描、探测、攻击等行为，均属于非法网络活动，涉嫌违反《中华人民共和国网络安全法》《中华人民共和国刑法》（第

目录