CC Switch
CC Switch 是一款面向开发者的API配置管理工具,主要用于在不同API服务端点(包括中转站)之间进行令牌和配置参数的切换与导入管理。其核心功能包括支持多API令牌的统一管理、快速切换不同服务配置,以及与代码开发环境的集成对接,旨在简化开发者在多平台或多账户场景下的API接入流程。
核心事实
时间轴 (近 90 天)
Codex 接入 DeepSeek 的过程:在 CC Switch 工具栏选中 Codex,添加 DeepSeek 作为供应商,填入从 DeepSeek 平台获取的 API Key,点击启用即可完成切换。
CC Switch 是一个开源工具,提供 Windows MSI 安装包,可为 Claude Code、Codex 等工具配置第三方 API Key
配置流程包括四步:在 Agnes API 平台创建密钥、在 CC Switch 新增 Cloud Provider 供应商并填入 API Key 和请求地址、获取模型列表并映射到 Agnes 2.0 Flash、开启本地路由和 Claude 路由开关。
模型映射(Model Mapping)是路由工具的核心功能,在路由层建立对照表,将 Claude Code 请求的任意模型名改写为后端实际可用的模型名,从而避免 404 或鉴权失败。
CC Switch 需要开启本地路由并启用 Claude 路由开关,供应商列表中启用 Agnes 后,Claude Code 的请求才会经 CC Switch 转发到 Agnes 免费网关。
在 CC Switch 中配置供应商时,类型选择 Cloud Provider,再选「自定义供应商」,填写 API Key、请求地址和 API 格式后点击「获取模型列表」可验证连接。
CC Switch 的技能存储位置默认在第一个位置,但作者推荐改为统一文件夹 `~/.agents/skills`,并勾选"软链接"同步方式,让不同项目的 Agent 都能调用通用技能库中的技能。
模型映射是 CC Switch 等中转工具的核心功能:由于 Claude Code 等 CLI 内部写死了对 Haiku、Sonnet、Opus 三种模型的调用名称,使用第三方模型时需通过映射将这些名称重定向到实际购买的模型上。
配置模型时必须先在 CC Switch 中应用新模型,再登录 Claude,否则历史配置会残留导致切换失败。
在 CC Switch 中配置国产大模型时,核心逻辑是模型映射:将 Claude 的 Haiku、Sonnet、Opus 分别映射到实际购买的模型,例如将 Haiku 映射到 Kimi 2.7 Code,将 Sonnet 和 Opus 映射到 Kimi 3。
还有 25 条时间轴事件
全部知识事实 (20)
CC Switch本质上是一个反向代理服务器,将Anthropic格式请求转换为OpenAI兼容格式后转发给Ollama
80%已验证ccswitch中Codex与Claude Code的配置是分开的,不共享配置,需要单独为Codex填写API Key
65%已验证CC Switch 按不同工具分别管理配置,Claude Code 中配置的供应商不会自动应用到 Codex
65%待验证CC Switch在本地启动轻量级代理服务器,通过拦截和转换API请求实现模型切换,对插件本身完全无侵入
85%待验证在 CC Switch 配置中勾选相关选项后,Claude Code 的上下文可扩展至 1M(一兆)级别
60%待验证DeepSeek V4 Flash直接适配了Codex,无需CC Switch就能直接接入
60%待验证Codex 接入 DeepSeek 的过程:在 CC Switch 工具栏选中 Codex,添加 DeepSeek 作为供应商,填入从 DeepSeek 平台获取的 API Key,点击启用即可完成切换。
50%待验证CC Switch 是一个开源工具,提供 Windows MSI 安装包,可为 Claude Code、Codex 等工具配置第三方 API Key
50%待验证配置流程包括四步:在 Agnes API 平台创建密钥、在 CC Switch 新增 Cloud Provider 供应商并填入 API Key 和请求地址、获取模型列表并映射到 Agnes 2.0 Flash、开启本地路由和 Claude 路由开关。
50%待验证在 CC Switch 中配置供应商时,类型选择 Cloud Provider,再选「自定义供应商」,填写 API Key、请求地址和 API 格式后点击「获取模型列表」可验证连接。
50%待验证模型映射(Model Mapping)是路由工具的核心功能,在路由层建立对照表,将 Claude Code 请求的任意模型名改写为后端实际可用的模型名,从而避免 404 或鉴权失败。
50%待验证CC Switch 需要开启本地路由并启用 Claude 路由开关,供应商列表中启用 Agnes 后,Claude Code 的请求才会经 CC Switch 转发到 Agnes 免费网关。
50%待验证CC Switch 的技能存储位置默认在第一个位置,但作者推荐改为统一文件夹 `~/.agents/skills`,并勾选"软链接"同步方式,让不同项目的 Agent 都能调用通用技能库中的技能。
50%待验证模型映射是 CC Switch 等中转工具的核心功能:由于 Claude Code 等 CLI 内部写死了对 Haiku、Sonnet、Opus 三种模型的调用名称,使用第三方模型时需通过映射将这些名称重定向到实际购买的模型上。
50%待验证配置模型时必须先在 CC Switch 中应用新模型,再登录 Claude,否则历史配置会残留导致切换失败。
50%待验证CC Switch 的官网为 ccswitch.io,可免费下载,用于管理模型配置,比手动编辑后台配置文件更直观。
50%待验证在 CC Switch 中配置国产大模型时,核心逻辑是模型映射:将 Claude 的 Haiku、Sonnet、Opus 分别映射到实际购买的模型,例如将 Haiku 映射到 Kimi 2.7 Code,将 Sonnet 和 Opus 映射到 Kimi 3。
50%待验证Claude Code 内部按模型档位(Haiku/Sonnet/Opus)路由不同任务,当主模型换成开放权重模型时,需显式指明各档位对应的模型 ID,否则某些后台请求会失败或回落到默认值。
50%待验证使用 CC Switch 配置第三方 API Key 后重新启动 Claude Code,登录步骤会被自动跳过
50%待验证CC Switch 内置了市面主流模型供应商的配置模板,并支持通过自定义配置填入第三方中转站的 API Key、官网链接和请求地址
50%