CC Switch v4.0.20 升级指南：13 个 AI 编程工具的供应商一次管完

CC Switch v4.0.20 升级指南13 个 AI 编程工具的供应商一次管完【免费下载链接】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-switchCC Switch v4.0.202026-10-24 发布把 Oh My Pi 纳入为第 13 个受管应用托管 ChatGPT 账号新增浏览器登录。用omp或有多个 Kimi 官方账号的用户应立刻升级只单一供应商使用 Claude Code 或 Codex 的可以等下一版。先看 v4.0.20 改了什么本版共 37 commits、198 个文件变更11737/-3046 行核心是三件事Oh My Pi命令omp的供应商、MCP、Skills、提示词与会话全链路接入「应用」页拆成已安装/未安装两组并支持拖拽排序托管 ChatGPT 账号可用浏览器登录。数据库 schema 从 22 升到 23升级前自动备份。升级决策按场景对号入座Oh My Piomp)用户必升。此前~/.omp/agent/models.yml只能手改现在多供应商共存写入、MCP/Skills/提示词/会话全接入。Kimi 官方账号用户建议升。官方卡片可以编辑模型、从 Kimi Code 移除无套餐账号显示「未订阅」而不是空白。企业工作区禁用设备码登录的 ChatGPT 用户必升。浏览器登录授权码 PKCE是唯一入口。Linux 上开启「应用级窗口按钮」的用户建议升。修复页头拖不动窗口、边缘无缩放光标#8091。DeepSeek 余额清零后看到「套餐已过期」、Skills 更新一直 429 的用户建议升两者均已修复。与上述都无关的单供应商用户可缓。本版是纯增量功能无破坏性改动。Oh My Pi三步接入供应商管理怎么操作侧栏底部进「应用」页点 Oh My Pi 一行的「安装」官方安装脚本有 Bun 走 Bun否则下官方二进制。安装后侧栏出现 Oh My Pi点进「添加供应商」表单与 Pi 共用预设来自 Pi 目录。「获取模型列表」后在弹窗勾选模型参数自动从预设或 models.dev 补全。填 API 地址与 Key可写环境变量名请求头、「模型自动发现」在「高级选项」里。保存后卡片出现「启用」「移除」多个供应商可同时写进models.yml共存。设计意图models.yml按纯文本编辑只重写 CC Switch 写的那一条其余字节原样保留写入前按 omp 18.12 的 schema 校验api、compat、reasoningEffortMap等枚举值因为 omp 只要一条供应商不合规就停用全部自定义供应商所以非法值在保存时直接拒绝实现见 src-tauri/src/omp_config.rs。数据库提交失败时文件按原字节回滚。哪里会卡住只剩旧版models.json添加供应商会被拒先跑一次omp让它自行迁移CC Switch 不替你新建models.yml挤掉原有供应商。文件里用了 YAML 锚点、标签或 flow 风格的条目不会被重写提示手动修改。MCP 与 Skills 的实际加载量omp 还会从其他工具的目录发现 MCP 和 Skills实际加载的可能比 CC Switch 列出的多MCP/Skills 页 Oh My Pi 一列有说明。本地路由与用量导入不适用Oh My Pi别在这两项找它的开关。托管 ChatGPT 账号浏览器登录怎么走怎么操作「授权中心」或 Codex 供应商表单里添加托管 ChatGPT 账号。「登录方式」选「浏览器登录」设备码登录仍在二选一。浏览器完成授权后回到本机回环回调端口 1455。账号即出现在授权中心托管列表。重新登录同样可选浏览器供工作区禁用设备码的账号使用。设计意图授权码 PKCE、回环回调固定 1455 端口#8288修复 #8284。有些企业工作区关闭了设备码登录这类账号以前根本加不进来现在两条登录路径并存。哪里会卡住1455 端口被占或回环被网络策略拦截回调失败时换设备码登录前提是工作区允许。登录只影响凭据槽位内的凭据CC Switch 不改动订阅侧状态。其他变化与修复额度与余额显示症状DeepSeek 余额为零或欠费时卡片显示「套餐已过期」、余额数字消失。根因DeepSeek 的is_available只表示余额够不够调用Key 本身仍有效。解决余额照常显示Key 真失效仍按认证失败提示#8812零或负数一律显示「余额 金额」卡片红字、托盘橙色。Kimi 账号无套餐时额度栏显示「未订阅」「额度没查到」改为「额度查询失败」卡片、授权中心、托盘同步。用量统计Kimi Code 子代理用量漏计#8792子代理记录写在各自的agents/agent/wire.jsonl以前只读主代理那份。现在全部导入、按messageId逐次记账父级的subagent.completed汇总不重复计算。Antigravity 子代理与 ACP 会话用量记成未知模型#8693现从 agy 本地对话数据库只读找回模型。用量页三个明细页签的数量一次查齐切换应用时不再消失重排。登录与网络Skills 安装/更新持续 HTTP 429#8813下载 GitHub 压缩包时没带 User-Agent 被限流现改发CC-Switch/version。Pi 的 API Key 写成$NAME/${NAME}环境变量引用时额度查询 401#8822以前把引用原样当 Key 发出现按 Pi 规则解析取值变量未设置时发空 Key取值不回写配置!command形式仍不执行。显示与交互Claude Code 会话标题显示成local-command-stdoutSet model to opus/local-command-stdout#8798/#8799会话开头跑过/model这类本地命令所致标题与摘要现跳过注入的本地命令输出。Linux 开启应用级窗口按钮后页头拖不动、无缩放光标#8091。Claude Code / Claude Desktop 选 Copilot 供应商时上游格式锁定为「由路由按模型自动选择」不再给无效手选项#8195。Codex Chat 上游的孤立工具结果里图片占位文字改为「已作为图片附上」#8157。其他小修「应用」页分「已安装 · N」「未安装 · N」两组空组隐藏已安装行可拖拽排序侧栏与默认应用跟随顺序存本机settings.json的appOrder不云同步。Kimi 官方卡片可编辑模型读该账号当前官方目录并可从 Kimi Code「移除」卡片与登录保留「添加」即恢复。Pi 获取模型改为弹窗勾选请求头与兼容选项收进默认收起的「高级选项」。预设刷新到各厂商最新型号价格表新增 Kimi K3.1 Pro 与 K3.1 Pro HighSpeedEveryAPI 赞助预设移除现有供应商图标保留土耳其语翻译补全#8616。动手升级检查、步骤与回滚前置检查确认升级前应用里无未保存的关键操作。schema 22 → 23 会给mcp_servers加enabled_omp列升级前自动建数据库备份。留后路需要回滚能力时手动复制一份~/.cc-switch/backups/里的最新备份到其他位置默认 24 小时间隔、保留最近 10 个。升级应用内检查更新或按平台重装下方制品。验证「应用」页出现 Oh My Pi 行启动无数据库版本告警不用 Oh My Pi 就在「应用」页关掉「在侧栏显示 Oh My Pi」。回滚旧版本拒绝打开 v23 数据库提示「数据库版本过新」。先在「设置 → 数据 → 备份与恢复」还原升级前备份再装回旧版本。检查项判断依据数据库版本升级后为 v23旧版本拒绝打开须先还原备份Oh My Pi 侧栏开关默认显示「应用」页可关models.yml改动范围仅 CC Switch 写入的那条变化其余字节不变应用排序appOrder存本机settings.json不参与云同步备份位置~/.cc-switch/backups/升级前自动备份获取与安装系统制品安装方式Windows 10x64CC-Switch-v4.0.20-Windows.msi双击安装ARM64 用-Windows-arm64.msiWindows 便携CC-Switch-v4.0.20-Windows-Portable.zip解压后运行CC-Switch.exe不写注册表macOS 12CC-Switch-v4.0.20-macOS.dmg拖入「应用程序」或brew install --cask cc-switch、升级brew upgrade --cask cc-switchLinux x86_64CC-Switch-v4.0.20-Linux-x86_64.debsudo apt install ./CC-Switch-*.debLinux x86_64CC-Switch-v4.0.20-Linux-x86_64.rpmsudo dnf install ./CC-Switch-*.rpmLinux 通用.AppImagex86_64 / arm64chmod x后直接运行Linux 需 glibc 2.35 与 WebKitGTK 4.1Ubuntu 22.04、Debian 12 可用。相关文档与致谢相关文档v4.0.20 发布说明、安装指南、CHANGELOG。官方渠道为官网 ccswitch.io 与项目开源仓库的 Releases 页面——任何收费、要求充值或索取登录凭据的「CC Switch」均为假冒。本版感谢贡献 Oh My Pi 支持与 ChatGPT 浏览器登录的开发者以及多位问题报告者。【免费下载链接】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），仅供参考