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、提示词自动同步,会话可以浏览和恢复,用量(输入、输出、缓存、首字时间、耗时)从会话日志导入。
手把手操作
- 侧边栏切到 Kimi Code,进入其供应商页,点「添加供应商」。
- 预设按「模型厂商 / 第三方平台 / 云服务商 / 本地」分组,另有「账号登录」分组直达官方登录。
- 选中预设后点「获取模型列表」,逐行勾选模型,上下文窗口、思考深度、图片输入自动填好;每模型可填显示名称,它决定 Kimi Code
/model里显示的文字。 - 「始终思考」「按需加载工具」旁有「?」说明;请求头移进了「高级选项」。
- 「添加」只写供应商、不动
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 里登过的账号会自动出现在列表。
手把手操作
- 侧边栏进「授权中心」,点「登录 Kimi」(在「添加供应商」里选「Kimi Code 官方登录」预设,也会跳到这里)。
- 选国内版或海外版,浏览器走设备码授权,完成后自动添加官方模型。
- 重复第 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 里的登录原样保留;删除单独添加的账号会连带删除其供应商节点、模型、凭据与卡片,正在使用中则拒绝。
用量统计页改版:数据口径没变,位置都变了
布局全变,数据口径未变。依赖旧「设置」页签的操作需要重学一次;旧「设置」页签已删除。
它替你解决了什么
筛选条件散在多行、同步与设置入口各占一处的旧版式,查数时要来回跳转。新版把范围、指标、明细各归其位:选什么指标,趋势图与热力图就显示什么。
手把手操作
- 打开用量统计页,最上方范围条:日期在最前,应用为 chips,供应商 / 模型合成一个两级级联菜单。
- 右上角只留一个同步按钮(旁标上次同步时间)与一个设置入口;数据来源、显示、价格设置移入设置。
- 指标条点选指标,驱动趋势图与热力图;输入 / 输出 / 缓存读 / 缓存写四项 Token 可展开为第二行。
- 明细面板分「请求日志 / 供应商 / 模型」三页签,标签带数量;表格按内容宽度排布,超宽横向滚动,时间与应用两列固定左侧。
- 请求日志的列选择移入状态筛选右侧菜单,每页条数可选 10 / 20 / 50 且记住选择,空值显示「—」。
底层做了什么
改版集中在 src/components/usage/ 的前端组件;页面语义参考 docs/user-manual/zh/4-proxy/4.4-usage.md。
哪些情况不适用
趋势图与热力图配色保持 4.0.16 之前的样式,不跟随新版式变化。7 / 14 / 30 天预设改按日历日计算,消除了夏令时切换前后多算或少算一天的偏差(#8719)。
顺手修掉的毛病
- 聚合模式从第三方 GPT 切到 direct 模型后 Codex 每轮报
unsupported call: exec(#8676)→ 根因是所有第三方聚合行共用一个comp_hash,切到只有exec_command的 direct 行时跳过压缩 → 提醒:现按工具协议分组(cc-switch-<tool_mode>),跨组切换要求上一家在线做压缩,不可用时压缩会失败,组内切换不压缩、新开会话可绕开。 - Linux / WSL 从终端启动后开「设置 → 关于」整个应用卡死(#3241)→ 根因是版本探测保留控制终端,被 SIGTTIN 停止 → 探测改以空 stdin、独立会话运行,10 秒硬超时。
- Codex 选模型后图片输入被关(#8682)→ 元数据报「仅文本」时曾写入
inputModalities: ["text"],表单又无开关可撤销 → 现只在元数据含 image 时填写,其余交给 Codex 默认判断。 - 中转模型误填别家参数(#8765)→
canonical_model_id指向其他厂商的分项被沿用(如deepseek-v4.1-flash-1017被套上 262144 窗口的文本-only 条目)→ 现跳过这类条目,相关字段留空。 - Claude Code VS Code 扩展经 Responses 上游报
redacted_thinking(#8691)→ 加密-only 推理转成了扩展不认识的格式 → 改为带签名的空thinking块,回放字节一致,摘要文本在output_item.done到达时一并恢复。 - macOS Claude 订阅额度查询失败(#8762)→ 钥匙串同名多条时可能命中只存 MCP 登录的旧条目 → 查找改为
-a $USER优先,跳过无 Claude OAuth 令牌的分项,兜底凭据文件逻辑不变。 - Antigravity 官方卡额度缺 Gemini 组 → Google 1.2.0 起只向
antigravity/cli/<version>返回 Gemini 组 → 请求 UA 改为cc-switch/<version> (antigravity/cli/<agy 本地版本>)。 - Codex 会话头只认
session_id、x-session-id(#8718)→ 现新增识别session-id/thread-id;MCP 自定义显示名称在列表与删除确认中生效(#8692)。 - 叠开多个全屏面板时一次 Esc 全关 → 现只关最上层;第一个深链接导入完成不再误关第二个的确认框(#8696)。
- Windows 刷新 Antigravity 额度、取模型列表闪黑色控制台窗口(#8700)→ 已消除;Hermes 配置目录指向
\\wsl$/\\wsl.localhost时,改在对应发行版内跑hermes dashboard(#8689)。 - 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.msi | MSI 安装包,支持应用内更新 |
| Windows | CC-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 |
| macOS | CC-Switch-v4.0.19-macOS.zip/.tar.gz | Universal Binary / Homebrew 源 |
| Linux(x86_64 / arm64) | .deb/.rpm/.AppImage | Ubuntu/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),仅供参考