{"full_name":"farion1231/cc-switch","owner":"farion1231","name":"cc-switch","url":"https://github.com/farion1231/cc-switch","description":"A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode,DeepSeek Harness and more. Only official website: ccswitch.io","homepage":"https://ccswitch.io","topics":[],"language":"Rust","license":"MIT","avatar":"https://avatars.githubusercontent.com/u/44939412?u=730e85639662b2f4e29a6b1b1c92c1b9461baa10&v=4","created_at":"2025-08-04T14:16:16Z","pushed_at":"2026-11-10T02:19:52Z","metrics":{"stars":153231,"forks":10068,"watchers":268,"issues":6150,"prs":2805,"releases":84,"issues_open":null,"issues_closed":null,"prs_open":null,"prs_closed":null,"prs_merged":null,"discussions":264},"growth":{"day":{"stars":277,"forks":16,"base_day":"2026-11-09"},"week":{"stars":2027,"forks":123,"base_day":"2026-11-03"}},"history":{"dates":["2026-10-12","2026-10-13","2026-10-14","2026-10-15","2026-10-16","2026-10-17","2026-10-18","2026-10-19","2026-10-20","2026-10-21","2026-10-22","2026-10-23","2026-10-24","2026-10-25","2026-10-26","2026-10-27","2026-10-28","2026-10-29","2026-10-30","2026-10-31","2026-11-01","2026-11-02","2026-11-03","2026-11-04","2026-11-09","2026-11-10"],"stars":[140514,140760,141335,141894,142425,143264,143761,144242,144707,145192,145533,146319,146778,147208,147654,148023,148309,148951,149359,149722,150055,150383,151204,151506,152954,153231],"forks":[9436,9444,9465,9476,9499,9533,9556,9570,9585,9611,9630,9665,9691,9713,9726,9742,9764,9795,9822,9833,9856,9881,9945,9969,10052,10068],"watchers":[260,260,261,262,264,265,263,263,264,266,266,264,265,266,266,266,261,261,263,263,263,263,263,264,268,268],"issues_open":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null],"prs_open":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null]},"boards":{"daily":127,"weekly":64,"monthly":44,"weekly_rate":196,"monthly_rate":153,"total":65},"same_owner":[],"issues":[{"number":1855,"title":"🗺️ New CLI Tool Support Tracker / 新 CLI 工具支持追踪","comments":201,"created_at":"2026-04-02T15:17:07Z"},{"number":4043,"title":"希望添加同时设置wsl和本机的配置","comments":38,"created_at":"2026-06-11T02:12:41Z"},{"number":4205,"title":"支持ZCode Agent应用","comments":25,"created_at":"2026-06-15T01:30:56Z"},{"number":7459,"title":"Codex 桌面端内置工具 automation_update 顶层 oneOf schema 被上游拒绝（HTTP 400）","comments":18,"created_at":"2026-09-17T06:42:31Z"},{"number":791,"title":"新功能需求：增加claude plugins管理","comments":18,"created_at":"2026-01-26T12:46:31Z"},{"number":2334,"title":"webui和cli","comments":17,"created_at":"2026-04-25T17:11:36Z"},{"number":1678,"title":"Claude Code Auto Mode Classifier Compatibility Issue","comments":16,"created_at":"2026-03-25T10:00:31Z"},{"number":3996,"title":"3.16.2版本使用 阿里云存储s3无法正常连接","comments":16,"created_at":"2026-06-10T06:05:01Z"}],"discussions":[{"number":9301,"title":"UI太丑了","comments":0,"category":"General","created_at":"2026-11-07T03:48:59Z"},{"number":9284,"title":"能不能增加用户功能，这样我在不同电脑只需要登录就能同步各种api的配置，以及我自己做的各种skill和MCP了。","comments":0,"category":"Ideas","created_at":"2026-11-06T09:20:21Z"},{"number":9278,"title":"【经验分享】Claude Desktop通过CC Switch接入第三方模型,和模型为空排错经验","comments":0,"category":"Show and tell","created_at":"2026-11-06T07:39:09Z"},{"number":9271,"title":"建议能够增加远程管理和路由/聚合能力","comments":0,"category":"Ideas","created_at":"2026-11-06T03:58:48Z"},{"number":9223,"title":"聚合","comments":0,"category":"Q&A","created_at":"2026-11-04T08:49:22Z"},{"number":9207,"title":"Show & tell: Managing PingCode AI configs for Claude Code & Codex with CC Switch","comments":0,"category":"Show and tell","created_at":"2026-11-04T02:29:58Z"},{"number":9166,"title":"支持切换定义的projects","comments":0,"category":"Ideas","created_at":"2026-11-02T15:24:14Z"},{"number":9035,"title":"[资源分享] 切换 API 前核对模型报价与来源；附 Codex 配置排查","comments":0,"category":"Show and tell","created_at":"2026-10-29T08:06:51Z"}],"latest_release":{"name":"CC Switch v4.0.28","tag":"v4.0.28","published_at":"2026-11-08T15:56:25Z","body":"# CC Switch v4.0.28\n\n本版本主要应对 Codex 11 月 8 日的不兼容更新。\n\n> ⚠️ **Codex 桌面版 26.1103、CLI 0.167 起，官方订阅和第三方供应商的会话彻底分开了。** 直连模式下在两者之间切换，以前只是两边的会话分开显示，现在另一边的会话直接变成只读：能查看，不能继续，继续时提示「模型提供商不匹配」。要来回切换并继续旧会话，有两个办法：\n>\n> 1. **改用路由或聚合模式**：本版本起，路由或聚合模式下切到第三方，会话和官方订阅留在同一组，来回切换都能继续。\n> 2. **打开「统一 Codex 会话历史」**（「设置 → 应用配置 → Codex」）：官方和第三方的会话归到同一组，直连模式下也能来回切换。\n\n此外，直连切换让会话变成只读时会提示数量；开启「统一 Codex 会话历史」并勾选迁入现有会话后，会持续把官方会话迁进来。官方额度用完、Codex 锁住发送键时，可以在路由或聚合设置里打开「暂停使用官方登录」，继续用第三方模型；官方额度保护改为默认开启。应用页的安装和升级会显示排队状态和实时进度。另外修复了 Codex 故障转移到别家时仍带着上一家的模型名、Kimi For Coding 上压缩失败、在 Kimi 或 DeepSeek 上续接工具调用后会话一直报 400 等问题。\n\n**[English →](https://github.com/farion1231/cc-switch/blob/main/docs/release-notes/v4.0.28-en.md) | [日本語版 →](https://github.com/farion1231/cc-switch/blob/main/docs/release-notes/v4.0.28-ja.md)**\n\n---\n\n## 新增\n\n### 适配新版 Codex 的会话分组\n\nCodex 按供应商标识记录会话：官方订阅记在内置的 `openai` 下，CC Switch 写入的第三方供应商记在 `custom` 下。新版 Codex 只能继续与当前供应商同一组的会话，另一组只读（[#7974](https://github.com/farion1231/cc-switch/issues/7974)）。本版本围绕这一点做了以下改动：\n\n- **路由或聚合模式下切到第三方，会话不再分成两组**：本机登录了 ChatGPT、且没有开「统一 Codex 会话历史」时，路由到第三方也和官方一样写成内置的 `openai`，请求照常经本地路由发往第三方，所有会话都在 `openai` 这一组。第三方的 Key 由本地路由替换，ChatGPT 的账号 ID、组织等请求头会被去掉，第三方收不到你的账号信息。\n  - 以下情况仍写成 `custom`：本机没有 ChatGPT 登录、开着统一会话历史、打开了「暂停使用官方登录」，或者供应商配置里写了请求重试、流重试、流空闲超时、远程压缩这些内置 `openai` 表达不了的设置。\n  - 已经在用路由模式的不用操作，CC Switch 下次接上路由时会自动改写一次。直连模式不变。\n- **直连切换后提示有多少会话只能查看**：没开统一会话历史时，直连模式下在官方订阅和第三方之间切换，切换成功的提示里会多一行，例如「之前在官方订阅下的 12 个会话现在只能查看」。从托盘切换不提示。\n- **统一 Codex 会话历史**（「设置 → 应用配置 → Codex」）：开启后官方订阅也改用 `custom` 标识，两边的会话在同一组，新版 Codex 里都能继续。经常在官方和第三方之间切换时建议开启。\n  - 「同时迁入现有官方会话历史」改为默认勾选。勾选后，之后每次启动 CC Switch 都会把又出现在官方组的会话迁进来，比如关掉再打开过这个开关，或者不经 CC Switch 用过 Codex。\n  - 迁移和还原前都要备份 Codex 的会话数据库，以前 42 MB 的数据库要备份约 90 秒，现在不到 1 秒。\n  - 后台迁移完成后会提示迁入了多少个会话，重启 Codex 后就能继续。\n\n### 暂停使用官方登录（Codex）\n\n官方 ChatGPT 额度用完后，Codex 会自己查额度，锁住模型选择和发送键，选了第三方模型也发不出去（[#7974](https://github.com/farion1231/cc-switch/issues/7974)、[#7962](https://github.com/farion1231/cc-switch/issues/7962)）。这一步在 Codex 客户端里，本地路由管不到；以前手动把 `requires_openai_auth` 改成 `false` 的办法，现在切换一次就会被覆盖。\n\n现在 Codex 的「路由设置」和「聚合设置」（路由或聚合模式生效时，模式标签栏右端的齿轮按钮）最上面多了「暂停使用官方登录」开关：\n\n- 打开后 Codex 不再使用官方登录，不会因为官方额度锁住发送键，聚合和路由里的第三方模型可以继续用。官方登录仍保存在本机，不会退出。\n- 打开期间，官方模型发不出去，会提示改用第三方模型；Codex 里不显示账号和用量信息，第一次打开可能弹出新手问卷；侧栏「项目」里原来的会话暂时看不到，关掉开关后会回来；新会话记在 `custom` 组，切回官方后只能查看。\n- 打开期间 Codex 页面顶部会一直有提示，官方额度恢复后点「恢复官方登录」即可。\n- 打开和关闭后都要彻底退出并重新打开 Codex。只在路由和聚合模式下生效，直连不受影响。\n\n### 应用页显示安装进度\n\n应用页的安装、升级和卸载一次只跑一个，以前慢的时候每一行都在转圈，分不清是在下载、在排队还是卡住了（MiniMax Code 的安装包约 100 MB，网络慢时要十几分钟）。现在排队的那一行会写「排队中，等前一个应用完成」，正在跑的那一行显示已用时间和命令输出的最新一行。离开应用页再回来，进度还在。\n\n---\n\n## 变更\n\n- **官方额度保护改为默认开启**：经本地路由的 Codex 官方请求，在五小时使用率达到 95% 或每周使用率达到 98% 时就会暂停，第三方模型照常可用，避免走到 Codex 锁住发送键那一步。升级后会自动打开一次；之后手动关掉，不会再被打开。阈值在「设置 → 应用配置 → Codex → 官方额度保护」里改。\n- **不再写入 `disable_response_storage`**（[#7524](https://github.com/farion1231/cc-switch/issues/7524)）：新版 Codex 删掉了这个设置，每次启动都会提示有一个无法识别的配置项。预设、模板、统一供应商和一键导入链接都不再写它，已有 `config.toml` 里的这一行在下次切换时清掉。\n- **Antigravity 显示 Argon 每周额度**（[#8913](https://github.com/farion1231/cc-switch/pull/8913)）：Pro 套餐的 Argon 每周额度以前不显示。现在卡片上把它并进 Gemini 那一行，下拉菜单和授权中心单独列出。\n- **Windows 上第一次启动更快**：新建数据库时建表和写入内置模型价格各合成一次提交，第一次启动快了约 6 秒。\n\n---\n\n## 修复\n\n- **Codex 故障转移到别家时，仍带着上一家的模型名，备用供应商报模型不存在**（[#7547](https://github.com/farion1231/cc-switch/issues/7547)）。现在开着故障转移时，换到备用供应商前会先看它认不认请求里的模型（是它自己的模型，或在它的模型列表里），不认就换成它自己的模型；同一个模型的中转队列照原样发。图片生成、图片编辑和搜索请求不换模型。\n- **Codex 经路由连 Kimi For Coding 时，压缩上下文总是失败（HTTP 400）**。Kimi 不接受压缩请求里的 `tool_choice: \"none\"`；现在第三方原生 Responses 上游拒绝压缩请求时，会去掉 `tool_choice` 再试一次。\n- **Codex 在 Kimi 或 DeepSeek 的原生 Responses 上续接工具调用后，这个会话之后每一轮都报 400**。工具调用和它的结果之间夹了一条助手消息，Kimi 和 DeepSeek 都会拒绝整段历史；Kimi 还会拒绝空的助手消息。现在只对 Kimi（Moonshot）和 DeepSeek 的地址整理这类历史，其他请求原样发出。\n- **Windows 上 Codex 目录在 WSL 里（`\\\\wsl.localhost`）时，分叉出来的会话用量一直不导入**。\n\n---\n\n## 致谢\n\n感谢 @allen546（Antigravity Argon 每周额度）、@fisHarly0（SSE 分隔符说明）的贡献。\n\n特别感谢以下贡献者：你们的 PR 发现并修复了真实的问题，只是同样的问题后来在主线上另行修好，PR 因此关闭。@SailingLoong（Codex 故障转移时更换模型，本版的修复参考了这个 PR 的思路）、@xiajiahang（聚合模式拖动排序后重排聚合模型）。\n\n感谢 @erickksun、@Juddd、@EMnian、@shidao-ap5、@LeenixP 报告问题、提"},"readme":true,"readme_zh":true,"news":[{"title":"CC Switch: Claude Code and Codex Provider Switcher","url":"https://github.com/farion1231/cc-switch","hn":"https://news.ycombinator.com/item?id=45861477","source":"Hacker News","lang":"en","date":"2025-11-09","points":3,"comments":0},{"title":"cc-switch：一行命令实现Git多账号与SSH配置的无缝切换","url":"https://blog.csdn.net/weixin_27743991/article/details/167180973","source":"blog.csdn","lang":"zh","date":"2026-10-06"},{"title":"Claude Code + cc-switch + Git + Node.js 一站式完整安装配置教程【8.3】","url":"https://blog.csdn.net/pangzi62732/article/details/163441371","source":"blog.csdn","lang":"zh","date":"2026-08-03"},{"title":"How to Use CC Switch | Switch API Providers for Claude Code / Codex / Gemini CLI in One App [Installation Guide]","url":"https://note.com/like_afterhours/n/n35d5d6bc4aae?hl=en","source":"note","lang":"en","date":"2026-06-13"},{"title":"130万次下载，2万Star开源项目CC Switch，36岁转行程序员Jason的第一个作品","url":"https://news.qq.com/rain/a/20260228A07XMT00","source":"腾讯网","lang":"zh","date":"2026-02-28"},{"title":"CC Switch Hits 104K Stars: One Desktop App for Seven AI Coding Tools","url":"https://news.google.com/rss/articles/CBMiggFBVV95cUxNbGJYRm9iUXV5Q1daNDBjczB4QzlnRlVRVE1zaEQzc2MzMFRCQ09EUTBmdFFGSGhrMnRJdUhjSGljVmg1eXM5T3U4WHdHX29idEZUNWVRdl9qSzBjR3ZDVC1WNVJJN19OUm9NUzZpUnE1ZTNJOGlvNndHYmxuQ0RHQVZ3?oc=5","source":"Augment Code","lang":"en","date":"2026-06-18"},{"title":"GitHub Codex切换节点报错？开源工具Codex++一键修复历史记录与502错误","url":"https://news.google.com/rss/articles/CBMiZkFVX3lxTE1DT2ZqaTl3akh3bDhUZ1VOYjFXRmRjQzAxaTNLUW13Ql92WWRVb2xTRE03c1RyYTlxdUtFak9IRDg5WGJjQ2lwQ0VnaHptUFBuWEQ5cUs1dlVQenFlOFpWaE9IOHJRZw?oc=5","source":"www.80aj.com","lang":"zh","date":"2026-06-05"},{"title":"CC Switch hits 89.1K stars as a unified manager for AI coding CLIs","url":"https://news.google.com/rss/articles/CBMiY0FVX3lxTFBhbjc2Rk1RNGExekhsWC0zSG12ajNsX1lhamprVkJHNDk2N3ZtSUhseHJmdUJEZ1pwMDQzQ3BGeU9MenhwTE1tZE5TaEZkdFBTOVZXSUNiemJTWDM4Sy1LVU1XRQ?oc=5","source":"Augment Code","lang":"en","date":"2026-06-02"},{"title":"开源工具CC-Switch CLI更新：新增WebDAV同步，统一管理多AI模型CLI环境","url":"https://news.google.com/rss/articles/CBMiakFVX3lxTE43a1AxQ0s3WEYzck9kZmJ2emREY2t3dHhBTVdkaXo2eXJMaUpHaXpSbW5KSFlSemdZeFVyN3VEdlc3VDlLVkpIbmN1a2V0Z3l4RUZSMy04Qzh3eDlTc3o4b3dvejg4UFh0b1E?oc=5","source":"80aj.com","lang":"zh","date":"2026-05-20"},{"title":"CC Switch hits 75K stars: why developers are unifying their AI coding CLIs","url":"https://news.google.com/rss/articles/CBMid0FVX3lxTE16Z0tvWlFRb0htdXM5YVlGQTRGZTl5dW9ITGZXRWFRZzVudW0wRVZtMTRSbExOOVE0alVNN3dCdnZGbVlNOXd0M0I2MFN3TzA1bnNCM2x3OTVsaVdlZlVvQmUwbFBacEZ0YVdFam1qenkwdENqX1c0?oc=5","source":"Augment Code","lang":"en","date":"2026-05-19"},{"title":"CC Switch hits 67.2K stars as a unified manager for AI coding CLIs","url":"https://news.google.com/rss/articles/CBMiY0FVX3lxTE5LVm5WaXdMSHNrRGJHYnE1SVM2UHFDV09CS0psNGJ1Qy1HdnFGZU1QdUNmMm5aOFRMdDgydGtYdGFMUktCZUlTSDRVZ2EwZ0xOWWYwNDBvSEJLVTJwRElTd3k2WQ?oc=5","source":"Augment Code","lang":"en","date":"2026-05-11"},{"title":"这个51K星标的开源神器，让任何Agent都能一键切换所有模型","url":"https://news.google.com/rss/articles/CBMiVkFVX3lxTE8xNHFBaV9peHNrRHY4S2kzNUdEQlVLTjNCa1k3TThacE81YTBrWGxEQXUxb0VFbXVnejc1SHdIWUNaXzE0MWpQRndqWEVHTW1LY1F2RXFB?oc=5","source":"投资界","lang":"zh","date":"2026-04-28"},{"title":"How to Connect Claude Code to Alternative APIs","url":"https://news.google.com/rss/articles/CBMigwFBVV95cUxPdkFkdlY3VlVBWF8wcnVxTTNUZklCV0U2cTFjNE1WRzhJYTU1UTZEZzRZS1dLT3YtUzdxTHI0blRwWnQxbk9fMEdHR1NlZTF0T0R1cmFBNTJZbkpLemt2WWIyeDZvS2FFcmQtQU9QcmxQdEVUQWJQMG12Q2tMRU5ka2V5MA?oc=5","source":"Tricontinental: Institute for Social Research","lang":"en","date":"2026-04-24"},{"title":"Codex登录又崩了？零基础用CCSwitch秒连教程","url":"https://news.google.com/rss/articles/CBMiV0FVX3lxTE1DT25aY1VJeE9YWlEtSnhBY2hFYWprTXVuZGZkRVN1eTBnaFpiVnBxaGs0UlFXdFllc3hzSy1qVUZPeTltNWpQMFVocU1xNmFLUUxsVGRLNA?oc=5","source":"view.inews.qq.com","lang":"zh","date":"2026-04-21"},{"title":"Claude Code保姆级入门：不会命令行也能用，我把5个必学技巧全整理好了","url":"https://news.google.com/rss/articles/CBMiVkFVX3lxTE9jNG9pdFNpd3ZKOHN6V3ZPUnpDSlQxWlJTUHlIei1Tc2l0VmRodXFnQUZ5QnhxVDRXYTItdlp6OGJlRGFQamFZWTdfeHoycHNPY1lYdWdR?oc=5","source":"QQ News","lang":"zh","date":"2025-12-01"}],"stale":false,"snapshot_at":"2026-11-10T09:35:25Z","history_start":"2026-09-06"}