docs/release-notes/v3.15.0-ja.md
Claude Desktop が一等管理パネルに昇格（プロキシゲートウェイ経由のサードパーティプロバイダー切り替えを含む）、ロールベースのモデルマッピング、リバースプロキシの大幅強化、Codex OAuth ライブモデル検出、Usage ダッシュボードのフィルター駆動 Hero カード
CC Switch v3.15.0 は v3.14.x に続く大型バージョンアップで、コアの焦点は Claude Desktop を一等管理パネルに昇格させることにあります。これに合わせて、内蔵プロキシゲートウェイを介したサードパーティプロバイダーの切り替え、ロールベースのモデルマッピング（sonnet / opus / haiku）+ supports1m ロングコンテキストフラグ、Copilot / Codex OAuth プロバイダーの再利用、再設計された Claude Code インポートフロー、App スイッチャーでの「Claude Code」と「Claude Desktop」の視覚的な区別、そして Claude Code プリセットディレクトリから翻訳された 44 個の Claude Desktop プリセットを提供します。
リバースプロキシの信頼性については、本リリースで系統的なハードニングを行いました: P0–P3 の複数回にわたるルーティング / ライフサイクル / リトライ / フェイルオーバー / 補正器の修正; 非 Anthropic バックエンドで HTTPS コネクションプールを再利用してリクエスト単位のレイテンシを低減; Codex と OpenAI Responses のキャッシュヒット率改善（prompt_cache_key は本物のクライアントセッション識別子がある場合のみ送信、外部リクエストボディと tool_call 引数 / tool_result 内容の JSON キーを正規化してソート、session_id を Usage ロガーに通す）; Anthropic ↔ OpenAI tool_choice の正しい相互変換; Vertex AI の完全な URL を切り詰めない; Gemini は URI パスからモデル名を抽出するように変更; Local Routing のテイクオーバー検出をより精緻化; IPv6 リッスンアドレスのサポート。Codex OAuth 系の Claude プロバイダーはハードコードされたモデルリストに依存しなくなり、CC Switch が必要に応じて ChatGPT バックエンドからライブモデルリストを取得します。
Claude Code のモデルマッピングはロールベース（sonnet / opus / haiku）+ 表示名に変更され、supports1m 真偽値フラグが導入されました。これは旧来の [1M] サフィックス記法に取って代わり、ルーティング判定と元のモデル ID を分離します。Usage ダッシュボードにはフィルター駆動 Hero カードが追加され、キャッシュ正規化後の真の総トークン数とキャッシュヒット率を表示し、現在の日付範囲 / プロバイダー / モデルのフィルターに追従してリアルタイム更新します。あわせてキャッシュコストのセマンティクスエラーと、リクエストごとに発生していた pricing 警告ノイズを修正しました。OpenAI Responses API の usage 解析パスを堅牢化し、上流の欠損または不正な usage のせいで VSCode Claude Code プラグインが null 出力でクラッシュしないようにしました。
プロバイダーエコシステムはさらに拡張されました: BytePlus、Volcengine Agentplan、ClaudeAPI、ClaudeCN、RunAPI、RelaxyCode、PatewayAI、Baidu Qianfan Coding Plan のパートナープリセットを追加; Doubao Seed をパートナープリセットに昇格; プロバイダーカードに「Local Routing 対応」バッジを表示。本リリースでは、Codex セッション、OAuth、Claude Desktop フォーム、Linux segfault、ターミナルフォールバックなどに関する多くの細部の問題も修正し、複数の GitHub Actions 依存関係をアップグレードしました。
リリース日: 2026-05-16
Stats: 127 commits | 211 files changed | +17,980 insertions | -2,748 deletions
supports1m ロングコンテキストフラグ、Copilot / Codex OAuth プロバイダーの再利用、Claude Code プリセットディレクトリから翻訳された 44 個のプリセットを提供。注意: 20 個の Claude Desktop プリセットがデフォルトでプロキシモードから直接接続モードに切り替わったため、アップグレード後にプロキシルーティングに依存している場合は接続性を検証してくださいtool_choice の正しいマッピング; Vertex AI URL の完全保持; Gemini パスベースのモデル抽出; テイクオーバー検出の精緻化; IPv6 リッスンアドレスのサポートsupports1m フラグ。旧来の [1M] サフィックスに取って代わるreasoning_content も返却するように (#2543, 感謝 @bling-yshs); 最終 message_delta は常に usage ブロックを含む（すべてゼロでも）ため、厳格な Anthropic クライアントが null でクラッシュしなくなった (#2485, 感謝 @Myoontyee)CC Switch は初めて Claude Desktop を一等管理対象パネルとして扱い、Claude Code / Codex / Gemini / OpenCode / OpenClaw / Hermes と並列に位置づけます。
sonnet / opus / haiku にロックClaude Code と Codex パネルのプロバイダーカードに「ルーティングプロキシ対応」バッジを追加し、Local Routing 経由で提供可能なプロバイダーを一目で識別できるようにしました。
ChatGPT Codex 系プロバイダーはハードコードされたモデル選択に依存しなくなり、CC Switch が必要に応じて ChatGPT バックエンドからライブモデルリストを取得します。
Claude Code のモデルマッピングはロールベース（sonnet / opus / haiku）+ 表示名に変更され、supports1m 真偽値フラグが導入されました。これは旧来の [1M] サフィックス記法に取って代わり、ルーティング判定と元のモデル ID を分離します。
Usage ダッシュボードの Hero サマリーがフィルター駆動になり、現在の日付範囲 / プロバイダー / モデルフィルターに追従してリアルタイムに変化します。キャッシュ正規化後の真の総トークン数とキャッシュヒット率を表示することで、Hero の数値が下部の詳細リストと整合するようになります。
プロバイダーフォームの入力検証を緩和し、非ブロッキングな入力上の問題を「とりあえず保存」型のヒントに変更しました。無害な軽微なフィールド問題が原因で保存が阻まれることがなくなります (#2307, 感謝 @allenxln)。
プロバイダーリスト内の universal プロバイダーに「複製」ボタンを追加しました (#2416, 感謝 @hubutui)。
ウィンドウの位置とサイズが再起動をまたいで保持されるようになりました (#2377, 感謝 @BillSaul)。
システムトレイアイコンにホバー時のステータスヒントを表示するようになりました (#2417, 感謝 @Coconut-Fish)。
Warp ターミナルのサポートを追加し、保存されたセッションを Warp で実行できるようになりました (#2466, 感謝 @tisonkun)。
reasoning_contentDeepSeek のツール呼び出しレスポンスが reasoning_content と tool_calls を同時に返却するようになり、呼び出し側が両方を一緒にレンダリングできるようになりました (#2543, 感謝 @bling-yshs)。
Baidu Qianfan Coding Plan プリセットを追加しました (#2322, 感謝 @jimmyzhuu)。
Compshare Coding Plan プリセットを claude / codex / hermes / openclaw の全アプリに展開しました。
BytePlus、Volcengine Agentplan、ClaudeAPI、ClaudeCN、RunAPI、RelaxyCode、PatewayAI のパートナープリセットを追加; Doubao Seed をパートナープリセットに昇格（エンドポイントとリンクをリフレッシュ）。
Claude Code プリセットディレクトリから 44 個のプロバイダープリセットを翻訳し、新しい Claude Desktop パネルに投入しました。
20 個の Claude Desktop プリセットがデフォルトでプロキシモードから直接接続モードに切り替わり、プロキシ互換シムを必要としないユーザーの導入摩擦を低減しました。アップグレード前にこれらのプリセットのプロキシルーティング経由の接続性に依存していた場合は、アップグレード後に検証してください。
Claude Desktop のプロバイダーを切り替えると CC Switch 管理の 3P プロファイルが書き込まれます。Claude Desktop の再起動が必要です; プロキシモードのプロバイダーは、使用中 CC Switch の Local Routing が動作し続けている必要があります。
Failover コントロールは、ターゲットアプリの Local Routing テイクオーバーが有効になっていないと開けないように変更しました。プロキシサービスのみを止めてもテイクオーバー状態に依存するアプリがある場合はブロックされ、「プロキシは止めたがアプリはまだテイクオーバー中と認識している」という不整合を回避します。
Usage サマリーはキャッシュ正規化後の真の総トークン数とキャッシュヒット率を報告するようになりました。データの重複排除と価格再計算により、過去のトークン数とコスト数値はずれる可能性があります — 新しい数値の方が正確ですが、旧バージョンの数値とは一致しません。
プリセットリストは作者が定義した配列順序でレンダリングされるようになり、パートナーが先頭に並びます。以前の暗黙的なソートを置き換えます。
modelMappingOffHint を中 / 英 / 日でアクション指向の簡潔な文面に書き直しました。
アプリ内および README 内のすべての「公式サイト」参照を、唯一の公式サイトとして ccswitch.io に統一しました; Release notes テンプレートにも ccswitch.io を反映。
テーマ切り替え時の円形拡散アニメーションを削除し、即座にクロスフェードする方式に変更しました。
App スイッチャーで「Claude Code」と「Claude Desktop」を視覚的に区別し、アプリ可視性設定では「Claude Code」ラベルを使用するようにしました。
Claude review GitHub Action を Opus 4.7 にアップグレード; nitpick ノイズを減らすためプロンプトを調整; @claude レビュー専用 Code Action を追加; PR head SHA を checkout 用にロック; --max-turns 5 制限を削除。
actions/checkout 4 → 6 (#2517)pnpm/action-setup 5 → 6 (#2518)softprops/action-gh-release 2 → 3 (#2519)actions/stale 9 → 10 (#2520)DeepSeek プリセットが V4（flash / pro）+ リフレッシュされた価格シードを出荷するようになりました。
Codex プロバイダー編集フォームでは 1M コンテキストトグルを表示しなくなり、現在の Codex デプロイメントには実効性のないノブの密度を低減しました。
OpenClaudeCode プリセットを MicuAPI ドメインに移行; Micu API リンクを micuapi.ai にリフレッシュ。
cn サブドメインに切り替えCrazyRouter プリセットのエンドポイントを cn サブドメインに変更しました。
RelaxyCode プリセットのアイコンをカスタム relaxcode.png アセットに変更しました。
Kimi For Coding のウェブサイト URL を /code/docs/ パスに更新しました。
SiliconFlow 国際版の残高を正しく USD で表示するように修正しました（以前は誤って CNY と表示）。
build_anthropic_usage_from_responses() と Responses → Anthropic SSE トランスレーターを強化し、上流の欠損または不正な usage が message_delta 内で "usage": null を生成しないようにしました。これにより、厳格な Anthropic クライアント（典型例: VSCode Claude Code プラグイン）が一部のプロバイダー（Codex OAuth、DashScope の compatible-mode/v1/responses エンドポイント）で Cannot read properties of null (reading 'output_tokens') でクラッシュしていた問題が解消されます。OpenAI フィールド名のフォールバック（prompt_tokens / completion_tokens）、null / 空 / 部分オブジェクトの処理、input/output tokens が欠損していても cache token フィールドを保持する処理を追加しました (#2422, 感謝 @magucas)。
request-forwarder パス全体で複数回にわたるルーティング / ライフサイクル / リトライ / 補正器の修正を実施; 共有された handle_rectifier_retry_failure ヘルパーと auth_header_value ヘルパーを抽出。
非 Anthropic バックエンドはプールされた HTTPS コネクションを再利用し、リクエストごとに新しい TLS セッションを開かなくなりました。リクエスト単位のレイテンシが大幅に低減します。
POST のハードコーディングをやめ、クライアントの実際の HTTP メソッドに従って転送するようになりました; 上流の非 POST エンドポイント（例: GET /v1/models）が正常に動作します。
max_retries の接続クライアントリクエストカウンターを試行ごとのループから外に移動; AppProxyConfig.max_retries がリクエストフォワーダーに正しく接続されるようになりました。
リクエストフォワーダー内でのリトライ可能 / 不可能エラーの分類がより正確になりました。
テイクオーバー検出をより厳密にしました; テイクオーバー OFF 時はフォールバック復旧パスを通り、残留状態によってプロバイダーが固まらないようにします。
tool_choice の相互変換フォーマット変換時に Anthropic の tool_choice を OpenAI Chat のネスト形式に正しくマッピングするようになりました。
Gemini リクエストのモデルを URI パスから抽出するようになりました（body からは取らない）。変換後のトラフィックが正しいモデル名を報告します。
get_auth_headers が Result を返すようになり、認証情報に問題がある場合にパニックしなくなりました。
プロキシパネルが IPv6 リッスンアドレスを受け付けるようになりました。
安定したキャッシュキー導出によって Codex と OpenAI Responses リクエストのキャッシュヒット率を改善: クライアントが本当にセッション識別子を持参してきた場合にのみ prompt_cache_key を送信し、無関係な会話が同じキーに潰されないようにする; 外部リクエストボディと tool_call 引数 / tool_result 内容内の JSON キーを正規化してソートし、プレフィックスキャッシュがバイト単位でマッチできるようにする; session_id を usage ロガーに通してリクエストを関連付けする。
プライベートパラメータフィルタリングが JSON Schema name map（properties、patternProperties、definitions、$defs）内のアンダースコア接頭辞のフィールド名を保持するようになりました。ユーザー定義 schema キー（_id、_meta など）がフィルターを正常に通り抜けられます。
Read ツールの入力から空白ページを除去し、プロバイダーがリクエストを拒否しないようにしました (#2472, 感謝 @Kwensiu)。
リクエストごとのホットパスのオーバーヘッドとデータベース待ち時間を削減しました。
テイクオーバー実行時に、Claude Code メニューが古いエイリアスではなく真のプロバイダーモデル名を露出するようになりました。
message_delta は常に usage を含む最終 message_delta イベントには常に usage ブロックが含まれるようになりました（すべてゼロでも）。厳格な Anthropic クライアントが null でクラッシュしなくなります (#2485, 感謝 @Myoontyee)。
message_delta の重複排除一部の上流が二重に送信する message_delta イベントの重複排除を行います (#2366, 感謝 @codeasier)。
reasoning_content 保持ツール呼び出しパスの変換時に scoped reasoning_content フィールドを正しく保持するようにしました; Kimi / Moonshot の OpenAI Chat 互換パスではこのフィールドを保持し、汎用 OpenAI 互換リクエストでは引き続き付加しません (#2367, 感謝 @codeasier)。
Vertex AI の完全 URL がプロキシ転送時に切り詰められないようにしました (#2415, 感謝 @xpfo-go)。
一部の上流が system message の先頭に挿入する課金ヘッダー内容を除去するようにしました (#2350)。
ANTHROPIC_* 環境変数名から導出不透明なヒューリスティックに依存するのをやめ、認証ストラテジーを実際の ANTHROPIC_* 環境変数名から導出するようにしました。
/v1/models を一貫して実装していないサードパーティ Claude ゲートウェイに対して、モデルプローブを無効化しました。
/models/models ディスカバリーが Anthropic 互換のサブパスプロバイダーに対しても動作するようになりました。
/models と照合Copilot バックエンドのプロバイダーはライブ /models リストを使って Claude モデル ID を照合し、古い ID の不整合を回避するようになりました。
environment_context を取り込まないようにCodex のセッションタイトル抽出が environment_context のノイズを引き込まなくなりました (#2439, 感謝 @eclipsehx)。
Codex の subagent セッションをメインセッションリストから非表示にしました (#2445, 感謝 @LanternCX)。
Codex 起動時の live import パスにおける重複インポートのバグを修正しました (#2590, 感謝 @DhruvShankpal)。
アクティブな Codex プロバイダーの切り替えが既存のセッション履歴を変更しなくなりました (#2349, 感謝 @SaladDay)。
Codex セッション usage の誤解を招くログを 1 件修正しました (#2473, 感謝 @tisonkun)。
max effort を env 経由で永続化max effort が再起動をまたいで env 変数経由で正しく永続化されるようになりました (#2493, 感謝 @makoMakoGo)。
[1M] サフィックスを要求しないようにルーティングマッチングがレガシーな [1M] サフィックスを要求しなくなりました。
Claude Desktop プロバイダーフォームで入力ボックス編集中にフォーカスを失う問題を修正しました。
プロキシが能動的に停止された際に誤って発火するヒントを削除しました。
Claude Desktop がアクティブアプリの場合、空のツールバーカプセルを非表示にします。
App スイッチャー内の Monitor バッジアイコンをセンタリングしました。
Linux でテーマを選択した際の segfault を防止しました (#2502, 感謝 @definfo)。
コールドスタート時に存在しない iTerm をフォールバックに選んでしまうのを防止しました (#2448, 感謝 @hulkbig)。
設定の書き込みが JSON キーを辞書順にソートするようになり、出力が決定的になりました (#2469, 感謝 @fuleinist)。
「既存をインポート」操作を副作用なしに変更しました (#2429, 感謝 @xwil1)。
Zhipu の週次ウィンドウのティア名を実際のリセット時刻に合うように修正しました (#2420, 感謝 @TuYv)。
DashScope の usage 解析を強化し、不正なペイロードが VSCode Claude Code プラグインをクラッシュさせないようにしました (#2425, 感謝 @magucas)。
プロキシとセッションログという 2 つのソースをまたいで usage レコードの重複排除を行います。
キャッシュコストのセマンティクスを修正し、リクエストごとに発生していたノイズの多い pricing 警告を解消しました。
CI のフロントエンドフォーマットと Linux clippy の実行を復活させました。
プロキシテストヘルパーの clippy 警告を 1 件修正しました。
本サイクルでオンラインにする予定だった Hermes Agent usage トラッキング統合を削除しました — 上流の動作変更によって、この統合のメンテナンスが現実的でなくなりました。この統合はいかなるリリース版でも有効化されたことはなく; 開発過程で発見された「ゼロコストレンダリング」バグは統合をロールバックする前に修正済みです。
テーマ切り替え時の円形拡散アニメーションを削除しました — 性能の弱いコンポジターでカクつき、視覚的なメリットが限定的でした。
DDSHub をパートナープリセットから削除し、各 README 内の相互リンクセクションも削除しました。
BytePlus、ClaudeCN、RunAPI、PatewayAI のスポンサーエントリを追加; BytePlus と Volcengine のエントリを相互リンク; CrazyRouter の $2 クレジット受領フロー、Compshare の説明、Right Code の説明、その他スポンサーのロゴおよびリストアイテムをリフレッシュ; LionCC のロゴを白背景にフラット化; 中国語 README のスポンサーロゴを Volcengine 画像に切り替え; README のサブタイトルに Hermes Agent を追加。
Release notes テンプレート内に ccswitch.io を反映しました。
各 README およびアプリ内参照で ccswitch.io を唯一の公式サイトとしてドキュメント化しました。
これら 20 個のプリセットは以前はデフォルトでプロキシ経由でルーティングされていましたが、現在はデフォルトで直接接続です。アップグレード前にこのうちのいずれかを使用しており、かつプロキシルーティングの接続性に依存していた場合（例: プロキシに特殊な補正器や変換層がある場合）、接続性を検証してください; 必要に応じて、CC Switch パネル内で手動でプロキシモードに戻すことができます。
Claude Desktop プロバイダーの切り替えには、Claude Desktop の再起動が必要です; プロキシモードのプロバイダーは、使用中 CC Switch の Local Routing が動作し続けている必要があります — CC Switch を終了させたり Local Routing を停止させたりすると、プロキシモードの Claude Desktop プロバイダーへの接続が切断されます。
Failover を有効化する前に、ターゲットアプリの Local Routing テイクオーバーが有効になっていることを確認してください。さもないと Failover コントロールは起動を拒否します; プロキシサービスを止めたいがテイクオーバーに依存するアプリがある場合はブロックされるため、アプリ層で先にテイクオーバーを止めてからプロキシを停止する必要があります。
Usage サマリーはキャッシュ正規化後の真の総トークン数 + キャッシュヒット率を使用するようになりました。データの重複排除と価格再計算により、過去のトークン数とコスト数値はずれる可能性があります — 新しい数値の方が正確ですが、旧バージョンの数値とは一致しません。
本リリースは、リバースプロキシ系機能について v3.12.3 / v3.13.0 で提起されたリスク通知を継承します。
GitHub Copilot リバースプロキシ: Copilot のリバースプロキシパスを使用すると、GitHub / Microsoft の利用規約に違反する可能性があります。詳細は v3.12.3 リリースノート を参照してください。
Codex OAuth リバースプロキシ: ChatGPT サブスクリプションを使用した Codex OAuth リバースプロキシは、OpenAI の利用規約に違反する可能性があります。詳細は v3.13.0 リリースノート を参照してください。
Claude Desktop サードパーティプロバイダーのプロキシ切り替え: CC Switch 内蔵プロキシゲートウェイ経由で Claude Desktop のリクエストをサードパーティプロバイダーに転送する際、サードパーティプロバイダーの課金、コンプライアンス、データ保持に関する制約はそれぞれ異なります。利用前にターゲットプロバイダーの利用規約をお読みください。
ユーザーが上記機能を有効化することで、すべてのリスクを自己責任で受諾したものとみなされます。CC Switch は、これらの機能の使用に起因するアカウントの制限、警告、サービス停止について一切の責任を負いません。
Releases から対応バージョンをダウンロードしてください。
| OS | 最小バージョン | アーキテクチャ |
|---|---|---|
| Windows | Windows 10 以降 | x64 |
| macOS | macOS 12 (Monterey) 以降 | Intel (x64) / Apple Silicon (arm64) |
| Linux | 下表参照 | x64 / ARM64 |
| ファイル | 説明 |
|---|---|
CC-Switch-v3.15.0-Windows.msi | 推奨 - MSI インストーラー、自動更新対応 |
CC-Switch-v3.15.0-Windows-Portable.zip | ポータブル版、解凍して実行、レジストリ不要 |
| ファイル | 説明 |
|---|---|
CC-Switch-v3.15.0-macOS.dmg | 推奨 - DMG インストーラー、Applications にドラッグ |
CC-Switch-v3.15.0-macOS.zip | 解凍して Applications にドラッグ、Universal Binary |
CC-Switch-v3.15.0-macOS.tar.gz | Homebrew インストールと自動更新用 |
macOS 版は Apple のコード署名および公証済みで、直接インストールして使用できます。
brew tap farion1231/ccswitch
brew install --cask cc-switch
更新:
brew upgrade --cask cc-switch
Linux 向けの成果物は x86_64 と ARM64（
aarch64）の両方が提供されます。ファイル名にアーキテクチャ識別子が含まれているため、uname -mの出力に応じて選択してください：
CC-Switch-v3.15.0-Linux-x86_64.AppImage/.deb/.rpmCC-Switch-v3.15.0-Linux-arm64.AppImage/.deb/.rpm
| ディストリビューション | 推奨形式 | インストール方法 |
|---|---|---|
| Ubuntu / Debian / Linux Mint / Pop!_OS | .deb | sudo dpkg -i CC-Switch-*.deb または sudo apt install ./CC-Switch-*.deb |
| Fedora / RHEL / CentOS / Rocky Linux | .rpm | sudo rpm -i CC-Switch-*.rpm または sudo dnf install ./CC-Switch-*.rpm |
| openSUSE | .rpm | sudo zypper install ./CC-Switch-*.rpm |
| Arch Linux / Manjaro | .AppImage | 実行権限を付与して実行、または AUR を使用 |
| その他のディストリビューション / 不明 | .AppImage | chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage |