# CC Switch v3.9.0

> ローカル API プロキシ、自動フェイルオーバー、Universal Provider、多アプリ対応の強化

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

---

## 概要

CC Switch v3.9.0 は v3.9 ベータ（`3.9.0-1`、`3.9.0-2`、`3.9.0-3`）の安定版です。
ローカル API プロキシ（アプリ別テイクオーバー対応）、自動フェイルオーバー、Universal Provider を追加し、Claude Code / Codex / Gemini CLI の安定性と操作性を大きく改善しました。

**リリース日**：2026-01-07

---

## ハイライト

- ローカル API プロキシ：Claude Code / Codex / Gemini CLI を統一的にプロキシ
- 自動フェイルオーバー：サーキットブレーカーとアプリ別のフェイルオーバーキュー
- Universal Provider：1つの設定を複数アプリへ同期（NewAPI などのゲートウェイ向け）
- Skills の改善：マルチアプリ対応、SSOT + React Query による管理の統一
- 共通設定スニペット：エディタ内容または現在のプロバイダから抽出
- MCP インポート：インストール済みアプリから MCP servers を取り込み
- 使用量の改善：自動更新、キャッシュ指標、タイムゾーン修正
- Linux パッケージ：RPM / Flatpak の成果物を追加

---

## 主要機能

### ローカル API プロキシ（Local API Proxy）

- ローカルで高性能な HTTP プロキシサーバーを起動（Axum ベース）
- Claude Code / Codex / Gemini CLI の API リクエストを統一的に扱う
- アプリ別テイクオーバー：アプリごとにプロキシ経由にするかを個別に切り替え可能
- Live 設定テイクオーバー：有効化時に CLI の live 設定をバックアップし、ローカルプロキシへリダイレクト
- 監視：リクエストログと使用量統計でデバッグとコスト把握を支援
- エラーリクエストのログ：失敗したプロキシリクエストも詳細に記録してデバッグを容易に（#401、@yovinchen に感謝）

### 自動フェイルオーバー（Auto Failover / サーキットブレーカー）

- 障害を検知して保護（サーキットブレーカー）を自動で発動
- 現在のプロバイダが不調な場合、バックアッププロバイダへ自動切り替え
- アプリごとに独立したフェイルオーバーキューとヘルス状態を管理
- フェイルオーバーを無効化している場合、タイムアウト/リトライ関連の設定は通常フローに影響しません

### Skills 管理

- Claude Code と Codex の Skills をマルチアプリで利用可能にし、旧レイアウトからの移行もよりスムーズに（#365、#378、@yovinchen に感謝）
- SSOT + React Query による Skills 管理の統一で、状態の一貫性と更新挙動を改善
- Discovery の体験と性能を改善：
  - スキャン時に隠しディレクトリをスキップ
  - Discoverable skills に長寿命キャッシュを適用して高速化
  - ローディング表示の改善と、インポート/更新などの操作導線を整理
  - Skills リポジトリのブランチ設定を修正（#505、@kjasn に感謝）

### Universal Provider

- 複数アプリで共有できるプロバイダ設定を追加（Claude/Codex/Gemini へ同期）（#348、@Calcium-Ion に感謝）
- NewAPI のような複数プロトコル対応の API ゲートウェイを想定
- 1つのプロバイダ内でアプリ別にデフォルトモデルを割り当て可能

### 共通設定スニペット（Claude/Codex/Gemini）

- 「共通設定スニペット」を保持し、有効化したプロバイダへマージ/追記
- 新しい抽出フロー：
  - エディタの現在内容から抽出（編集している内容）
  - エディタ内容がない場合は、現在アクティブなプロバイダから抽出
- Codex の抽出はより安全：
  - `model_provider`、`model`、および `model_providers` テーブル全体など、プロバイダ固有の設定を除去
  - `[mcp_servers.*]` 配下の `base_url` は保持し、MCP 設定を壊しにくくしています

### MCP 管理

- インストール済みアプリから MCP servers をインポート
- 安定性向上：対象 CLI が未インストールなら同期をスキップし、無効な Codex `config.toml` も適切に扱います（#461、@majiayu000 に感謝）
- Windows 互換性：MCP エクスポート時の npx/npm 呼び出しを `cmd /c` でラップ

### 使用量と価格データ

