Files
cc-switch/README_ZH.md
T
Jason e85ade714a chore(presets): swap the FluxA TokenPlan and Shengsuanyun sponsor positions
Move FluxA TokenPlan up to Shengsuanyun's former slot after V-API and
Shengsuanyun down to FluxA's former slot after SubRouter, in the four
README sponsor tables and the seven preset files that carry both.
2026-10-23 17:05:55 +08:00

63 KiB
Raw Blame History

CC Switch

Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes Agent、Pi、MiniMax Code、Kimi Code 的全方位管理工具

一键切换 API 供应商,统一管理 MCP、Skills 与提示词,不用再手改 JSON / TOML / YAML 配置文件。

Version Platform Built with Tauri Downloads

farion1231%2Fcc-switch | Trendshift Star History Rank

🌐 唯一官方网站:ccswitch.io

English | 中文 | 日本語 | Deutsch | 更新日志

下载安装 · 快速开始 · 功能特性 · 常见问题 · 用户手册

❤️赞助商

想出现在这里?

点击折叠

Kimi K2.7 Code

Kimi K3 是 Moonshot AI 迄今能力最强的模型,也是全球首个开源 3T 级模型。K3 拥有 2.8T 参数、原生视觉能力与 100 万 Token 上下文,在长程编码、知识工作和推理任务中展现前沿性能。使用 CC Switch,可以在各类 Agent 工具中便捷配置和切换 Kimi。

主要进行编程工作?可以试试 Kimi Code 订阅(中文站 | Global),或通过 Kimi 开放平台使用 API(中文站 | Global)。

新用户首充福利:通过上方 API 链接注册并完成首次充值,即可获赠充值金额 10% 的 API 额度,最高赠送 ¥1,000。


