CC Switch v4.0.19 升级指南：一步接入 Kimi Code，完整看懂新用量页与聚合模式修复
【免费下载链接】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
CC Switch v4.0.19 于 2026-10-23 发布，45 个提交改动 206 个文件。一句话价值判断：这版对存量用户是「一新一改一修」——Kimi Code 成为第 12 个受管应用、用量统计页整体重排、聚合模式下 Codex 每轮报unsupported call: exec的老毛病被根治。升级的唯一实质成本是数据库从 21 版迁到 22 版，且回退有前置条件。
先对号入座：这版你到底要不要升
| 用户类型 | 升级建议 | 升级后要做什么 |
|---|---|---|
| 在用 Kimi Code（命令行或桌面版） | 强烈建议 | 侧栏默认多出 Kimi Code 入口，不用就去「应用」页关掉 |
被聚合模式unsupported call: exec坑过 | 必须升级 | 无需任何操作，修复自动生效 |
| 经常看用量、对账成本 | 建议 | 旧「设置」页签已删除，到设置弹层里重新核对数据来源与价格 |
| 管理多个 Kimi 官方账号 | 建议 | 到授权中心核对每个账号的绑定关系与默认模型 |
| 只用 Claude / Codex 等单应用且运行稳定 | 可升可不升 | 熟悉一下用量页新布局，其余无感 |
你用 Kimi Code：供应商怎么加、第二个官方账号怎么绑
接入 Kimi Code 后，命令行版和桌面版共用同一份配置，在 CC Switch 里做的改动对两个版本同时生效。配置默认落在~/.kimi-code/config.toml，设置了KIMI_CODE_HOME环境变量时以该目录为准。
如何给 Kimi Code 添加第三方供应商
价值先说清：多个供应商可以同时写入配置并启用，在 Kimi Code 里用/model自由切换；写入是累加式的，你配置里其他节点、环境变量与 OAuth 引用原样保留。
- 进入 Kimi Code 应用页，点「添加供应商」，预设按模型厂商 / 第三方平台 / 云服务商 / 本地 / 账号登录五组排列；
- 点「获取模型列表」，选中的模型自动填上上下文窗口、思考档与图片输入；每个模型一行，可单独填显示名称（
/model里显示的就是它）； - 点「添加」只写配置、不动默认模型；「设为默认」在卡片更多菜单里；正被用作默认模型或子代理模型的供应商受保护，删不掉时会提示你先换掉。
避坑：
- ⚠️ 官方订阅绑定复用 Kimi 自己的 OAuth 登录，账号可能因此被限制，风险自负；
- ⚠️ 官方卡片只能在授权中心管理，供应商页里编辑、删除均不可用；
- ⚠️ 删除单独添加的账号会连带删除其供应商、模型、凭据与卡片，正在使用时拒绝删除；
- Kimi Code 自己登着的号只会被移出列表，不会被登出；
- 快过期的登录在后台自动续期，与 Kimi Code 共用同一把锁（
<slot>.lock），不会互相抢；Windows 上只读取额度、不代写凭据； - Kimi Code 不参与本地路由与聚合模式，直连各供应商自己的端点。
如何绑定第二个 Kimi 官方账号
多账号各自独立凭据槽位，互不覆盖：
- 授权中心点「登录 Kimi」，选国内版或海外版，在浏览器里完成设备码授权；Kimi Code 里已登录的账号会自动出现在列表；
- 第一个账号占用 Kimi Code 自己的登录槽位，之后的每个账号有独立凭据文件、供应商节点与模型别名（
kimi-code-ccs-<hash>形态），模型选择器里显示为「Kimi 订阅 <昵称>」，昵称与额度一并展示； - 点「使用此账号」或卡片菜单「设为默认」，Kimi Code 的默认模型即切到该账号。
不用 Kimi Code 的话怎么关掉侧栏入口
升级后侧栏默认显示 Kimi Code。不用的话，到「应用」页关闭「在侧栏显示 Kimi Code」即可；Kimi Code 的安装、升级、卸载也在这个页面用官方安装程序完成。
你看用量：新统计页按这个顺序读
重排对每个用户都生效，打开即是新布局，没有开关可退回旧版。按下面顺序走一遍就能读懂：
- 时间、应用、供应商、模型排在同一行，供应商与模型合成一个两级联动菜单；
- 概览里点选任意指标，趋势图与热力图立刻跟着它切换；输入、输出、缓存读写四项 Token 可展开成第二行；
- 右上角只剩一个同步按钮（带上次同步时间）和一个设置入口，数据来源、显示、价格设置全部收进设置弹层；
- 明细区剩「请求日志 / 供应商 / 模型」三个页签，标签带数量；表格按内容宽度排列，太宽时横向滚动，时间与应用两列钉在左侧；
- 请求日志可选每页 10 / 20 / 50 条，默认 20，选择会被记住；显示哪些列改由页签右侧的菜单勾选；没有数据的格子显示「—」。
避坑：
- ⚠️ 旧版「设置」页签被直接删除——之前在那里配过数据来源或价格的话，升级后要到设置弹层里逐项核对；
- 「近 7 / 14 / 30 天」现按日历日计算起点，横跨夏令时（DST）切换的区间与旧版有 1 天级别的出入，属修正而非数据错误。
聚合模式报unsupported call: exec：这版怎么修的
被这个报错坑过的话值得立刻升级，升级后你不需要做任何事。
- 症状：聚合模式下从第三方 GPT 行切到 DeepSeek、Kimi 等模型行后，Codex 每一轮都报
unsupported call: exec； - 成因：第三方 GPT 与其余行以前共用同一个
comp_hash，跨协议切换时 Codex 跳过历史压缩，新模型照抄了历史里它不认识的工具调用记录； - 解法：按工具协议给行分组——直连行保留
cc-switch，聚合行走cc-switch-<tool_mode>（实现见 codex_config.rs），跨协议切换时先用原模型压缩一次历史再切； - 边界：同协议内的切换照旧不压缩；直连与路由模式不受影响。暂时升不了的临时办法是留在第三方 GPT 行工作。
其余小改动速查表（大多数不用动手）
| 变更 | 影响谁 | 要不要动手 |
|---|---|---|
| Linux/WSL 从终端启动后打开「设置 → 关于」卡死，现版本查询不再占终端、最多等 10 秒 | Linux/WSL 终端启动用户 | 无 |
给 Codex 选模型后图片输入被关掉：纯文本资料曾把inputModalities写成["text"]，现仅在资料明确含图片时才填 | Codex 用户 | 无 |
| 中转站模型查不到原厂条目时曾借用别家托管条目（如 262144 窗口仅实际四分之一），现留空 | 供应商元数据补全 | 无 |
VS Code 扩展经 Responses 上游报redacted_thinking：加密思考改成带签名的空thinking块，重放字节一致 | Claude Code + Responses 上游 | 无 |
| macOS 读 Claude 订阅额度曾读错钥匙串条目，现先按当前用户账号查找 | macOS | 无 |
| Antigravity 官方卡额度缺 Gemini 一组，查询时带上本机 agy 版本 | macOS | 无 |
Windows 刷新 Antigravity 额度、获取模型列表弹黑色命令行窗口，子进程加CREATE_NO_WINDOW | Windows | 无 |
Hermes 装在 WSL 时「打开终端并启动」曾拉起 Windows 侧 Hermes，现改在该发行版内运行hermes dashboard | Windows + WSL | 无 |
Codex 请求带session-id/thread-id头时路由认不出会话，已可识别 | 代理路由 | 无 |
百炼 / 千问 Token Plan 的 Anthropic 地址补试{root}/compatible-mode/v1/models | 相关供应商 | 无 |
OpenCode Zen / Go 旧地址映射到 models.dev 新位置，deepseek-v4.1-flash等恢复自动补参 | 相关供应商 | 无 |
| OpenCode / OpenClaw「设为默认」挪进卡片菜单，默认供应商改蓝色标出 | 对应应用 | 无 |
| Pi 供应商标识始终显示并预填，重复 key 提示且阻止保存 | Pi | 无 |
| MCP 服务器显示自定义显示名；会话页项目分组标题整行可点展开 | MCP / 会话页 | 无 |
| 新增 BuyToken、V-API 预设 | 预设 | 无 |
| 叠开多个全屏面板按 Esc 只关最上层；请求日志页数收缩后自动退回末页；深链接二次确认不再被误关；「应用」页多余英文行与「高级选项」文字跳动已修 | 界面 | 无 |
升级前自查清单
- 确认当前数据库是 21 版：升级会自动生成 21→22 备份（
mcp_servers与skills表各加一个enabled_kimi列），记下备份存放位置再升； - 不使用 Kimi Code 的话，升级后到「应用」页关闭「在侧栏显示 Kimi Code」；
- 曾在用量页旧「设置」页签配过数据来源或价格的，到设置弹层里逐项核对一遍；
- 在聚合模式里跨工具协议切换（第三方 GPT ↔ 其他模型）的，升级后首次切换 Codex 会先压缩一次历史，属预期行为，别当故障处理；
- 持有多个 Kimi 官方账号的，升级前记下各账号昵称与默认模型，升级后到授权中心核对绑定关系。
安装与回滚：三个系统各走一条路
安装包只从官方渠道获取（官网 ccswitch.io 或 GitHub Releases，两处文件相同）；任何收费、要求充值或索取登录凭据的「CC Switch」都是假冒。
| 系统 | 推荐安装包 | 说明 |
|---|---|---|
| Windows 10+（x64） | CC-Switch-v4.0.19-Windows.msi | 支持自动更新；ARM64 下载arm64版；另有 Portable 绿色版不写注册表 |
| macOS 12+（Intel / Apple Silicon） | CC-Switch-v4.0.19-macOS.dmg | Universal 通用包，拖入 Applications |
| Linux（x64/ARM64） | .deb/.rpm/.AppImage | 需 glibc 2.35+ 与 WebKitGTK 4.1，按发行版与uname -m选择 |
brew install --cask cc-switch # macOS 首次安装；升级用 brew upgrade --cask cc-switch sudo dpkg -i CC-Switch-v4.0.19-Linux-*.deb # Debian/Ubuntu；Fedora 用 dnf，Arch 系走 AUR 或 AppImage回退步骤（仅在需要时执行）：
- 找到 21→22 升级前自动生成的数据库备份文件；
- ⚠️ 若 v4.0.19 已运行过，旧版本会拒绝打开 v22 数据库——必须先把备份还原为 21 版数据库，再启动旧版本；
- 启动旧版本，核对供应商、会话与 MCP 数据完整。
附录：本版贡献者与相关文档
| 贡献者 | 本版贡献 |
|---|---|
| @funkpopo | Kimi Code 全链路与官方账号 |
| @94mashiro | 用量统计页重排 |
| @AkimioJR | MCP 显示名称 |
| @minimote | 会话分组标题 |
| @StrengW | Codex 会话请求头 |
| @clarkchen | 百炼模型列表 |
| @allenxu09 | 钥匙串条目修复 |
更多问题报告者与完整技术细节见 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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
