CC Switch 版本記錄

• 支援 Kimi Code： 可管理供應商、MCP、Skills、提示詞、會話和用量，同時適用於共用配置的命令列版和桌面版。支援新增多個 Kimi 官方賬號，並顯示暱稱和額度。
• 用量統計： 時間、應用、供應商和模型篩選放在同一行；選中的指標同時控制趨勢圖和熱力圖。明細頁籤顯示數量，請求日誌可選擇每頁 10、20 或 50 條。
• macOS — Claude： 查詢訂閱額度時優先查詢與當前使用者賬號匹配的鑰匙串條目，避免讀到只含 MCP 登入資訊的舊條目。
• macOS — Antigravity： 查詢額度時攜帶本機 agy 版本，補回官方供應商卡片中缺失的 Gemini 額度。
• 升級提醒： 資料庫從版本 21 升至 22，遷移前會自動備份。升級後，舊版應用無法開啟資料庫。

https://github.com/farion1231/cc-switch/releases/tag/v4.0.19

新增 Antigravity CLI（agy）的供應商卡、MCP、Skills、提示詞、會話及用量管理。供應商卡僅對從卡片終端入口啟動的 agy 生效，其他終端仍使用 agy 自身設定。macOS 新增多賬號授權管理，並修復檔案控制代碼耗盡和從訪達啟動時重啟 Codex 守護程序失敗的問題。

Source: https://github.com/farion1231/cc-switch/releases/tag/v4.0.18

修復 Codex 恢復過期登入、MCP 配置併發寫入、僅含 URL 的 MCP 同步至 Hermes/OpenCode，以及 macOS 金鑰自動大寫問題。改進托盤額度顯示並提醒 Hermes 供應商標識衝突；資料庫結構仍為 20。

Source: https://github.com/farion1231/cc-switch/releases/tag/v4.0.17

新增托盤快捷面板，可切換供應商、檢視額度和用量，也可恢復原選單。OpenCode 卡片可設定預設模型。修復 Codex 聚合壓縮失敗、重啟後 ChatGPT 登入丟失、並行工具結果被拆開及自定義 GPT 上下文視窗問題；糾正 Claude 5.5 路由模型標識、多種供應商額度查詢及 macOS/Linux 環境變數衝突誤報。macOS 圖示底色改為淺灰。資料庫結構仍為 20，已儲存的 GPT 上下文視窗值不遷移。

Official source

新增費用顯示幣種、可配置用量指標和請求日誌列，並記住用量檢視；修復 Codex 路由 Gemini 的工具簽名、重試設定及大型 Skills 下載。資料庫結構仍為 20。

Source

Claude Desktop 新增直連、路由、聚合模式；Codex 可配置審批及子代理模型。切回直連先確認，GPT 上下文預設封頂 272K，並修復 Codex 配置鍵重複。

https://github.com/farion1231/cc-switch/releases/tag/v4.0.13

工具與供應商

• 應用頁補齊安裝、升級、解除安裝和衝突診斷；可選擇解除安裝哪一處安裝，執行前重新核對路徑。支援 Grok Build 0.2.112 起的佈局，保留配置和會話並清理失效啟動連結。
• npm 升級前檢查實際使用的 Node 版本；不滿足要求時隱藏升級並跳過“全部升級”。未知要求或查詢失敗不阻止升級；原生、Homebrew、Bun 和 WSL 安裝不做此檢查。
• 新增 Ollama、LM Studio、llama.cpp、vLLM 本地預設及 14 家雲平臺預設；本地地址請求繞過應用和系統代理。須先啟動服務、下載模型；上下文長度由服務啟動配置決定。
• OpenCode 新增矽基流動國內與國際預設；StreamLake 新增 Codex，使用公開 KAT-Coder 接入點。新預設和接入點變化僅影響新新增的供應商。

效能、介面與修復

• 後臺日誌掃描從 60 秒改為 10 分鐘；開啟用量頁或重新顯示視窗立即掃描，之後按 5、10、30 或 60 秒間隔掃描，預設 60 秒。原“關閉”選項改為 60 秒；不經路由的後臺用量最多延遲 10 分鐘，經路由的即時記錄不受影響。
• 供應商搜尋不再遮擋或推移卡片；應用頁列寬穩定，解除安裝移到行尾選單，隱藏應用不會改動其配置。
• 新增社群土耳其語；首次啟動遇到不支援的系統語言時使用英文，已有語言選擇不變。
• 修復雲同步 Skills 恢復反覆失敗；替換和回滾都失敗時保留原始副本並報告位置。修復 Responses 正常結束後的多餘流錯誤、當前側欄頁面點選破壞未儲存修改保護，以及空上游錯誤資訊。
• Pi 新匯入會話可估算速度，舊記錄仍顯示“—”；修復 WSL 路徑寫入，自動 Skills 同步使用複製，手動軟連結仍會明確報錯。Windows 更新後讀取 OpenCode/Codex 模型列表補全 PATH 並展開變數；Hermes 解除安裝反饋區分命令完成與狀態檢查失敗。

升級注意

資料庫結構仍為 20。Claude Desktop 本地預設會清空 Key，須手動填寫 ollama、lmstudio、no-key 或 dummy；若服務設定了 Key，則使用實際值。此文為分類摘要，完整細節見該精確版本官方說明。

官方來源

• 來源 1

應用頁新增工具解除安裝：先顯示安裝路徑和命令，只處理來源可確認的當前安裝，保留配置、會話及其他安裝；無法識別的安裝改用手動命令。執行前會重新檢查安裝狀態。

新新增或匯入的套餐供應商在所有應用中預設開啟額度查詢；usageEnabled=false 仍保持關閉，ZenMux 仍只在 Claude Code 中預設開啟，已有供應商不受影響。

Codex 用量匯入不再每分鐘整份重讀未變化的分叉會話，並能合併分頁父會話以補回此前遺漏的子代理用量。分叉執行緒自身翻頁後的續寫頁仍不計入；計費規則不變。

修復 Skills 和 MCP 批次切換的錯誤成功提示，以及工作區編輯器讀取失敗時誤用前一個檔案內容的問題。全屏頁面取消淡入淡出；Windows 自動更新後的 npm PATH 問題也已修復。資料庫結構仍為 20。

來源：https://github.com/farion1231/cc-switch/releases/tag/v4.0.11

編輯摘要