PackyCode 感谢 PackyCode 赞助了本项目!PackyCode 是一家稳定、高效的API中转服务商,提供 Claude Code、Codex、Gemini 等多种中转服务。PackyCode 为本软件的用户提供了特别优惠,使用此链接注册并在充值时填写"cc-switch"优惠码,首次充值可以享受9折优惠!
APINebula 感谢 APINEBULA 赞助本项目!APINEBULA 是银河录像局旗下的企业级 AI 聚合平台,背靠大平台资源,面向开发者、团队与企业用户提供稳定、高性价比的大模型 API 接入服务。平台聚合 Claude、GPT、Gemini 等主流满血模型,一个接口,接入全球顶尖 AI 大模型,各大模型价格低至 1 折起,支持企业级高并发、正式合同、对公打款与开票服务,适合 AI 编程、Agent 开发、业务系统集成等多种场景!使用此链接注册并在充值时填写 "ccswitch" 优惠码可享九折优惠!
AICodeMirror 感谢 AICodeMirror 赞助了本项目!AICodeMirror 提供 Claude Code / Codex / Gemini CLI 官方高稳定中转服务,支持企业级高并发、极速开票、7×24 专属技术支持。 Claude Code / Codex / Gemini 官方渠道低至 3.8 / 0.2 / 0.9 折,充值更有折上折!AICodeMirror 为 CCSwitch 的用户提供了特别福利,通过此链接注册的用户,可享受首充8折,企业客户最高可享 7.5 折!
PatewayAI 感谢 PatewayAI 赞助了本项目!PatewayAI 是一家面向重度 AI 开发者、专注官方直连高品质模型 API 中转服务商。提供 Claude 全系列与 Codex 系列模型,100% 官方源直供,不掺假不注水,欢迎检验。计费透明,Token 级账单可逐笔核验。 同时支持企业级高并发,并为企业客户提供了专业的管理平台,企业客户可签订正式合同并开具发票,更多详情进入官网获取联系方式。 现在通过此链接注册即送 $3 试用额度,用户充值低至 6 折,邀请好友双向赠送,邀请奖励可达 $150!
hao.ai 感谢 hao.ai 赞助了本项目!hao.ai 是面向开发者与团队的高速、稳定大模型统一 API 网关。通过一个 API Key 和统一接口,即可接入 GPT、Claude、xAI Grok 等主流模型,兼容 OpenAI、Anthropic 等常用协议与 SDK。平台提供模型路由、故障回退、团队管理及完整调用日志,模型价格低至官方参考价的 1.5 折,帮助用户更简单、更稳定、更低成本地构建 AI 应用。hao.ai 为 CC Switch 用户提供了特别福利,通过此链接注册的用户,首单可享受 5% 赠送额度!
Fenno.ai 感谢 Fenno.ai 赞助了本项目!Fenno.ai 是一家稳定、高效的 API 中转服务商,目前主要提供 Codex 中转服务,兼容 OpenAI 及 Anthropic 协议,可灵活接入 Codex、Claude Code、OpenCode 等主流编程工具,可稳定支撑千亿 Token/日的企业级调用需求,支持国内及海外主体公对公结算、开票。Fenno.ai 为 CC Switch 的用户提供了专属福利:通过此链接即可订阅 1.99 刀/50 刀额度的 Trial 计划(有效期 7 天),邀请好友最高可享 20% 奖励,多邀多得!
RunAPI 感谢 RunAPI 赞助本项目!RunAPI 是高效稳定的 AI 模型 API 中转平台,一个 API Key 即可访问 OpenAI、Claude、Gemini、DeepSeek、Grok 等 150+ 主流模型,低至 1 折,极其稳定,可以无缝兼容 Claude Code、OpenClaw 等工具。RunAPI为CC switch的用户提供了特别福利,使用此链接注册并首次充值即可享受10%的优惠折扣!
OpenModel 感谢 OpenModel 赞助本项目!OpenModel 为 Codex 和 Claude Code 提供客户端专属折扣,所支持的模型通过 Codex 调用最高优惠 90%、通过 Claude Code 调用最高优惠 60%,帮助开发者在不改变工作方式的前提下降低 API 成本。只需填入 OpenModel API Key,像往常一样继续使用 Codex 或 Claude Code,系统会自动识别所支持的客户端并应用折扣路由,无需额外参数或手动路由。你还可以为每个 API Key 单独设置回退策略:折扣路由暂时不可用时,选择按标准价格继续调用或直接停止。CC Switch 用户通过此链接注册,并使用优惠码 "cc-switch",即可享受首次充值九折优惠!
EveryAPI 感谢 EveryAPI 赞助了本项目!EveryAPI 致力于为开发者提供稳定、高效、高性价比的 API 中转服务,支持 Claude、Codex、Gemini 等主流 AI 编程工具及多种先进模型。无需复杂配置,轻松接入,助力开发者高效编程、快速构建 AI 应用。无论是日常开发、项目调试还是 AI 辅助编程,EveryAPI 都能为你提供便捷、流畅的使用体验。EveryAPI,让 AI 开发更简单,让每一次调用都更有价值!EveryAPI 为 CC Switch 的用户提供了特别福利,通过此链接注册即送 14 元,首充使用折扣码 ccswitch 享 20% 优惠,GPT 低至 1.5 折!
GrooRoute Pro 感谢 GrooRoute Pro 赞助了本项目!GrooRoute Pro 是可靠流畅的 AI API 中转服务平台,接入 OpenAI、Claude、DeepSeek 等多款主流大模型。平台采用海外服务器部署,支持倍率档位自选,兼具按量计费与订阅套餐两种方案,多种使用方式灵活可选,线路稳定、响应迅速,让使用者可以更轻松便捷地调用各类 AI 能力。GrooRoute Pro 为 CC Switch 用户准备了专属福利,点击此链接注册即可获得免费 5 元体验额度!
DIT.ai 感谢 DIT.ai 赞助了本项目!DIT.ai 是一个 AI Token 交易市场,通过多供应商路由降低调用成本。开发者只需一个 OpenAI 兼容 API,即可调用 GPT、Claude、Gemini、DeepSeek、Grok、Llama 等 50 多个主流 AI 模型,覆盖文本、图像、视频和音频。合格供应商在 160 多条线路上为每个请求竞价,DIT 实时选出性价比最优的线路,价格通常比官方定价低 30–70%。DIT.ai 面向开发者、初创公司以及规模化运行 Agent 或 AI 产品的团队:只需更换 Base URL 和 API Key,保留现有技术栈,即可享受自动路由与故障转移。CC Switch 用户通过此链接注册并使用优惠码 ccswitch,即可领取 5 美元新人券!
BuyToken 感谢 BuyToken 赞助了本项目!BuyToken 提供 Claude Code / Codex / DeepSeek 等各类中转服务,支持企业级并发、可极速开票,做的就是稳定长久站。本站也为 CC Switch 的用户提供了特别优惠,使用此链接注册,可得 3 元体验额度,并且通过本站充值的用户,首充 9 折!
V-API 感谢 V-API 赞助了本项目!V-API 三年老品牌,致力于为个人、开发者和企业提供稳定、快速、安全的高品质的大语言模型 API 服务平台,支持合同签约、正规开票(普票 / 专票)。V-API 为 CC Switch 的用户提供了特别优惠,使用此链接注册的用户,可享受首单减 2 元和 9 折优惠!
FluxA TokenPlan 感谢 FluxA & Baidu AI Cloud 赞助了本项目! FluxA 与百度智能云联合推出 AgenticPlan,为 AI Agent 提供自主购买/管理/使用模型、API、工具的能力。内含百度千帆 TokenPlan,低至6折,可使用 DeepSeek V4、GLM 5.2、Kimi 等旗舰模型,并获赠 FluxA AgentMarket API的调用额度,解锁搜索、数据抓取、社交媒体、金融、加密、生图、视频等 13000+ 付费 API。
在用户授权下,AI Agent 还可借助官方的Visa卡支付自主采购资源、管理 API Key、监控用量并规划续费,帮助 Agent 从「自主完成任务」升级为真正能够「自主规划预算,完成任务」。通过此链接购买!
AIGoCode 感谢 AIGoCode 赞助了本项目!AIGoCode 是一个集成了 Claude Code、Codex 以及 Gemini 最新模型的一站式平台,为你提供稳定、高效且高性价比的AI编程服务。本站提供灵活的订阅计划,零封号风险,国内直连,无需魔法,极速响应。AIGoCode 为 CC Switch 的用户提供了特别福利,通过此链接注册的用户首次充值可以获得额外10%奖励额度!
AICoding 感谢 AICoding 赞助了本项目!AICoding —— 全球大模型 API 超值中转服务!Claude Code 1.9 折,GPT 0.1 折,已为数百家企业提供高性价比 AI 服务。支持 Claude Code、GPT、Gemini 及国内主流模型,企业级高并发、极速开票、7×24 专属技术支持,通过此链接 注册的 CC Switch 用户,首充可享受九折优惠!
SubRouter 感谢 SubRouter 赞助本项目!SubRouter 是面向 AI 服务经营者的公开市场与智能路由平台。商家可快速开通独立经营站,发布套餐、管理用户与模型价格;用户可在市场发现服务,并通过统一 API 获得稳定高效的模型调用。通过此链接注册!
Shengsuanyun 感谢胜算云赞助了本项目!胜算云是专为AI Native Teams服务的超级工厂,工业级AI任务并行执行平台,模型商城集采直供聚合接入了Claude、Chatgpt、Gemini等海内外LLM及图片视频多媒体模型算力,绝无逆向掺水、全站模型SLA可用性高达99.7%、监测接口日常全绿。更有企业级专属定制网关,实现团队精细化成本与权限管控,智能路由+安全防护+BYOK企业自带密钥托管。平台按量及tokens plan(即将上线)计费,可开票,使用此链接注册新用户可获10元模力及首充10%赠送。
88API 感谢 88API Token聚合平台赞助了本项目!88API 是一家由香港企业运营并且主要面向开发者、创作者与 AI 应用用户的一站式多模型 API 平台,通过统一接口接入文本、图片、语音和视频模型,覆盖 AI 编程、智能翻译、内容创作、配音、图像生成、视频生成等常见工作流。可以直接在 CC Switch 中完成 Provider 添加并切换,支持国际主流付款方式,可提供发票,提供企业级稳定服务。通过此链接注册可以获取专属赠送额度!
APIKEY.FUN 感谢 APIKEY.FUN 赞助本项目!APIKEY.FUN 是一家专业的企业级 AI 中转站,致力于为企业和个人开发者提供稳定、高效、低成本的 AI 模型 API 接入服务。平台支持 Claude、OpenAI、Gemini 等主流热门模型,价格低至官方原价的 7%。通过本项目专属链接注册,还可享受最高 充值永久 95 折 专属优惠。
9527CODE 感谢 9527CODE 赞助本项目!9527 CODE 是专注于稳定性与服务质量的企业级满血 AI 中转平台,为 Claude Code、Codex 等主流 AI 模型提供高速、稳定、高质量的中转服务。更重视长期稳定、线路质量与持续可用性。面向企业及高强度 AI 用户,提供稳定、高效的一站式模型接入方案。持续运营一年,服务稳定性达 99.9%,提供 7×24 小时人工技术支持。通过本项目专属链接注册,新人福利联系客服赠送体验额度,拉新返现无上限!
TeamoRouter 感谢 TeamoRouter 赞助本项目!TeamoRouter 是一款面向开发者、AI 团队和企业的企业级 Agentic LLM 网关。无需任何订阅,你就可以通过一个统一 API 访问 Claude Code、Codex、Gemini CLI、OpenAI Codex 以及其他热门 AI Agent,同时享受最高可达 90% 折扣的 API 价格。 不同于常见的 API 中转服务,TeamoRouter 聚合了数百家官方模型提供商和可信基础设施合作伙伴,包括 OpenAI、Anthropic、Vertex、Azure 和 AWS Bedrock。每个提供商都经过验证,确保 100% 兼容 Agent 协议,并具备可靠的缓存性能和请求可追踪性,从而提供稳定质量,而不是反向工程或缩水后的接口。平台提供接近官方水平的 TTFT、99.6% SLA、最高 5,000 QPM 的企业级吞吐量,以及行业领先的缓存命中率,可大幅降低长时间运行的 Agent 工作流中的 token 成本。 TeamoRouter 还提供企业级功能,包括集中账单、团队管理、BYOK、智能路由、用量分析、动态提供商优化和专属支持。为了获得更简单的使用体验,Teamo Desktop 支持你一键使用 Claude Code、Codex、Gemini CLI 和其他热门 AI Agent,无需管理 API Key,也无需手动配置网关。新用户通过此链接注册,首次充值可享受 10% 折扣。
PPIO 感谢 PPIO 赞助了本项目!PPIO 是国内领先的独立 Agentic Cloud 服务商,由 PPTV 创始人姚欣和前 PPTV 首席架构师王闻宇于 2018 年联合创立。PPIO 支持一个 API key 调用 DeepSeek-V4-Flash、Kimi-K3、GLM-5.2、MiniMax-M3 等所有旗舰开源模型;企业 Token Plan 最低 6 折接入,支持 200 席位;Fusion 融合模型以 1/10 的价格比肩 Fable5。通过此链接注册并完成实名认证,即可获得 ¥10 元代金券,邀请好友充值还可获得最高 15% 充值返利。
new-api 感谢开源 AI 基础设施项目 new-api 对本项目的鼎力支持!new-api 是由 QuantumNous(锟腾科技)推出的开源 AI 基础设施项目,也是活跃度与使用规模领先的大模型统一接入与分发项目之一,专注于帮助开发者、团队和企业以更低成本构建可管理、可扩展的 AI 服务平台。作为同样扎根开源生态的项目,new-api 希望通过赞助支持更多优秀开源项目持续发展。🌟 欢迎 Star 支持 new-api:https://github.com/QuantumNous/new-api,官网:https://www.newapi.ai/。
ClaudeCN 感谢 ClaudeCN 赞助本项目!ClaudeCN 由是一家实体企业运营的企业级AI中转平台。平台可提供高可用性的商用API服务,提供Claude、GPT、Deepseek等热门模型,支持企业采购流程,可对公打款、签约,服务合规有保障。点击此链接注册!
HuoShan 感谢火山方舟 Agent Plan 模型赞助了本项目!方舟 Agent Plan 模型订阅套餐集成了包含 Doubao-Seed、Doubao-Seedance、Doubao-Seedream 等在内的字节跳动自研 SOTA 级模型,覆盖文本、代码、图像、视频等多模态任务。最新支持 MiniMax-M3、DeepSeek-V4 系列、GLM-5.1、Doubao-Seed-2.0 系列、Kimi-K2.6 等模型,工具不限。超全模态模型与 Harness 升级一步到位,深度支持 Agent 框架与 AI 编程工具。一次订阅,可以为不同任务切换合适的 AI 引擎。方舟 Coding Plan 为 CC Switch 的用户提供了专属福利:通过此链接订阅方舟 Coding Plan,新客户首两个月享 2.5 折优惠,再用专属邀请码 6J6FV5N2 领取奖励叠加 9.5 折,低至 9.4 元/月!>>For developers outside Mainland China, please click here
SiliconFlow 感谢硅基流动赞助了本项目!硅基流动是一个高性能 AI 基础设施与模型 API 平台,一站式提供语言、语音、图像、视频等多模态模型的快速、可靠访问。平台支持按量计费、丰富的多模态模型选择、高速推理和企业级稳定性,帮助开发者和团队更高效地构建和扩展 AI 应用。通过此链接注册并完成实名认证,即可获得 ¥16 奖励金,可在平台内跨模型使用。硅基流动现已兼容 OpenClaw,用户可接入硅基流动 API Key 免费调用主流 AI 模型。
A6API 感谢 A6API 赞助本项目!A6API 是一站式 AI 模型 API 聚合平台,覆盖 Claude、GPT、Gemini、Codex 等主流模型,支持多商家入驻供货,同一个模型可由多个上游商家竞争报价。平台通过智能路由自动优选更稳定、更低价的可用线路,并支持失败自动切换,帮助用户减少请求失败、降低调用成本、提升使用稳定性。无论你是开发者、AI 产品团队还是工作室,都可以通过统一接口快速接入,兼容所有格式,迁移成本低,使用更省心。新用户通过 此链接 注册即可获得免费体验额度,先试再用,低价开用。
优云智算 感谢优云智算赞助了本项目!优云智算是UCloud旗下AI云平台,提供稳定、全面的国内外模型API,仅一个key即可调用。主打包月、按次的高性价比 国模Coding Plan套餐,同时提供官转稳定海外模型。支持接入 Claude Code、Codex 及 API 调用。支持企业高并发、7*24技术支持、自助开票。通过此链接注册的用户,可得免费5元平台体验金!
CCSub 感谢 CCSub 赞助本项目!CCSub 是稳定、实惠的 AI API 中转平台,是 Claude Code 官方订阅的超强平替。一个 API Key 即可调用 Claude Opus 4.8、Sonnet 4.6、Haiku 4.5、GPT-5、Gemini、DeepSeek 全系列模型,价格约为官方直连的 1/3,全球直连无需梯子。兼容 Claude Code、Codex、Cursor、Cline、Continue、Windsurf 等所有主流 AI 编程工具。通过此链接注册即送 $5 体验额度!
SSSAiCode 感谢 SSSAiCode 赞助了本项目!SSSAiCode 是一家稳定可靠的API中转站,致力于提供稳定、可靠、平价的Claude、CodeX模型服务,支持当日快速开票,SSSAiCode为本软件的用户提供特别优惠,使用此链接注册每次充值均可享受10$的额外奖励!
SoleAPI 感谢 SoleAPI 对本项目的支持!SoleAPI 是一个面向开发者与企业的 AI 模型网关,一个 API Key 直达 Claude、GPT、Gemini 等 30+ 主流模型。原生兼容 OpenAI 与 Anthropic 协议,只需替换 Base URL 即可无缝接入 Claude Code、Codex、Cursor 等编码工具与现有 SDK。平台基于延迟与健康度实时智能选路,上游异常毫秒级自动切换备用渠道,服务可用性 99.99%,并提供 7×24 小时技术支持;所有调用一张账单,逐请求的 Token 与费用透明可查。通过本项目专属链接注册即送体验额度,邀请好友充值可持续获得返现奖励!
Micu 感谢 米醋API 赞助了本项目!米醋API 是一家致力于提供极致性价比与高稳定性的全球大模型中转服务商。米醋API 背后有实体企业做核心保障,杜绝跑路风险,支持极速正规开票!我们主打“试错零成本”:1 元起充低门槛,0 手续费随时退款!米醋API 为本软件的用户提供了特别优惠,使用此链接注册并在充值时填写"ccswitch"优惠码可享九折优惠!
RightCode 感谢 Right Code 赞助了本项目!Right Code 稳定提供 Claude Code、Codex、Gemini 等模型的中转服务,并可选按量、包月两种计费模式。充值即可开票,企业、团队用户一对一对接。同时为 CC Switch 的用户提供了特别优惠:通过此链接注册,每次充值均可获得实付金额5%的按量额度!
Cubence 感谢 Cubence 赞助本项目!Cubence 是一家可靠高效的 API 中继服务提供商,提供对 Claude Code、Codex、Gemini 等模型的中继服务,并提供按量、包月等灵活的计费方式。Cubence 为 CC Switch 的用户提供了特别优惠:使用 此链接 注册,并在充值时输入 "CCSWITCH" 优惠码,每次充值均可享受九折优惠!
Crazyrouter 感谢 Crazyrouter 赞助了本项目!Crazyrouter 是一个高性能 AI API 聚合平台——一个 API Key 即可访问 300+ 模型,包括 Claude Code、Codex、Gemini CLI 等。全部模型低至官方定价的 55%,支持自动故障转移、智能路由和无限并发。Crazyrouter 为 CC Switch 用户提供了专属优惠:通过此链接注册后联系客服即可领取 $2 免费额度,首次充值时输入优惠码 `CCSWITCH` 还可获得额外 30% 奖励额度!
DMXAPI 感谢 DMXAPI(大模型API)赞助了本项目! DMXAPI,一个Key用全球大模型。 为200多家企业用户提供全球大模型API服务。· 充值即开票 ·当天开票 ·并发不限制 ·1元起充 · 7x24 在线技术辅导,GPT/Claude/Gemini全部6.8折,国内模型5~8折,Claude Code 专属模型3.4折进行中!点击这里注册

