CC-Switch 零基础保姆级教程1（2026 最新版）

是Yu欸2026-05-27 15:04

CC-Switch 零基础保姆级教程（2026 最新版）

  • 写在最前面
  • [一、CC-Switch 到底是什么？](#一、CC-Switch 到底是什么？)
    • [1.1 先理解 Claude Code](#1.1 先理解 Claude Code)
  • [1.2 CC-Switch](#1.2 CC-Switch)
  • [二、CC-Switch 能干什么？](#二、CC-Switch 能干什么？)
  • 三、小白必须先理解的几个概念
    • [3.1 什么是 AI 模型？](#3.1 什么是 AI 模型？)
    • [3.2 什么是 API？](#3.2 什么是 API？)
    • [3.3 什么是 API Key？](#3.3 什么是 API Key？)
    • [3.4 什么是供应商（Provider）？](#3.4 什么是供应商（Provider）？)
  • 四、安装前准备
  • [五、安装 Node.js（最重要）](#五、安装 Node.js（最重要）)
    • [5.1 什么是 Node.js？](#5.1 什么是 Node.js？)
    • [5.2 下载 Node.js](#5.2 下载 Node.js)
    • [5.3 Windows 安装步骤](#5.3 Windows 安装步骤)
    • [5.4 验证是否安装成功](#5.4 验证是否安装成功)
  • [六、安装 Claude Code](#六、安装 Claude Code)
    • [6.1 什么是 Claude Code](#6.1 什么是 Claude Code)
    • [6.2 安装 Claude Code](#6.2 安装 Claude Code)
    • [6.3 验证安装](#6.3 验证安装)
  • [七、安装 CC-Switch](#七、安装 CC-Switch)
    • [7.1 下载地址](#7.1 下载地址)
    • [7.2 Windows 安装](#7.2 Windows 安装)
  • [八、第一次打开 CC-Switch](#八、第一次打开 CC-Switch)
  • 供应商配置
  • [九、配置第一个模型（DeepSeek 示例）](#九、配置第一个模型（DeepSeek 示例）)
    • [9.1 获取 API Key](#9.1 获取 API Key)
    • [9.2 添加供应商](#9.2 添加供应商)
    • [9.3 选择模板](#9.3 选择模板)
    • [9.4 填写 API Key](#9.4 填写 API Key)
    • [9.5 保存](#9.5 保存)
    • [9.6 启用](#9.6 启用)
  • 十、测试是否成功
  • 十一、切换模型
  • [十二、Claude Code 基础使用](#十二、Claude Code 基础使用)
    • [12.1 打开项目](#12.1 打开项目)
    • [12.2 启动 Claude Code](#12.2 启动 Claude Code)
    • [12.3 最简单测试](#12.3 最简单测试)
  • 十三、最推荐的新手工作流
    • [13.1 模型搭配推荐](#13.1 模型搭配推荐)
    • [13.2 为什么大家要切换模型](#13.2 为什么大家要切换模型)
  • 十四、系统托盘功能
  • [十五、什么是 MCP？](#十五、什么是 MCP？)
    • [15.1 MCP 是什么](#15.1 MCP 是什么)
    • [15.2 新手要不要学 MCP](#15.2 新手要不要学 MCP)
  • [十六、什么是 Skills？](#十六、什么是 Skills？)
  • 十七、最容易遇到的问题
    • [17.1 node 不是内部命令](#17.1 node 不是内部命令)
    • [17.2 claude 不是内部命令](#17.2 claude 不是内部命令)
    • [17.3 API Key 无效](#17.3 API Key 无效)
    • [17.4 没有响应](#17.4 没有响应)
    • [17.5 切换模型没生效](#17.5 切换模型没生效)
  • [十八、CC-Switch 高级玩法](#十八、CC-Switch 高级玩法)
  • 十九、新手最推荐配置
  • 二十、完整安装顺序（非常重要）
  • 二十一、你现在已经学会了什么
  • 二十二、下一步学什么
  • 二十三、推荐资源站
  • 二十四、总结
  • 参考资料


🌌你好！这里是 晓雨的笔记本 在所有感兴趣的领域扩展知识，感谢你的陪伴与支持~ 👋 欢迎添加文末好友，不定期掉落福利资讯

写在最前面

版权声明：本文为原创，遵循 CC 4.0 BY-SA 协议。转载请注明出处。
适合人群：完全没有基础的新手、小白、第一次接触 Claude Code / Codex / AI 编程工具的人。

教程目标：从"什么都不懂"，到"能够自己安装、配置、切换模型、正常使用 Claude Code"。

一、CC-Switch 到底是什么？

很多新手第一次看到 CC-Switch 都会懵：

  • 什么是 Claude Code？
  • 什么是 API？
  • 什么是模型切换？
  • 为什么大家都在装 CC-Switch？

别急，我们一步一步来。

1.1 先理解 Claude Code

你可以把 Claude Code 理解成：

"一个会写代码、会读项目、会帮你开发的软件 AI 助手。"

它可以：

  • 帮你写代码
  • 自动修改项目
  • 分析 Bug
  • 自动生成网页
  • 自动生成脚本
  • 帮你学习编程
  • 自动完成很多开发工作

但 Claude Code 本身需要：

  • AI 模型
  • API Key
  • 网络配置
  • 环境变量

这些东西对于新手来说非常复杂。

于是就出现了：

1.2 CC-Switch

CC-Switch 是一个：

"AI 编程工具配置管理器"

简单理解：

它是一个"控制面板"。

你不用再手动改各种配置文件。

你只需要：

  • 点按钮
  • 填 API Key
  • 选择模型
  • 点击启用

就能直接使用。

二、CC-Switch 能干什么？

CC-Switch 的核心功能：

功能 作用
一键切换模型 Claude / DeepSeek / GLM / Gemini 随便切
管理 API Key 不需要手动写配置文件
管理 Claude Code 自动写入配置
管理 Codex 统一管理多个 AI 工具
代理配置 自动处理网络问题
MCP 管理 AI 插件管理
Skills 管理 AI 技能扩展
Prompts 管理 提示词管理
系统托盘切换 不打开软件也能切模型

三、小白必须先理解的几个概念

这是全教程最重要的一部分。

如果你理解了下面几个词，后面就完全不难。

3.1 什么是 AI 模型？

模型就是 AI 的"大脑"。

比如：

模型 公司
Claude Anthropic
GPT OpenAI
Gemini Google
DeepSeek DeepSeek
GLM 智谱
Qwen 阿里

不同模型：

  • 能力不同
  • 价格不同
  • 速度不同
  • 擅长领域不同

例如：

  • Claude：代码能力强
  • DeepSeek：便宜
  • Gemini：上下文长
  • GPT：综合能力强

3.2 什么是 API？

API 就是：

"让你的软件连接 AI 的钥匙和接口"

你可以理解成：

  • ChatGPT 网页版 = 官方聊天界面
  • API = 程序调用 AI 的通道

Claude Code 用的不是网页。

它是通过 API 和 AI 通信。

3.3 什么是 API Key？

API Key 就像：

"AI 平台给你的密码"

格式一般长这样：

txt 复制代码 
sk-xxxxxxxxxxxxxxxx

没有 Key：

  • AI 不让你使用
  • 无法连接模型

3.4 什么是供应商（Provider）？

CC-Switch 里面经常出现：

  • Provider
  • 供应商

它的意思就是：

"你使用哪家的 AI 接口"

比如：

  • Anthropic 官方
  • OpenAI 官方
  • DeepSeek 官方
  • 国内中转 API
  • 第三方聚合平台

四、安装前准备

安装之前需要准备：

必装软件

软件 是否必须
Node.js 必须
Claude Code 建议
CC-Switch 必须

五、安装 Node.js（最重要）

很多新手卡死在这里。

别怕。

我带你一步一步安装。

5.1 什么是 Node.js？

Node.js 是：

"运行 AI CLI 工具的基础环境"

没有它：

  • Claude Code 无法运行
  • Codex 无法运行
  • Gemini CLI 无法运行

5.2 下载 Node.js

打开官网：

下载：

  • LTS 版本（长期稳定版）

不要下载 Current。

新手只下：

LTS

5.3 Windows 安装步骤

双击下载的 exe 文件。

然后：

一路 Next。

重点：

一定勾选：

txt 复制代码 
Add to PATH

否则命令无法使用。

5.4 验证是否安装成功

按：

txt 复制代码 
Win + R

输入：

txt 复制代码 
cmd

打开黑窗口。

输入：

bash 复制代码 
node -v

如果出现：

bash 复制代码 
v22.x.x

说明成功。

再输入：

bash 复制代码 
npm -v

如果也显示版本号。

说明完全安装成功。

六、安装 Claude Code

6.1 什么是 Claude Code

Claude Code 是一个 AI 编程工具。

可以在终端里直接让 AI：

  • 写代码
  • 修改项目
  • 自动修 Bug
  • 创建网页
  • 生成脚本

6.2 安装 Claude Code

打开 cmd。

输入：

bash 复制代码 
npm install -g @anthropic-ai/claude-code

等待安装。

6.3 验证安装

输入：

bash 复制代码 
claude

如果出现 Claude 界面。

说明安装成功。

七、安装 CC-Switch

7.1 下载地址

GitHub 项目：

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

下载：

  • Windows：msi
  • Mac：dmg
  • Linux：AppImage

7.2 Windows 安装

双击安装包。

一路 Next。

完成后打开。

八、第一次打开 CC-Switch

第一次打开后：

你会看到：

  • 供应商管理
  • Claude Code
  • Codex
  • Gemini
  • MCP
  • Skills
  • 设置

新手不用全部懂。

我们先学：

供应商配置

九、配置第一个模型（DeepSeek 示例）

这是最核心步骤。

9.1 获取 API Key

去：

https://platform.deepseek.com

注册账号。

然后：

  • 进入 API Keys
  • 创建 Key
  • 复制保存

注意：

Key 只显示一次。

一定保存。

9.2 添加供应商

打开 CC-Switch。

点击：

txt 复制代码 
添加供应商

9.3 选择模板

CC-Switch 内置很多模板。

比如：

  • DeepSeek
  • OpenAI
  • Claude
  • GLM
  • Gemini

选择：

txt 复制代码 
DeepSeek

9.4 填写 API Key

把刚刚复制的 Key 粘贴进去。

9.5 保存

点击：

txt 复制代码 
保存

9.6 启用

选择刚刚添加的供应商。

点击：

txt 复制代码 
启用

CC-Switch 会自动：

  • 写入配置文件
  • 修改环境变量
  • 切换模型

你什么都不用改。

十、测试是否成功

打开 cmd。

输入：

bash 复制代码 
claude

然后输入：

txt 复制代码 
你好

如果 AI 回复。

说明成功。

十一、切换模型

以后你只需要：

  • 打开 CC-Switch
  • 点击其他模型
  • 点击启用

即可切换。

比如：

模型 特点
Claude 代码强
DeepSeek 便宜
GLM 中文强
Gemini 上下文长

十二、Claude Code 基础使用

现在你已经能用了。

下面教你真正开始 AI 编程。

12.1 打开项目

进入你的项目文件夹：

bash 复制代码 
cd 项目目录

例如：

bash 复制代码 
cd Desktop/test

12.2 启动 Claude Code

输入：

bash 复制代码 
claude

12.3 最简单测试

输入：

txt 复制代码 
帮我创建一个登录页面

Claude 会自动：

  • 创建 html
  • 创建 css
  • 创建 js

十三、最推荐的新手工作流

这是目前最舒服的玩法。

13.1 模型搭配推荐

任务 推荐模型
规划 Claude
写代码 DeepSeek
中文 GLM
长文本 Gemini

13.2 为什么大家要切换模型

因为：

Claude 很强。

但贵。

DeepSeek 很便宜。

所以很多人：

  • 用 Claude 做规划
  • 用 DeepSeek 执行

CC-Switch 最大价值就在这里。

十四、系统托盘功能

CC-Switch 支持：

右下角托盘切换。

以后甚至不用打开软件。

直接：

  • 右键托盘
  • 选择模型
  • 自动切换

十五、什么是 MCP？

这是进阶功能。

15.1 MCP 是什么

MCP = AI 插件系统。

它能让 AI：

  • 访问数据库
  • 访问浏览器
  • 操作文件
  • 使用 GitHub
  • 联网搜索

15.2 新手要不要学 MCP

建议：

先别学。

先学会：

  • 安装
  • 切模型
  • 使用 Claude Code

再研究 MCP。

十六、什么是 Skills？

Skills 就是：

"AI 的技能包"

比如：

  • 自动生成 React
  • 自动写 Python
  • 自动分析代码

本质是提示词模板。

十七、最容易遇到的问题

17.1 node 不是内部命令

原因：

Node.js 没装好。

解决：

重新安装。

勾选 PATH。

17.2 claude 不是内部命令

原因：

Claude Code 没安装。

重新执行：

bash 复制代码 
npm install -g @anthropic-ai/claude-code

17.3 API Key 无效

原因：

  • Key 复制错误
  • 平台余额不足
  • Key 已删除

17.4 没有响应

原因：

  • 网络问题
  • API 平台崩了
  • 模型不可用

解决：

切换供应商。

17.5 切换模型没生效

解决：

关闭终端。

重新打开。

再运行：

bash 复制代码 
claude

十八、CC-Switch 高级玩法

等你熟练后，可以研究：

  • MCP
  • Skills
  • Prompt 管理
  • 代理
  • 故障转移
  • 多 Provider 轮询
  • 自动测速
  • 请求日志

十九、新手最推荐配置

如果你什么都不懂。

推荐：

方案一（最简单）

  • Claude Code
  • DeepSeek API
  • CC-Switch

这是最适合中国新手的。

方案二（进阶）

  • Claude
  • DeepSeek
  • Gemini
  • GLM

多模型切换。

二十、完整安装顺序（非常重要）

一定按这个顺序：

第一步

安装 Node.js

第二步

安装 Claude Code

第三步

安装 CC-Switch

第四步

申请 API Key

第五步

添加供应商

第六步

点击启用

第七步

运行 claude

二十一、你现在已经学会了什么

如果你已经看到这里。

你其实已经超过很多刚入门的人了。

你已经学会：

  • 什么是 Claude Code
  • 什么是 API
  • 什么是 API Key
  • 什么是模型
  • 什么是 Provider
  • 如何安装 Node.js
  • 如何安装 Claude Code
  • 如何安装 CC-Switch
  • 如何添加模型
  • 如何切换模型
  • 如何开始 AI 编程

二十二、下一步学什么

推荐学习顺序：

第一阶段

  • 学会正常使用 Claude Code
  • 学会切模型
  • 学会基础命令

第二阶段

  • 学 Git
  • 学 Cursor
  • 学 MCP
  • 学 Prompt

第三阶段

  • AI 自动开发
  • Agent
  • 自动化工作流
  • 多智能体

二十三、推荐资源站

官方 GitHub

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

官方文档

https://docs.packyapi.com/docs/ccswitch/

二十四、总结

一句话总结：

CC-Switch = AI 编程工具的"模型切换控制中心"

它最大的价值是：

  • 不用手改配置
  • 不用折腾环境变量
  • 不用重复配置
  • 一键切换 AI 模型

对于新手来说：

它能让复杂的 AI 配置变成：

"点按钮"。

这是为什么现在大量 Claude Code 用户都会安装 CC-Switch。

参考资料

CC-Switch 是用于统一管理 Claude Code、Codex、Gemini CLI 等 AI 工具配置的开源工具。(docs.packyapi.com)

官方文档中说明，CC-Switch 支持供应商切换、MCP 管理、Skills 管理等功能。(github.com)

官方安装文档要求安装 Node.js 18 LTS 或更高版本。(github.com)

hello，这里是 晓雨的笔记本。如果你喜欢我的文章，欢迎三连给我鼓励和支持：👍点赞 📁 关注 💬评论，我会给大家带来更多有用有趣的文章。

原文链接 👉 ，⚡️更新更及时。

欢迎大家点开下面名片，添加好友交流。

相关推荐
有一个好名字3 小时前
CrewAI 入门指南01：从零开始构建多 Agent 协作系统
人工智能
生成论实验室4 小时前
Transformer架构上的语言模型自已评判“判断力缺失”
人工智能·深度学习·语言模型·自然语言处理·transformer
@encryption4 小时前
计算机网络 --- LSA
网络·计算机网络·智能路由器
ฅ ฅBonnie4 小时前
Hermes 与 Cloud Code/OpenClaw 架构对比分析及部署实践
人工智能·ai·架构·ai编程
ZHANG8023ZHEN4 小时前
Diffusion 数学推理
人工智能·python·机器学习
实在智能RPA4 小时前
实在Agent针对金融行业Agent灾备与高可用是如何进行设计的？深度拆解金融级智能体的架构安全与连续性保障
人工智能·安全·ai·金融·架构
sali-tec4 小时前
C# 基于OpenCv的视觉工作流-章78-KRT测量
图像处理·人工智能·数码相机·opencv·算法·计算机视觉
Szime4 小时前
AI服务器电源、充电桩、储能BMS项目，电子元器件BOM配单怎么做更高效？
运维·服务器·人工智能
lulu12165440784 小时前
Claude Code SpringBoot技能体系架构设计与演进
java·人工智能·spring boot·后端·ai编程
不加辣椒4 小时前
第17章 实战项目1：个人知识库助手
人工智能
热门推荐
01GitHub 镜像站点02Codex 接入 DeepSeek API 完整配置文档03【AI】2026 年具身智能模型和世界模型总结04【踩坑记录 | 第一篇】微软商店无法使用时，如何手动安装 OpenAI Codex？附`.msix`文件系统错误解决方法05裂开！ChatGPT 居然开始要手机号验证，附详细解决方法06CC-Switch & Claude 基于 Linux 服务器安装使用指南07Codegraph 实战：用知识图谱让 AI 编程效率翻倍08Codex使用DeepSeek API的方法（cc switch + codex bridge方案）09LLM Wiki：让大模型替你打理知识库的完整指南10给 Claude Code 装上“技能库”和“眼睛”：配置 Skills 与图片识别实战