mirror of
https://github.com/farion1231/cc-switch.git
synced 2026-08-04 19:45:34 +08:00
- docs: update user manual for v3.15.0
- Sync zh/en/ja manuals with Claude Desktop and Hermes support - Update install requirements, official channels, and release asset guidance - Document Usage Hero, Codex OAuth live models, Save Anyway, Hermes sessions, and Warp launch - Correct tray and app-scope descriptions to match current implementation
This commit is contained in:
@@ -2,14 +2,14 @@
|
||||
|
||||
## CC Switch とは
|
||||
|
||||
CC Switch はクロスプラットフォームのデスクトップアプリケーションで、AI プログラミングツールを使用する開発者向けに設計されています。**Claude Code**、**Codex**、**Gemini CLI**、**OpenCode**、**OpenClaw** の 5 つの AI プログラミングツールの設定を統一的に管理できます。
|
||||
CC Switch はクロスプラットフォームのデスクトップアプリケーションで、AI プログラミングツールを使用する開発者向けに設計されています。**Claude Code**、**Claude Desktop**、**Codex**、**Gemini CLI**、**OpenCode**、**OpenClaw**、**Hermes** などの管理対象アプリの設定を統一的に管理できます。
|
||||
|
||||
## どのような問題を解決するか
|
||||
|
||||
日常の開発で、以下のような課題に直面することがあります:
|
||||
|
||||
- **複数プロバイダーの切り替えが面倒**:異なる API プロバイダー(公式、中継サービスなど)を使用する際、設定ファイルを手動で変更する必要がある
|
||||
- **設定が分散して管理しづらい**:Claude、Codex、Gemini、OpenCode、OpenClaw がそれぞれ独立した設定ファイルを持ち、フォーマットも異なる
|
||||
- **設定が分散して管理しづらい**:Claude Code、Claude Desktop、Codex、Gemini、OpenCode、OpenClaw、Hermes がそれぞれ独立した設定ファイルを持ち、フォーマットも異なる
|
||||
- **使用量を監視できない**:API をどれだけ呼び出したか、いくらかかったかが分からない
|
||||
- **サービスが不安定**:単一プロバイダーに問題が発生すると、ワークフロー全体が中断する
|
||||
|
||||
@@ -21,6 +21,7 @@ CC Switch は統一されたインターフェースでこれらの問題を解
|
||||
- ワンクリックで複数の API プロバイダー設定を切り替え
|
||||
- プリセットテンプレートで一般的なプロバイダーを素早く追加
|
||||
- 統一プロバイダー機能で、アプリ間で設定を共有
|
||||
- Claude Desktop のサードパーティプロバイダー、直結モード、モデルマッピング
|
||||
- 使用量クエリと残額表示
|
||||
- エンドポイント速度テスト
|
||||
|
||||
@@ -40,16 +41,18 @@ CC Switch は統一されたインターフェースでこれらの問題を解
|
||||
| アプリ | 説明 |
|
||||
|------|------|
|
||||
| **Claude Code** | Anthropic 公式の AI プログラミングアシスタント |
|
||||
| **Claude Desktop** | Claude デスクトップアプリ。公式サインインとサードパーティ 3P profile に対応 |
|
||||
| **Codex** | OpenAI のコード生成ツール |
|
||||
| **Gemini CLI** | Google の AI コマンドラインツール |
|
||||
| **OpenCode** | オープンソース AI プログラミングターミナルツール |
|
||||
| **OpenClaw** | オープンソース AI プログラミングアシスタント(マルチプロバイダーゲートウェイ) |
|
||||
| **Hermes** | Hermes Agent のプロバイダー、MCP、Skills、Memory 管理 |
|
||||
|
||||
## 対応プラットフォーム
|
||||
|
||||
- **Windows** 10 以上
|
||||
- **macOS** 10.15 (Catalina) 以上
|
||||
- **Linux** Ubuntu 22.04+ / Debian 11+ / Fedora 34+
|
||||
- **macOS** 12 (Monterey) 以上
|
||||
- **Linux** Ubuntu 22.04+ / Debian 11+ / Fedora 34+(x64 / ARM64)
|
||||
|
||||
## 技術アーキテクチャ
|
||||
|
||||
|
||||
@@ -1,5 +1,15 @@
|
||||
# 1.2 インストールガイド
|
||||
|
||||
## 公式チャネルとシステム要件
|
||||
|
||||
CC Switch は **[ccswitch.io](https://ccswitch.io)**、**[GitHub Releases](https://github.com/farion1231/cc-switch/releases)**、またはプロジェクトのソースリポジトリからのみ入手してください。支払い、チャージ、ログイン情報の入力を求める「CC Switch」サイトやクライアントは公式ではありません。
|
||||
|
||||
| システム | 最低バージョン | アーキテクチャ |
|
||||
|------|----------------|----------------|
|
||||
| Windows | Windows 10 以上 | x64 |
|
||||
| macOS | macOS 12 (Monterey) 以上 | Intel (x64) / Apple Silicon (arm64) |
|
||||
| Linux | 下記ディストリビューション説明を参照 | x64 / ARM64 |
|
||||
|
||||
## 前提条件
|
||||
|
||||
### Node.js のインストール
|
||||
@@ -127,8 +137,8 @@ brew upgrade --cask cc-switch
|
||||
|
||||
### 方法 2:手動ダウンロード
|
||||
|
||||
1. `CC-Switch-v{バージョン}-macOS.zip` をダウンロード
|
||||
2. 展開して `CC Switch.app` を取得
|
||||
1. `CC-Switch-v{バージョン}-macOS.dmg`(推奨)または `CC-Switch-v{バージョン}-macOS.zip` をダウンロード
|
||||
2. DMG を開く、または zip を展開して `CC Switch.app` を取得
|
||||
3. 「アプリケーション」フォルダにドラッグ
|
||||
|
||||
### 署名・公証済み
|
||||
@@ -151,11 +161,11 @@ yay -S cc-switch-bin
|
||||
|
||||
### Debian / Ubuntu
|
||||
|
||||
1. `CC-Switch-v{バージョン}-Linux.deb` をダウンロード
|
||||
1. アーキテクチャに合わせて `CC-Switch-v{バージョン}-Linux-x86_64.deb` または `CC-Switch-v{バージョン}-Linux-arm64.deb` をダウンロード
|
||||
2. インストール:
|
||||
|
||||
```bash
|
||||
sudo dpkg -i CC-Switch-v{バージョン}-Linux.deb
|
||||
sudo dpkg -i CC-Switch-v{バージョン}-Linux-*.deb
|
||||
|
||||
# 依存関係に問題がある場合
|
||||
sudo apt-get install -f
|
||||
@@ -163,17 +173,17 @@ sudo apt-get install -f
|
||||
|
||||
### AppImage(汎用)
|
||||
|
||||
1. `CC-Switch-v{バージョン}-Linux.AppImage` をダウンロード
|
||||
1. アーキテクチャに合わせて `CC-Switch-v{バージョン}-Linux-x86_64.AppImage` または `CC-Switch-v{バージョン}-Linux-arm64.AppImage` をダウンロード
|
||||
2. 実行権限を追加:
|
||||
|
||||
```bash
|
||||
chmod +x CC-Switch-v{バージョン}-Linux.AppImage
|
||||
chmod +x CC-Switch-v{バージョン}-Linux-*.AppImage
|
||||
```
|
||||
|
||||
3. 実行:
|
||||
|
||||
```bash
|
||||
./CC-Switch-v{バージョン}-Linux.AppImage
|
||||
./CC-Switch-v{バージョン}-Linux-*.AppImage
|
||||
```
|
||||
|
||||
## インストールの確認
|
||||
@@ -182,7 +192,7 @@ chmod +x CC-Switch-v{バージョン}-Linux.AppImage
|
||||
|
||||
1. アプリウィンドウが正常に表示される
|
||||
2. システムトレイに CC Switch のアイコンが表示される
|
||||
3. Claude / Codex / Gemini の 3 つのアプリを切り替えられる
|
||||
3. アプリ切り替えに有効化された管理対象アプリが表示され、目的のアプリパネルへ切り替えられる
|
||||
|
||||
## 自動更新
|
||||
|
||||
|
||||
@@ -11,7 +11,7 @@
|
||||
| ① | Logo | クリックで GitHub プロジェクトページにアクセス |
|
||||
| ② | 設定ボタン | 設定ページを開く(ショートカット `Cmd/Ctrl + ,`) |
|
||||
| ③ | プロキシスイッチ | ローカルプロキシサービスの起動/停止 |
|
||||
| ④ | アプリ切り替え | Claude / Codex / Gemini / OpenCode / OpenClaw を切り替え |
|
||||
| ④ | アプリ切り替え | Claude / Claude Desktop / Codex / Gemini / OpenCode / OpenClaw / Hermes を切り替え |
|
||||
| ⑤ | 機能エリア | Skills / Prompts / MCP の入口 |
|
||||
| ⑥ | 追加ボタン | 新しいプロバイダーを追加 |
|
||||
|
||||
@@ -20,10 +20,12 @@
|
||||
ドロップダウンメニューをクリックして、現在管理するアプリを切り替えます:
|
||||
|
||||
- **Claude** - Claude Code の設定を管理
|
||||
- **Claude Desktop** - Claude Desktop のサードパーティプロバイダーと公式モードを管理
|
||||
- **Codex** - Codex の設定を管理
|
||||
- **Gemini** - Gemini CLI の設定を管理
|
||||
- **OpenCode** - OpenCode の設定を管理
|
||||
- **OpenClaw** - OpenClaw の設定を管理
|
||||
- **Hermes** - Hermes Agent のプロバイダーと Memory を管理
|
||||
|
||||
切り替え後、プロバイダーリストに対応アプリの設定が表示されます。
|
||||
|
||||
@@ -56,6 +58,8 @@
|
||||
|
||||
> **ヒント**:操作ボタンエリア(⑤-⑩)はマウスホバー時に表示され、通常は非表示で画面をすっきり保ちます。
|
||||
|
||||
v3.15.0 から、Claude Code と Codex の一部プロバイダーカードには **Local Routing 対応バッジ**も表示されます。ローカルルーティング経由で利用できるプロバイダーを素早く判別できます。
|
||||
|
||||
### ボタンの詳細説明
|
||||
|
||||
| ボタン | 状態変化 | 説明 |
|
||||
@@ -100,12 +104,12 @@ CC Switch はシステムトレイにアイコンを表示し、クイック操
|
||||
| メニュー項目 | 機能 |
|
||||
|--------|------|
|
||||
| メインウィンドウを開く | メインウィンドウを表示してフォーカス |
|
||||
| アプリサブメニュー | Claude/Codex/Gemini/OpenCode/OpenClaw ごとの折りたたみサブメニュー(例:「Claude · PackyCode」) |
|
||||
| アプリサブメニュー | Claude/Codex/Gemini ごとの折りたたみサブメニュー(例:「Claude · PackyCode」)。利用可能な場合は現在のプロバイダーとキャッシュ済み使用量サマリーも表示 |
|
||||
| プロバイダーリスト | 各サブメニュー内でクリックして切り替え、現在有効なものにはチェックマークを表示 |
|
||||
| ライトウェイトモード | トグルチェックボックスでトレイ専用モードの開始/終了 |
|
||||
| 終了 | アプリを完全に終了 |
|
||||
|
||||
> **注意**:各アプリのサブメニュータイトルには現在のプロバイダー名が表示されます(例:「Claude · PackyCode」)。プロバイダーが設定されていないアプリでは、無効化された「(プロバイダーなし)」エントリが表示されます。アプリの表示はアプリの表示設定で制御されます。
|
||||
> **注意**:各トレイサブメニューのタイトルには現在のプロバイダー名が表示されます(例:「Claude · PackyCode」)。プロバイダーが設定されていないアプリでは、無効化された「(プロバイダーなし)」エントリが表示されます。トレイは現在、プロキシルーティングと使用量サマリーに対応する Claude / Codex / Gemini にフォーカスしています。メイン画面のアプリ表示はアプリの表示設定で制御されます。
|
||||
|
||||
### 多言語対応
|
||||
|
||||
|
||||
@@ -5,7 +5,7 @@
|
||||
メイン画面右上の **+** ボタンをクリックして、プロバイダー追加パネルを開きます。
|
||||
|
||||
パネルは 2 つのタブに分かれています:
|
||||
- **アプリ専用プロバイダー**:現在選択中のアプリ(Claude/Codex/Gemini/OpenCode/OpenClaw)専用
|
||||
- **アプリ専用プロバイダー**:現在選択中のアプリ(Claude Code / Claude Desktop / Codex / Gemini / OpenCode / OpenClaw / Hermes)専用
|
||||
- **統一プロバイダー**:アプリ間で共有する設定
|
||||
|
||||
## プリセットで追加
|
||||
@@ -56,6 +56,16 @@
|
||||
|
||||
> ⭐ は公式パートナーを示します。プリセットリストはバージョンの更新に伴い変更される場合があります。アプリ内の実際の表示を基準にしてください。
|
||||
|
||||
#### Claude Desktop プリセット
|
||||
|
||||
Claude Desktop パネルには、Claude Code のプリセットカタログから変換されたプロバイダープリセットが含まれます。追加時には次のモードを選択できます:
|
||||
|
||||
- **直結モード**:プロバイダーがネイティブの Anthropic Messages API を提供し、Claude Desktop から直接アクセスできる場合
|
||||
- **モデルマッピングモード**:非 Claude モデルを CC Switch ローカルゲートウェイ経由で Sonnet / Opus / Haiku ルートへマッピング
|
||||
- **Claude Desktop Official**:Claude Desktop の公式サインインモードへ戻す
|
||||
|
||||
詳しい手順は [2.6 Claude Desktop](./2.6-claude-desktop.md) を参照してください。
|
||||
|
||||
#### Codex プリセット
|
||||
|
||||
| プリセット名 | 説明 |
|
||||
@@ -161,7 +171,7 @@
|
||||
3. CC Switch が設定された API Key で OpenAI 互換の `/v1/models` エンドポイントを呼び出し
|
||||
4. カテゴリ別にグループ化されたドロップダウンからモデルを選択
|
||||
|
||||
この機能は **5 つのアプリ全対応** —— **Claude / Codex / Gemini / OpenCode / OpenClaw** のプロバイダーで利用可能で、`/v1/models` エンドポイントをサポートするすべてのプロバイダーに対応します。
|
||||
この機能は **Claude Code / Claude Desktop / Codex / Gemini / OpenCode / OpenClaw / Hermes** のうちモデル項目を持つプロバイダーフォームで利用でき、`/v1/models` エンドポイントをサポートするプロバイダーに対応します。Codex OAuth 系プロバイダーでは、必要に応じて ChatGPT Codex バックエンドからライブモデル一覧を取得します。
|
||||
|
||||
**よくあるエラー:**
|
||||
- **認証失敗(401/403)**:API Key が正しいか確認してください
|
||||
@@ -259,7 +269,7 @@ requires_openai_auth = true
|
||||
|
||||
## 統一プロバイダー
|
||||
|
||||
統一プロバイダーは Claude/Codex/Gemini/OpenCode/OpenClaw 間で設定を共有でき、複数の API 形式をサポートする中継サービスに適しています。
|
||||
統一プロバイダーは Claude Code / Codex / Gemini 間で設定を共有でき、複数の API 形式をサポートする中継サービスに適しています。
|
||||
|
||||
### 統一プロバイダーの作成
|
||||
|
||||
@@ -269,7 +279,7 @@ requires_openai_auth = true
|
||||
- 名前
|
||||
- API Key
|
||||
- エンドポイントアドレス
|
||||
4. 同期するアプリにチェック(Claude/Codex/Gemini/OpenCode/OpenClaw)
|
||||
4. 同期するアプリにチェック(Claude Code / Codex / Gemini)
|
||||
5. 保存
|
||||
|
||||
### 同期の仕組み
|
||||
@@ -403,6 +413,8 @@ Codex OAuth プリセットのデフォルトモデルマッピング:
|
||||
| Opus 役割 | `gpt-5.4` |
|
||||
| Haiku 役割 | `gpt-5.4-mini` |
|
||||
|
||||
v3.15.0 以降、Codex OAuth のモデル選択は固定リストだけに依存しません。モデルセレクターを開くと、CC Switch は必要に応じて ChatGPT Codex バックエンドから利用可能モデルを取得します。デフォルトマッピングは引き続き上書きできます。
|
||||
|
||||
プロバイダーの JSON エディタで `ANTHROPIC_MODEL` などの環境変数を上書きしてカスタマイズできます。
|
||||
|
||||
### マルチアカウント管理(OAuth 認証センター)
|
||||
@@ -523,7 +535,7 @@ Codex プロバイダーの追加時、**1M コンテキストウィンドウを
|
||||
- **有効時**:config.toml に `model_context_window = 1000000` を設定し、`model_auto_compact_token_limit = 900000` を自動入力
|
||||
- **無効時**:両方のフィールドを削除
|
||||
|
||||
トグルがオンの場合に表示されるテキストフィールドで、自動コンパクト制限をカスタマイズできます。
|
||||
トグルがオンの場合に表示されるテキストフィールドで、自動コンパクト制限をカスタマイズできます。v3.15.0 以降、このトグルは Codex プロバイダーの新規追加時のみ表示されます。既存プロバイダーの編集時は、必要に応じて高度な設定で該当フィールドを直接調整してください。
|
||||
|
||||
### カスタムアイコン
|
||||
|
||||
|
||||
@@ -39,14 +39,12 @@ v3.13.0 より、トレイメニューがフラットなリストから **アプ
|
||||
| Claude | Claude のすべてのプロバイダー(Codex OAuth リバースプロキシを含む) |
|
||||
| Codex | Codex のすべてのプロバイダー |
|
||||
| Gemini | Gemini のすべてのプロバイダー |
|
||||
| OpenCode | OpenCode のすべてのプロバイダー |
|
||||
| OpenClaw | OpenClaw のすべてのプロバイダー |
|
||||
|
||||
**リファクタリングの利点**:
|
||||
|
||||
- **メニューのオーバーフロー防止**:プロバイダーが多数ある場合、フラットなリストでは画面の高さを超えますが、アプリ別サブメニューは自然にスケールします
|
||||
- **サブメニューのタイトルに現在有効なプロバイダーを表示**:サブメニューを開かなくても、各アプリがどのプロバイダーを使用中か一目でわかります
|
||||
- **アプリ別の分離**:Claude のプロバイダーを切り替えても Codex のビューには影響しません
|
||||
- **サブメニューのタイトルに現在有効なプロバイダーと使用量サマリーを表示**:サブメニューを開かなくても、Claude / Codex / Gemini がどのプロバイダーを使用中か、利用可能なキャッシュ済み使用量情報とあわせて確認できます
|
||||
- **アプリ別の分離**:Claude のプロバイダーを切り替えても Codex や Gemini のビューには影響しません
|
||||
|
||||
> **ヒント**:バックグラウンド常駐 + 軽量モード + アプリ別サブメニューの組み合わせは、複数のアプリを頻繁に切り替えるヘビーユーザーに特に適しています。[1.5 個人設定 → 軽量モード](../1-getting-started/1.5-settings.md) を参照してください。
|
||||
|
||||
|
||||
@@ -151,8 +151,9 @@ Claude プロバイダーの編集時、JSON エディタの上部にツール
|
||||
## 保存と反映
|
||||
|
||||
1. 「保存」ボタンをクリック
|
||||
2. 現在有効なプロバイダーの場合、設定は即座に live ファイルに書き込まれる
|
||||
3. CLI ツールを再起動して反映
|
||||
2. フォームが非ブロッキングな問題を検出した場合、「それでも保存」の確認が表示されます。確認すると保存できます
|
||||
3. 現在有効なプロバイダーの場合、設定は即座に live ファイルに書き込まれる
|
||||
4. CLI ツールを再起動して反映
|
||||
|
||||
## 編集のキャンセル
|
||||
|
||||
|
||||
@@ -24,6 +24,8 @@
|
||||
- 現在の設定をバックアップ
|
||||
- テスト用の設定を作成
|
||||
|
||||
v3.15.0 以降、統一プロバイダー一覧にも複製アクションがあります。既存の統一プロバイダーをコピーしてから、有効化するアプリやモデルを調整できます。
|
||||
|
||||
### 操作手順
|
||||
|
||||
1. プロバイダーカードにマウスをホバーして操作ボタンを表示
|
||||
|
||||
@@ -11,12 +11,13 @@
|
||||
| OpenCode | `~/.local/share/opencode/`(JSON または SQLite) |
|
||||
| OpenClaw | `~/.openclaw/agents/<agent>/sessions/*.jsonl` |
|
||||
| Gemini CLI | `~/.cache/gemini/tmp/<project_hash>/chats/` |
|
||||
| Hermes | `~/.hermes/state.db` または `~/.hermes/sessions/*.jsonl` |
|
||||
|
||||
## セッションマネージャーを開く
|
||||
|
||||
メインナビゲーションバーの **セッション** ボタンをクリックします。
|
||||
|
||||
> **注意**:セッションボタンは対応する 5 つのアプリすべてで表示されます。
|
||||
> **注意**:セッションマネージャーは上表の 6 種類のセッションソースを対象にします。Claude Desktop 入口では Claude Code のセッションビューを再利用します。
|
||||
|
||||
## インターフェースのレイアウト
|
||||
|
||||
@@ -63,6 +64,7 @@
|
||||
- **OpenCode**
|
||||
- **OpenClaw**
|
||||
- **Gemini CLI**
|
||||
- **Hermes**
|
||||
|
||||
フィルターは検索と組み合わせて使用できます。
|
||||
|
||||
@@ -81,7 +83,7 @@
|
||||
- ターミナルはセッションのプロジェクトディレクトリで開きます
|
||||
- ターミナルの起動に失敗した場合、コマンドがクリップボードにコピーされます
|
||||
|
||||
**対応ターミナル(macOS):** Terminal.app、iTerm2、Ghostty、Kitty、WezTerm、Alacritty
|
||||
**対応ターミナル(macOS):** Terminal.app、iTerm2、Ghostty、Kitty、WezTerm、Alacritty、Warp
|
||||
|
||||
**その他のプラットフォーム:**
|
||||
- 再開コマンドがクリップボードにコピーされます
|
||||
@@ -103,7 +105,7 @@ v3.13.0 より、**Claude セッション** の再開前に **ディレクトリ
|
||||
2. 表示されるディレクトリピッカーで、デフォルトのディレクトリを確認するか、新しいディレクトリを選択
|
||||
3. CC Switch が選択したディレクトリで Claude ターミナルセッションを起動します
|
||||
|
||||
> **ヒント**:Codex / Gemini / OpenCode / OpenClaw のセッション再開フローには現在ディレクトリピッカーは含まれず、セッション元のプロジェクトディレクトリを使用します。
|
||||
> **ヒント**:Codex / Gemini / OpenCode / OpenClaw / Hermes のセッション再開フローには現在ディレクトリピッカーは含まれず、セッション元のプロジェクトディレクトリを使用します。
|
||||
|
||||
### セッションの削除
|
||||
|
||||
|
||||
@@ -50,10 +50,15 @@ v3.13.0 より、使用量データの取得元は 2 つあります:
|
||||
| 指標 | 説明 |
|
||||
|------|------|
|
||||
| 総リクエスト数 | 統計期間内のリクエスト総数 |
|
||||
| 総 Token | 入力 + 出力 Token の合計 |
|
||||
| 実消費 Token | 入力 + 出力 + キャッシュ作成 + キャッシュ読取をキャッシュ正規化した合計 |
|
||||
| キャッシュヒット率 | キャッシュ可能な入力に対するキャッシュ読取 Token の割合 |
|
||||
| 推定費用 | 料金設定に基づいて計算された費用 |
|
||||
| 成功率 | 成功したリクエストの割合 |
|
||||
|
||||
v3.15.0 以降、使用量ページ上部はフィルター連動の Hero カードになりました。日付範囲、アプリ、プロバイダー、モデルフィルターを変更すると、Hero の実消費 Token、キャッシュヒット率、リクエスト数、費用が同時に更新され、下部のログや統計一覧と整合します。
|
||||
|
||||
> 注意:v3.15.0 ではキャッシュ読取、キャッシュ作成、OpenAI 系プロトコルのキャッシュ報告方式を正規化しています。過去の Token や費用の数値は旧バージョンの推定値と一致しない場合があります。現在の数値は正規化後のルールに基づきます。
|
||||
|
||||
### 期間
|
||||
|
||||
統計の期間を選択できます:
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
- 応答レイテンシが正常か
|
||||
- ストリーミングレスポンスの初回トークン時間(TTFB)
|
||||
|
||||
v3.13.0 より、Stream Check の対応範囲が **5 つのアプリ全対応**(Claude / Codex / Gemini / OpenCode / OpenClaw)に拡張され、OpenClaw の全プロトコルバリアント(`openai-completions` など)も含まれます。OpenCode は npm パッケージマッピングで自動識別、OpenClaw はカスタム `auth-header` 検出、Bedrock エラーメッセージ、`baseURL` フォールバックなどのエッジケースにも対応しています。
|
||||
v3.13.0 より、Stream Check の対応範囲が **Claude / Codex / Gemini / OpenCode / OpenClaw** に拡張され、OpenClaw の全プロトコルバリアント(`openai-completions` など)も含まれます。OpenCode は npm パッケージマッピングで自動識別、OpenClaw はカスタム `auth-header` 検出、Bedrock エラーメッセージ、`baseURL` フォールバックなどのエッジケースにも対応しています。
|
||||
|
||||
## 設定を開く
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# CC Switch ユーザーマニュアル
|
||||
|
||||
> Claude Code / Codex / Gemini CLI / OpenCode / OpenClaw オールインワンアシスタント
|
||||
> Claude Code / Claude Desktop / Codex / Gemini CLI / OpenCode / OpenClaw / Hermes オールインワンアシスタント
|
||||
|
||||
## 目次構成
|
||||
|
||||
@@ -115,13 +115,16 @@ CC Switch ユーザーマニュアル
|
||||
- **Claude Desktop の一等管理パネル**:サードパーティプロバイダー、直結 / モデルマッピングの 2 モード、Copilot / Codex OAuth 再利用、3P profile 書き込みに対応 — 詳細は [2.6 Claude Desktop](./2-providers/2.6-claude-desktop.md)
|
||||
- **役割別モデルマッピング**:Sonnet / Opus / Haiku ルートと `supports1m` フラグで Claude Desktop のモデル検証に対応
|
||||
- **Claude Desktop ローカルルーティング**:変換が必要なプロバイダー向けに `127.0.0.1:15721/claude-desktop` のローカルゲートウェイを提供
|
||||
- **ルーティング対応バッジ**:Claude Code / Codex のプロバイダーカードで Local Routing 対応可否を確認可能
|
||||
- **Codex OAuth ライブモデル検出**:ChatGPT Codex 系プロバイダーは必要に応じて ChatGPT バックエンドから利用可能モデルを取得
|
||||
- **フィルター連動 Usage Hero**:キャッシュ正規化後の実消費 Token とキャッシュヒット率を表示し、日付 / プロバイダー / モデルフィルターに追従 — 詳細は [4.4 使用量統計](./4-proxy/4.4-usage.md)
|
||||
- **軽量モード**:トレイへ最小化時にメインウィンドウを破棄、アイドル時のリソース使用量をほぼゼロに — 詳細は [1.5 個人設定](./1-getting-started/1.5-settings.md)
|
||||
- **クォータ・残高表示**:公式サブスクリプション系(Claude/Codex/Gemini/Copilot/Codex OAuth)はカードに自動表示、Token Plan および第三者残高は内蔵テンプレートでワンクリック有効化 — 詳細は [2.5 使用量クエリ](./2-providers/2.5-usage-query.md)
|
||||
- **Codex OAuth リバースプロキシ**:ChatGPT アカウントで Claude Code 内から Codex サービスを再利用 — 詳細は [2.1 プロバイダーの追加](./2-providers/2.1-add.md)
|
||||
- **アプリ別トレイサブメニュー**:5 アプリ独立サブメニュー、メニューのオーバーフローを防止 — 詳細は [2.2 プロバイダーの切り替え](./2-providers/2.2-switch.md)
|
||||
- **アプリ別トレイサブメニュー**:Claude / Codex / Gemini のサブメニューで現在のプロバイダーと使用量サマリーを確認可能 — 詳細は [2.2 プロバイダーの切り替え](./2-providers/2.2-switch.md)
|
||||
- **Skills の発見と一括更新**:SHA-256 ハッシュによる更新検出、一括更新、skills.sh 公式レジストリ検索 — 詳細は [3.3 Skills スキル管理](./3-extensions/3.3-skills.md)
|
||||
- **完全URLエンドポイントモード**:高度なオプションで `base_url` を完全なアップストリームエンドポイントとして扱う — 詳細は [2.1 プロバイダーの追加](./2-providers/2.1-add.md)
|
||||
- **OpenCode / OpenClaw ストリームチェック完全対応**:Stream Check パネルを 5 アプリ全対応に拡張 — 詳細は [4.5 モデルテスト](./4-proxy/4.5-model-test.md)
|
||||
- **OpenCode / OpenClaw ストリームチェック対応**:Stream Check は Claude / Codex / Gemini / OpenCode / OpenClaw をカバー — 詳細は [4.5 モデルテスト](./4-proxy/4.5-model-test.md)
|
||||
|
||||
## コントリビュート
|
||||
|
||||
|
||||
Reference in New Issue
Block a user