为什么选择 CC Switch?

Claude Code、Codex、Gemini CLI 等 AI 编程工具各有各的配置格式。换一个 API 供应商,就得手动改 JSON、TOML、YAML 或 .env 文件;MCP、Skills 和提示词也要在每个工具里分别维护。

CC Switch 把这些工作集中到一个桌面应用里:选一个预设、填入 Key,一键即可切换。切换时只替换地址、Key、模型这几项连接信息,你自己加的插件、Hook、MCP 和注释都原样保留。

  • 一个应用,十一个工具 — Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi、MiniMax Code、Kimi Code
  • 告别手动编辑 — 90+ 供应商预设,包括 AWS Bedrock、NVIDIA NIM 和社区中转服务
  • 直连、路由、聚合,按需选择 — 直连是工具直接连供应商;路由经本机转发,能转换接口格式、自动故障转移,让 Claude Code 用 GPT、Codex 用 Claude;聚合把多家供应商的模型放进 Claude Code 或 Codex 的同一个模型列表,选哪个模型,请求就发给哪一家
  • MCP、Skills 与提示词集中管理 — MCP 和 Skills 添加一次,按工具勾选同步;提示词按工具分别维护
  • 会话读得懂 — 把各工具的会话记录整理成阅读页:每一轮做了什么、改了哪些文件、哪一步失败了,一目了然
  • 用量与额度一目了然 — 不开本地路由也能统计 Token 用量和花费;供应商卡片和托盘上直接显示订阅额度剩余量与账户余额
  • 跨平台 — 基于 Tauri 2 构建的原生桌面应用,支持 Windows、macOS 和 Linux

