# CC Switch v3.15.0

> Claude Desktop が一等管理パネルに昇格（プロキシゲートウェイ経由のサードパーティプロバイダー切り替えを含む）、ロールベースのモデルマッピング、リバースプロキシの大幅強化、Codex OAuth ライブモデル検出、Usage ダッシュボードのフィルター駆動 Hero カード

**[English →](v3.15.0-en.md) | [中文 →](v3.15.0-zh.md)**

---

> [!WARNING]
>
> ## 唯一の公式チャネル（必ずお読みください）
>
> CC Switch は**完全に無料・オープンソース**のデスクトップアプリで、**ユーザーから料金を徴収することはありません**。最近、CC Switch の名を騙って課金を要求したり認証情報を収集する偽サイトが複数確認されており、一部のユーザーには既に金銭的被害が発生しています。本ソフトウェアは下記の公式チャネルからのみ入手してください：
>
> | チャネル     | 唯一の公式                                                                     |
> | ------------ | ------------------------------------------------------------------------------ |
> | 公式サイト   | **[ccswitch.io](https://ccswitch.io)**                                         |
> | ソースコード | **[github.com/farion1231/cc-switch](https://github.com/farion1231/cc-switch)** |
> | ダウンロード | **[GitHub Releases](https://github.com/farion1231/cc-switch/releases)**        |
> | 作者         | **[@farion1231](https://github.com/farion1231)**                               |
> | 偽サイト通報 | **[GitHub Issues](https://github.com/farion1231/cc-switch/issues)**            |
>
> **料金請求・チャージ・認証情報の提供を求める「CC Switch」サイトやクライアントはすべて偽物です。** 支払いを誘導された場合は、直ちに取引を中止し、偽サイトを速やかに削除できるよう GitHub Issues からご報告ください。

---

## Claude Desktop 利用ガイド

本リリースの主役は **Claude Desktop の一等管理パネル**です。すでに Claude Code 側で多くのプロバイダーを設定している場合は、まずこのガイドをご覧ください：

**[CC Switch で Claude Desktop プロバイダーを一括設定・管理・切り替える](../user-manual/ja/2-providers/2.6-claude-desktop.md)**

このガイドでは、Claude Code から既存プロバイダーを一括インポートする方法、Claude Desktop 専用プロバイダーの追加、直結 / モデルマッピングの 2 モード、非表示のローカルルーティング切り替えを表示する設定、Claude Desktop 公式サインインモードへの復帰までを説明しています。

---

## 概要

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

---

## ハイライト

- **Claude Desktop が一等管理パネルに**: 内蔵プロキシゲートウェイを介したサードパーティプロバイダーの切り替え、ロールベースのモデルマッピング（sonnet / opus / haiku）+ `supports1m` ロングコンテキストフラグ、Copilot / Codex OAuth プロバイダーの再利用、Claude Code プリセットディレクトリから翻訳された 44 個のプリセットを提供。注意: 20 個の Claude Desktop プリセットがデフォルトでプロキシモードから直接接続モードに切り替わったため、アップグレード後にプロキシルーティングに依存している場合は接続性を検証してください
- **リバースプロキシの大幅強化**: P0–P3 のライフサイクル / リトライ / フェイルオーバー / 補正器の修正; 非 Anthropic バックエンドの HTTPS コネクションプール再利用; Codex / Responses キャッシュヒット率改善; Anthropic ↔ OpenAI `tool_choice` の正しいマッピング; Vertex AI URL の完全保持; Gemini パスベースのモデル抽出; テイクオーバー検出の精緻化; IPv6 リッスンアドレスのサポート
- **プロバイダーエコシステムの拡張**: BytePlus、Volcengine Agentplan、ClaudeAPI、ClaudeCN、RunAPI、RelaxyCode、PatewayAI、Baidu Qianfan Coding Plan のパートナープリセットを追加; Doubao Seed をパートナーに昇格; プロバイダーカードに「ルーティングプロキシ対応」バッジを表示
- **ロールベースのモデルマッピング + 1M フラグ**: ロールベースの sonnet / opus / haiku ルーティング + 表示名 + `supports1m` フラグ。旧来の `[1M]` サフィックスに取って代わる
- **Codex OAuth ライブモデル検出**: ChatGPT Codex 系プロバイダーは必要に応じて ChatGPT バックエンドからライブモデルリストを取得
- **Usage ダッシュボードのフィルター駆動 Hero**: キャッシュ正規化後の真の総トークン数とキャッシュヒット率を表示し、現在の日付 / プロバイダー / モデルフィルターに追従してリアルタイム更新
- **DeepSeek ツール呼び出し + ゼロ usage 最終 delta**: DeepSeek のツール呼び出しが `reasoning_content` も返却するように (#2543, 感謝 @bling-yshs); 最終 `message_delta` は常に usage ブロックを含む（すべてゼロでも）ため、厳格な Anthropic クライアントが `null` でクラッシュしなくなった (#2485, 感謝 @Myoontyee)
- **OpenAI Responses API usage 解析の堅牢化**: 上流の欠損または不正な usage によって VSCode Claude Code プラグインがクラッシュしないように (#2422, 感謝 @magucas)

---

## 追加機能

### Claude Desktop サードパーティプロバイダーのプロキシ切り替え

CC Switch は初めて **Claude Desktop** を一等管理対象パネルとして扱い、Claude Code / Codex / Gemini / OpenCode / OpenClaw / Hermes と並列に位置づけます。

- Claude Desktop 専用パネルを追加し、CC Switch 内蔵プロキシゲートウェイを介してサードパーティプロバイダーを Claude Desktop に代理転送
- ルーティングプロキシを必要とするプロバイダーには、カード上に「Local Routing 対応」バッジを表示
- ロールベースのモデルルーティングマッピングで `sonnet` / `opus` / `haiku` にロック
- Copilot / Codex OAuth プロバイダーを Claude Desktop パネルで再利用可能
- 再設計された Claude Code 設定インポートフロー
- App スイッチャーで「Claude Code」と「Claude Desktop」を視覚的に区別、アプリ可視性設定では「Claude Code」ラベルを使用
- Claude Code プリセットディレクトリから翻訳された 44 個の Claude Desktop プロバイダープリセット

### プロバイダーカード: ルーティングプロキシ対応バッジ

Claude Code と Codex パネルのプロバイダーカードに「ルーティングプロキシ対応」バッジを追加し、Local Routing 経由で提供可能なプロバイダーを一目で識別できるようにしました。

### Codex OAuth ライブモデルリスト

ChatGPT Codex 系プロバイダーはハードコードされたモデル選択に依存しなくなり、CC Switch が必要に応じて ChatGPT バックエンドから**ライブモデルリスト**を取得します。

### ロールベースのモデルマッピング + 1M フラグ

Claude Code のモデルマッピングはロールベース（`sonnet` / `opus` / `haiku`）+ 表示名に変更され、`supports1m` 真偽値フラグが導入されました。これは旧来の `[1M]` サフィックス記法に取って代わり、ルーティング判定と元のモデル ID を分離します。

### Usage ダッシュボードのフィルター駆動 Hero

Usage ダッシュボードの Hero サマリーがフィルター駆動になり、現在の日付範囲 / プロバイダー / モデルフィルターに追従してリアルタイムに変化します。**キャッシュ正規化後の真の総トークン数**とキャッシュヒット率を表示することで、Hero の数値が下部の詳細リストと整合するようになります。

### プロバイダーフォームの「とりあえず保存」

プロバイダーフォームの入力検証を緩和し、非ブロッキングな入力上の問題を「とりあえず保存」型のヒントに変更しました。無害な軽微なフィールド問題が原因で保存が阻まれることがなくなります (#2307, 感謝 @allenxln)。

### Universal プロバイダーの複製アクション

プロバイダーリスト内の universal プロバイダーに「複製」ボタンを追加しました (#2416, 感謝 @hubutui)。

### Tauri ウィンドウ状態の永続化

ウィンドウの位置とサイズが再起動をまたいで保持されるようになりました (#2377, 感謝 @BillSaul)。

### トレイアイコンのホバーヒント

システムトレイアイコンにホバー時のステータスヒントを表示するようになりました (#2417, 感謝 @Coconut-Fish)。

### Warp ターミナルセッション起動

Warp ターミナルのサポートを追加し、保存されたセッションを Warp で実行できるようになりました (#2466, 感謝 @tisonkun)。

### DeepSeek ツール呼び出し `reasoning_content`

DeepSeek のツール呼び出しレスポンスが `reasoning_content` と `tool_calls` を同時に返却するようになり、呼び出し側が両方を一緒にレンダリングできるようになりました (#2543, 感謝 @bling-yshs)。

### Baidu Qianfan Coding Plan（Claude Code）

Baidu Qianfan Coding Plan プリセットを追加しました (#2322, 感謝 @jimmyzhuu)。

### Compshare Coding Plan プリセット（クロスアプリ）

Compshare Coding Plan プリセットを claude / codex / hermes / openclaw の全アプリに展開しました。

### パートナープロバイダープリセット

**BytePlus**、**Volcengine Agentplan**、**ClaudeAPI**、**ClaudeCN**、**RunAPI**、**RelaxyCode**、**PatewayAI** のパートナープリセットを追加; **Doubao Seed** をパートナープリセットに昇格（エンドポイントとリンクをリフレッシュ）。

### 44 個の Claude Desktop プロバイダープリセット

Claude Code プリセットディレクトリから 44 個のプロバイダープリセットを翻訳し、新しい Claude Desktop パネルに投入しました。

---

## 変更

### 20 個の Claude Desktop プリセットがデフォルトで直接接続モードに

20 個の Claude Desktop プリセットがデフォルトでプロキシモードから直接接続モードに切り替わり、プロキシ互換シムを必要としないユーザーの導入摩擦を低減しました。アップグレード前にこれらのプリセットのプロキシルーティング経由の接続性に依存していた場合は、アップグレード後に検証してください。

### Claude Desktop の操作制約

Claude Desktop のプロバイダーを切り替えると CC Switch 管理の 3P プロファイルが書き込まれます。**Claude Desktop の再起動**が必要です; プロキシモードのプロバイダーは、使用中 CC Switch の Local Routing が動作し続けている必要があります。

### Failover / Local Routing 連動検証

Failover コントロールは、ターゲットアプリの Local Routing テイクオーバーが有効になっていないと開けないように変更しました。プロキシサービスのみを止めてもテイクオーバー状態に依存するアプリがある場合はブロックされ、「プロキシは止めたがアプリはまだテイクオーバー中と認識している」という不整合を回避します。

### Usage 統計のセマンティクス変更

Usage サマリーは**キャッシュ正規化後の真の総トークン数**と**キャッシュヒット率**を報告するようになりました。データの重複排除と価格再計算により、過去のトークン数とコスト数値は**ずれる可能性があります** — 新しい数値の方が正確ですが、旧バージョンの数値とは一致しません。

### プロバイダープリセットのレンダリング順序

プリセットリストは作者が定義した配列順序でレンダリングされるようになり、パートナーが先頭に並びます。以前の暗黙的なソートを置き換えます。

### モデルマッピングヒント文面の簡素化

`modelMappingOffHint` を中 / 英 / 日でアクション指向の簡潔な文面に書き直しました。

### CC Switch ブランド公式サイトを ccswitch.io に統一

アプリ内および README 内のすべての「公式サイト」参照を、唯一の公式サイトとして ccswitch.io に統一しました; Release notes テンプレートにも ccswitch.io を反映。

### テーマ切り替えの簡素化

テーマ切り替え時の円形拡散アニメーションを削除し、即座にクロスフェードする方式に変更しました。

### Claude Code App スイッチャーの視覚的な区別

App スイッチャーで「Claude Code」と「Claude Desktop」を視覚的に区別し、アプリ可視性設定では「Claude Code」ラベルを使用するようにしました。

### CI: Claude Review を Opus 4.7 にアップグレード

Claude review GitHub Action を Opus 4.7 にアップグレード; nitpick ノイズを減らすためプロンプトを調整; `@claude` レビュー専用 Code Action を追加; PR head SHA を checkout 用にロック; `--max-turns 5` 制限を削除。

### GitHub Actions 依存関係のアップグレード

- `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 に

DeepSeek プリセットが V4（flash / pro）+ リフレッシュされた価格シードを出荷するようになりました。

### Codex 1M コンテキストトグルを編集フォームから隠す

Codex プロバイダー編集フォームでは 1M コンテキストトグルを表示しなくなり、現在の Codex デプロイメントには実効性のないノブの密度を低減しました。

### OpenClaudeCode を MicuAPI ドメインに移行

OpenClaudeCode プリセットを MicuAPI ドメインに移行; Micu API リンクを `micuapi.ai` にリフレッシュ。

### CrazyRouter エンドポイントを `cn` サブドメインに切り替え

CrazyRouter プリセットのエンドポイントを `cn` サブドメインに変更しました。

### RelaxyCode カスタムアイコン

RelaxyCode プリセットのアイコンをカスタム `relaxcode.png` アセットに変更しました。

### Kimi For Coding ドキュメント URL

Kimi For Coding のウェブサイト URL を `/code/docs/` パスに更新しました。

### SiliconFlow 国際版で USD 表示

SiliconFlow 国際版の残高を正しく USD で表示するように修正しました（以前は誤って CNY と表示）。

---

## 修正

### OpenAI Responses API usage 解析の堅牢化

`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)。

### プロキシ信頼性パッチ（P0–P3）

request-forwarder パス全体で複数回にわたるルーティング / ライフサイクル / リトライ / 補正器の修正を実施; 共有された `handle_rectifier_retry_failure` ヘルパーと `auth_header_value` ヘルパーを抽出。

### プロキシ: 非 Anthropic バックエンドの HTTPS コネクションプール再利用

非 Anthropic バックエンドはプールされた HTTPS コネクションを再利用し、リクエストごとに新しい TLS セッションを開かなくなりました。リクエスト単位のレイテンシが大幅に低減します。

### プロキシ: クライアントの実際の HTTP メソッドを転送

`POST` のハードコーディングをやめ、クライアントの実際の HTTP メソッドに従って転送するようになりました; 上流の非 POST エンドポイント（例: GET `/v1/models`）が正常に動作します。

### プロキシ: 試行ごとのカウンター + `max_retries` の接続

クライアントリクエストカウンターを試行ごとのループから外に移動; `AppProxyConfig.max_retries` がリクエストフォワーダーに正しく接続されるようになりました。

### プロキシ: フェイルオーバー判定の精緻化

リクエストフォワーダー内でのリトライ可能 / 不可能エラーの分類がより正確になりました。

### プロキシ: テイクオーバー検出の精緻化

テイクオーバー検出をより厳密にしました; テイクオーバー OFF 時はフォールバック復旧パスを通り、残留状態によってプロバイダーが固まらないようにします。

### プロキシ: Anthropic ↔ OpenAI `tool_choice` の相互変換

フォーマット変換時に Anthropic の `tool_choice` を OpenAI Chat のネスト形式に正しくマッピングするようになりました。

### プロキシ: Gemini リクエストのモデルを URI パスから抽出

Gemini リクエストのモデルを URI パスから抽出するようになりました（body からは取らない）。変換後のトラフィックが正しいモデル名を報告します。

### プロキシ: 認証ヘッダーのエラー処理

`get_auth_headers` が `Result` を返すようになり、認証情報に問題がある場合にパニックしなくなりました。

### プロキシ: IPv6 リッスンアドレスの検証

プロキシパネルが IPv6 リッスンアドレスを受け付けるようになりました。

### プロキシ: Codex / Responses キャッシュヒット率の改善

安定したキャッシュキー導出によって Codex と OpenAI Responses リクエストのキャッシュヒット率を改善: クライアントが本当にセッション識別子を持参してきた場合にのみ `prompt_cache_key` を送信し、無関係な会話が同じキーに潰されないようにする; 外部リクエストボディと `tool_call` 引数 / `tool_result` 内容内の JSON キーを正規化してソートし、プレフィックスキャッシュがバイト単位でマッチできるようにする; `session_id` を usage ロガーに通してリクエストを関連付けする。

### プロキシ: JSON Schema のアンダースコアフィールド保持

プライベートパラメータフィルタリングが JSON Schema name map（`properties`、`patternProperties`、`definitions`、`$defs`）内のアンダースコア接頭辞のフィールド名を保持するようになりました。ユーザー定義 schema キー（`_id`、`_meta` など）がフィルターを正常に通り抜けられます。

### プロキシ: Read ツールの空白ページ除去

`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 保持

Vertex AI の完全 URL がプロキシ転送時に切り詰められないようにしました (#2415, 感謝 @xpfo-go)。

### プロキシ: system content 先頭の課金ヘッダーを除去

一部の上流が system message の先頭に挿入する課金ヘッダー内容を除去するようにしました (#2350)。

### プロキシ: Claude 認証ストラテジーを `ANTHROPIC_*` 環境変数名から導出

不透明なヒューリスティックに依存するのをやめ、認証ストラテジーを実際の `ANTHROPIC_*` 環境変数名から導出するようにしました。

### サードパーティ Claude プロバイダー: モデルテストの無効化

`/v1/models` を一貫して実装していないサードパーティ Claude ゲートウェイに対して、モデルプローブを無効化しました。

### Model-Fetch: Anthropic 互換サブパスプロバイダーの `/models`

`/models` ディスカバリーが Anthropic 互換のサブパスプロバイダーに対しても動作するようになりました。

### Copilot: Claude モデル ID をライブ `/models` と照合

Copilot バックエンドのプロバイダーはライブ `/models` リストを使って Claude モデル ID を照合し、古い ID の不整合を回避するようになりました。

### Codex: セッションタイトルが `environment_context` を取り込まないように

Codex のセッションタイトル抽出が `environment_context` のノイズを引き込まなくなりました (#2439, 感謝 @eclipsehx)。

### Codex: subagent セッションを非表示

Codex の subagent セッションをメインセッションリストから非表示にしました (#2445, 感謝 @LanternCX)。

### Codex 起動時の live import 重複排除

Codex 起動時の live import パスにおける重複インポートのバグを修正しました (#2590, 感謝 @DhruvShankpal)。

### Codex プロバイダー切り替えで履歴を擾乱しないように

アクティブな Codex プロバイダーの切り替えが既存のセッション履歴を変更しなくなりました (#2349, 感謝 @SaladDay)。

### Codex usage ログの文言修正

Codex セッション usage の誤解を招くログを 1 件修正しました (#2473, 感謝 @tisonkun)。

### Claude: `max` effort を env 経由で永続化

`max` effort が再起動をまたいで env 変数経由で正しく永続化されるようになりました (#2493, 感謝 @makoMakoGo)。

### Claude Desktop: モデルルーティングで `[1M]` サフィックスを要求しないように

ルーティングマッチングがレガシーな `[1M]` サフィックスを要求しなくなりました。

### Claude Desktop: プロバイダーフォームの入力フォーカス消失

Claude Desktop プロバイダーフォームで入力ボックス編集中にフォーカスを失う問題を修正しました。

### Claude Desktop: 偽の「プロキシ停止」ステータス通知

プロキシが能動的に停止された際に誤って発火するヒントを削除しました。

### Claude Desktop: 空のツールバーカプセル非表示

Claude Desktop がアクティブアプリの場合、空のツールバーカプセルを非表示にします。

### UI: Monitor バッジアイコンのセンタリング

App スイッチャー内の Monitor バッジアイコンをセンタリングしました。

### Linux: テーマ選択で segfault

Linux でテーマを選択した際の segfault を防止しました (#2502, 感謝 @definfo)。

### ターミナル: コールドスタート時の iTerm fallback

コールドスタート時に存在しない iTerm をフォールバックに選んでしまうのを防止しました (#2448, 感謝 @hulkbig)。

### 設定: JSON キーを辞書順でソート

設定の書き込みが JSON キーを辞書順にソートするようになり、出力が決定的になりました (#2469, 感謝 @fuleinist)。

### 「既存をインポート」を副作用なしに

「既存をインポート」操作を副作用なしに変更しました (#2429, 感謝 @xwil1)。

### Coding Plan: Zhipu の週次ウィンドウをリセット時刻で命名

Zhipu の週次ウィンドウのティア名を実際のリセット時刻に合うように修正しました (#2420, 感謝 @TuYv)。

### DashScope: usage 解析の堅牢化

DashScope の usage 解析を強化し、不正なペイロードが VSCode Claude Code プラグインをクラッシュさせないようにしました (#2425, 感謝 @magucas)。

### Usage: プロキシとセッションログの重複排除

プロキシとセッションログという 2 つのソースをまたいで usage レコードの重複排除を行います。

### Usage: キャッシュコストのセマンティクス + pricing 警告の嵐

キャッシュコストのセマンティクスを修正し、リクエストごとに発生していたノイズの多い pricing 警告を解消しました。

### CI: フロントエンドフォーマット + Linux clippy の復活

CI のフロントエンドフォーマットと Linux clippy の実行を復活させました。

### プロキシテストヘルパー clippy 警告

プロキシテストヘルパーの clippy 警告を 1 件修正しました。

---

## 削除

### Hermes Agent usage トラッキング統合

本サイクルでオンラインにする予定だった Hermes Agent usage トラッキング統合を削除しました — 上流の動作変更によって、この統合のメンテナンスが現実的でなくなりました。この統合は**いかなるリリース版でも有効化されたことはなく**; 開発過程で発見された「ゼロコストレンダリング」バグは統合をロールバックする前に修正済みです。

### テーマ切り替えの円形拡散アニメーション

テーマ切り替え時の円形拡散アニメーションを削除しました — 性能の弱いコンポジターでカクつき、視覚的なメリットが限定的でした。

### DDSHub パートナー統合

DDSHub をパートナープリセットから削除し、各 README 内の相互リンクセクションも削除しました。

---

## ドキュメント

### README スポンサー更新（中 / 英 / 日）

BytePlus、ClaudeCN、RunAPI、PatewayAI のスポンサーエントリを追加; BytePlus と Volcengine のエントリを相互リンク; CrazyRouter の $2 クレジット受領フロー、Compshare の説明、Right Code の説明、その他スポンサーのロゴおよびリストアイテムをリフレッシュ; LionCC のロゴを白背景にフラット化; 中国語 README のスポンサーロゴを Volcengine 画像に切り替え; README のサブタイトルに Hermes Agent を追加。

### Release notes テンプレート

Release notes テンプレート内に `ccswitch.io` を反映しました。

### ブランド公式サイト

各 README およびアプリ内参照で `ccswitch.io` を唯一の公式サイトとしてドキュメント化しました。

---

## ⚠️ アップグレード時の注意

### 20 個の Claude Desktop プリセットがデフォルトで直接接続モードに

これら 20 個のプリセットは以前はデフォルトでプロキシ経由でルーティングされていましたが、現在はデフォルトで直接接続です。アップグレード前にこのうちのいずれかを使用しており、かつプロキシルーティングの接続性に依存していた場合（例: プロキシに特殊な補正器や変換層がある場合）、接続性を検証してください; 必要に応じて、CC Switch パネル内で手動でプロキシモードに戻すことができます。

### Claude Desktop の操作制約

Claude Desktop プロバイダーの切り替えには、**Claude Desktop の再起動**が必要です; プロキシモードのプロバイダーは、使用中 CC Switch の Local Routing が動作し続けている必要があります — CC Switch を終了させたり Local Routing を停止させたりすると、プロキシモードの Claude Desktop プロバイダーへの接続が切断されます。

### Failover にはテイクオーバーの有効化が必要

Failover を有効化する前に、ターゲットアプリの Local Routing テイクオーバーが有効になっていることを確認してください。さもないと Failover コントロールは起動を拒否します; プロキシサービスを止めたいがテイクオーバーに依存するアプリがある場合はブロックされるため、アプリ層で先にテイクオーバーを止めてからプロキシを停止する必要があります。

### Usage 統計の数値が過去と一致しない可能性

Usage サマリーはキャッシュ正規化後の真の総トークン数 + キャッシュヒット率を使用するようになりました。データの重複排除と価格再計算により、過去のトークン数とコスト数値は**ずれる可能性があります** — 新しい数値の方が正確ですが、旧バージョンの数値とは一致しません。

---

## ⚠️ リスク通知

本リリースは、リバースプロキシ系機能について v3.12.3 / v3.13.0 で提起されたリスク通知を継承します。

**GitHub Copilot リバースプロキシ**: Copilot のリバースプロキシパスを使用すると、GitHub / Microsoft の利用規約に違反する可能性があります。詳細は [v3.12.3 リリースノート](v3.12.3-ja.md#️-リスクに関する注意事項) を参照してください。

**Codex OAuth リバースプロキシ**: ChatGPT サブスクリプションを使用した Codex OAuth リバースプロキシは、OpenAI の利用規約に違反する可能性があります。詳細は [v3.13.0 リリースノート](v3.13.0-ja.md#️-リスクに関する注意事項) を参照してください。

**Claude Desktop サードパーティプロバイダーのプロキシ切り替え**: CC Switch 内蔵プロキシゲートウェイ経由で Claude Desktop のリクエストをサードパーティプロバイダーに転送する際、サードパーティプロバイダーの課金、コンプライアンス、データ保持に関する制約はそれぞれ異なります。利用前にターゲットプロバイダーの利用規約をお読みください。

ユーザーが上記機能を有効化することで、**すべてのリスクを自己責任で**受諾したものとみなされます。CC Switch は、これらの機能の使用に起因するアカウントの制限、警告、サービス停止について一切の責任を負いません。

---

## ダウンロード・インストール

[Releases](https://github.com/farion1231/cc-switch/releases/latest) から対応バージョンをダウンロードしてください。

### システム要件

| OS      | 最小バージョン           | アーキテクチャ                      |
| ------- | ------------------------ | ----------------------------------- |
| Windows | Windows 10 以降          | x64                                 |
| macOS   | macOS 12 (Monterey) 以降 | Intel (x64) / Apple Silicon (arm64) |
| Linux   | 下表参照                 | x64 / ARM64                         |

### Windows

| ファイル                                 | 説明                                        |
| ---------------------------------------- | ------------------------------------------- |
| `CC-Switch-v3.15.0-Windows.msi`          | **推奨** - MSI インストーラー、自動更新対応 |
| `CC-Switch-v3.15.0-Windows-Portable.zip` | ポータブル版、解凍して実行、レジストリ不要  |

### macOS

| ファイル                         | 説明                                                   |
| -------------------------------- | ------------------------------------------------------ |
| `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 のコード署名および公証済みで、直接インストールして使用できます。

### Homebrew（macOS）

> 🎉 CC Switch は Homebrew 公式 cask リポジトリに収録されました。カスタム tap の追加は不要です！

```bash
brew install --cask cc-switch
```

更新:

```bash
brew upgrade --cask cc-switch
```

### Linux

> Linux 向けの成果物は **x86_64** と **ARM64**（`aarch64`）の両方が提供されます。ファイル名にアーキテクチャ識別子が含まれているため、`uname -m` の出力に応じて選択してください：
>
> - `CC-Switch-v3.15.0-Linux-x86_64.AppImage` / `.deb` / `.rpm`
> - `CC-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`                  |
