CC Switch v4.0.19 升级指南：Kimi Code 新用法、升级前 3 项自检与回滚红线

【免费下载链接】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

这是 CC Switch v4.0.19 升级的完整说明：版本发布于 2026-10-23，共 45 commits、206 files changed，代码改动 +15,661/-2,347 行。新版做了三件大事——Kimi Code（命令名kimi）成为第 12 个受管应用、Kimi 官方账号不限数量绑定、用量统计页整体重排，外加一批高影响修复。结论很直接：Kimi Code 用户、手握多个 Kimi 账号的人、聚合模式（把多家模型通过一个本地代理统一调用）下的 Codex 用户建议立即升级；其余用户可以按自己的节奏来。但有一条红线要提前知道：数据库迁移过一次之后，旧版本会拒绝打开它。

一图看懂 v4.0.19 的变化

升级分三档：必升、建议升、可缓

必升（命中任意一条就升）

• 你在用 Kimi Code：此前~/.kimi-code/config.toml只能手动改，现在供应商以原生[providers]/[models]条目写入、多卡共存。
• 你管理多个 Kimi 官方账号：首个账号占据 Kimi Code 自己的managed:kimi-code登录位，之后每个号各有独立凭据。
• 你开着聚合模式、经常在第三方 GPT 与 direct（直连、不经中转）模型之间切换：每轮unsupported call: exec的问题（#8676）在本版修复。

建议升

• Linux/WSL 上习惯从终端拉起 CC Switch：「关于」页导致全应用被停摆的故障（#3241）已修。
• Codex 用户：选完模型图片输入被关（#8682）、macOS 读 Claude 订阅额度出错（#8762）都在这版解决。

可缓

• 以上功能都不沾边、当前版本运行稳定：可以暂时不动。但要留意数据库版本，下文回滚一节有说明。

Kimi Code 怎么配：从添加到设为默认

你会看到什么：侧栏默认出现 Kimi Code 入口（不用可在「应用」页关掉「在侧栏显示 Kimi Code」）；「添加供应商」弹窗里它的预设与其他应用同法分组——模型厂商、第三方平台、云服务商、本地，另有一个「账号登录」分组直达官方登录。

具体怎么操作

• 「获取模型列表」后逐行勾选，上下文窗口、思考能力、图片输入会自动填好；每个模型占一行，display_name就是 Kimi Code 里/model命令显示的文本。
• 卡片上点「添加」只把供应商写进配置、不碰默认模型；「移除」「设为默认」在卡片的更多菜单里。
• 「始终思考」「按需加载工具」两项带说明提示；请求头收进了「高级选项」。
• MCP 的 stdio、HTTP、SSE 三种传输都支持。
• 安装、升级、卸载 Kimi Code 都在「应用」页完成，调用官方安装器，是否装好以本机探测为准。

系统内部做了什么：写入逻辑在 kimi_config.rs，流程是先读整份文件、只改 CC Switch 管的那部分、再原子写回；providers或models不是对象时整体拒绝写入；文件里已有的原生条目绝不会被存储副本覆盖。

边界与例外

• 没有本地路由、没有聚合模式：Kimi Code 不经过 CC Switch 的本地代理，这两项能力对它显式不适用。
• 当前持有default_model（或子代理模型）的供应商移除不了；硬移除会被拒，程序会重读config.toml并用四种语言说明原因。
• 设置了KIMI_CODE_HOME环境变量时，供应商与账号一律写到该目录而非~/.kimi-code。
• MCP 与 Skills 对 Kimi Code 的启用开关enabled_kimi默认关闭，存量条目不会突然出现在 Kimi Code 里；Kimi Code 原生目录里的同名 Skill 也会被同步拒覆盖。

多个 Kimi 官方账号：登录、切换与删除规则

你会看到什么：认证中心多了「登录 Kimi」入口（「添加供应商」里选「Kimi Code 官方登录」预设也会跳过来），选国内版或海外版，浏览器里走设备码授权（设备码：浏览器里输入一串代码完成登录的 OAuth 方式）。列表每行与每张官方卡都显示账号昵称和额度。

具体怎么操作

• 点「登录 Kimi」→ 选版本 → 浏览器完成授权，账号即入列表；Kimi Code 里已登录的号会被自动识别、直接出现。
• 切默认模型：点「使用此账号」，或从卡片更多菜单选「设为默认」。每个新增账号在模型列表里显示为「Kimi 订阅 <昵称>」。
• 同一账号重登：更新原槽位，不产生第二份，自定义字段保留。
• 删除：删掉单独添加的账号，其供应商节点、模型条目、凭据与卡片一并删除；正在使用中会被拒绝。

系统内部做了什么：账号身份（user id、昵称、头像）缓存在应用配置目录的kimi_accounts.json（权限 0600，仅存本机，永不参与云同步），只用来给账号贴标签——Kimi 自己的配置与凭据文件始终是事实源，实现见 account.rs。令牌临期时在 Kimi 自己的锁文件（<slot>.lock）下后台续期，不与 Kimi Code 抢锁。

边界与例外

• CC Switch 从不替 Kimi 退出登录：移除「首个账号」只是把它从列表隐藏，Kimi Code 里的登录原样保留；隐藏状态绑定在具体账号上，别人换人占用同一槽位时，原账号会重新出现。
• ⚠️ Windows 上那把锁是只读的，令牌不自动续期——过期只能重登。这是它与 macOS/Linux 的实质差异。
• 官方卡片只能在认证中心管理，供应商页对它们不开放编辑与删除。

用量统计页大改：一行范围、一行指标、三个页签

一句话先定调：界面布局全新，数据口径没变；习惯在旧「设置」页签里找东西的人要重新学一次位置。

你会看到什么

• 最上面一行放筛选条件：日期控件在左首，应用以 chip（可点击的小标签）呈现，供应商和模型两个下拉合并成一个两级菜单。
• 右上角只留两样东西：一个同步按钮（旁边标注上次同步时间）和一个设置入口；数据来源、显示、价格配置全部移入设置面板；旧「设置」页签从此消失。
• 指标条是双图总开关——点哪个指标，趋势图与热力图就切到哪个；输入、输出、缓存读、缓存写四项 Token 可展开成第二行；两图配色保持 4.0.16 之前的样式。
• 明细区拆成「请求日志 / 供应商 / 模型」三个页签，各带数量角标；表格按内容宽度排布，超宽时横向滚动，时间与应用两列钉在左侧。
• 请求日志里，列的显隐改在状态筛选右侧的菜单里选；每页条数可选 10/20

【免费下载链接】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