界面预览

主界面:侧边栏、直连 / 路由 / 聚合标签和供应商卡片
主界面
应用页:集中管理各个 AI 编程工具的版本、安装与升级
应用页
聚合模式:一家默认供应商,另外添加了多家
聚合模式
Codex 的模型选择器里同时列出多家供应商的模型
Codex 里的聚合模型列表
会话阅读页:执行过程摘要、工具调用详情和对话目录
会话阅读页
用量统计:热力图与请求日志
用量统计

下载安装

系统要求

  • Windows:Windows 10 及以上
  • macOS:macOS 12 (Monterey) 及以上
  • Linux:x86_64 或 ARM64,需要 glibc 2.35+ 和 WebKitGTK 4.1,例如 Ubuntu 22.04+、Debian 12+ 及较新的 Fedora;RHEL / Rocky / Alma 8–9 暂不支持

Windows 用户

从 Releases 页面下载最新版本的 CC-Switch-v{版本号}-Windows.msi 安装包或 CC-Switch-v{版本号}-Windows-Portable.zip 绿色版。ARM 版 Windows 请下载 CC-Switch-v{版本号}-Windows-arm64.msi 或 CC-Switch-v{版本号}-Windows-arm64-Portable.zip。

macOS 用户

方式一:通过 Homebrew 安装(推荐)

brew install --cask cc-switch

更新:

brew upgrade --cask cc-switch

方式二:手动下载

从 Releases 页面下载 CC-Switch-v{版本号}-macOS.dmg(推荐)或 .zip。这是 Universal 通用包,Apple Silicon 和 Intel Mac 均可原生运行。

注意:CC Switch macOS 版本已通过 Apple 代码签名和公证,可直接安装打开。

Arch Linux 用户

通过 paru 安装(推荐)

paru -S cc-switch-bin

Linux 用户

