docs/release-notes/v3.14.0-ja.md
Hermes Agent が 6 番目の管理対象アプリに、Claude Opus 4.7 をプリセットマトリクス全体へ展開、Gemini Native API プロキシ、「Local Routing」への名称統一、アプリケーションレベルのウィンドウコントロール
CC Switch v3.14.0 は、Hermes Agent を 6 番目の一等管理対象アプリケーションとして CC Switch に取り込み、Claude Opus 4.7 をアグリゲーターおよび Bedrock プリセットのマトリクス全体に展開することを中心に据えた大型リリースです。Hermes サポートは、データベース v9 → v10 マイグレーション、完全な Rust コマンド面、アトミックバックアップ付きの YAML ベースな ~/.hermes/config.yaml 読み書き、MCP 同期、Skills 同期、SQLite + JSONL セッション管理、および Memory エディターを含む専用のフロントエンドパネルをカバーします。Hermes Agent 0.10.0 スキーマに整合する 4 つの API プロトコル(chat_completions、anthropic_messages、codex_responses、bedrock_converse)すべてを選択可能です。ユーザーが直接記述した providers: dict のエントリは読み取り専用カードとして表示され、深い YAML 設定は Hermes Web UI に委譲されます。
Hermes に加えて、本リリースでは Gemini Native API プロキシ(api_format = "gemini_native")を追加し、プロキシがリクエストを Google の generateContent エンドポイントに直接転送できるようにしました(完全なストリーミング、スキーマ変換、シャドウリクエストをサポート)。また、旧「Local Proxy Takeover」を三言語の UI / README / ドキュメント全体で Local Routing に統一リネームし、コンポジターが描画するボタンが無反応になり得る Linux Wayland などのシーンで、CC Switch が自前で最小化 / 最大化 / 閉じるボタンを描画できるオプション「アプリケーションレベルのウィンドウコントロール」を導入しました。さらにリリース直前に、ツールバーからの hermes dashboard 直接起動、LemonData の全アプリプリセット、DDSHub の Codex エンドポイント、および複数の Hermes ヘルスチェックと Usage モーダルの修正が追加されました。
セッション側では、@tanstack/react-virtual によるセッションリストの仮想化で数千件のレコードを持つ長い会話も滑らかにスクロールでき、長いメッセージはデフォルトで折り畳まれます。Usage ダッシュボードには日付範囲ピッカー(今日 / 1d / 7d / 14d / 30d + カスタム日時カレンダー)とページジャンプ入力が追加され、Stream Check エラー分類は色分けされたトーストで提示され、デフォルトの探索モデルが更新され、「モデルが見つからない」レスポンスを個別に識別するようになりました。また、Local Routing が有効な間に公式プロバイダーへの切り替えを強制的にブロックする保護を追加し、公式 API トラフィックがローカルプロキシを経由することによるアカウント停止リスクを防ぎます。Pricing データベースは v8 → v9 で再シードされ、約 50 件の新しいモデルエントリ(Claude 4.7、Opus 4.7 Adaptive Thinking、Grok 4、Qwen 3.5/3.6、MiniMax M2.5/M2.7、Doubao Seed 2.0 系列、GLM-5/5.1 など)を追加し、いくつかの古い価格を修正しました。
リリース日: 2026-04-21
更新規模: 100 commits | 219 files changed | +20,548 / -3,569 lines
chat_completions / anthropic_messages / codex_responses / bedrock_converse)anthropic.claude-opus-4-7 / global.anthropic.claude-opus-4-7、旧 -v1 サフィックスを廃止)、全アグリゲーター / Bedrock プリセットを Opus 4.7 をデフォルト Opus モデルに移行max エフォートティア: エフォートのドロップダウンを high から max に引き上げapi_format = "gemini_native" により、プロキシが Google の generateContent に直接転送可能に(完全なストリーミング / スキーマ変換 / シャドウリクエスト対応)tool_result メッセージ分類修正、subagent 検出、x-interaction-id 課金マージ、孤立 tool_result のサニタイズ、Warmup ダウングレードのデフォルト有効化など、premium 交互消費を系統的に削減message_id 末尾ノイズを除去~/.hermes/config.yaml や openclaw.json のカスタム位置を指定可能hermes dashboard を実行可能CC Switch は Hermes Agent を Claude / Codex / Gemini / OpenCode / OpenClaw と並ぶ一等の管理対象アプリとして初めてサポートします。
mcp_servers と skills テーブルに enabled_hermes カラムを追加(DEFAULT 0、自動マイグレーション、データ損失なし)~/.hermes/config.yaml をアトミックバックアップ付きで読み書き。tests/hermes_roundtrip.rs が OAuth MCP auth ブロックの消失や無関係なキーの汚染を防止chat_completions / anthropic_messages / codex_responses / bedrock_converse。新しいディープリンクはデフォルトで chat_completionsproviders: dict の読み取り専用表示: YAML に手書きされたプロバイダーエントリは CC Switch で読み取り専用カードとして表示され、深い設定は Hermes Web UI に委譲MEMORY.md / USER.md を直接編集できる Memory パネルを追加(有効化スイッチ、文字数制限、ライブ保存フロー付き)hermes dashboard を実行する確認ダイアログを表示hermes dashboard 自身が準備完了後にブラウザを開くため、ポーリングは不要hermes web のヒントも修正(正しいコマンドは hermes dashboard)/usr/bin、/bin、/usr/local/bin を stat する前に which を試すようにanthropic.claude-opus-4-7 / global.anthropic.claude-opus-4-7、旧 -v1 サフィックスを廃止)max エフォートティアhigh から max に引き上げ、より強力な推論容量を解放api_format = "gemini_native" により、プロキシが Google の generateContent API に直接転送可能 (#1918, 感謝 @yovinchen)gemini_url.rs、gemini_schema.rs、gemini_shadow.rs、streaming_gemini.rs、transform_gemini.rs を追加@tanstack/react-virtual によりセッションリストを仮想化。数千件のレコードを持つ長い会話も滑らかにスクロールmessage_id 末尾ノイズを除去openclaw.json のカスタム位置を設定できるオプションを追加 (#1518, 感謝 @mrFranklin)~/.hermes/config.yaml のカスタム位置を設定できるオプションを追加。データ駆動 dispatch でサポートANTHROPIC_API_KEY 認証を使用。OpenAI 互換アプリは gpt-5.4 をターゲット/v1 サフィックスを省略(ゲートウェイが OpenAI SDK パスを自動ルーティング)Auto api_mode の削除chat_completionsmodel: にバインドExternalLink から LayoutDashboard に変更(クリック時に単に URL を開くのではなく hermes dashboard を起動する場合があるため、パネル型アイコンのほうが意味的に正確)ANTHROPIC_REASONING_MODEL を削除"main" から TRAY_ID 定数("cc-switch")に移行。すべての呼び出し箇所で同期 (#1978, 感謝 @lidaxian121)Copilot リバースプロキシの premium 交互消費を削減するための系統的な最適化。以下の複数の改善をカバー:
thinking / redacted_thinking ブロックは OpenAI 互換エンドポイントに拒否される。従来は上流でリクエストが失敗して premium 交互を 1 回消費した後、thinking_rectifier によってリトライされていた。新しい主動削除ステップ(Copilot 最適化パイプラインの 3.5 ステップ目、tool_result マージ後)により、この無駄な premium 消費を直接解消tool_result を含むメッセージをユーザー発起の新規リクエストではなく、エージェント継続として分類。ツール呼び出しが毎回 premium 交互としてカウントされる問題を防止__SUBAGENT_MARKER__ と metadata._agent_ フォールバックで subagent を識別し、x-interaction-type=conversation-subagent を設定x-interaction-id による課金マージ: セッション ID から x-interaction-id を導出し、同一セッション内の複数リクエストを 1 回の課金交互に統合tool_result のサニタイズ: 孤立した tool_result を整理し、上流エラーによるリトライおよび重複課金を防止gpt-5-mini をデフォルトのダウングレードモデルとして使用tool_result セマンティクスを参照可能にCopilotOptimizerConfig のデフォルト値の不一致を修正(gpt-5-mini に統一)auth 消失auth ブロックが消失したり、無関係な YAML キーが汚染されたりしなくなったtests/hermes_roundtrip.rs をガードテストとして追加custom_providers: の下に永続化され、api_mode と model が再起動 / 設定再読み込みを生き延びるcheck_additive_app_stream(OpenClaw のディスパッチャー)にルーティングされており、これは camelCase の baseUrl / apiKey / api を読むため、Hermes フィールドをすべて記入しても "OpenClaw provider is missing baseUrl" と表示されていたcheck_hermes_stream を導入し、Hermes 専用のエクストラクターで api_mode(chat_completions / anthropic_messages / codex_responses)を対応する check_claude_stream の api_format にマッピング。bedrock_converse は非対応として返すapi_mode を解決することで、bedrock_converse を選んだユーザーには「missing base_url」という誤解を招くメッセージではなく実際の原因が表示されるgetProviderCredentials が Hermes(snake_case の base_url / api_key)と OpenClaw(camelCase の baseUrl / apiKey)のフラットな settingsConfig フィールドを読むようになり、SiliconFlow などマッチするプロバイダーで「official balance」テンプレートが自動選択されるenv.ANTHROPIC_* を直接再読するのではなく、事前計算された providerCredentials を再利用するように変更。これにより非 Claude アプリでキーが設定されていても「empty key」エラーが出ていた問題を修正cache_control 保持cache_control を保持 (#1946, 感謝 @yovinchen)settings.json 同期settings.json に同期されるように修正 (#1905, 感謝 @chengww5217)env ブロックが消えないように修正weekly_limit ティアラベルを公式の「7 日」命名にロケール間で揃えた--working-directory 付きのシェル実行に変更 (#1976, 感謝 @Suda202)cwd エスケープ問題を回避code.pipellm.ai に更新api_mode が必須Auto モードは廃止。インポートまたはディープリンクで取得したプロバイダーはデフォルトで chat_completionsAuto 設定のユーザーはプロトコルを選択するよう促されるANTHROPIC_REASONING_MODEL を削除mcp_servers と skills に enabled_hermes カラムを追加DEFAULT 0 で自動マイグレーション、データ損失なしmodel_pricing テーブルがクリアされ再シードされる本リリースは、リバースプロキシ型機能について v3.12.3 / v3.13.0 で提起された既存のリスク注意事項を継承します。
GitHub Copilot リバースプロキシ: Copilot のリバースプロキシパスを使用すると、GitHub / Microsoft の利用規約に違反する可能性があります。詳細は v3.12.3 リリースノート を参照してください。
Codex OAuth リバースプロキシ: ChatGPT サブスクリプションで Codex OAuth リバースプロキシを使用すると、OpenAI の利用規約に違反する可能性があります。詳細は v3.13.0 リリースノート を参照してください。
これらの機能を有効にすることで、ユーザーはすべての関連リスクを自己責任で受諾したものとみなされます。CC Switch はこれらの機能の使用に起因するアカウントの制限、警告、サービス停止について一切の責任を負いません。
Releases から対応バージョンをダウンロードしてください。
| OS | 最小バージョン | アーキテクチャ |
|---|---|---|
| Windows | Windows 10 以降 | x64 |
| macOS | macOS 12 (Monterey) 以降 | Intel (x64) / Apple Silicon (arm64) |
| Linux | 下表参照 | x64 |
| ファイル | 説明 |
|---|---|
CC-Switch-v3.14.0-Windows.msi | 推奨 - MSI インストーラー、自動更新対応 |
CC-Switch-v3.14.0-Windows-Portable.zip | ポータブル版、解凍して実行、レジストリ不要 |
| ファイル | 説明 |
|---|---|
CC-Switch-v3.14.0-macOS.dmg | 推奨 - DMG インストーラー、Applications にドラッグ |
CC-Switch-v3.14.0-macOS.zip | 解凍して Applications にドラッグ、Universal Binary |
CC-Switch-v3.14.0-macOS.tar.gz | Homebrew インストールと自動更新用 |
macOS 版は Apple のコード署名および公証済みで、直接インストールして使用できます。
brew tap farion1231/ccswitch
brew install --cask cc-switch
更新:
brew upgrade --cask cc-switch
| ディストリビューション | 推奨形式 | インストール方法 |
|---|---|---|
| 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 |