CC Switch v3.14.0 深度解析Hermes Agent 成为第 6 个受管应用与 Gemini Native API 代理落地【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switchCC Switch v3.14.0 是一次以「受管应用版图扩张」为主线的大版本Hermes Agent 作为第 6 个一等受管应用完整接入数据库迁移、YAML 读写、MCP / Skills 同步、会话管理、专属面板一应俱全同时新增 Gemini Native API 代理、把 Local Proxy Takeover 统一重命名为 Local Routing并在 Copilot 反向代理上做了系统性的 premium 次数消耗优化。读完本篇你将了解 Hermes 集成的数据层与配置层实现细节、Gemini Native 代理的模块划分、Copilot 优化管线的具体步骤以及本版本所有破坏性变更与风险提示。概览一次「应用版图扩张 代理能力补强」的大版本v3.14.0 的核心焦点是把Hermes Agent 作为第 6 个一等受管应用接入 CC Switch与 Claude / Codex / Gemini / OpenCode / OpenClaw 并列并把Claude Opus 4.7铺设到全部聚合器与 Bedrock 预设矩阵。Hermes 支持覆盖数据库 v9 → v10 迁移为mcp_servers与skills表新增enabled_hermes列完整的 Rust 命令面基于 YAML 的~/.hermes/config.yaml读写含原子备份MCP 同步、Skills 同步SQLite JSONL 会话管理专属的前端面板和 Memory 编辑面板与 Hermes Agent 0.10.0 schema 对齐的四种协议chat_completions、anthropic_messages、codex_responses、bedrock_converse全部可选。用户在 YAML 里自行维护的providers:dict 条目以只读卡片形式呈现深度 YAML 配置则直接委托给 Hermes Web UI。除 Hermes 外本版本还新增Gemini Native API 代理api_format gemini_native让代理可以把请求直接转发到 Google 的generateContent端点完整支持流式、schema 转换和 shadow 请求把老的 Local Proxy Takeover 在三语 UI / README / 文档中统一重命名为Local Routing新增应用级窗口控件在 Linux Wayland 等合成器绘制按钮失灵的场景下可选让 CC Switch 自绘最小化 / 最大化 / 关闭按钮并在发布前额外合入了从工具栏直接启动hermes dashboard、LemonData 全应用预设、DDSHub Codex 端点以及若干 Hermes 健康检查与 Usage 模态框的修复。会话侧通过tanstack/react-virtual虚拟化会话列表让上千条记录的长会话也能流畅滚动长消息默认折叠Usage 面板新增日期范围选择器今日 / 1d / 7d / 14d / 30d 自定义日期时间和翻页输入Stream Check 错误分类以彩色 toast 呈现默认探测模型重新梳理模型不存在响应被单独识别并新增在 Local Routing 激活时阻止切换到官方供应商的保护以免官方流量被引入本地代理造成账号风险。Pricing 数据库 v8 → v9 重新种入约 50 个新模型条目包括 Claude 4.7、Opus 4.7 Adaptive Thinking、Grok 4、Qwen 3.5/3.6、MiniMax M2.5/M2.7、Doubao Seed 2.0 系列、GLM-5/5.1 等并修正了多项陈旧价格。发布日期2026-04-21更新规模100 commits | 219 files changed | 20,548 / -3,569 lines多语言版本English | 日本語版重点内容速览特性一句话说明Hermes Agent 支持第 6 个受管应用数据库 v9 → v10 迁移、完整 Rust 命令面、YAML 读写带原子备份、MCP 同步、Skills 同步、SQLite JSONL 会话管理、专属前端面板、四种 API 协议Claude Opus 4.7 全面接入自适应思维白名单、按百万 token 定价种子、Bedrock SKUanthropic.claude-opus-4-7/global.anthropic.claude-opus-4-7丢弃老-v1后缀全部聚合器 / Bedrock 预设升级为默认 Opus 模型Claudemax推理力度推理下拉从high升级到maxGemini Native API 代理新增api_format gemini_native代理可直达 GooglegenerateContent完整流式 / schema 转换 / shadow 请求GitHub Copilot 企业版为 Copilot 型 Claude 供应商新增 GHES 认证与端点配置Copilot 次数消耗深度优化转发前主动剥离 thinking 块、tool_result消息归类修正、subagent 检测、x-interaction-id合并计费、orphantool_result清理、默认启用 warmup 降级会话列表虚拟化tanstack/react-virtual长会话流畅滚动长消息默认折叠降低文字布局成本Codex / OpenClaw 会话标题提取自动抽取有意义标题两行显示剥离 OpenClawmessage_id尾噪声Usage 日期范围选择器Today / 1d / 7d / 14d / 30d 预设 自定义日期时间日历分页列表支持页码跳转输入Stream Check 错误分类错误按类别分色 toast默认探测模型刷新单独识别 model not foundLocal Routing 激活时阻止官方供应商切换官方流量走本地代理有账号暂停风险强制拦截并 toast 警告Pricing 数据库刷新v8 → v9新增 ~50 条模型条目并修正陈旧价格应用级窗口控件可选让 CC Switch 自绘 min/max/close显著改善 Linux Wayland 体验Hermes 接入统一 Skills 管理Skills 安装 / 启用 / 过滤现覆盖 HermesHermes / OpenClaw 配置目录自定义在设置里指定~/.hermes/config.yaml或openclaw.json的自定义位置从工具栏启动 Hermes DashboardWeb UI 探测失败时点击可在用户首选终端中启动hermes dashboard新合作伙伴预设LemonData 覆盖全部 6 个应用DDSHub 新增 Codex 端点StepFun Step PlanHermes Agent 支持第 6 个受管应用的完整落地数据层数据库迁移 v9 → v10为mcp_servers和skills两张表新增enabled_hermes列DEFAULT 0自动迁移、无数据丢失让 MCP 服务器和 Skills 都能像对待其他五个应用一样按应用维度启用 Hermes。在源码中可以直接验证这一迁移逻辑。迁移函数migrate_v9_to_v10位于 schema.rs它先对mcp_servers表调用add_column_if_missing补齐enabled_hermes BOOLEAN NOT NULL DEFAULT 0再判断skills表是否存在兼容从极旧版本迁移、可能还没有skills表的数据库存在时同样补齐该列。两表的建表语句中也已原生包含该列见 schema.rs 中mcp_servers与skills的CREATE TABLE定义均带enabled_hermes BOOLEAN NOT NULL DEFAULT 0。需要注意当前仓库的SCHEMA_VERSION已经随后续版本继续迭代见 mod.rsv9 → v10是 v3.14.0 发布时执行的迁移步骤迁移框架通过user_version逐步升迁对已有数据无损。配置层~/.hermes/config.yaml读写与「累加式」切换Hermes 的 YAML 配置读写带原子备份后端实现集中在 hermes_config.rs。从源码结构看几个关键设计与 release notes 的描述一一对应用户providers:dict 只读呈现CC Switch 可写的条目落在custom_providers:序列下PROVIDER_SOURCE_CUSTOM_LIST常量即custom_providers见 hermes_config.rs而用户在providers:dict 里手写的条目只被读取并以只读卡片展示深度配置跳转到 Hermes Web UI。读取逻辑会 union 两个来源——custom_providers:列表条目CC Switch 可写与providers:dict 中 CC Switch 不认识的条目只读与上游get_compatible_custom_providers的行为保持一致见 hermes_config.rs防污染消毒器针对「经 CC Switch 往返写入污染custom_providers:条目」的风险代码内置了防御性 sanitiser防止外来字段污染写回的条目见 hermes_config.rs 的注释说明累加式切换与 Claude / Codex 的「覆盖式」切换不同Hermes 所有供应商共存于同一 YAML——写入以「按name匹配 upsert 进custom_providers:序列」的方式进行见 hermes_config.rs 的 upsert / remove 实现而非整体覆盖文件。四种 API 协议与显式api_mode与 Hermes Agent 0.10.0 schema 对齐的chat_completions/anthropic_messages/codex_responses/bedrock_converse四种协议全部可选新 deeplink 默认为chat_completions。api_mode是custom_providers:条目的核心字段deeplink 与表单都会显式写入见 provider.rs 的注释Hermescustom_providers:条目使用base_url/api_key/api_mode等 snake_case 字段。本版本同时移除了 HermesAutoapi_mode用户必须显式选择协议导入或 deeplink 得到的供应商默认落到chat_completions消除了基于 URL 的启发式识别带来的意外详见下文 Breaking 章节。守护测试hermes_roundtrip.rs「不损坏不相关键、不丢失 OAuth MCPauth块」由集成测试 hermes_roundtrip.rs 守护该测试对「读取 → 修改 → 写回」的完整往返做断言保证经 CC Switch 往返写入后YAML 中其他键与 OAuth MCP 的auth块保持原样。Hermes Memory 面板与供应商预设Memory 面板新增 Memory 面板可直接编辑MEMORY.md/USER.md带启用开关、字符数限制和保存流它替换了 Hermes 的 Prompts 入口即 Hermes 的长期记忆配置从此在 CC Switch 内闭环管理前端面板位于 HermesMemoryPanel.tsx。供应商预设约 50 个Hermes 预设矩阵覆盖Nous Research、胜算云、OpenRouter、DeepSeek、Together AI、StepFun、智谱 GLM、百炼、Kimi、MiniMax、豆包、百灵、魔搭、KAT-Coder、PackyCode、Cubence、AIGoCode、RightCode、AICodeMirror、AICoding、CrazyRouter、SSSAiCode、Micu、CTok.ai、DDSHub、E-FlowCode、LionCCAPI、PIPELLM、Compshare、SiliconFlow、AiHubMix、DMXAPI、TheRouter、Novita、Nvidia、小米 MiMo预设定义集中在 hermesProviderPresets.ts。从工具栏启动 Hermes DashboardHermes Web UI 探测失败时工具栏按钮不再只是一个打不开的死链而是弹出确认框提供在用户首选终端里运行hermes dashboard。实现上通过临时 bash / batch 脚本启动hermes dashboard就绪后自动打开浏览器无需前端轮询。后端命令入口在 commands/hermes.rslaunch_terminal_running(hermes dashboard, hermes_dashboard)以非阻塞方式在用户终端中执行。配套行为包括Memory 面板和 Health banner 保留原有 toast 行为修正了离线 toast 里过时的hermes web提示正确命令是hermes dashboardLinux 终端探测改为先which后 stat提升兼容性。Claude Opus 4.7 与max推理力度Opus 4.7 全面接入新增 Claude Opus 4.7 及其自适应思维白名单、按百万 token 定价种子、Bedrock SKUanthropic.claude-opus-4-7/global.anthropic.claude-opus-4-7丢弃老-v1后缀全部聚合器 / Bedrock 预设升级为默认 Opus 模型。max推理力度Claude 推理下拉从high升级到max解锁更强的思考容量。配套的 Quick-Set 表单变更把推理能力和模型选择解耦ANTHROPIC_REASONING_MODEL这一遗留字段不再暴露既有设置自动清理见下文 Breaking 章节。Gemini Native API 代理api_format gemini_native新增api_format gemini_native后CC Switch 的本地代理不必再走 OpenAI 兼容层可以直接把请求转发到 Google 的generateContentAPI完整支持流式、schema 转换与 shadow 请求。在源码中该能力由 proxy providers 模块下的一组新文件承载位于 src-tauri/src/proxy/providers/文件职责从命名与调用结构看gemini_url.rsgenerateContent目标 URL 的构造gemini_schema.rs请求 / 响应 schema 与 Gemini 原生格式间的转换gemini_shadow.rsshadow 请求处理streaming_gemini.rsSSE 流式响应的解析与转发transform_gemini.rs上游请求体的格式转换gemini_native标识在 proxy/providers/mod.rs、forwarder.rs 与 handlers.rs 中作为 api_format 分支出现与既有的 Claude / Codex 转换路径并列。GitHub Copilot 企业版GHES为 Copilot 型 Claude 供应商新增 GHESGitHub Enterprise Server认证与端点配置私有化部署的 GitHub 企业版用户现在可以把自己的 GHES 端点接进 Copilot 反代路径。Copilot 次数消耗深度优化一条省 premium 交互的管线本版本做了一次系统性优化专门降低 Copilot 反向代理的 premium 交互消耗。核心实现位于 copilot_optimizer.rs逐项对应如下转发前主动剥离 thinking 块Anthropic 的thinking/redacted_thinking块会被 OpenAI 兼容端点拒绝——过去的行为是一次请求先失败、消耗一次 premium 交互再由thinking_rectifier触发重试。现在新增主动剥离步骤Copilot 优化管线第 3.5 步位于tool_result合并之后直接省掉那次无谓的 premium 消耗。源码中strip_thinking_blocks函数只剥离thinking/redacted_thinking两类 block不触碰signature见 copilot_optimizer.rs并有专门测试覆盖「多轮 assistant、空 content、字符串 content、block 顺序保持」等边界见同文件 L1406 起的测试段请求分类修正含tool_result的消息归类为「代理继续」而不是用户发起的新请求——避免每次工具调用都被错误计入 premium 次数subagent 检测通过__SUBAGENT_MARKER__和metadata._agent_回退识别 subagent设置x-interaction-typeconversation-subagent。源码中检测逻辑先查 system 文本里的显式__SUBAGENT_MARKER__Claude Code 2.x 自动注入再回退到metadata._agent_见 copilot_optimizer.rs确定性x-interaction-id合并计费从 session ID 推导x-interaction-id把同一会话内的多次请求合并为一次计费交互Orphantool_result清理清理孤立的tool_result避免触发上游错误导致重试和重复计费Warmup 降级默认开启使用gpt-5-mini作为默认降级模型并修复了CopilotOptimizerConfig默认值不一致统一到gpt-5-mini优化管线重排classify → sanitize → merge → warmup让分类步骤能看到原始tool_result语义。会话管理列表虚拟化与标题提取会话列表虚拟化通过tanstack/react-virtual虚拟化会话列表上千条记录的长会话也能流畅滚动长会话消息默认折叠减少文字布局开销。前端实现在 SessionManagerPage.tsx 与会话条目组件 SessionItem.tsx。Codex / OpenClaw 会话标题提取Codex 和 OpenClaw 会话自动抽取有意义的标题两行显示剥离 OpenClawmessage_id后缀噪声避免把内部 ID 当成标题的一部分展示。Usage 面板日期范围选择器与分页跳转Usage 面板新增日期范围选择器预设 TabToday / 1d / 7d / 14d / 30d 自定义日期 时间日历分页列表新增页码跳转输入请求日志时间范围与面板的 1d / 7d / 30d 选择器同步去重与同步逻辑见 Bug 修复章节。前端对应组件为 UsageDateRangePicker.tsx、UsageDashboard.tsx 与 RequestLogTable.tsx。Stream Check 错误分类按类别为 Stream Check 错误上色并以 toast 呈现快速定位是鉴权、网络还是模型问题刷新所有厂商默认探测模型到当前主力机型对 model not found 响应做单独识别不再与一般性失败混为一谈。Local Routing 激活时阻止官方供应商切换在 Local Routing 激活状态下切换到官方供应商会被强制拦截并弹出警告 toast。原因官方 API 流量经由本地代理存在账号暂停风险——这与文末风险提示中「Codex OAuth 反向代理」「GitHub Copilot 反向代理」的条款风险一脉相承属于产品层的主动防御。Pricing 数据库刷新v8 → v9迁移时重新种入定价表首次启动时model_pricing表被清空并重新种入新增约 50 条模型条目覆盖 Claude 4.7、Opus 4.7 Adaptive Thinking、Grok 4、Qwen 3.5/3.6、MiniMax M2.5/M2.7、Doubao Seed 2.0 系列、GLM-5/5.1修正 DeepSeek、Kimi K2.5 等陈旧价格。应用级窗口控件Wayland 场景下的自救新增可选设置让 CC Switch 自绘最小化 / 切换最大化 / 关闭按钮代替系统装饰。在合成器可能画不出窗口按钮的 Linux Wayland 上这一项显著改善体验——当窗口管理器不提供标题栏控件时应用自绘控件成为唯一可靠的窗口操作入口。Hermes 接入统一 Skills 管理 / 配置目录自定义统一 Skills 管理统一的 Skills 界面新增 HermesSkills 安装 / 启用 / 过滤现覆盖 Hermes与 Claude / Codex / Gemini / OpenCode / OpenClaw 并列前端入口 UnifiedSkillsPanel.tsxHermes 配置目录自定义新增设置项允许把 CC Switch 指向自定义的~/.hermes/config.yaml位置底层通过数据驱动 dispatch 实现OpenClaw 配置目录自定义新增设置项允许把 CC Switch 指向自定义的openclaw.json位置设置界面位于 DirectorySettings.tsx。两者对容器化部署、多账户或多配置场景尤为有用配置路径不再被写死在用户主目录下。新预设与其他功能模型映射快速填入供应商表单的模型映射字段旁新增快速填入按钮加快编辑。StepFun Step Plan 预设新增 StepFun Step PlanEN / ZH供应商预设。New API 用量脚本模板为 New API 用量脚本模板新增 User-Agent 头提升上游兼容性。LemonData 全应用预设LemonData 作为第三方合作伙伴预设覆盖 Claude / Codex / Gemini / OpenCode / OpenClaw / Hermes 全部 6 个应用含图标资源和 zh / en / ja 三语合作伙伴推广文案Claude 预设使用ANTHROPIC_API_KEY认证OpenAI 兼容应用目标为gpt-5.4。DDSHub Codex 预设新增 DDSHub 的 Codex 兼容端点与 Claude 服务同 hostbase URL 省略/v1后缀由网关自动路由 OpenAI SDK 路径。变更ChangesLocal Proxy Takeover → Local Routing三语 UI 文案、README、文档中全部统一重命名功能行为保持不变接管相关文档在三语下也重命名为 routing 并同步更新锚点。如果你还在按旧名搜索文档注意新入口的措辞是 Routing。Hermes 供应商表单新增 API mode 下拉和按供应商的模型编辑器切换激活供应商时把按供应商的模型绑定到顶层model:。Hermes 深度配置委托深度 YAML 配置不再在 CC Switch 表单里重复直接通过「启动 Hermes Web UI」按钮交给 Web UI 处理——CC Switch 只管理它「写得安全」的部分。Hermes 工具栏布局Web UI 按钮图标从ExternalLink换成LayoutDashboard——点击可能启动hermes dashboard而非仅仅打开 URL面板式图标语义更准MCP 移到工具栏末尾与 Claude / Codex / Gemini / OpenCode 的布局对齐。按供应商代理配置移除按供应商的代理开关和存储都已移除统一到全局的 Local Routing 设置既有按供应商代理值被忽略。统一工具栏图标按钮宽度在 Claude / Codex / Gemini / OpenCode / OpenClaw / Hermes 面板之间规格化图标按钮宽度表头视觉一致。Rust Toolchain 锁定 1.95全仓库采纳 clippy 1.95 建议并锁定 toolchain防止 nightly 漂移仓库内通过 rust-toolchain.toml 固定。托盘菜单 ID 常量托盘标识符从硬编码字符串main改为TRAY_ID常量cc-switch所有调用点同步降低后续改动托盘逻辑时的字符串漂移风险。用量脚本内网支持移除 usage script 的私网 IP / 可疑主机名屏蔽解锁企业内网、Docker、自建 API 端点。安全边界仍然保留内置模板仍强制 HTTPSlocalhost 除外和同源检查自定义模板仍由用户控制这类请求的 URL 检查跳过。Failover 队列备注供应商备注现在在 failover 队列选择器和队列行中显示方便在多供应商队列里识别前端入口 FailoverQueueManager.tsx。Bug 修复Hermes 相关YAML 污染与 OAuth MCPauth丢失经 CC Switch 往返写入不再丢失 OAuth MCPauth块、也不污染不相关的 YAML 键新增 tests/hermes_roundtrip.rs 作为守护测试激活供应商展示Hermes UI 现在正确展示激活供应商并连通添加 / 启用 / 移除动作供应商持久化供应商持久化到custom_providers:下api_mode和model可跨重启 / 配置重载存活健康检查错借 OpenClaw schema以前 Hermes 供应商被路由到check_additive_app_streamOpenClaw 的调度器后者读 camelCase 的baseUrl/apiKey/api导致即便 Hermes 字段全填还是报 OpenClaw provider is missing baseUrl。新增check_hermes_stream用 Hermes 专用提取器把api_modechat_completions/anthropic_messages/codex_responses映射到对应的check_claude_streamapi_formatbedrock_converse明确标记为不支持先解析api_mode再抽 URL / API key让bedrock_converse用户看到真实原因而不是误导性的 missing base_url预设刷新刷新陈旧模型 ID回填 Hermes 模型列表修正 Nous 端点Hermes 占位图替换为 Nous 品牌图移除未使用的官方 Hermes 预设Usage 查询模态框支持 Hermes / OpenClawgetProviderCredentials新增对 Hermessnake_casebase_url/api_key和 OpenClawcamelCasebaseUrl/apiKey的扁平settingsConfig字段读取让 SiliconFlow 等匹配供应商自动选中 official balance 模板重构 BALANCE 和 TOKEN_PLAN 测试路径复用providerCredentials不再直接读env.ANTHROPIC_*修正了非 Claude 应用即使配置了 key 也报 empty key 的问题。代理与协议相关Codexcache_control保留在 Codex 格式转换合并 system prompt 时保留cache_controlClaude prompt cache key 泄漏Claude chat 转换时不再发送 prompt cache key代理逐跳响应头剥离按 RFC 7230 剥离代理响应的 hop-by-hop 头Connection、Keep-Alive、Transfer-Encoding 等代理 CORS 层移除移除代理中过于宽松的 CORS 层代理 toast 显示后端错误详情代理相关 toast 现在展示后端错误 payload 的详情而不是一句笼统的失败。用量与配置Usage 日志去重代理和会话日志的用量记录去重相同请求不再被重复计数请求日志时间范围与面板的 1d / 7d / 30d 选择器同步Common Config 勾选持久化Claude / Codex / Gemini common-config 勾选状态重开后正确保留Claude 插件settings.json同步编辑当前供应商时会同步回 Claude 插件路径下的settings.jsonGoogle Official Gemini env 保留保存 Google Official Gemini 供应商时不再清空env块OpenCode JSON5 尾逗号解析OpenCode 配置读取容忍尾逗号JSON5预设刷新刷新 DeepSeek 和 Claude 1M 的陈旧 context 窗口。会话与 UI工具栏最大化后持续折叠窗口最大化 / 还原后工具栏不再卡在折叠状态折叠判定会随尺寸变化重新计算搜索命中时折叠消息自动展开搜索匹配落在折叠内容内部时消息自动展开以定位匹配未知订阅配额等级隐藏供应商卡片不再渲染未知订阅配额等级weekly_limit标签统一跨语言把weekly_limit等级标签对齐到官方的「7 天」命名Skills 导入同步导入的 Skills 即时同步到启用应用目录不再仅记录在数据库里导致 UI 显示「已安装」但目标目录空缺根级 Skill 仓库安装修复当仓库根本身就是一个 skill 时的安装失败Ghostty 会话恢复改为通过 shell 执行 --working-directory启动 Ghostty 会话恢复避免路径含空格 / 特殊字符时cwd转义问题Session ID 解析 clippy移除 session ID 解析里的冗余闭包clippy 警告。文档侧更新README 赞助商更新SiliconFlow 注册赠送更新为 ¥16、精简 SSSAiCode 赞助文案、更新合作伙伴 logo、新增 LemonData 赞助商三语澄清全局代理与 Local Routing 的关系接管相关文档在三语下重命名为 routing同步更新锚点PIPELLM 赞助商网站 URL 更新。⚠️ 重要变更Breaking变更影响与迁移建议Hermes 必须显式api_modeAuto模式移除导入或 deeplink 得到的供应商默认落到chat_completions既有Auto配置的用户会被提示选择协议Claude Quick-Set 移除ANTHROPIC_REASONING_MODEL该遗留字段不再暴露既有设置自动清理按供应商代理配置移除迁移到全局 Local Routing 设置既有按供应商代理值被忽略数据库 schema v9 → v10为mcp_servers和skills表新增enabled_hermes列自动迁移DEFAULT 0无数据丢失Pricing 表 v8 → v9 重置首次启动时model_pricing表被清空并重新种入以应用新模型和修正后的价格XCodeAPI 预设移除使用 XCodeAPI 预设的用户请迁移到其它供应商⚠️ 风险提示本版本在涉及反向代理类功能上沿用 v3.12.3 / v3.13.0 提出的风险提示GitHub Copilot 反向代理使用 Copilot 的反代路径可能违反 GitHub / Microsoft 服务条款。详情见 v3.12.3 release notesCodex OAuth 反向代理使用 ChatGPT 订阅的 Codex OAuth 反代可能违反 OpenAI 服务条款详情见 v3.13.0 release notes。用户启用上述功能即表示自行承担所有风险。CC Switch 不对因使用这些功能而导致的任何账号限制、警告或服务暂停承担责任。这也是本版本「Local Routing 激活时阻止官方供应商切换」这一保护机制存在的背景。下载与安装从项目官方 Releases 页下载对应版本官网 ccswitch.io 有入口。系统要求系统最低版本架构WindowsWindows 10 及以上x64macOSmacOS 12 (Monterey) 及以上Intel (x64) / Apple Silicon (arm64)Linux见下表x64Windows文件说明CC-Switch-v3.14.0-Windows.msi推荐- MSI 安装包支持自动更新CC-Switch-v3.14.0-Windows-Portable.zip便携版解压即用不写入注册表macOS文件说明CC-Switch-v3.14.0-macOS.dmg推荐- DMG 安装包拖入 Applications 即可CC-Switch-v3.14.0-macOS.zip解压后拖入 ApplicationsUniversal BinaryCC-Switch-v3.14.0-macOS.tar.gz用于 Homebrew 安装和自动更新macOS 版本已通过 Apple 代码签名和公证可直接安装使用。HomebrewmacOSbrew tap farion1231/ccswitch brew install --cask cc-switch更新brew upgrade --cask cc-switchLinux发行版推荐格式安装方式Ubuntu / Debian / Linux Mint / Pop!_OS.debsudo dpkg -i CC-Switch-*.deb或sudo apt install ./CC-Switch-*.debFedora / RHEL / CentOS / Rocky Linux.rpmsudo rpm -i CC-Switch-*.rpm或sudo dnf install ./CC-Switch-*.rpmopenSUSE.rpmsudo zypper install ./CC-Switch-*.rpmArch Linux / Manjaro.AppImage添加执行权限后直接运行或使用 AUR其他发行版 / 不确定.AppImagechmod x CC-Switch-*.AppImage ./CC-Switch-*.AppImage小结v3.14.0 的关键词是「扩容」与「收敛」一方面受管应用版图从 5 扩到 6Hermes 完整接入含数据层迁移、YAML 安全写入与守护测试代理能力补上 Gemini Native 直连另一方面对 Copilot premium 消耗、Local Routing 命名、按供应商代理配置等历史遗留做了系统性收敛。升级时重点注意三件破坏性事项——Hermes 必须显式选择api_mode、按供应商代理配置被全局 Local Routing 取代、model_pricing表会在首次启动时重置——其余迁移均为无损自动完成。【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考