CC Switch v4.0.19 升级指南：Kimi Code 三步接入，exec 报错与用量页重排一次修完

【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode,DeepSeek Harness and more. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch

如果你在用 Kimi Code，或者 Codex 聚合模式一直弹unsupported call: exec，CC Switch v4.0.19（2026-10-23 发布）值得立刻升级。这版把 Kimi Code 接成第 12 个受管应用，并把用量统计页整个重排了一遍——不涉及这两块的老用户可以缓一缓。

现在就该升级的人

• 你在用 Kimi Code（命令行或桌面版）→ 立即升。这是它第一次被正式接管，配置一改两个版本同时生效。
• 聚合模式下见过unsupported call: exec→ 别缓。升级后修复自动生效，你不需要做任何事。
• 手里有多个 Kimi 官方账号→ 建议升。认证中心支持多账号登录，各自独立凭据，昵称和额度都分开显示。
• 只用 Claude 或 Codex 单个应用、一切稳定→ 可升可不升。升了的话留意一点：用量页旧的「设置」页签没了，价格与数据来源配置挪进了设置弹层。
• 完全不用 Kimi Code→ 可缓。若已升，去「应用」页把「在侧栏显示 Kimi Code」关掉即可。

Kimi Code 接入：这版的核心变化

Kimi Code 的命令是kimi。它和桌面版共用同一份配置（~/.kimi-code/config.toml，设置了KIMI_CODE_HOME环境变量时以该目录为准），所以在 CC Switch 里做的任何改动，命令行和桌面版同时生效。

添加一个第三方供应商

1. 到「应用」页装好 Kimi Code（官方安装器支持安装、升级、卸载），在侧栏切到 Kimi Code，点「添加供应商」。
2. 预设按「模型厂商 / 第三方平台 / 云服务商 / 本地 / 账号登录」五组排列，选好预设后点「获取模型列表」。选中的模型会自动填上下文窗口、思考档与图片输入，每个模型一行，可单独填显示名称——/model里看到的就是它。
3. 点「添加」，供应商写进配置但不改默认模型。想换默认模型，去卡片的更多菜单里选「设为默认」。多个供应商可同时启用，在 Kimi Code 里用/model切换。

写入是累加式的：只动 CC Switch 管的供应商和模型节点，其余配置、环境变量与注释原样保留。

怎么绑定多个 Kimi 官方账号

1. 认证中心点「登录 Kimi」，选国内版或海外版，在浏览器里完成设备码授权。Kimi Code 里已经登着的号会自动出现。
2. 第一个账号占用 Kimi Code 自己的登录槽位（managed:kimi-code）；之后再加的每个账号有独立的凭据文件（kimi-code-ccs-<标识>形态）、供应商节点与模型别名，模型选择器里显示为「Kimi 订阅 <昵称>」。
3. 点「使用此账号」或卡片菜单里的「设为默认」，就把 Kimi Code 的默认模型切到这个号。

快过期的登录会在后台自动续期，和 Kimi Code 共用同一把锁（<槽位>.lock），不会互相抢；Windows 上只读额度、不代写凭据。

动手前要知道的规则

• ⚠️ 官方订阅绑定复用 Kimi 自己的 OAuth 登录，账号因此被限制的风险自负 → 重要账号建议只在 Kimi Code 里直接登录，不要走 CC Switch 绑定。
• ⚠️ 官方卡片只能在认证中心管理，供应商页里编辑、删除都被禁用 → 想改账号就去认证中心操作，别在供应商页找入口。
• ⚠️ 删除单独添加的账号会连带删掉它的供应商、模型、凭据与卡片，正在使用时拒绝删除 → 先把默认模型切到别的供应商再删。
• Kimi Code 自己登着的号只会被移出列表，不会被登出。
• Kimi Code 不参与本地路由与聚合模式，直连供应商自己的端点。

用量统计页搬去了哪里

重排对所有人直接生效，没有开关可退回旧版。打开新页面，按这个顺序读：

1. 筛选行：时间、应用、供应商、模型排在同一行，供应商与模型合成一个两级联动菜单。
2. 概览卡：点选任意指标，趋势图与热力图立刻跟着它切换；输入、输出、缓存读、缓存写四项 Token 可展开成第二行。
3. 右上角：只剩一个同步按钮（旁边带上次同步时间）和一个设置入口——数据来源、显示、价格设置全部收进这个设置弹层。
4. 明细区：只剩「请求日志 / 供应商 / 模型」三个页签，标签带数量。表格按内容宽度排列，太宽时横向滚动，时间与应用两列钉在左侧。
5. 请求日志：每页可选 10 / 20 / 50 条，默认 20，选择会被记住；显示哪些列改由页签右侧的菜单挑选；没有数据的格子显示「—」。

• ⚠️ 旧版「设置」页签被直接删除 → 升级后到设置弹层里核对一遍数据来源和价格配置。
• 趋势图与热力图配色保持原样。
• 「近 7 / 14 / 30 天」现按日历日计算起点，横跨夏令时切换的区间与旧版有 1 天级别的出入，属修正而非数据错误。

被这个报错卡住的人看这里：聚合模式unsupported call: exec

• 症状：聚合模式下从第三方 GPT 行切到 DeepSeek、Kimi 等模型行，Codex 每一轮都报unsupported call: exec。
• 成因：聚合的合并目录里，每行模型带一个历史压缩标识（comp_hash），标识相同的行共享历史、切换时不压缩。以前第三方 GPT 行和其余行共用同一个标识，跨协议切换后 Codex 直接照抄历史里新模型不认识的工具调用记录。
• 怎么修：升级即好，无需操作。实现上按工具协议给行分组——直连行保留cc-switch，聚合行走cc-switch-<tool_mode>（见 codex_config.rs），跨协议切换时先用原模型压缩一次历史再切。
• 边界：同协议内切换照旧不压缩；直连与路由模式完全不受影响。暂时升不了的话，留在第三方 GPT 行工作是可用的临时办法。

这版的其他改动

安装 v4.0.19 与回退方法

brew install --cask cc-switch # macOS 用户最省事的方式，升级用 brew upgrade --cask cc-switch sudo apt install ./CC-Switch-*.deb # Debian/Ubuntu 系；Fedora 用 dnf 装 .rpm，Arch 系直接跑 AppImage

回退只在需要时做，顺序不能反：

1. 先找到升级前自动生成的数据库备份。这版把数据库从 21 升到 22，只是给mcp_servers与skills两张表各加了一个enabled_kimi开关列（迁移逻辑在 database/schema.rs）。
2. ⚠️ v4.0.19 只要运行过一次，数据库就是 v22，旧版本会拒绝打开它 → 必须先把备份还原成 21 版数据库，再启动旧版本，顺序反了直接打不开。
3. 旧版本启动后，核对供应商与会话数据完整。

官方声明与相关文档

CC Switch 完全免费开源，唯一官网是 ccswitch.io——任何收费、要求充值或索取登录凭据的「CC Switch」网站与客户端都是假冒的。

• Kimi Code 接入文档
• 添加供应商
• 用量统计
• v4.0.19 发布说明
• 完整更新记录

【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode,DeepSeek Harness and more. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch