CC Switch v4.0.19 完整指南：Kimi Code 原生接入、多账号绑定与用量页重排一次讲清-优快云博客

CC Switch v4.0.19 完整指南：Kimi Code 原生接入、多账号绑定与用量页重排一次讲清

【免费下载链接】cc-switch A 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 发布：Kimi Code 接入、Kimi 官方多账号绑定、用量统计页重排为三大重点，另修复 4 个长期痛点。本文给出功能详解、升级须知与安装方式。

版本亮点速览

本版共 45 commits，206 files changed，+15,661/-2,347 行。

功能点	影响谁	一句话说明
Kimi Code（命令 `kimi`）接入	Kimi Code CLI / 桌面版用户	成为第 12 个受管应用，供应商、MCP、Skills、提示词、会话、用量原生读写 `~/.kimi-code/config.toml`
Kimi 官方多账号绑定	持有多个 Kimi 订阅的用户	账号数量不限，各自独立凭据槽位、供应商与额度显示
用量统计页重排	所有看用量统计的用户	范围条 + 指标条 + 页签式明细面板，旧「设置」页签删除
聚合模式跨协议切换修复	聚合模式从第三方 GPT 切 direct 模型的用户	修复每轮 `unsupported call: exec`（#8676）
Linux/WSL「关于」页卡死修复	从终端拉起应用的用户	版本探测不再占用控制终端，SIGTTIN 挂起消失（#3241）

Kimi Code：供应商配置与官方账号管理

Kimi Code 供应商三步配置

解决什么问题：此前 ~/.kimi-code/config.toml 只能手改，多个供应商无法共存。

现在能做什么：供应商以原生 [providers] / [models] 条目写入配置，多卡共存；「添加」不改 default_model，「移除」「设为默认」都在卡片菜单里。

操作步骤：

「添加供应商」里选 Kimi Code 预设。按「模型厂商 / 第三方平台 / 云服务商 / 本地」分组，另有「账号登录」分组直达官方登录。
点「获取模型列表」逐行勾选模型：上下文窗口、思考、图片输入自动填充；每模型一行，display_name 即 Kimi Code /model 里显示的文本。
点「添加」写入配置；之后在卡片更多菜单里「设为默认」或「移除」。

写入纪律是读取-修改-原子写回（见 kimi_config.rs）：文件里 providers、models 若不是对象，整体拒绝写入；已有原生节点绝不用存储副本覆盖。「始终思考」「按需加载工具」带表单内说明，请求头移入「高级选项」；MCP 支持 stdio、HTTP、SSE 三种传输。

注意这些限制：

没有本地路由，也没有聚合模式：Kimi Code 不走 CC Switch 代理，相关能力对该应用显式不适用。
持有 default_model（或子代理模型）的供应商不能移除；被拒时程序会重读 config.toml，并在四种语言里说明原因。
「应用」页的安装 / 升级 / 卸载走官方安装器，安装状态以本机探测为准。

多账号绑定与切换方法

解决什么问题：多个 Kimi 官方订阅此前要手动来回切换凭据。

现在能做什么：认证中心可登录任意数量账号。第一个账号占用 Kimi Code 自己的 managed:kimi-code 登录位；之后每个账号有独立凭据槽位，供应商键为 Kimi 订阅 <昵称>，每行与每张官方卡显示昵称和额度。已在 Kimi Code 里登录的账号会自动出现在列表。

操作步骤：

认证中心选「登录 Kimi」（添加供应商里的「Kimi Code 官方登录」预设同样跳来），选国内版或海外版。
浏览器里完成设备码授权，登录成功后自动添加官方模型。
点「使用此账号」或卡片菜单「设为默认」，切换 Kimi Code 的默认模型。

账号标签（user id、昵称、头像）缓存在应用配置目录的 kimi_accounts.json（0600、设备本地、绝不参与云同步），只用于给账号贴标签；Kimi 自己的配置与凭据文件始终是事实源（见 account.rs）。令牌临期时在 Kimi 自己的锁 <slot>.lock 下续期，不与 Kimi Code 抢锁。

重登与删除的行为边界：

CC Switch 绝不替 Kimi 退出登录：移除「首个账号」只把它从列表隐藏，Kimi Code 里的登录原样保留；隐藏钉到具体账号，换人占用同一槽位时会重新出现。
同一账号重登更新原槽位，不产生第二份，自定义字段保留。
删除单独添加的账号，其供应商节点、模型、凭据与卡片一并删除；正在使用中则拒绝。
官方卡只能在认证中心管理，供应商页不开放编辑与删除。

⚠️ Windows 上令牌不自动续期（锁只读），过期需重登——这是与 macOS/Linux 的实质差异。

用量统计页重排：旧页签都去哪了

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

范围条：日期在最前，应用为 chips，供应商 / 模型合成一个两级级联菜单。
右上角收敛：只留一个同步按钮（旁标上次同步时间）与一个设置入口；数据来源、显示、价格设置移入设置；旧「设置」页签删除。
指标条驱动双图：点选哪个指标，趋势图与热力图就显示哪个；输入 / 输出 / 缓存读 / 缓存写四项 Token 可展开为第二行；两图配色保持 4.0.16 之前的样式。
明细面板页签化：「请求日志 / 供应商 / 模型」三页签带数量；表格按内容宽度排布、超宽横向滚动，时间与应用两列固定左侧。
请求日志：列选择移入状态筛选右侧的菜单；每页条数可选 10 / 20 / 50 且记住选择；空值显示「—」。

问题修复清单

功能缺陷

聚合模式每轮报 unsupported call: exec（#8676）→ 所有第三方聚合行共用一个 comp_hash，从带 tool_mode: "code_mode_only"（shell 调用记为 exec）的镜像官方行切到只有 exec_command 的 direct 行时跳过压缩，新模型照抄了历史里不存在的调用 → 现按工具协议分组 cc-switch-<tool_mode>，direct 行沿用 cc-switch（见 codex_config.rs 的 join_stack_history）。边界：跨组切换要求上一家在线做压缩，其不可用时压缩失败（#8485 在这条路径上回来）；组内切换不压缩，新开会话可绕开。
Codex 选模型后图片输入被关（#8682）→ 元数据报「仅文本」时写入了 inputModalities: ["text"]，Codex 视之为禁用图片且表单无开关可撤销 → 现只在元数据含 image 时填写，其余交给 Codex 默认判断。
VS Code 扩展经 Responses 上游报 Unsupported content type: redacted_thinking（#8691）→ 加密-only 推理改为带签名的空 thinking 块，回放字节一致；只在 output_item.done 到达的摘要文本一并恢复。
叠开多个全屏面板时一次 Esc 全部关掉 → 现只关最上层。
第二个深链接的确认框被误关（#8696）→ 第一个导入完成不再影响第二个的确认框。
请求日志总数变少后表格空、回不去 → 页码回退到末页。

平台问题

Linux/WSL 打开「关于」整应用卡死（#3241）→ $SHELL -lic 版本探测保留控制终端，被 SIGTTIN 停止 → 探测以空 stdin、独立会话运行，10 秒硬超时。
Windows 刷新闪黑色控制台（#8700）→ Antigravity 额度刷新与模型列表获取不再闪黑色控制台窗口。
Hermes 配置目录指向 WSL 时误启动 Windows 端 Hermes（#8689）→ 目录指向 \\wsl$ / \\wsl.localhost 时改在对应发行版内跑 hermes dashboard。
macOS Claude 订阅额度读错钥匙串条目（#8762）→ 同名多条时可能命中只存 MCP 登录的旧条目 → 查找改为 -a $USER 优先，跳过无 Claude OAuth 令牌的分项，兜底凭据文件逻辑不变。

兼容与数据

中转模型元数据借用别家托管条目（#8765）→ canonical_model_id 指向其他厂商的分项现被跳过（deepseek-v4.1-flash-1017 不再被套用 262144 窗口的文本-only LoRA 条目）。
Codex 路由认不出 session-id / thread-id 头（#8718）→ 此前只认 session_id、x-session-id，现两者均识别。
百炼 / 千问 Token Plan 从 /apps/anthropic 地址取不到模型列表（#8755）→ 补试 {root}/compatible-mode/v1/models。
OpenCode Zen / Go 模型参数补不全 → models.dev 更换了这两家的地址，旧地址映射到新路径后 deepseek-v4.1-flash 等可再自动填充。
Antigravity 官方卡额度缺 Gemini 组 → Google 自 1.2.0 起只向 antigravity/cli/<version> 返回 Gemini 组，请求 UA 改为 cc-switch/<version> (antigravity/cli/<agy 本地版本>)。
用量 7/14/30 天预设在夏令时切换前后多算或少算一天（#8719）→ 改按日历日计算。

交互与显示细节

MCP 自定义显示名称在列表与删除确认中生效（#8692）；会话项目分组标题整行可点击（#8709）。
Pi 供应商标识始终显示、预设预填；与其他 Pi 卡重复时当场拦下不可保存。
OpenCode / OpenClaw「设为默认」从星形图标移入卡片更多菜单（多模型供应商带子菜单）；OpenCode、OpenClaw、Hermes、Kimi Code 四个累加型应用的默认供应商改用与「使用中」同色标识。
预设新增 BuyToken、V-API。
「应用」页不再为未安装工具多出一行「not installed」；「高级选项」按下时文字不再跳动。

升级与兼容须知

数据库迁移 schema 21 → 22：mcp_servers 与 skills 各加 enabled_kimi（BOOLEAN NOT NULL DEFAULT 0），迁移前自动建备份。

⚠️ 本版运行过一次后，旧版本会拒绝打开该数据库；回滚必须先还原自动备份再降级。

若设置了 KIMI_CODE_HOME：Kimi Code 的供应商、账号都写在该目录而非 ~/.kimi-code，备份时别漏。
若不使用 Kimi Code：侧栏默认显示它，需在「应用」页关闭「在侧栏显示 Kimi Code」。
若持有带 default_model 或子代理模型的供应商：先在 Kimi Code 里换掉再移除卡片，否则移除被拒。
Kimi Code 原生目录有同名 Skill 时，同步拒绝覆盖，属预期行为。
MCP 与 Skills 的 enabled_kimi 开关默认关闭（初值 0），存量条目不会突然出现在 Kimi Code 里。

⚠️ 若内置官方卡的账号在 Windows 上长时间未刷新，升级后额度可能显示过期——先在认证中心重登一次再依赖其配额显示。

合规说明：Kimi 官方账号登录使用 Kimi 自有 OAuth（设备码 + 浏览器授权），刷新在其锁保护下进行；CC Switch 只有只读展示与槽位内更新，不执行登出。配额查询均为只读，不改变订阅侧任何状态。官方渠道仅为官网 ccswitch.io 与项目开源仓库及其 Releases 页面——任何向你收费、要求充值或索取登录凭据的「CC Switch」网站或客户端均为假冒。

下载与安装

系统要求：Windows 10+（x64/ARM64）、macOS 12+（Intel/Apple Silicon）、Linux（x64/ARM64）。

系统	推荐制品	说明
Windows	`CC-Switch-v4.0.19-Windows.msi`	MSI 安装包，支持应用内更新
Windows	`CC-Switch-v4.0.19-Windows-Portable.zip`	便携版，不写注册表
macOS	`CC-Switch-v4.0.19-macOS.dmg`	拖入 Applications
macOS	`CC-Switch-v4.0.19-macOS.zip` / `.tar.gz`	Universal Binary / Homebrew
Linux	`.deb` / `.rpm` / `.AppImage`（x86_64 与 arm64）	按发行版选择

# macOS
brew install --cask cc-switch      # 安装
brew upgrade --cask cc-switch      # 升级

# Linux（按 uname -m 选架构）
sudo apt install ./CC-Switch-*.deb  # Ubuntu/Debian 系
sudo dnf install ./CC-Switch-*.rpm  # Fedora/RHEL 系

常见问题 FAQ

问：Kimi Code 命令行版和桌面版是同一套配置吗？ 答：是。两者共用 ~/.kimi-code/config.toml 与登录；在 CC Switch 里添加的供应商、MCP、Skills、提示词和官方账号两个版本都能直接用。设置了 KIMI_CODE_HOME 时，一切写向该目录。

问：移除第一个 Kimi 账号，会把 Kimi 登出吗？ 答：不会。CC Switch 绝不替 Kimi 退出登录，只把该账号从列表隐藏，Kimi Code 里的登录原样保留。

问：为什么某张供应商卡片移除不了？ 答：该供应商正被 Kimi Code 用作 default_model 或子代理模型。先在 Kimi Code 里换掉，再移除；被拒时程序会重读 config.toml 并说明原因。

问：升级后能直接退回旧版本吗？ 答：不能。本版把 schema 21 迁到 22 且迁移前自动备份；升级运行过一次后旧版本拒绝打开该数据库，必须先还原自动备份再降级。

问：为什么我的 MCP 和 Skills 没出现在 Kimi Code 里？ 答：本版的 enabled_kimi 开关默认关闭（初值 0），存量条目不会自动生效，需手动打开开关。

延伸阅读

文档：添加供应商、用量统计、v4.0.19 发布说明、CHANGELOG
源码：Kimi Code 配置读写、Kimi 账号管理、聚合历史分组

致谢：@funkpopo（Kimi Code 支持、Kimi 官方账号）、@94mashiro（用量统计页重排）、@AkimioJR（MCP 显示名称）、@minimote（会话分组标题）、@StrengW（Codex 会话请求头识别）、@clarkchen（百炼 Token Plan 模型列表）、@allenxu09（Claude 订阅钥匙串条目）；另有十余位贡献者提供了问题报告、复现信息与修复思路。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考