跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashNode.jsAI

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

综述由AI生成详细说明了如何在终端环境中安装 Node.js、Claude Code CLI 及 cc-switch 图形化工具，并通过配置 API Key 实现调用 Kimi 等 AI 模型辅助编程。内容涵盖环境准备、工具安装、密钥获取、模型切换及速率限制说明，帮助用户快速搭建本地 AI 开发工作流。

开源信徒发布于 2026/4/6更新于 2026/5/2238 浏览

Claude Code + cc-switch 配置指南

本指南介绍如何安装和配置 Claude Code 命令行工具及 cc-switch 模型管理工具。完成配置后，用户即可在代码编辑器的终端中调用 Kimi、GPT-4 或其他主流 AI 模型，辅助完成代码编写、解释和调试等任务。

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/claude-code@2.0.25: 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/claude-code@2.0.25

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

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

  1. 确认版本要求：请确保输出的版本号为 v18.0.0 或更高。
  2. 安装与管理 (推荐使用 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 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 需要三项核心信息：

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

获取步骤如下：

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

用户等级累计充值金额并发RPM (每分钟请求数)TPM (每分钟 Token 数)TPD (每天 Token 数)
Free¥ 01332,0001,500,000
Tier1¥ 5050200128,00010,000,000
Tier2¥ 100100500128,00020,000,000
………………

目录

  1. Claude Code + cc-switch 配置指南
  2. 1. 准备工作：配置必需的 Node.js 环境
  3. 为什么必须使用较新版本的 Node.js？
  4. 检查并安装正确的 Node.js 版本
  5. 安装 Node.js v18 的最新稳定版
  6. 将当前会话的 Node.js 版本切换为 v18
  7. 2. 第一步：安装 Claude Code 命令行工具
  8. 3. 第二步：安装 cc-switch 模型管理工具
  9. 4. 第三步：获取 AI 模型的 API Key
  10. API Key 是访问 AI 服务的凭证
  11. 以 Kimi (Moonshot) 为例，获取 API Key
  12. 5. 第四步：在 cc-switch 中配置 AI 模型
  13. 6. 第五步：激活配置并进行验证
  14. 7. 第六步：在实际项目中使用
  15. 8. 注意事项：理解并应对 API 频率限制
  16. 速率限制的机制
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫，关注极客日志

微信公众号「极客日志V2」，在微信中扫描左侧二维码关注。展示文案：极客日志V2 zeeklog

更多推荐文章

查看全部
  • webdav-server 轻量级部署与实战配置指南
  • 十大 AI 论文辅助工具评测：降重、去 AIGC 痕迹与写作效率提升
  • 七种主流大模型微调方法详解：原理与场景对比
  • Linux 互斥锁详解：临界区保护与多线程协作
  • Python 基础入门：环境配置与开发工具安装
  • C++ 类与对象进阶：初始化列表、静态成员与编译器优化实战
  • 前端面试题精选：ES6、Vue、跨域及性能优化
  • 5 分钟了解 Sora 技术原理与应用前景
  • Python 内置函数 range、repr、reversed、round 用法详解
  • Python 内置函数详解：30 个核心函数的语法、案例与最佳实践
  • 本地 AI 服务远程管理难题与加密隧道解决方案
  • 鸿蒙系统若不再兼容安卓，对行业生态有何影响？
  • 嵌入式系统 Newlib 编译指南
  • Flutter 三方库 arcade 的鸿蒙化适配指南
  • OpenClaw 记忆管理实践：Token 压缩与双层记忆体系
  • Python 学习路线：从入门到精通的完整指南
  • Llama-2-7b 在昇腾 NPU 上的部署与性能基准实测
  • Python Pandas 核心用法与实战指南
  • Web3D 技术栈指南：Blender、Three.js 与数字孪生开发
  • Flutter 三方库 bavard 的鸿蒙化适配指南：语义化聊天协议与机器人逻辑

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online

  • 随机西班牙地址生成器

    随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online

  • Markdown转HTML

    将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online