- 使用量/価格の改善：自動更新、キャッシュ指標、タイムゾーン修正、内蔵価格テーブル更新（#508、@yovinchen に感謝）
- DeepLink 対応：deeplink から使用量クエリ設定をインポート（#400、@qyinter に感謝）
- 使用量統計からモデル情報を抽出（#455、@yovinchen に感謝）
- 使用量クエリ資格情報はプロバイダ設定へフォールバック可能（#360、@Sirhexs に感謝）

---

## 使い勝手の改善

- プロバイダ検索フィルター（名前で素早く検索）（#435、@TinsFox に感謝）
- プロバイダのアイコン色：アイコンに任意の色を設定して見分けやすく（#385、@yovinchen に感謝）
- ショートカット：`Cmd/Ctrl + ,` で設定を開く（#436、@TinsFox に感謝）
- Claude Code の初回確認ダイアログをスキップ可能（任意）
- トースト通知のクローズボタン：切り替え通知と成功通知を閉じられるように（#350、@ForteScarlet に感謝）
- 更新バッジをクリックすると About タブへ移動
- 設定ページのタブスタイル改善（#342、@wenyuanw に感謝）
- アプリ/ビュー切り替えのフェードとパネル終了アニメーション
- プロキシテイクオーバー中はエメラルド系テーマを適用して状態を分かりやすく
- ダークモードの視認性改善
- FullScreenPanel のウィンドウドラッグ領域を改善（#525、@zerob13 に感謝）

---

## プラットフォーム別メモ

### Windows

- バージョンチェック時にターミナルが表示されないよう改善
- ウィンドウ最小サイズのデフォルトを調整
- 起動時の黒画面を避けるため、システムタイトルバー方式を採用
- 古い WebView 向けに `crypto.randomUUID()` のフォールバックを追加

### macOS

- 自動起動で `.app` バンドルパスを使用し、ターミナル表示を回避（#462、@majiayu000 に感謝）
- トレイとヘッダー周りの体験を改善

---

## パッケージ

- Linux：RPM と Flatpak のパッケージングを追加し、リリース成果物の生成に対応

---

## 注意事項

- セキュリティ強化：JavaScript 実行器と使用量スクリプト実行に関するセキュリティ問題を修正（#151、@luojiyin1987 に感謝）。
- SQL インポートは CC Switch がエクスポートしたバックアップのみに制限されます（安全性のため）。
- プロキシのテイクオーバーは CLI の live 設定を変更します。CC Switch はリダイレクト前に live 設定をバックアップします。元に戻す場合はテイクオーバー無効化/プロキシ停止を行い、必要に応じてバックアップから復元してください。

## 特別な謝辞

@xunyu @deijing @su-fen の皆様のサポートと貢献に特別な感謝を申し上げます。皆様なしではこのリリースは実現しませんでした！

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

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

### システム要件

| システム | 最低バージョン                | アーキテクチャ                      |
| -------- | ----------------------------- | ----------------------------------- |
| Windows  | Windows 10 以降               | x64                                 |
| macOS    | macOS 10.15 (Catalina) 以降   | Intel (x64) / Apple Silicon (arm64) |
| Linux    | 下表参照                      | x64                                 |

### Windows

| ファイル                                | 説明                                         |
| --------------------------------------- | -------------------------------------------- |
| `CC-Switch-v3.9.0-Windows.msi`          | **推奨** - MSI インストーラー、自動更新対応  |
| `CC-Switch-v3.9.0-Windows-Portable.zip` | ポータブル版、インストール不要               |

### macOS

| ファイル                        | 説明                                                              |
| ------------------------------- | ----------------------------------------------------------------- |
| `CC-Switch-v3.9.0-macOS.zip`    | **推奨** - 解凍して Applications へドラッグ、Universal Binary     |
| `CC-Switch-v3.9.0-macOS.tar.gz` | Homebrew インストールおよび自動更新用                             |

> **注意**: 作者が Apple Developer アカウントを持っていないため、初回起動時に「開発元が未確認」という警告が表示される場合があります。アプリを閉じてから、「システム設定」→「プライバシーとセキュリティ」→「このまま開く」をクリックすると、正常に開けるようになります。

### Homebrew (MacOS)

```bash
brew tap farion1231/ccswitch
brew install --cask cc-switch
```

アップデート:

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

### Linux

| ディストリビューション                  | 推奨形式    | インストール方法                                                               |
| --------------------------------------- | ----------- | ------------------------------------------------------------------------------ |
| 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`                      |
| サンドボックスで実行したい場合          | `.flatpak`  | `flatpak install CC-Switch-*.flatpak`                                          |
