CC Switch v4.0.19:Kimi 多账号绑定,告别手改 config

发布时间:2026/10/31 14:26:55
CC Switch v4.0.19:Kimi 多账号绑定,告别手改 config

CC Switch v4.0.19:Kimi 多账号绑定,告别手改 config

【免费下载链接】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 个 commit 触及 206 个文件,净增约 1.3 万行。这版把 Kimi Code 正式纳入管理,并支持 Kimi 官方账号多账号绑定;用量统计页换成「范围条 + 指标条 + 页签明细」的新版式。对存量用户一句话:Kimi 重度用户收益最大,其余用户按需升级。

一图速览这版升级

  • Kimi Code 成为第 12 个受管应用,供应商告别手改
  • Kimi 官方账号可多号绑定,昵称额度各看各的
  • 用量统计页全面改版,范围、指标、明细各归其位
  • 聚合模式unsupported call: exec修复(#8676)
  • 数据库 schema 21 → 22,回滚前必须先还原备份

对号入座:你是哪类用户

用户类型建议理由
Kimi Code 用户必升供应商添加、移除、设默认都能在应用内完成,MCP / Skills / 提示词同步,会话可恢复
持有多个 Kimi 官方账号必升每个账号独立凭据槽位与额度显示,切换默认模型只需一次点击
聚合模式跑 Codex,常在第三方 GPT 与其他模型间切换可缓升#8676 修复影响你,但跨组切换依赖上一家在线做压缩,切换习惯要调整
Linux / WSL 习惯从终端启动可缓升#3241 卡死问题修复,不升级也不影响核心功能
Windows 上登录 Kimi 官方账号需注意该端令牌不自动续期,过期需要重登,这是与 macOS / Linux 的实质差异
不用 Kimi Code 的老用户需注意侧栏默认多出一个 Kimi Code 入口,可在「应用」页关掉;MCP 与 Skills 对它的开关默认关闭,存量条目不会突然出现在里面

Kimi Code 供应商管理:一次配好,命令行桌面版都生效

Kimi Code 现在是 CC Switch 的第 12 个受管应用。命令行版(kimi)与桌面版共用同一份~/.kimi-code/config.toml,所以在 CC Switch 里做的任何改动,两边同时生效。

它替你解决了什么

以前~/.kimi-code/config.toml里的供应商只能手写,改错一个键就得手动排查。现在添加、移除、设为默认全部在卡片上完成,MCP、Skills、提示词自动同步,会话可以浏览和恢复,用量(输入、输出、缓存、首字时间、耗时)从会话日志导入。

手把手操作

  1. 侧边栏切到 Kimi Code,进入其供应商页,点「添加供应商」。
  2. 预设按「模型厂商 / 第三方平台 / 云服务商 / 本地」分组,另有「账号登录」分组直达官方登录。
  3. 选中预设后点「获取模型列表」,逐行勾选模型,上下文窗口、思考深度、图片输入自动填好;每模型可填显示名称,它决定 Kimi Code/model里显示的文字。
  4. 「始终思考」「按需加载工具」旁有「?」说明;请求头移进了「高级选项」。
  5. 「添加」只写供应商、不动default_model;已添加卡片在更多菜单里「移除」或「设为默认」。

底层做了什么

写盘逻辑在 src-tauri/src/kimi_config.rs:读取-修改-原子写回,providers与models必须是对象,否则整体拒绝;配置文件里已有的原生节点绝不会被存储副本覆盖。

哪些情况不适用

Kimi Code 不走 CC Switch 本地路由,也没有聚合模式,代理相关能力对该应用显式不适用。持有default_model(或子代理模型)的供应商不能移除,被拒时程序重读config.toml并在四种语言里说明原因。设置了KIMI_CODE_HOME时,一切写向该目录而非~/.kimi-code,备份别漏。

Kimi 官方账号多账号绑定:一个授权中心管所有号

认证中心可以登录任意数量的 Kimi 官方账号,每个号有自己的凭据槽位、供应商键与额度显示。第一个账号用 Kimi Code 自己的登录位;之后每加一个账号,独立凭据,在 Kimi Code 模型列表里显示为「Kimi 订阅 <昵称>」。

它替你解决了什么

家里号、工作号、订阅号过去只能串行登录,切号得重走一遍设备码授权。现在所有账号并排展示,各看各的额度;「使用此账号」或卡片菜单「设为默认」一步切换 Kimi Code 的默认模型。已在 Kimi Code 里登过的账号会自动出现在列表。

手把手操作

  1. 侧边栏进「授权中心」,点「登录 Kimi」(在「添加供应商」里选「Kimi Code 官方登录」预设,也会跳到这里)。
  2. 选国内版或海外版,浏览器走设备码授权,完成后自动添加官方模型。
  3. 重复第 1–2 步登录其余账号;之后用「使用此账号」或卡片菜单「设为默认」切换。

底层做了什么

账号身份(user id、昵称、头像)缓存在应用配置目录的kimi_accounts.json(0600、设备本地、绝不参与云同步),只用于贴标签;Kimi 自己的配置与凭据文件始终是事实源。令牌临期在 Kimi 自己的锁<slot>.lock下续期,不与 Kimi Code 抢锁。实现见 src-tauri/src/services/kimi_oauth/account.rs。

哪些情况不适用

官方卡片只能在授权中心管理,供应商页不开放编辑与删除。Windows 上令牌不自动续期(锁只读),过期需重登——这是与 macOS / Linux 的实质差异。CC Switch 绝不替 Kimi 登出:移除「首个账号」只把它从列表隐藏,Kimi Code 里的登录原样保留;删除单独添加的账号会连带删除其供应商节点、模型、凭据与卡片,正在使用中则拒绝。

用量统计页改版:数据口径没变,位置都变了

布局全变,数据口径未变。依赖旧「设置」页签的操作需要重学一次;旧「设置」页签已删除。

它替你解决了什么

筛选条件散在多行、同步与设置入口各占一处的旧版式,查数时要来回跳转。新版把范围、指标、明细各归其位:选什么指标,趋势图与热力图就显示什么。

手把手操作

  1. 打开用量统计页,最上方范围条:日期在最前,应用为 chips,供应商 / 模型合成一个两级级联菜单。
  2. 右上角只留一个同步按钮(旁标上次同步时间)与一个设置入口;数据来源、显示、价格设置移入设置。
  3. 指标条点选指标,驱动趋势图与热力图;输入 / 输出 / 缓存读 / 缓存写四项 Token 可展开为第二行。
  4. 明细面板分「请求日志 / 供应商 / 模型」三页签,标签带数量;表格按内容宽度排布,超宽横向滚动,时间与应用两列固定左侧。
  5. 请求日志的列选择移入状态筛选右侧菜单,每页条数可选 10 / 20 / 50 且记住选择,空值显示「—」。

底层做了什么

改版集中在 src/components/usage/ 的前端组件;页面语义参考 docs/user-manual/zh/4-proxy/4.4-usage.md。

哪些情况不适用

趋势图与热力图配色保持 4.0.16 之前的样式,不跟随新版式变化。7 / 14 / 30 天预设改按日历日计算,消除了夏令时切换前后多算或少算一天的偏差(#8719)。

顺手修掉的毛病

  1. 聚合模式从第三方 GPT 切到 direct 模型后 Codex 每轮报unsupported call: exec(#8676)→ 根因是所有第三方聚合行共用一个comp_hash,切到只有exec_command的 direct 行时跳过压缩 → 提醒:现按工具协议分组(cc-switch-<tool_mode>),跨组切换要求上一家在线做压缩,不可用时压缩会失败,组内切换不压缩、新开会话可绕开。
  2. Linux / WSL 从终端启动后开「设置 → 关于」整个应用卡死(#3241)→ 根因是版本探测保留控制终端,被 SIGTTIN 停止 → 探测改以空 stdin、独立会话运行,10 秒硬超时。
  3. Codex 选模型后图片输入被关(#8682)→ 元数据报「仅文本」时曾写入inputModalities: ["text"],表单又无开关可撤销 → 现只在元数据含 image 时填写,其余交给 Codex 默认判断。
  4. 中转模型误填别家参数(#8765)→canonical_model_id指向其他厂商的分项被沿用(如deepseek-v4.1-flash-1017被套上 262144 窗口的文本-only 条目)→ 现跳过这类条目,相关字段留空。
  5. Claude Code VS Code 扩展经 Responses 上游报redacted_thinking(#8691)→ 加密-only 推理转成了扩展不认识的格式 → 改为带签名的空thinking块,回放字节一致,摘要文本在output_item.done到达时一并恢复。
  6. macOS Claude 订阅额度查询失败(#8762)→ 钥匙串同名多条时可能命中只存 MCP 登录的旧条目 → 查找改为-a $USER优先,跳过无 Claude OAuth 令牌的分项,兜底凭据文件逻辑不变。
  7. Antigravity 官方卡额度缺 Gemini 组 → Google 1.2.0 起只向antigravity/cli/<version>返回 Gemini 组 → 请求 UA 改为cc-switch/<version> (antigravity/cli/<agy 本地版本>)。
  8. Codex 会话头只认session_id、x-session-id(#8718)→ 现新增识别session-id/thread-id;MCP 自定义显示名称在列表与删除确认中生效(#8692)。
  9. 叠开多个全屏面板时一次 Esc 全关 → 现只关最上层;第一个深链接导入完成不再误关第二个的确认框(#8696)。
  10. Windows 刷新 Antigravity 额度、取模型列表闪黑色控制台窗口(#8700)→ 已消除;Hermes 配置目录指向\\wsl$/\\wsl.localhost时,改在对应发行版内跑hermes dashboard(#8689)。
  11. OpenCode / OpenClaw「设为默认」从星形图标移入卡片更多菜单(多模型供应商带子菜单)→ 四个累加型应用的默认供应商用与「使用中」同色标识;预设新增 BuyToken、V-API。

升级与回滚怎么安排

升级前检查清单:

  • schema 21 → 22 为mcp_servers与skills各加enabled_kimi(BOOLEAN NOT NULL DEFAULT 0),迁移前自动建备份。
  • 设置了KIMI_CODE_HOME的:供应商与账号都写在该目录,备份时别漏。
  • 不用 Kimi Code 的:到「应用」页关掉「在侧栏显示 Kimi Code」。
  • 持有default_model或子代理模型的 Kimi Code 供应商:先在 Kimi Code 里换掉,再移除卡片。
  • Windows 登录过 Kimi 官方账号的:该端不自动续期,令牌过期需重登。
  • Kimi Code 原生目录有同名 Skill 的:同步拒绝覆盖,属预期行为。

回滚条件与前置动作:本版运行过一次后,数据库即升级到 schema 22,旧版本会拒绝打开。需要降级时,先还原迁移前自动生成的备份,再运行旧版本,顺序不能反。

下载与安装

系统制品说明
Windows 10+(x64 / ARM64)CC-Switch-v4.0.19-Windows.msiMSI 安装包,支持应用内更新
WindowsCC-Switch-v4.0.19-Windows-Portable.zip便携版,不写注册表
macOS 12+(Intel / Apple Silicon)CC-Switch-v4.0.19-macOS.dmg拖入 Applications;也可brew install --cask cc-switch
macOSCC-Switch-v4.0.19-macOS.zip/.tar.gzUniversal Binary / Homebrew 源
Linux(x86_64 / arm64).deb/.rpm/.AppImageUbuntu/Debian 系sudo apt install ./CC-Switch-*.deb;Fedora/RHEL 系sudo dnf install ./CC-Switch-*.rpm

配额查询均为只读,不改变订阅侧任何状态。官方渠道只有官网 ccswitch.io 与项目开源仓库及其 Releases 页面——任何向你收费、要求充值或索取登录凭据的「CC Switch」网站或客户端均为假冒。

参考链接:

  • docs/release-notes/v4.0.19-zh.md:本版发布说明全文
  • docs/user-manual/zh/2-providers/2.1-add.md:添加供应商
  • docs/user-manual/zh/4-proxy/4.4-usage.md:用量统计
  • src-tauri/src/kimi_config.rs:Kimi Code 写盘逻辑
  • src-tauri/src/codex_config.rs:聚合模式join_stack_history

【免费下载链接】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),仅供参考