CC-Switch/docs/user-manual/ja

CC Switch ユーザーマニュアル

Claude Code / Claude Desktop / Codex / Gemini CLI / OpenCode / OpenClaw / Hermes オールインワンアシスタント

目次構成

CC Switch ユーザーマニュアル
│
├── 1. はじめに
│   ├── 1.1 ソフトウェア紹介
│   ├── 1.2 インストールガイド
│   ├── 1.3 インターフェース概要
│   ├── 1.4 クイックスタート
│   └── 1.5 個人設定
│
├── 2. プロバイダー管理
│   ├── 2.1 プロバイダーの追加
│   ├── 2.2 プロバイダーの切り替え
│   ├── 2.3 プロバイダーの編集
│   ├── 2.4 並べ替えと複製
│   ├── 2.5 使用量クエリ
│   └── 2.6 Claude Desktop
│
├── 3. 拡張機能
│   ├── 3.1 MCP サーバー管理
│   ├── 3.2 Prompts プロンプト管理
│   ├── 3.3 Skills スキル管理
│   ├── 3.4 セッションマネージャー
│   └── 3.5 ワークスペースとメモリー
│
├── 4. プロキシと高可用性
│   ├── 4.1 プロキシサービス
│   ├── 4.2 アプリケーション接管
│   ├── 4.3 フェイルオーバー
│   ├── 4.4 使用量統計
│   └── 4.5 モデルテスト
│
└── 5. よくある質問
    ├── 5.1 設定ファイルの説明
    ├── 5.2 FAQ
    ├── 5.3 ディープリンクプロトコル
    └── 5.4 環境変数の競合

ファイル一覧

1. はじめに

ファイル	内容
1.1-introduction.md	ソフトウェア紹介、主要機能、対応プラットフォーム
1.2-installation.md	Windows/macOS/Linux インストールガイド
1.3-interface.md	インターフェースレイアウト、ナビゲーションバー、プロバイダーカードの説明
1.4-quickstart.md	5 分でできるクイックスタートチュートリアル
1.5-settings.md	言語、テーマ、ディレクトリ、クラウド同期の設定

2. プロバイダー管理

ファイル	内容
2.1-add.md	プリセットの使用、カスタム設定、統一プロバイダー
2.2-switch.md	メイン画面での切り替え、トレイでの切り替え、反映方法
2.3-edit.md	設定の編集、API Key の変更、バックフィル機能
2.4-sort-duplicate.md	ドラッグで並べ替え、プロバイダーの複製、削除
2.5-usage-query.md	使用量クエリ、残額表示、複数プラン表示
2.6-claude-desktop.md	Claude Desktop サードパーティプロバイダー、直結モード、モデルマッピング

3. 拡張機能

ファイル	内容
3.1-mcp.md	MCP プロトコル、サーバーの追加、アプリバインド
3.2-prompts.md	プリセットの作成、有効化の切り替え、スマートバックフィル
3.3-skills.md	スキルの発見、インストール・アンインストール、リポジトリ管理
3.4-sessions.md	セッションマネージャー：閲覧、検索、再開、削除
3.5-workspace.md	ワークスペースファイルとデイリーメモリー（OpenClaw）

4. プロキシと高可用性

ファイル	内容
4.1-service.md	プロキシの起動、設定項目、実行状態
4.2-routing.md	アプリケーションルーティング、設定変更、ステータス表示
4.3-failover.md	フェイルオーバーキュー、サーキットブレーカー、ヘルスステータス
4.4-usage.md	使用量統計、トレンドグラフ、料金設定
4.5-model-test.md	モデルテスト、ヘルスチェック、レイテンシテスト

5. よくある質問

ファイル	内容
5.1-config-files.md	CC Switch のストレージ、CLI 設定ファイル形式
5.2-questions.md	よくある質問と回答
5.3-deeplink.md	ディープリンクプロトコル、生成と使用方法
5.4-env-conflict.md	環境変数の競合検出と対処

クイックリンク

• 初めての方：1.1 ソフトウェア紹介 からお読みください
• インストールの問題：1.2 インストールガイド をご確認ください
• プロバイダーの設定：2.1 プロバイダーの追加 をご確認ください
• Claude Desktop の利用：2.6 Claude Desktop をご確認ください
• プロキシの使用：4.1 プロキシサービス をご確認ください
• お困りの方：5.2 FAQ をご確認ください

バージョン情報

• ドキュメントバージョン：v3.15.0
• 最終更新：2026-05-16
• CC Switch v3.15.0+ 対応

v3.15.0 の注目機能

• Claude Desktop の一等管理パネル：サードパーティプロバイダー、直結 / モデルマッピングの 2 モード、Copilot / Codex OAuth 再利用、3P profile 書き込みに対応 — 詳細は 2.6 Claude Desktop
• 役割別モデルマッピング：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 使用量統計
• 軽量モード：トレイへ最小化時にメインウィンドウを破棄、アイドル時のリソース使用量をほぼゼロに — 詳細は 1.5 個人設定
• クォータ・残高表示：公式サブスクリプション系（Claude/Codex/Gemini/Copilot/Codex OAuth）はカードに自動表示、Token Plan および第三者残高は内蔵テンプレートでワンクリック有効化 — 詳細は 2.5 使用量クエリ
• Codex OAuth リバースプロキシ：ChatGPT アカウントで Claude Code 内から Codex サービスを再利用 — 詳細は 2.1 プロバイダーの追加
• アプリ別トレイサブメニュー：Claude / Codex / Gemini のサブメニューで現在のプロバイダーと使用量サマリーを確認可能 — 詳細は 2.2 プロバイダーの切り替え
• Skills の発見と一括更新：SHA-256 ハッシュによる更新検出、一括更新、skills.sh 公式レジストリ検索 — 詳細は 3.3 Skills スキル管理
• 完全URLエンドポイントモード：高度なオプションで base_url を完全なアップストリームエンドポイントとして扱う — 詳細は 2.1 プロバイダーの追加
• OpenCode / OpenClaw ストリームチェック対応：Stream Check は Claude / Codex / Gemini / OpenCode / OpenClaw をカバー — 詳細は 4.5 モデルテスト

コントリビュート

Issue や PR でドキュメントの改善にご協力ください：

• GitHub Issues
• GitHub Repository