改進 ccswitch:// 匯入，安全保留供應商配置，新增可複用的本地圖示和首個 token 延遲統計。修復 Claude Code 路由、舊版 Codex 會話恢復、Grok Build 標題和用量歸屬。資料庫結構仍為 20。

供應商匯入後的立即切換預設關閉；共存式應用和 Pi 的新增/啟用預設開啟。enabled 只決定開關初值，關閉時只儲存供應商。usageEnabled=false 仍停用用量查詢；指令碼只允許一次同源 HTTPS 請求。config.toml 保留供應商欄位，不匯入全域性設定；會執行命令、讀取本地憑據或展開環境變數/檔案的配置被拒絕。apiFormat 的非原生格式需要相應客戶端啟用本地路由。

Claude Code 路由別名從 claude-haiku-4-5 改為 claude-haiku-5-5，但實際選模規則不變。舊 cc-switch-official 會話啟動時遷回 openai，每個 Codex 配置目錄僅遷移一次並備份；仍在使用手動恢復的表時跳過遷移，不改 config.toml。已匯入的 Codex 用量不會自動重寫，需在源日誌仍存在時使用 Rebuild Codex Usage。完整安全限制、預設值及升級行為見下方官方英文原文。

以下保留完整英文內容及原始來源；上方為經審校的中文摘要，並非全文翻譯。

Official English notes — unabridged

CC Switch v4.0.10

The sixth fix release for 4.0 stable