从 Releases 页面下载最新版本的 Linux 安装包:

  • CC-Switch-v{版本号}-Linux-x86_64.deb / -Linux-arm64.deb(Debian/Ubuntu)
  • CC-Switch-v{版本号}-Linux-x86_64.rpm / -Linux-arm64.rpm(Fedora 等提供 WebKitGTK 4.1 的 RPM 发行版)
  • CC-Switch-v{版本号}-Linux-x86_64.AppImage / -Linux-arm64.AppImage(满足上述系统要求的发行版)

Flatpak:官方 Release 不包含 Flatpak 包。如需使用,可从 .deb 自行构建 — 参见 flatpak/README.md。

快速开始

基本使用

  1. 添加供应商:在侧栏选中要管理的工具,点击页面右上角的“+”(添加供应商)→ 选择预设或创建自定义配置
  2. 切换供应商:
    • 主界面:选择供应商 → 点击“启用”(OpenCode、OpenClaw、Hermes、MiniMax Code、Kimi Code 的按钮为“添加”,Pi 为“启用 / 移除”;这六个是共存式工具,可以同时添加多个供应商)
    • 系统托盘:每个工具一行,显示“名称 · 模式 · 供应商 · 额度”,在子菜单里直接点击供应商名称(支持 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build)
  3. 生效方式:Claude Code 无需重启;Codex、Gemini CLI、Grok Build 需重启终端或对应的 CLI 工具;Claude Desktop 需重启应用本身(详见常见问题)
  4. 恢复官方登录:切换到列表中自带的官方供应商(如“Claude Official”),重启工具后按照其登录/OAuth 流程操作
  5. 路由与聚合(可选):Claude Code、Codex、Gemini CLI、Grok Build 的页面顶部有「直连 / 路由」标签,Claude Code 和 Codex 还有「聚合」。点标签只是切换查看的内容,不会改动配置;真正切换要点页面上的“开始路由”或“切换到聚合模式”,回到直连点“回到直连”。想在 Claude Code 里使用 OpenAI 或 Gemini 格式的供应商,或在 Codex 里使用 Claude,用路由;想在同一个模型列表里混用多家供应商的模型,用聚合
  6. 管理工具:侧栏的「应用」页集中显示每个 AI 编程工具的版本、安装位置和来源,可以安装、升级或全部升级,也可以选择哪些工具显示在侧栏

MCP、提示词、Skills、项目与会话

  • MCP:点击侧栏的“MCP” → 通过模板或自定义配置添加服务器(或“导入已有”)→ 切换各工具的同步开关
  • 提示词:点击侧栏的“提示词” → 使用 Markdown 编辑器创建提示词 → 启用后写入该工具的提示词文件
  • Skills:点击侧栏的“Skills” →“发现技能” → 搜索 skills.sh 或浏览 GitHub 仓库 → 一键安装到支持的工具
  • 项目:先在「设置 → 通用」里打开“显示项目切换”,然后在 Claude Code、Claude Desktop 或 Codex 页面,打开顶部的项目切换器 →“新建项目”,把当前配置保存下来,之后从切换器里选择即可整套切换
  • 会话:点击侧栏的“会话” → 浏览、搜索会话历史,打开阅读页,或恢复各工具的会话
  • 授权中心:点击侧栏的“授权中心”,登录 GitHub Copilot、ChatGPT、xAI(Grok)、Kimi Code 账号,把订阅当作供应商使用。Kimi Code 支持同时保存多个官方账号,每个账号使用独立凭据和原生供应商,首个登录沿用 Kimi 原生默认凭据槽位,在此添加、重新登录和退出账号。仍在原生配置中的 Kimi 官方 OAuth 节点在供应商页受到保护;原生节点被移除后,可以删除留下的档案。

注意:首次启动时,CC Switch 会自动把 Claude Code、Codex、Gemini CLI、Grok Build 的现有配置导入为名为 default 的供应商,并为这几个工具和 Claude Desktop 添加官方供应商,原有配置不会丢失。

各项功能的详细用法请查阅 用户手册,涵盖供应商管理、MCP/提示词/Skills、本地路由与故障转移等全部功能。

功能特性

完整更新日志 | v4.0 发布说明

各工具支持的功能

工具 供应商 本地路由 聚合 托盘切换 MCP Skills 提示词 会话 用量统计
Claude Code 切换 ✓ ✓ ✓ ✓ ✓ CLAUDE.md ✓ ✓
Claude Desktop 切换 模型映射时 – ✓ – – – – 模型映射时
Codex 切换 ✓ ✓ ✓ ✓ ✓ AGENTS.md ✓ ✓
Gemini CLI 切换 ✓ – ✓ ✓ ✓ GEMINI.md ✓ ✓
Grok Build 切换 ✓ – ✓ ✓ ✓ AGENTS.md ✓ ✓
OpenCode 共存 – – – ✓ ✓ AGENTS.md ✓ ✓
OpenClaw 共存 – – – – – 工作区编辑器 ✓ –
Hermes 共存 – – – ✓ ✓ 记忆管理 ✓ –
Pi 共存 – – – ✓ ✓ AGENTS.md、SYSTEM.md、提示词模板 ✓ ✓
MiniMax Code 共存 – – – ✓ ✓ AGENTS.md ✓ ✓
Kimi Code 共存 – – – ✓ ✓ AGENTS.md ✓ ✓
  • 切换:同一时间只启用一个供应商;共存:多个供应商同时写入工具自身的配置,在工具里选择使用。
  • 本地路由:由 CC Switch 在本机转发请求并转换接口格式,见下方本地路由与故障转移。Claude Desktop 的供应商可选“直连”或“模型映射”,选“模型映射”时经本地路由转发。
  • 聚合:把多家供应商的模型放进同一个模型列表,按所选模型分发请求,见下方聚合模式。
  • 会话:浏览、搜索会话历史,打开阅读页,复制恢复命令继续对话(OpenClaw、Hermes 的会话暂不支持恢复)。Hermes 只显示最近 500 个会话。
  • 用量统计:不开本地路由时,从各工具的本地会话记录统计;经本地路由的请求也会计入。
  • 在 Claude Desktop 页面打开的 MCP、Skills、提示词和会话面板,作用于 Claude Code。

