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