This release focuses on one-click import links (ccswitch:// deep links): clicking a link while CC Switch is not running no longer loses it; links can declare the API format, import Pi providers and bring the site's own icon; Codex and Grok Build links keep the provider's own configuration instead of having it replaced with a fixed template; and the confirmation dialog lets you choose whether to switch right after import. Site owner guides in Chinese, English and Japanese and an online link generator are also published. Provider icons can now be uploaded from local images, and once saved to "My Icons" any provider can use them; the usage page adds first-token time, which can be estimated from session logs even when routing is off. It also fixes upstreams that require thinking rejecting Claude Code's haiku-tier requests in Routing mode, Codex sessions left by using an official account through routing in v3.20 and earlier failing to open, and Grok Build third-party providers being unable to generate session titles. For everything new in 4.0, see the v4.0 release notes.

---

One-click import links

What changes for users

• Clicking a link while CC Switch is not running no longer loses it. On Windows and Linux, clicking a one-click import link while CC Switch was not open used to start the app, but the import confirmation dialog did not appear; in lightweight mode the link was also lost when the window was recreated. On macOS the same link brought up the confirmation dialog twice. Links are now stored first and only count as handled once the confirmation dialog has been shown, so they are not lost if something interrupts along the way, and an older link arriving later does not overwrite a newer one.
• The confirmation dialog lets you choose whether to switch right after import. The confirmation dialog for provider links adds a "Switch to this provider after import" switch, off by default; when it is on, the dialog warns that client requests will be sent to the address in the link. Coexist-mode apps such as OpenCode, OpenClaw, Hermes and MiniMax Code get a switch like "Add to the OpenCode config after import", and Pi gets "Enable in Pi after import"; these two kinds are on by default. For prompts it is "Enable after import". The enabled value in a link only sets the switch's initial state. With the switch off, only the provider is saved and the client config is not changed, even if this is the app's first provider.
• Links with a usage query script turn on usage query by default after import. A site owner attaches a script to the link because they want you to see your balance right after import; previously you had to turn it on manually. Links that set usageEnabled=false still keep it off; links without a script behave as before. The script runs in a sandbox and can send only one request, over HTTPS to the same origin as the provider address, and the confirmation dialog still shows the full script as before.
• Codex links keep the provider's own configuration. When a link carried a full config.toml, only the Key, address and model used to be taken out and put into a fixed template, losing the provider's authentication method, request headers, WebSocket support and model catalog URL. Now the parts that belong to this provider are kept: connection and authentication fields, model, reasoning effort, context window, subagent model and so on; the model catalog URL is kept only when it has the same origin as the API address, because Codex sends the provider's credentials when fetching it. Global settings such as [features], MCP and permissions are not imported. Provider configurations that would make Codex run commands or read local credentials (auth, aws, gateway_oauth, env_http_headers) are rejected outright. Links without a configuration import exactly as before.
• Grok Build links keep the model configuration. Links with a config.toml used to be replaced with a fixed template too, losing the display name, description, API type and context window. Now the model table that [models] default points to is kept, while the address, Key and model still come from the link parameters; links that use auth_provider, env_http_headers or mtls_cert_dir are rejected. A provider takes only one table in Grok Build, so other model tables are not imported.
• Values that would be expanded and executed are always rejected. Coexist-mode apps expand some special syntax in their configs: in Pi, values starting with ! are run as commands and $NAME / ${NAME} read environment variables; OpenCode has {env:} / {file:}; OpenClaw and Hermes have ${...}. When a link contains this syntax, it could run commands or send secrets and file contents from this machine to the address in the link. This is now checked when parsing the link, merging configs and building the provider, and the import is rejected if any is found.
• Other: Links with configUrl now say it is not supported as soon as they are opened, instead of failing after you confirm; prompt links support MiniMax Code, and MCP links support Pi and MiniMax Code; the tray menu refreshes right after a provider is imported.

New parameters for site owners

• apiFormat: One parameter declares the upstream API format (anthropic / openai_chat / openai_responses / gemini_native), and CC Switch turns it into each app's own fields. Non-native formats for Claude Code, Codex and Grok Build need local routing to be on; combinations an app does not support are rejected when the link is parsed. Links without this parameter behave as before.
• Pi provider links: Newly supported. After import they are written to Pi's models.json, and the link must include a model.
• iconUrl: The https address of the site's own logo. It is downloaded and shown at the top as soon as the confirmation dialog opens, and becomes the card's custom icon after import; if the download fails, the import still goes ahead and the card falls back to a built-in icon or the first letter of the name. The image is redrawn and saved as a small PNG; the address itself is neither saved nor rendered. Downloads connect only to public addresses and pin the resolved result, so a second DNS lookup cannot point somewhere else; each redirect hop is checked, up to 3 hops. No system proxy, no cookies, a 5-second timeout, 256 KB maximum, and the file type must match the content.

Site owner guide and online generator

• Site owner integration guide (also in 中文 and 日本語): how to generate links, how to put a "one-click import" button on your page (the link is fetched from your backend when the button is clicked, so the Key never appears in the page source), what to show when the user hasn't installed CC Switch, and how to attach a usage query script. Sites built with New API or Sub2API already have an "Import to CC Switch" button in their Key list; the difference is that New API links carry no usage query script, so users don't see a balance after import.
• Online link generator: changed from a test page into a generator for site owners, covering four kinds of links (provider, MCP, prompt, Skill), listing the apiFormat options available for each app, with built-in usage script templates, and checking icon / iconUrl with the same rules as the app. The generator link in the user manual pointed to a GitHub Pages address that was never set up and opened a 404; the manual and README now point here.

New

Provider icons can be uploaded from local images and kept in "My Icons" for reuse. The icon picker is split into two groups, "My Icons" and "Built-in Icons", and the search box filters both. Click "Upload", the first tile in "My Icons", pick a PNG, JPG, WebP or SVG (up to 2 MB) and give it a name (the file name by default), and it is saved to "My Icons" and used for the current provider; from then on other providers and other apps can pick it directly without uploading it again, and uploading the same image again reuses the existing entry. Hover over an icon to rename or delete it; cards store the image itself, so renaming or deleting does not affect providers already using it. Images are shrunk to a 96×96 PNG, and "My Icons" and provider configs both travel with cloud sync, with no separate files saved on disk; SVGs are converted to bitmaps first, any scripts and external requests inside them are not run, and the original file does not go into the database. Site icons brought in by one-click import links are shown as "Current icon" and can be saved to "My Icons". In the picker, one click on an icon now selects it and closes the picker; to remove the icon, click "Clear icon" next to the search box.

The usage page shows first-token time. The routing service has always recorded first-token time, but it used to be visible only in hover tooltips and request details. Provider stats and model stats now have a "First token" column, which takes the median of successful streaming requests through the routing service, so occasional slow requests from queuing or cold starts don't pull it up; the request log also adds a "First token" column after "Speed". When routing is off, it is estimated from session log timestamps and shown with ≈: for Claude Code, from replies that start with thinking; for Codex, from timestamps written by newer versions; replies that start with body text or a tool call have no estimate. Records imported before the upgrade are not backfilled.

Usage query adds a Sub2API template. The templates in "Configure usage query" add Sub2API, which needs only the provider's Key and address, with or without /v1; it shows the plan name, and unlimited subscriptions no longer show as a negative balance.

New presets: NekoCode (Claude Code, Claude Desktop, Codex, OpenCode, OpenClaw, Hermes, Pi; MiniMax Code uses the Pi preset). YYLX is shown as 「魚魚連線」 in the Simplified Chinese interface (「魚魚連線」 in Traditional Chinese); the English interface still shows YYLX.

Fixes

• In Routing mode, upstreams rejected Claude Code's haiku-tier requests (#8118). Routing mode writes fixed model aliases into settings.json, and Claude Code decides how to send thinking parameters based on the alias. The haiku tier used to be written as claude-haiku-4-5; Claude Code considers that model able to turn thinking off, so it sent requests with thinking turned off, which upstreams that require thinking reject outright. It is now claude-haiku-5-5, sent the same way as the sonnet and opus tiers. Routing itself still maps by the "haiku" keyword, so the model it picks does not change.
• Codex sessions left by using an official account through routing in v3.20 and earlier could not be opened (#7948). From v3.17 to v3.20, when an official account went through local routing, Codex recorded its sessions under cc-switch-official; v4.0 no longer writes that table, so when Codex resumed those sessions it reported "Model provider cc-switch-official not found". CC Switch now moves them back to Codex's built-in openai group at startup, changing only the session records and not touching config.toml. These sessions used the official sign-in all along and Codex always treated them as OpenAI, so behavior does not change after the move.
• Grok Build could not generate session titles with a third-party provider (#7003). When models.session_summary was not set, Grok Build generated titles with the built-in grok-4.6 but sent the request to the default model table's address, which third-party upstreams reject. Now, when you switch providers, session_summary follows the current provider if it is unset or points to a table CC Switch wrote, and it is removed when you switch back to the official account; a built-in model or a table you set yourself is left alone.
• OpenRouter and Novita cards showed "Plan expired" when the balance was zero (#8148). When the balance was zero or negative, the Key actually still worked, but the card and the tray showed the plan as expired. They now show "Balance used up"; when the API returns a missing or malformed balance, an error is reported instead of treating it as a zero balance.
• After switching models mid-thread in Codex, usage was recorded under the previous model. When the model is changed in Codex's thread settings, the log does not always get a new turn context, so usage import used to record later requests under the previous model name (or as unknown when there was no earlier record) and price them at the previous model's rate. That setting is now read. Records already imported are not rewritten automatically; if the source session logs still exist, click "Rebuild Codex Usage" under "Data sources" on the usage page (the database is backed up automatically before rebuilding).
• After changing a config directory in Settings without clicking Save, changing another setting saved the directory too (#7849). When other settings auto-save, only confirmed directories are now included, and discarded drafts no longer stay in the input box either.
• On Windows, the window flashed when opening the add or edit provider page. v4.0.9 fixed the edit page showing a loading page first, but the full-page fade still flashed on Windows. These two pages no longer fade in and out; other pages are not affected.
• On Windows, a deleted desktop shortcut came back with every update. An MSI upgrade uninstalls the old version and then fully installs the new one, and it used to create the desktop shortcut again every time. It is now created only on a fresh install; on upgrade it is kept only if the original shortcut is still there.

Other: The description of "Connection mode" now leads with what each mode is good at: Direct is the most native, Routing can hot-switch providers and supports failover and format conversion, and Aggregation lets you switch seamlessly between models from several providers inside the client. All usage table columns are now left-aligned, and the provider and model columns in the request log give up some width to the number columns. The Japanese interface changes 「高階オプション」 to 「詳細オプション」.

Upgrade Notes

The database schema is unchanged, still at 20.

• If Claude Code is already in Routing mode, CC Switch writes the new haiku alias into settings.json when it starts after the upgrade, and new Claude Code sessions will use it.
• The Codex session migration runs automatically when CC Switch starts, once per Codex config directory, and the session records from before the change are backed up in the existing session-group migration backup directory. If you manually restored the cc-switch-official table and still use it, this migration is skipped.
• The new presets only affect newly added providers.

---

Thanks

Thanks to @funkpopo (OpenRouter showing the plan as expired when the balance is zero, and Codex usage recorded under the wrong model after switching models mid-thread), @hulkbig (unconfirmed directories being saved when settings auto-save) and @NestorRay (the flash on Windows when opening provider pages) for their contributions.

Thanks to @hao-lin-lwh, @desmonna, @mossonli, @enderzcx, @nbcoming, @liyangdeamo-svg, @linhay and @aofee for reporting issues, providing reproduction details and helping verify fixes.

For the full technical details, see the CHANGELOG.

Official original — Chinese (unabridged)

CC Switch v4.0.10

4.0 正式版的第六個修復版本

這一版的重點是一鍵匯入連結（ccswitch:// 深度連結）：CC Switch 沒在執行時點連結不會再丟；連結可以宣告介面格式、匯入 Pi 供應商、帶上網站自己的圖示；Codex 和 Grok Build 的連結保留供應商自帶的配置，不再被換成固定模板；確認框裡可以選匯入後是否立即切換。同時釋出了中、英、日三語的站長接入指南和線上連結生成器。供應商圖示現在可以上傳本地圖片，存進「我的圖示」後所有供應商都能選用；用量頁新增首字時間，沒開路由也能按會話日誌估算。另外修復了路由模式下 Claude Code 的 haiku 檔請求被要求思考的上游拒絕、v3.20 及更早用官方賬號走路由留下的 Codex 會話打不開、Grok Build 第三方供應商生成不了會話標題等問題。4.0 完整的更新內容請見 v4.0 釋出說明。

English → | 日本語版 →

---

一鍵匯入連結

使用者能感受到的變化

• CC Switch 沒在執行時點連結，不會再丟。 以前在 Windows 和 Linux 上，CC Switch 沒開著時點一鍵匯入連結，應用會啟動，但匯入確認框不出現；輕量模式下視窗重建時也會丟。macOS 上同一個連結會彈兩次確認框。現在連結會先存下來，確認框顯示出來之後才算處理完，中途被打斷也不會丟，後到的舊連結也不會蓋掉新連結。
• 確認框裡可以選匯入後是否立即切換。 供應商連結的確認框新增「匯入後立即切換到這個供應商」開關，預設關閉，開啟時會提示客戶端請求將改發到連結裡的地址。OpenCode、OpenClaw、Hermes、MiniMax Code 這類共存式應用是「匯入後立即新增到 OpenCode 配置」這樣的開關，Pi 是「匯入後立即在 Pi 中啟用」，這兩類預設開啟；提示詞是「匯入後立即啟用」。連結裡的 enabled 只決定開關的初始狀態。關掉開關就只儲存供應商，不改客戶端配置，即使這是該應用的第一個供應商。
• 帶用量查詢指令碼的連結，匯入後預設開啟用量查詢。 站長在連結裡附上指令碼，就是想讓你匯入後直接看到餘額，以前還要再手動開啟一次。連結寫了 usageEnabled=false 時仍然關閉；不帶指令碼的連結和以前一樣。指令碼在沙箱裡執行，只能向供應商地址的同源 HTTPS 發一次請求，確認框裡照常完整顯示指令碼內容。
• Codex 連結保留供應商自帶的配置。 連結帶完整 config.toml 時，以前只取出 Key、地址和模型，再套進固定模板，供應商的認證方式、請求頭、WebSocket 支援和模型目錄地址都會丟。現在保留其中屬於這個供應商的部分：連線和認證欄位、模型、推理強度、上下文視窗、子代理模型等；模型目錄地址只在和介面地址同源時保留，因為 Codex 拉取它時會帶上供應商的憑據。[features]、MCP、許可權這類全域性設定不匯入。會讓 Codex 執行命令或讀取本機憑據的供應商配置（auth、aws、gateway_oauth、env_http_headers）整條拒絕。不帶配置的連結匯入結果和以前逐字一致。
• Grok Build 連結保留模型配置。 帶 config.toml 的連結以前也會被換成固定模板，丟掉顯示名、說明、介面型別和上下文視窗。現在保留 [models] default 指向的那張模型表，地址、Key 和模型仍以連結引數為準；用到 auth_provider、env_http_headers、mtls_cert_dir 的連結會被拒絕。一個供應商在 Grok Build 裡只佔一張表，所以其他模型表不匯入。
• 會被展開執行的值一律拒絕。 共存式應用會展開配置裡的一些特殊寫法：Pi 裡以 ! 開頭的值會被當成命令執行，$NAME / ${NAME} 會讀環境變數；OpenCode 有 {env:} / {file:}；OpenClaw 和 Hermes 有 ${...}。連結裡出現這些寫法時，可能執行命令，或者把本機的金鑰和檔案內容發到連結裡的地址。現在解析連結、合併配置和生成供應商時都會檢查，發現就拒絕匯入。
• 其他： 帶 configUrl 的連結現在一開啟就提示不支援，不會等你確認後才失敗；提示詞連結支援 MiniMax Code，MCP 連結支援 Pi 和 MiniMax Code；匯入供應商後托盤選單會立即重新整理。

站長能用的新引數

• apiFormat： 一個引數宣告上游的介面格式（anthropic / openai_chat / openai_responses / gemini_native），CC Switch 會換成各應用自己的欄位。Claude Code、Codex、Grok Build 的非原生格式需要開啟本地路由；應用不支援的組合在解析時就會被拒絕。不帶這個引數的連結行為不變。
• Pi 供應商連結： 新增支援，匯入後寫進 Pi 的 models.json，連結必須帶模型。
• iconUrl： 填網站自己 logo 的 https 地址。確認框開啟時就下載並顯示在頂部，匯入後作為卡片的自定義圖示；下載失敗不影響匯入，卡片退回內建圖示或名稱首字母。圖片會重繪成小尺寸 PNG 儲存，地址本身不儲存也不渲染。下載時只連公網地址，並鎖定解析結果，防止第二次 DNS 解析指向別處；重定向逐跳檢查，最多 3 跳。不走系統代理、不帶 Cookie，5 秒超時，最大 256 KB，檔案型別必須和內容一致。

站長接入指南和線上生成器

• 站長接入指南（另有 English、日本語）：怎么生成链接、怎么在页面上放「一键导入」按钮（点按钮时再向后端取链接，Key 不會出現在頁面原始碼裡）、使用者沒裝 CC Switch 時顯示什麼、怎麼附上用量查詢指令碼。用 New API 或 Sub2API 搭的站，Key 列表裡已經自帶「匯入到 CC Switch」按鈕；區別是 New API 的連結不帶用量查詢指令碼，使用者匯入後看不到餘額。
• 線上連結生成器：从测试页改成给站长用的生成器，分供应商、MCP、提示词、Skill 四類，按應用列出可選的 apiFormat，內建用量指令碼模板，填 icon / iconUrl 時按應用內同樣的規則檢查。使用者手冊裡原來的生成器連結指向一個從沒開通的 GitHub Pages 地址，開啟是 404，現在手冊和 README 都改指這裡。

新增

供應商圖示可以上傳本地圖片，存進「我的圖示」反覆使用。 圖示選擇器分成「我的圖示」和「內建圖示」兩組，搜尋框同時篩兩組。點「我的圖示」第一格的「上傳」，選一張 PNG、JPG、WebP 或 SVG（不超過 2 MB），起個名字（預設是檔名）就存進「我的圖示」並用在當前供應商上；以後其他供應商、其他應用都能直接選，不用再傳一次，重複上傳同一張圖會複用已有的那條。滑鼠移到圖示上可以重新命名或刪除；卡片儲存的是圖片本身，所以重新命名、刪除都不影響已經在用它的供應商。圖片會縮成 96×96 的 PNG，「我的圖示」和供應商配置都隨雲同步帶走，不在磁碟上另存檔案；SVG 會先轉成點陣圖，裡面的指令碼和外部請求都不會執行，原始檔案不進資料庫。一鍵匯入連結帶來的網站圖示會以「當前圖示」顯示，可以存進「我的圖示」。選擇器現在點一下圖示就選好並關閉，去掉圖示點搜尋框旁的「清除圖示」。

用量頁顯示首字時間。 路由服務一直記錄首字時間，以前只在懸停提示和請求詳情裡能看到。現在供應商統計和模型統計新增「首字」列，取經路由服務的成功流式請求的中位數，偶爾排隊、冷啟動的慢請求不會把它拉高；請求日誌在「速度」後面也加了「首字」列。沒開路由時，按會話日誌的時間戳估算，帶 ≈ 顯示：Claude Code 看以思考開頭的回覆，Codex 看較新版本寫入的時間戳；以正文或工具呼叫開頭的回覆沒有估算值。升級前匯入的記錄不補算。

用量查詢新增 Sub2API 模板。 「配置用量查詢」的模板裡新增 Sub2API，只需要供應商的 Key 和地址，地址帶不帶 /v1 都行；會顯示套餐名，額度不限的訂閱不再顯示成負餘額。

新增預設： NekoCode（Claude Code、Claude Desktop、Codex、OpenCode、OpenClaw、Hermes、Pi，MiniMax Code 沿用 Pi 預設）。YYLX 在中文介面顯示為「魚魚連線」（繁體中文為「魚魚連線」）。

修復

• 路由模式下 Claude Code 的 haiku 檔請求被上游拒絕（#8118）。路由模式往 settings.json 裡寫的是固定的模型別名，Claude Code 按別名決定怎麼發思考引數。haiku 檔以前寫的是 claude-haiku-4-5，Claude Code 認為這個模型可以關思考，就發出關閉思考的請求，要求必須開思考的上游會直接拒絕。現在改成 claude-haiku-5-5，和 sonnet、opus 檔的發法一致。路由本身仍按「haiku」關鍵詞對映，選到哪個模型不變。
• v3.20 及更早用官方賬號走路由留下的 Codex 會話打不開（#7948）。v3.17 到 v3.20 用官方賬號走本地路由時，Codex 把會話記在 cc-switch-official 名下；v4.0 不再寫這張表，Codex 恢復這些會話時就會報「Model provider cc-switch-official not found」。現在 CC Switch 啟動時會把它們移回 Codex 內建的 openai 分組，只改會話記錄，不碰 config.toml。這些會話本來就用官方登入，Codex 也一直把它們當 OpenAI 處理，移動後行為不變。
• Grok Build 用第三方供應商時生成不了會話標題（#7003）。没设 models.session_summary 時，Grok Build 用內建的 grok-4.6 生成標題，卻把請求發到預設模型表的地址，第三方上游會拒絕。現在切換供應商時，session_summary 在沒設或指向 CC Switch 寫的表時會跟著指向當前供應商，切回官方賬號時刪掉；你自己設的內建模型或自己的表保持不動。
• OpenRouter、Novita 餘額為零時卡片顯示「套餐已過期」（#8148）。余额为零或为负时，Key 其實還能用，卡片和托盤卻顯示套餐已過期。現在顯示「餘額已用完」；介面返回缺失或格式不對的餘額時報錯，不再當成零餘額。
• Codex 中途換模型後，用量記在了原來的模型上。 Codex 線上程設定裡換模型時，日誌裡不一定會寫新的輪次上下文，用量匯入以前會把之後的請求記在上一個模型名下（沒有更早記錄時記成 unknown），價格也按原模型算。現在會讀取這條設定。已經匯入的記錄不會自動改寫，源會話日誌還在的話，可以在用量頁的「資料來源」裡點「重建 Codex 用量」（重建前會自動備份資料庫）。
• 在設定裡改了配置目錄、還沒點儲存，改另一項設定時目錄也被儲存了（#7849）。其他设置自动保存时，现在只会带上已确认的目录；被放弃的草稿也不会再留在输入框里。
• Windows 上開啟新增或編輯供應商頁面時視窗閃一下。 v4.0.9 修了編輯頁先顯示載入頁的問題，但整頁的淡入淡出在 Windows 上仍會閃。現在這兩個頁面不再做淡入淡出，其他頁面不受影響。
• Windows 上刪掉的桌面快捷方式，每次更新都會被裝回來。 MSI 升級會先解除安裝舊版再完整安裝新版，以前每次都會重新建立桌面快捷方式。現在只在全新安裝時建立；升級時只有原來的快捷方式還在才保留。

其他： 「連線模式」的說明改為先講每種模式的長處：直連最原生，路由可熱切換供應商、支援故障轉移和格式轉換，聚合可在客戶端內無縫切換多家模型。用量頁的所有表格列統一左對齊，請求日誌裡供應商和模型兩列讓出一些寬度給數字列。日文介面把「高階オプション」改為「詳細オプション」。

升級說明

資料庫結構沒有變化，仍然是 20。

• 已經在用路由模式的 Claude Code，升級後啟動 CC Switch 時會把新的 haiku 別名寫進 settings.json，新開的 Claude Code 會話會用上。
• Codex 會話的遷移在 CC Switch 啟動時自動進行，每個 Codex 配置目錄只做一次，改動前的會話記錄備份在原有的會話分組遷移備份目錄。如果你手動恢復過 cc-switch-official 表並且仍在使用，這次遷移會跳過。
• 新增預設隻影響新新增的供應商。

---

致謝

感謝 @funkpopo（OpenRouter 餘額為零時顯示套餐已過期、Codex 中途換模型後用量記錯模型）、@hulkbig（設定自動儲存時帶上未確認的目錄）、@NestorRay（Windows 上開啟供應商頁面時的閃爍）的貢獻。

感謝 @hao-lin-lwh、@desmonna、@mossonli、@enderzcx、@nbcoming、@liyangdeamo-svg、@linhay、@aofee 報告問題、提供復現資訊和幫忙驗證。

完整的技術細節請見 CHANGELOG。

Official original — Japanese (unabridged)

CC Switch v4.0.10

4.0 正式版の 6 回目の修正リリース

今回の中心はワンクリックインポートのリンク（ccswitch:// ディープリンク）です。CC Switch が起動していないときにリンクを押しても失われなくなりました。リンクで API の形式を宣言したり、Pi のプロバイダーをインポートしたり、サイト自身のアイコンを付けたりできます。Codex と Grok Build のリンクはプロバイダー獨自の設定を保ち、固定のテンプレートに置き換えられなくなりました。確認ダイアログでは、インポート後すぐに切り替えるかどうかを選べます。あわせて、中國語・英語・日本語のサイト運営者向け連攜ガイドと、オンラインのリンク生成ツールを公開しました。プロバイダーのアイコンにはローカルの畫像をアップロードできるようになり、「マイアイコン」に儲存すればすべてのプロバイダーで選べます。使用量ページには最初のトークンまでの時間を追加し、ルーティングを使っていなくてもセッションログから推定します。また、ルーティングモードで Claude Code の haiku 階層のリクエストが、思考を必須とする上流に拒否される問題、v3.20 以前に公式アカウントでルーティングを使ったときに殘った Codex のセッションが開けない問題、Grok Build でサードパーティのプロバイダーを使うとセッションのタイトルを生成できない問題などを修正しました。4.0 の更新內容の全體は v4.0 リリースノート をご覧ください。

---

ワンクリックインポートのリンク

ユーザーから見た変化

• CC Switch が起動していないときにリンクを押しても、失われなくなりました。 これまで Windows と Linux では、CC Switch を起動していない狀態でワンクリックインポートのリンクを押すと、アプリは起動するもののインポートの確認ダイアログが表示されませんでした。軽量モードでウィンドウを作り直したときにも失われていました。macOS では同じリンクで確認ダイアログが 2 回表示されていました。現在はリンクをいったん儲存し、確認ダイアログが表示されて初めて処理済みとします。途中で中斷されても失われず、後から屆いた古いリンクが新しいリンクを上書きすることもありません。
• 確認ダイアログで、インポート後すぐに切り替えるかどうかを選べるようになりました。 プロバイダーのリンクの確認ダイアログに「インポート後にこのプロバイダーへ切り替える」スイッチを追加しました。デフォルトはオフで、オンにすると、クライアントのリクエストの送り先がリンクに書かれたアドレスに変わることが表示されます。OpenCode、OpenClaw、Hermes、MiniMax Code のような共存型アプリでは「インポート後に OpenCode の設定へ追加する」のようなスイッチ、Pi では「インポート後に Pi で有効にする」で、この 2 種類はデフォルトでオンです。プロンプトは「インポート後に有効にする」です。リンクの enabled が決めるのはスイッチの初期狀態だけです。スイッチをオフにするとプロバイダーを儲存するだけで、クライアントの設定は変更しません。そのアプリで最初のプロバイダーであっても同じです。
• 使用量クエリスクリプト付きのリンクは、インポート後に使用量クエリがデフォルトで有効になります。 サイト運営者がリンクにスクリプトを付けるのは、インポートしてすぐに殘高を見てほしいからですが、これまではさらに手動で有効にする必要がありました。リンクに usageEnabled=false と書かれていれば引き続きオフです。スクリプトのないリンクはこれまでと同じです。スクリプトはサンドボックスで実行され、プロバイダーのアドレスと同一オリジンの HTTPS に 1 回だけリクエストを送れます。確認ダイアログには、これまでどおりスクリプトの內容がすべて表示されます。
• Codex のリンクで、プロバイダー獨自の設定を保つようになりました。 リンクに完全な config.toml が含まれている場合、これまでは Key、アドレス、モデルだけを取り出して固定のテンプレートに當てはめていたため、プロバイダーの認証方式、リクエストヘッダー、WebSocket 対応、モデルカタログのアドレスが失われていました。現在はそのうち、このプロバイダーに屬する部分を保ちます。接続と認証のフィールド、モデル、推論強度、コンテキストウィンドウ、サブエージェントモデルなどです。モデルカタログのアドレスは、API のアドレスと同一オリジンの場合にだけ保ちます。Codex はこれを取得するときにプロバイダーの認証情報を付けるためです。[features]、MCP、権限のようなグローバル設定はインポートしません。Codex にコマンドを実行させたり、ローカルの認証情報を読ませたりするプロバイダー設定（auth、aws、gateway_oauth、env_http_headers）を含むリンクは、全體を拒否します。設定を含まないリンクのインポート結果は、これまでと一字一句同じです。
• Grok Build のリンクで、モデルの設定を保つようになりました。 config.toml を含むリンクも、これまでは固定のテンプレートに置き換えられ、表示名、説明、API の種類、コンテキストウィンドウが失われていました。現在は [models] default が指すモデルテーブルを保ち、アドレス、Key、モデルは引き続きリンクのパラメーターを優先します。auth_provider、env_http_headers、mtls_cert_dir を使うリンクは拒否されます。Grok Build では 1 つのプロバイダーが使うテーブルは 1 つだけなので、ほかのモデルテーブルはインポートしません。
• 展開して実行される値は、すべて拒否するようになりました。 共存型アプリは、設定にある特殊な書き方を展開します。Pi では ! で始まる値がコマンドとして実行され、$NAME / ${NAME} は環境変數を読みます。OpenCode には {env:} / {file:}、OpenClaw と Hermes には ${...} があります。リンクにこうした書き方があると、コマンドが実行されたり、ローカルの秘密情報やファイルの內容がリンクに書かれたアドレスに送られたりするおそれがあります。現在はリンクの解析、設定のマージ、プロバイダーの生成のそれぞれで確認し、見つかればインポートを拒否します。
• その他： configUrl を含むリンクは、開いた時點で非対応であることを表示するようになり、確認した後で失敗することはなくなりました。プロンプトのリンクが MiniMax Code に、MCP のリンクが Pi と MiniMax Code に対応しました。プロバイダーをインポートすると、トレイメニューがすぐに更新されます。

サイト運営者向けの新しいパラメーター

• apiFormat： 1 つのパラメーターで上流の API 形式（anthropic / openai_chat / openai_responses / gemini_native）を宣言でき、CC Switch が各アプリ自身のフィールドに置き換えます。Claude Code、Codex、Grok Build でネイティブでない形式を使うには、ローカルルーティングを有効にする必要があります。アプリが対応していない組み合わせは、解析の時點で拒否されます。このパラメーターのないリンクの動作は変わりません。
• Pi のプロバイダーのリンク： 新たに対応しました。インポートすると Pi の models.json に書き込まれます。リンクにはモデルが必須です。
• iconUrl： サイト自身のロゴの https アドレスを指定します。確認ダイアログを開いた時點でダウンロードして上部に表示し、インポート後はカードのカスタムアイコンになります。ダウンロードに失敗してもインポートには影響せず、カードは內蔵アイコンか名前の頭文字に戻ります。畫像は小さな PNG に描き直して儲存し、アドレス自體は儲存も表示もしません。ダウンロード時にはパブリックなアドレスにだけ接続し、名前解決の結果を固定して、2 回目の DNS 解決で別の場所を指されるのを防ぎます。リダイレクトは 1 回ごとに確認し、最大 3 回までです。システムプロキシは使わず、Cookie も送りません。タイムアウトは 5 秒、サイズは最大 256 KB で、ファイルの種類が內容と一致している必要があります。

サイト運営者向け連攜ガイドとオンライン生成ツール

• サイト運営者向け連攜ガイド（ほかに 中文、English）：リンクの生成方法、ページに「ワンクリックインポート」ボタンを置く方法（ボタンを押したときにバックエンドへリンクを要求するので、Key がページのソースに現れません）、ユーザーが CC Switch をインストールしていないときに何を表示するか、使用量クエリスクリプトの付け方を説明しています。New API や Sub2API で構築したサイトでは、Key 一覧に「CC Switch へのインポート」ボタンが最初から付いています。違いは、New API のリンクには使用量クエリスクリプトが含まれないため、ユーザーがインポートしても殘高が表示されないことです。
• オンラインのリンク生成ツール：テストページから、サイト運営者向けの生成ツールに作り替えました。プロバイダー、MCP、プロンプト、Skill の 4 種類に分かれ、アプリごとに選べる apiFormat を一覧にし、使用量スクリプトのテンプレートを內蔵しています。icon / iconUrl を入力すると、アプリ內と同じルールで確認します。ユーザーマニュアルにあった生成ツールへのリンクは、一度も公開されたことのない GitHub Pages のアドレスを指しており、開くと 404 でした。現在はマニュアルと README のどちらもここを指すようにしました。

新機能

プロバイダーのアイコンにローカルの畫像をアップロードし、「マイアイコン」に儲存して繰り返し使えるようになりました。 アイコンの選択畫面は「マイアイコン」と「內蔵アイコン」の 2 グループに分かれ、検索欄で両方を同時に絞り込めます。「マイアイコン」の最初のマスにある「アップロード」を押し、PNG、JPG、WebP、SVG のいずれか（2 MB まで）を選んで名前を付ける（デフォルトはファイル名）と、「マイアイコン」に儲存され、現在のプロバイダーに使われます。以降はほかのプロバイダーやほかのアプリでもそのまま選べ、もう一度アップロードする必要はありません。同じ畫像をもう一度アップロードすると、既存のものを再利用します。アイコンにマウスを重ねると、名前の変更や削除ができます。カードには畫像そのものを儲存しているため、名前を変えても削除しても、すでにそのアイコンを使っているプロバイダーには影響しません。畫像は 96×96 の PNG に縮小され、「マイアイコン」もプロバイダーの設定もクラウド同期で引き継がれます。ディスクに別のファイルとして儲存することはありません。SVG はまずビットマップに変換し、中のスクリプトや外部へのリクエストは実行されず、元のファイルはデータベースに入りません。ワンクリックインポートのリンクで付いてきたサイトのアイコンは「現在のアイコン」として表示され、「マイアイコン」に儲存できます。選択畫面ではアイコンを 1 回クリックすると選択して閉じるようになりました。アイコンを外すには、検索欄の橫の「アイコンをクリア」を押します。

使用量ページに最初のトークンまでの時間を表示するようになりました。 ルーティングサービスはこれまでも最初のトークンまでの時間を記録していましたが、見られるのはツールチップとリクエストの詳細だけでした。現在はプロバイダー統計とモデル統計に「最初のトークン」列を追加しました。値はルーティングサービス経由で成功したストリーミングリクエストの中央値なので、キュー待ちやコールドスタートでたまに遅くなったリクエストに引き上げられることはありません。リクエストログでも「速度」の後ろに「最初のトークン」列を追加しました。ルーティングを使っていないときは、セッションログのタイムスタンプから推定し、≈ を付けて表示します。Claude Code は思考から始まる返信を、Codex は比較的新しいバージョンが書き込んだタイムスタンプを使います。本文やツール呼び出しから始まる返信には推定値がありません。アップグレード前にインポートした記録は計算し直しません。

使用量クエリに Sub2API のテンプレートを追加しました。 「利用狀況を設定」のテンプレートに Sub2API を追加しました。必要なのはプロバイダーの Key とアドレスだけで、アドレスに /v1 が付いていてもいなくても構いません。プラン名を表示し、無制限のサブスクリプションがマイナスの殘高として表示されることもなくなりました。

新しいプリセット： NekoCode（Claude Code、Claude Desktop、Codex、OpenCode、OpenClaw、Hermes、Pi。MiniMax Code は Pi のプリセットを使います）。YYLX は中國語（簡體字）の畫面では「魚魚連線」（繁體字中國語では「魚魚連線」）と表示されます。日本語の畫面では引き続き YYLX と表示されます。

修正

• ルーティングモードで、Claude Code の haiku 階層のリクエストが上流に拒否されていた問題（#8118）。ルーティングモードでは settings.json に固定のモデルエイリアスを書き込み、Claude Code はエイリアスによって思考パラメーターの送り方を決めます。haiku 階層にはこれまで claude-haiku-4-5 を書いていたため、Claude Code はこのモデルでは思考をオフにできると判斷して思考をオフにしたリクエストを送り、思考を必須とする上流にそのまま拒否されていました。現在は claude-haiku-5-5 に変え、sonnet、opus 階層と同じ送り方になりました。ルーティング自體は引き続き「haiku」というキーワードでマッピングするため、選ばれるモデルは変わりません。
• v3.20 以前に公式アカウントでルーティングを使ったときに殘った Codex のセッションが開けなかった問題（#7948）。v3.17 から v3.20 で公式アカウントからローカルルーティングを使っていたとき、Codex はセッションを cc-switch-official の名前で記録していました。v4.0 はこのテーブルを書き込まなくなったため、Codex がこれらのセッションを再開しようとすると「Model provider cc-switch-official not found」というエラーになっていました。現在は CC Switch の起動時に、これらのセッションを Codex 內蔵の openai グループに戻します。変更するのはセッションの記録だけで、config.toml には觸れません。これらのセッションはもともと公式ログインを使っており、Codex も一貫して OpenAI として扱っていたため、移動後も動作は変わりません。
• Grok Build でサードパーティのプロバイダーを使うと、セッションのタイトルを生成できなかった問題（#7003）。models.session_summary が設定されていない場合、Grok Build は內蔵の grok-4.6 でタイトルを生成しますが、リクエストはデフォルトのモデルテーブルのアドレスに送られるため、サードパーティの上流に拒否されていました。現在はプロバイダーを切り替えるとき、session_summary が未設定か CC Switch が書いたテーブルを指している場合は、現在のプロバイダーを指すように合わせ、公式アカウントに戻すときは削除します。自分で設定した內蔵モデルや自分のテーブルはそのまま殘します。
• OpenRouter、Novita の殘高がゼロのとき、カードに「プラン期限切れ」と表示されていた問題（#8148）。残高がゼロまたはマイナスでも Key は実際には使えるのに、カードとトレイにはプランの期限が切れたと表示されていました。現在は「殘高なし」と表示します。API が返す殘高が欠けていたり形式が正しくなかったりする場合はエラーとし、殘高ゼロとしては扱わなくなりました。
• Codex で途中でモデルを変えた後も、使用量が元のモデルで記録されていた問題。 Codex がスレッドの設定でモデルを変えたとき、ログに新しいターンのコンテキストが書かれるとは限らず、使用量の取り込みではこれまで、その後のリクエストを直前のモデル名で記録し（それより前の記録がなければ unknown）、料金も元のモデルで計算していました。現在はこの設定を読み取ります。すでに取り込んだ記録は自動では書き換えません。元のセッションログが殘っていれば、使用量ページの「データソース」で「Codex 使用量を再構築」を押して作り直せます（再構築の前にデータベースが自動でバックアップされます）。
• 設定畫面で設定ディレクトリを変更し、まだ儲存を押していないときに別の設定を変更すると、ディレクトリまで儲存されていた問題（#7849）。ほかの設定が自動保存されるとき、確定済みのディレクトリだけを含めるようになりました。破棄した下書きが入力欄に残ることもなくなりました。
• Windows でプロバイダーの追加・編集ページを開くと、ウィンドウが一瞬ちらついていた問題。 v4.0.9 では編集ページで先に読み込み中の畫面が表示される問題を修正しましたが、ページ全體のフェードイン・フェードアウトが Windows ではまだちらついていました。現在はこの 2 つのページでフェードイン・フェードアウトをしなくなりました。ほかのページには影響しません。
• Windows で削除したデスクトップのショートカットが、更新のたびに作り直されていた問題。 MSI のアップグレードは舊バージョンをアンインストールしてから新バージョンを完全にインストールするため、これまでは毎回デスクトップのショートカットを作り直していました。現在は新規インストールのときにだけ作成し、アップグレードでは元のショートカットが殘っている場合にだけ保持します。

その他： 「接続モード」の説明を、まずそれぞれのモードの長所を述べる形に改めました。直接接続は最もネイティブ、ルーティングはプロバイダーのホットスイッチができ、フェイルオーバーとフォーマット変換に対応、集約はクライアント內で複數のプロバイダーのモデルをシームレスに切り替えられます。使用量ページの表の列はすべて左揃えにし、リクエストログではプロバイダーとモデルの 2 列の幅を少し減らして數値の列に回しました。日本語の畫面では「高階オプション」を「詳細オプション」に改めました。

アップグレードに関する注意

データベースの構造は変わっていません。 バージョンは 20 のままです。

• すでにルーティングモードで Claude Code を使っている場合、アップグレード後に CC Switch を起動すると新しい haiku のエイリアスが settings.json に書き込まれ、新しく開いた Claude Code のセッションから使われます。
• Codex のセッションの移行は CC Switch の起動時に自動で行われ、Codex の設定ディレクトリごとに 1 回だけです。変更前のセッション記録は、既存のセッショングループ移行用のバックアップディレクトリに儲存されます。cc-switch-official テーブルを手動で復元していて、まだ使っている場合、この移行はスキップされます。
• 新しいプリセットは新しく追加するプロバイダーにだけ影響します。

---

謝辭

@funkpopo（OpenRouter の殘高がゼロのときにプラン期限切れと表示される問題、Codex で途中でモデルを変えた後に使用量が誤ったモデルで記録される問題）、@hulkbig（設定の自動保存で未確定のディレクトリまで保存される問題）、@NestorRay（Windows でプロバイダーのページを開くときのちらつき）の貢獻に感謝します。

問題の報告、再現情報の提供、検証に協力してくださった @hao-lin-lwh、@desmonna、@mossonli、@enderzcx、@nbcoming、@liyangdeamo-svg、@linhay、@aofee に感謝します。

技術的な詳細は CHANGELOG をご覧ください。

Official sources

• https://github.com/farion1231/cc-switch/releases/tag/v4.0.10
• https://github.com/farion1231/cc-switch/blob/v4.0.10/docs/release-notes/v4.0.10-en.md