供应商管理

  • 90+ 供应商预设 — 选择预设、填入 Key 即可添加,也可以创建自定义配置。添加面板支持按中文名和域名搜索,同一家的不同套餐和地区合并成一行
  • 只改关键字段 — 切换时只替换请求地址、Key、模型等连接信息,插件、Hook、MCP、你自己加的设置和注释都原样保留;编辑器底部显示切换后配置文件的样子,CC Switch 第一次改写配置文件前会自动备份原文件
  • 项目 — 把 Claude Code 或 Codex 当前的供应商、MCP、Skills 和提示词文件保存为一个项目(Claude Desktop 只保存供应商),之后在页面顶部的项目切换器或托盘里一键整套切换;切到其他项目时,当前状态会自动存回原项目。项目切换器默认隐藏,在「设置 → 通用」里打开“显示项目切换”
  • 授权中心(Beta) — 在侧栏的「授权中心」里登录多个 GitHub Copilot、ChatGPT、xAI(Grok)账号,把订阅当作供应商用在 Claude Code、Claude Desktop 和 Codex 中(除 Codex 的 OpenAI Official 外,都需要在路由模式下使用)。在官方客户端以外使用订阅可能违反厂商的服务条款,请自行评估风险
  • Claude Desktop 接入第三方 — 可以直连 Anthropic 兼容端点;非 Claude 模型选“模型映射”,经本地路由把 Sonnet、Opus、Haiku 等档位映射到供应商的实际模型
  • 通用供应商 — 一份配置同步到 Claude Code、Codex 和 Gemini CLI
  • 一键切换、系统托盘快速切换(Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build)、拖拽排序、导入导出

本地路由与故障转移

  • 接口格式转换 — 本地路由在 Anthropic Messages、OpenAI Chat Completions、OpenAI Responses 和 Gemini Native 之间转换请求格式:Claude Code 和 Claude Desktop 可以使用 OpenAI 或 Gemini 格式的供应商,Codex 和 Grok Build 可以使用 Chat Completions 或 Anthropic Messages 格式的供应商
  • 按工具开启 — Claude Code、Codex、Gemini CLI、Grok Build 可以分别进入路由模式:在页面顶部的「路由」标签里点“开始路由”。路由模式下,切换供应商会立即作用于后续请求(如果切换改变了模型,Codex、Gemini CLI 和 Grok Build 仍可能需要重启)。退出 CC Switch 时会先写回直连配置,下次启动再接上
  • 自动故障转移 — 为每个工具配置故障转移队列,请求失败时按队列顺序自动改用下一个供应商,配合熔断器和供应商健康监控
  • 整流器 — 自动修正部分上游不兼容的请求(如 Thinking 签名、不支持图片时降级)
  • 官方供应商(如 Claude Official)不能走本地路由(Codex 的 OpenAI Official 除外)
  • 路由服务的状态、监听地址和故障转移参数集中在「设置 → 本地路由」
  • 使用攻略:在 Claude Code 中使用 GPT · 在 Codex 中使用 Claude

聚合模式

  • 一个模型列表,多家供应商 — 在 Claude Code 或 Codex 的页面切到「聚合」,添加几家供应商,它们的模型会同时出现在客户端的模型选择器里;选哪个模型,请求就发给哪一家,不用回到 CC Switch 切换
  • 随时添加和移除 — 在供应商卡片上点“添加”或“移除”,再选一家作为默认供应商,没有指定聚合模型的请求都交给它;Codex 的 OpenAI Official 只能作为默认供应商;聚合模式暂不支持 Claude 官方订阅
  • 注意 — 聚合不提供故障转移;Claude Code 需要 2.1.243 或更新版本;Codex 的聚合列表变化后需要重启,Claude Code 不需要。同一会话里换模型后,新模型要重新建立提示词缓存,第一轮费用会高一些
  • 聚合模式的许多设计参考了 opencodex,感谢作者和贡献者
  • 使用攻略:聚合模式图文指南 · 聚合模式手册

MCP、提示词与 Skills

  • 统一 MCP 面板 — 一处管理所有 MCP 服务器,按工具勾选同步(Claude Code、Codex、Gemini CLI、Grok Build、OpenCode、Hermes、Pi、MiniMax Code、Kimi Code),支持从各工具导入现有配置,支持 Deep Link 导入
  • 提示词 — 按工具分别管理的提示词库,使用 Markdown 编辑器;启用后写入该工具的提示词文件(CLAUDE.md / AGENTS.md / GEMINI.md),启用前会先把文件里原有的内容存回提示词库,不会丢失。Pi 还可以编辑 SYSTEM.md、APPEND_SYSTEM.md 和提示词模板
  • Skills — 搜索 skills.sh,或从 GitHub 仓库、ZIP 文件一键安装;检查更新并一键全部更新;同步到各工具的方式可选自动、只用软链接或只用复制,存储位置可选 ~/.agents/skills
  • 三个面板都支持搜索,MCP 和 Skills 还可以按工具一键全部启用或停用;供应商、MCP 和提示词都在内容区整页编辑,有未保存的修改时离开会先提醒

用量与成本追踪

  • 用量仪表盘 — 不开本地路由也能统计:默认自动扫描各工具的本地会话记录,按供应商和模型统计请求数、Token、缓存命中率、输出速度和花费,提供趋势图、全年热力图和逐条请求日志
  • 额度与余额 — 供应商卡片和托盘上直接显示剩余量和重置倒计时,比如“5 小时剩余 94%”:官方订阅额度(Claude、ChatGPT、Gemini、SuperGrok)、Coding Plan 的 5 小时 / 周 / 月额度(Kimi、智谱 GLM、MiniMax、火山方舟等)和账户余额(DeepSeek、OpenRouter、硅基流动等),部分需要先在供应商卡片的“配置用量查询”里开启;其他供应商可以写自定义用量脚本。ChatGPT 订阅还会显示剩余重置次数和 Codex Credits 余额
  • 自定义定价 — 按模型设置单价,可以从 models.dev 导入

会话管理器与工作区

  • 会话阅读页 — 把各工具的会话记录解析成结构化内容:正文、思考、工具调用、工具结果和图片分开呈现;每一轮工作折叠成一行摘要(多少步、改了几个文件、几处失败),失败步骤标红;右侧是对话目录,支持会话内查找、导出 Markdown、复制单轮或整段对话
  • 列表与恢复 — 按项目或时间分组,搜索标题、目录、消息或会话 ID,支持批量删除;复制恢复命令继续对话,macOS 上可以一键在终端中恢复
  • 工作区编辑器(OpenClaw)— 编辑 Agent 文件(AGENTS.md、SOUL.md 等)和每日记忆
  • 记忆管理(Hermes)— 编辑 Hermes 的 MEMORY.md 和 USER.md

