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.16.0
• 最終更新：2026-05-29
• CC Switch v3.16.0+ 対応

v3.16.0 の注目機能

• Codex Chat Completions ルーティング：DeepSeek、Kimi、GLM、MiniMax など Chat 専用プロバイダーを Codex で利用可能 — 詳細は 2.1 プロバイダーの追加
• 管理対象 CLI ツールのライフサイクル：設定 / About で Claude / Codex / Gemini / OpenCode / OpenClaw / Hermes のインストール、更新、一括更新、診断に対応 — 詳細は 1.5 個人設定
• プロバイダーとモデルマトリクス更新：提携プリセットを追加し、既定モデルと価格表を更新。Claude Opus は 4.8、該当する GPT 既定値は 5.5 に更新
• ルーティング対応バッジ：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 / Hermes ストリームチェック対応：Stream Check は Claude / Codex / Gemini / OpenCode / OpenClaw / Hermes をカバー — 詳細は 4.5 モデルテスト

コントリビュート

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

• GitHub Issues
• GitHub Repository