系统与平台

  • 云同步 — 通过 WebDAV(坚果云、Nextcloud、群晖 NAS 等)或 S3 兼容存储(AWS S3、Cloudflare R2、阿里云 OSS、腾讯云 COS 等)在多台设备之间同步;也可以把 CC Switch 配置目录放到 Dropbox、OneDrive、iCloud 等网盘文件夹中
  • CLI 工具管理 — 在侧栏的「应用」页查看 Claude Code、Codex 等命令行工具的当前版本和最新版本,一键安装、升级或全部升级,并诊断重复安装;Windows 上还能管理 WSL 里的工具(见常见问题)
  • Deep Link(ccswitch://)— 通过链接一键导入供应商、MCP 服务器和提示词,或添加技能仓库。用 在线生成器 生成链接;站长想在网站上放导入按钮,见 站长接入指南
  • 小工具 — 跳过 Claude Code 初次安装确认、隐藏 AI 署名、让 VS Code 的 Claude Code 插件随本软件切换供应商等
  • 深色 / 浅色 / 跟随系统主题、开机自启、自动更新、原子写入、自动备份(「设置 → 数据」里可以看到所有备份的位置和占用空间)、国际化(简中/繁中/英/日,另有社区翻译的土耳其语)

常见问题

CC Switch 支持哪些 AI 工具?

CC Switch 支持十一个工具:Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi、MiniMax Code、Kimi Code。每个工具都有专属的供应商预设和配置管理,各自支持哪些功能见各工具支持的功能。

切换供应商后需要重启终端吗?

视工具而定:

  • Claude Code:支持供应商数据的热切换,无需重启。
  • Codex、Gemini CLI、Grok Build:需要重启终端或 CLI 工具才能生效(切换成功后会有提示)。路由模式下,请求会立即转发到新供应商;但如果切换改变了模型,这三个工具仍可能需要重启。
  • 聚合模式:Claude Code 的聚合模型改动立即生效;Codex 进入或退出聚合、改动聚合模型列表后都要彻底重启,见下一条。
  • Claude Desktop:需要完全退出并重新打开 Claude Desktop;使用“模型映射”时,还需要保持 CC Switch 运行。
  • OpenCode、OpenClaw、Hermes、Pi、MiniMax Code、Kimi Code:这些是共存式工具,点击“添加”(Pi 为“启用”)会把供应商写入工具自身的配置、与其他供应商共存,之后在工具里选择要使用的模型即可。Kimi Code 还提供“切换”按钮选择供应商的模型;主模型或子代理模型池仍引用的模型不能移除。配置与账号详情见 Kimi Code 接入说明。
Codex 聚合模式下,/model 里看不到聚合的模型?

Codex 只在启动时读取模型列表。进入或退出聚合模式、添加或移除聚合的供应商、改动某家的聚合模型之后,都要彻底重启 Codex 才能看到新的列表:

  • Codex CLI:只关掉终端重开 codex 不够。所有终端里的 codex 共用一个后台守护进程,要重启它才会读到新列表。CC Switch 检测到 Codex 还在用旧列表时,会在 Codex 页面顶部提示,点提示里的“重启 Codex 守护进程”即可。重启会中断守护进程里正在运行的任务。
  • Codex 桌面版:要彻底退出后重新打开(macOS 上按 ⌘Q,只关窗口不行)。
  • 编辑器插件:重开编辑器窗口。

Claude Code 不受影响,聚合模型改动立即生效。

切换供应商会改掉我的插件、Hook 等设置吗?

不会。Claude Code、Codex、Gemini CLI、Grok Build 切换供应商时,CC Switch 只替换配置文件里的关键字段:请求地址、Key、模型名和接口协议(Codex 还包括推理档位,Gemini CLI 还包括认证方式),以及少数跟着供应商走的兼容选项(如 Claude Code 的“禁用 Artifact 工具”、上下文窗口)。插件、Hook、权限、MCP、你自己加的环境变量、注释和排版都原样保留,对所有供应商生效。

这些共享设置可以直接在工具里改,或手动编辑配置文件;也可以在 CC Switch 里编辑任意一个供应商:编辑框显示的是“切到这个供应商之后配置文件的样子”,保存时关键字段存进这个供应商,其余改动写进配置文件,对所有供应商生效。

所以以前的“通用配置片段”已经不需要了,相关按钮已移除。升级前片段里的设置在切换时早已写进配置文件,会继续保留。CC Switch 第一次改写每个配置文件之前,还会把原文件备份到 ~/.cc-switch/backups/live-first-write/。

在工具里换了模型,切走再切回来怎么又变回去了?

模型属于关键字段,归供应商所有。在工具里换的模型(如 Claude Code 的 /model)会一直生效到下次切换;切换时,配置文件里的模型会换成目标供应商保存的那个,CC Switch 不会把你在工具里换的模型存回原来的供应商。想长期使用某个模型,请在 CC Switch 里编辑这个供应商。

旧版本会在切走时把整份配置文件存回供应商,现在不再这样做:那样会把插件等共享设置冻结进某一个供应商,切到别的供应商时就丢了。

为什么总有一个正在使用的供应商无法删除?

本软件的设计原则是“最小侵入性”,即使卸载本软件,也不会影响应用的正常使用。

所以对于同一时间只启用一个供应商的工具(Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build),系统总会保留一个正在使用的配置,因为如果将所有配置全部删除,该应用将无法正常使用;想删它,先切换到别家。聚合模式下的默认供应商同样不能移除,先把别家设为默认。OpenCode、OpenClaw、Hermes、Pi、MiniMax Code 等共存式工具不受此限制,可以直接删除任意供应商。如果你不常用某个工具,可以在侧栏的「应用」页里把它从侧栏隐藏。如果你想切换回官方登录,可以参考下条。

如何切换回官方登录?

Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build 的供应商列表里都自带一个官方供应商(Claude Official、Claude Desktop Official、OpenAI Official、Google Official、Grok Official),如果删掉了,可以从预设里重新添加。切换到官方供应商后,按照工具自身的登录流程操作(如 Claude Code 的 /login、Codex 的 codex login),之后便可以在官方供应商和第三方供应商之间随意切换。

Codex 还可以在 CC Switch 里用“使用 ChatGPT 登录”登录多个 ChatGPT 账号,再为每张 OpenAI Official 卡片选择“使用的账号”,多个 Plus、Pro 或 Team 账号之间一键切换;选择“跟随 Codex 登录”的卡片则沿用 Codex CLI 自己的登录。

注意:官方订阅用的是工具自己的登录,不经过本地路由。路由模式下不能切换到官方供应商(Codex 的 OpenAI Official 卡片除外),先回到直连即可。

开始路由后,配置文件里的地址为什么变成了 127.0.0.1?

路由模式下,工具的请求会先发到 CC Switch 的本地路由(默认 http://127.0.0.1:15721),再由 CC Switch 转发给你选中的供应商。所以工具的配置文件里只有本地地址和占位密钥 PROXY_MANAGED;Claude Code 的模型名还会写成 claude-sonnet-5 之类的固定别名(/model 菜单里仍显示真实模型名)。真实的供应商地址、密钥和模型都保存在 CC Switch 里。聚合模式同样如此。

在侧栏「用量统计」的请求日志里可以看到每条请求的“请求模型 → 实际模型”。

路由模式下,切换的是路由使用的供应商,进入路由前在用的供应商保持不变,卡片上标“直连”。点“回到直连”后,配置文件会写回这个直连供应商的配置。退出 CC Switch 时也会先写回直连供应商,下次启动再重新接上。

能在 Claude Code 里使用 OpenAI 兼容接口、Gemini 或本地模型吗?

可以,但需要使用路由。编辑供应商时,在“高级选项”的“上游格式”里选择和供应商一致的接口格式:只提供 Chat Completions 接口的服务(很多本地模型服务都是这样)选“OpenAI Chat Completions”,提供 Responses 接口的选“OpenAI Responses API”,Gemini 选“Gemini Native generateContent”。然后在 Claude Code 页面的「路由」标签里点“开始路由”。格式选错或没有开始路由,通常会报 404 或 405 错误。

反过来,在 Codex 或 Grok Build 的“上游格式”里选“Anthropic Messages”,就能使用 Claude 格式的供应商,同样需要路由。详见在 Claude Code 中使用 GPT 和 在 Codex 中使用 Claude。

“检测连通”通过了,为什么请求还是失败?

供应商卡片上的“检测连通”只检查供应商地址能不能连上,不会发送真实的模型请求,所以验证不了 API Key 和模型名是否正确。请求失败时,请检查 Key、模型名和上游格式;经过路由的请求,还可以在侧栏「用量统计」的请求日志里查看具体报错。

我的数据存储在哪里?

默认都在用户主目录下的 .cc-switch 文件夹(Windows 为 C:\Users\<用户名>\.cc-switch):

  • 数据库:cc-switch.db(SQLite — 供应商、MCP、提示词、Skills、项目、用量记录等)
  • 本地设置:settings.json(设备级设置,如各工具的配置目录、备份策略、云同步连接信息)
  • 备份:backups/(默认每 24 小时自动备份一次、保留最近 10 个,可在「设置 → 数据 → 备份与恢复」中调整;下方的“其他备份”列出其余备份的位置和大小,可以按类别清理)
  • Skills:skills/(可在设置中改为 ~/.agents/skills),默认通过软链接同步到各工具,失败时改为复制
  • 技能备份:skill-backups/(卸载或更新技能前自动创建,保留最近 20 个)
  • OAuth 登录凭据:copilot_auth.json、codex_oauth_auth.json、xai_oauth_auth.json
  • 日志:logs/cc-switch.log 和 crash.log,反馈问题时请附上
  • 本机状态:live-state.json(各工具当前是直连、路由还是聚合,上一次写入了什么)、codex-login-stash.json(切到第三方时被移走的 Codex 官方登录,切回官方时还原)
  • 配置文件原件:backups/live-first-write/(CC Switch 第一次改写各工具配置文件之前的原文件)

在「设置 → 数据 → 存储位置」里修改“CC Switch 配置目录”后,除 settings.json、本机状态和配置文件原件以外的上述文件都改为存放在新目录。CC Switch 不会自动搬运已有文件,需要先手动复制过去。settings.json、本机状态和配置文件原件只属于这台电脑,始终在默认目录,也不参与云同步。

在 Windows 上怎么管理 WSL 里的工具?

CC Switch 不会自动识别 WSL。请在「设置 → 应用配置」里,把对应工具的配置目录改成 WSL 里的路径,例如 \\wsl.localhost\Ubuntu\home\<用户名>\.claude,保存后 CC Switch 就会读写 WSL 里的配置(Claude Code、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi 支持设置)。设置之后,侧栏的「应用」页也会在对应的 WSL 发行版里检测和升级该工具。

注意:路由和聚合写入配置的地址是 127.0.0.1。WSL2 默认的 NAT 网络模式下,WSL 里的 127.0.0.1 连不到 Windows 上的本地路由,需要改用 WSL 的 mirrored 网络模式。

有命令行版本或无界面版本吗?

CC Switch 本身只提供需要图形界面的桌面版(系统要求见下载安装)。在服务器、SSH 远程或没有桌面环境的机器上,推荐使用社区维护的 CC Switch CLI:它提供交互式终端界面(TUI)和命令行两种用法,支持 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes、Pi,可以通过 Homebrew(brew install cc-switch-cli)或安装脚本安装。

CC Switch CLI 默认与桌面版共用数据目录 ~/.cc-switch,也兼容桌面版的 WebDAV 同步。两个项目分别发版,CLI 版支持的数据库版本有时会落后于桌面版;遇到“数据库版本过新”的提示时,请升级 CLI 版,或等它跟进更新。

Linux(Wayland + NVIDIA):网页内容点不动、缩放后黑屏

AppImage 会强制 GDK_BACKEND=x11(走 XWayland)以规避历史上的原生 Wayland 崩溃。但在较新的 Wayland + NVIDIA 环境下,这会导致网页内容区点不动(标题栏按钮仍可点)、窗口缩放后黑屏。可用内置的逃生开关切回原生 Wayland:

CC_SWITCH_GDK_BACKEND=wayland ./CC-Switch-*.AppImage

如果你是从桌面图标启动的,请把它写进 .desktop 的 Exec= 行(如 env CC_SWITCH_GDK_BACKEND=wayland /path/to/AppImage),或在会话环境中设置。该变量是通用的:在 tiling Wayland 合成器(sway/Hyprland)下若出现点击失效,可反过来设 CC_SWITCH_GDK_BACKEND=x11。不设置则保持默认行为。

更多问题请查看用户手册中的常见问题。

贡献

欢迎提交 Issue 反馈问题和建议!新功能开发前,请先开 Issue 讨论实现方案,不适合项目的功能性 PR 有可能会被关闭。

开发环境、提交前检查和架构说明见 CONTRIBUTING.md;使用问题请先看 SUPPORT.md;安全漏洞请按 SECURITY.md 私下报告。

技术栈:Tauri 2 · Rust · React 18 · TypeScript · SQLite

Star History

Star History Chart

License

MIT © Jason Young