Jason
a058ebeafc
Refresh the user manual to cover the v3.13.0 feature set so users can discover and correctly use new functionality without cross-referencing the release notes. All three language versions are updated line-by-line symmetric. Highlights: - Lightweight Mode: tray-only running state added in 1.5-settings, with a comparison table against "Minimize to tray" and a new OAuth Auth Center (Beta) section - Quota & Balance display restructured in 2.5-usage-query: split into auto-query (Claude/Codex/Gemini official, Copilot, Codex OAuth) vs manual-enable (Token Plan, third-party balances). Explains why manual enabling is required: the same API URL may expose both plan-quota and balance query modes - Codex OAuth reverse proxy: full usage guide in 2.1-add with two entry points (Add Provider panel / OAuth Auth Center), Device Code login flow, token auto-refresh, multi-account management, quota display, common failures, and risk notice - Full URL Endpoint Mode: new advanced option in 2.1-add - Per-app tray submenus: 2.2-switch refactored to reflect the 5-app submenu structure and cross-link to Lightweight Mode - Skills workflow: remove obsolete "automatic update not supported" section in 3.3-skills, add SHA-256 update detection, single/batch update, storage location switch, and skills.sh registry search - Directory picker for Claude terminal resume in 3.4-sessions - Usage stats in 4.4-usage: document the new CLI session log source (no proxy required) and per-app filtering for Claude/Codex/Gemini; note CNY->USD pricing corrections and MiniMax quota fixes - Stream Check coverage extended to OpenCode/OpenClaw in 4.5-model-test - New FAQs in 5.2-questions: quota visibility (auto vs manual), Codex OAuth risks and login flow, deep link wake in Lightweight Mode - v3.13.0 highlights navigation block added to top-level README and each per-language README; version bumped to v3.13.0 / 2026-04-08
16 KiB
1.5 個人設定
このセクションでは、個人の好みに合わせて CC Switch を設定する方法を説明します。
設定を開く
- 左上の ⚙️ ボタンをクリック
- またはショートカット
Cmd/Ctrl + ,
言語設定
CC Switch は 3 つの言語に対応しています：
| 言語 | 説明 |
|---|---|
| 簡体中文 | デフォルト言語 |
| English | 英語インターフェース |
| 日本語 | 日本語インターフェース |
言語を切り替えると即座に反映され、再起動は不要です。
テーマ設定
| オプション | 説明 |
|---|---|
| システムに合わせる | システムのダーク/ライトモードに自動的に合わせる |
| ライト | 常にライトテーマを使用 |
| ダーク | 常にダークテーマを使用 |
ウィンドウ動作
起動時に自動実行
有効にすると、システム起動時に CC Switch が自動的に起動します。
- Windows：レジストリを使用
- macOS：LaunchAgent を使用
- Linux：XDG autostart を使用
閉じる動作
| オプション | 説明 |
|---|---|
| トレイへ最小化 | 閉じるボタンをクリックするとシステムトレイに隠す |
| 直接終了 | 閉じるボタンをクリックするとアプリを完全に終了 |
トレイからプロバイダーを素早く切り替えられるため、「トレイへ最小化」の使用を推奨します。
軽量モード
v3.13.0 より、CC Switch に 軽量モード が追加されました — アイドル時のデスクトップ占有を最小限に抑える トレイのみ実行状態 です。
開始方法：トレイアイコンを右クリック → 軽量モード をクリック。メインウィンドウは 破棄（単に非表示ではなく）され、UI リソースとメモリが解放されます。
終了方法：トレイメニューから メインウィンドウを開く をクリック、またはディープリンク / 再起動で CC Switch を呼び出します。ウィンドウは 必要に応じて再構築 され、状態は保持されます。
| 項目 | トレイへ最小化 | 軽量モード |
|---|---|---|
| UI プロセス | メモリに保持 | 完全に破棄 |
| アイドル時リソース | 通常実行と同じ | ほぼゼロ |
| 再表示速度 | 瞬時（直接表示） | やや遅い（ウィンドウ再構築） |
| トレイ切り替え | 利用可能 | 利用可能 |
| ディープリンク起動 | 利用可能 | 利用可能（必要時再構築） |
使用シーン：CC Switch を長時間バックグラウンドに常駐させ、主にトレイメニューからプロバイダーを切り替える場合、軽量モードを有効にするとメモリ使用量を大幅に削減できます。
注意：軽量モードの状態は永続化されません — 次回の通常起動では通常モードに戻ります。長期的に使用する場合は「起動時に自動実行」と組み合わせてください。
Claude プラグイン連携
有効にすると、CC Switch はプロバイダー切り替え時に VS Code の Claude Code 拡張に設定を自動同期します（~/.claude/config.json の primaryApiKey に書き込み）。
使用シーン：Claude Code CLI と VS Code プラグインを同時に使用する場合、このオプションを有効にすると両方の設定を一致させることができます。
Claude 初回ガイドのスキップ
有効にすると、Claude Code の初回ガイドフローをスキップします。Claude Code に慣れているユーザー向けです。
注意：このオプションは
~/.claude/settings.jsonのskipIntroductionフィールドに書き込まれます。
アプリの表示設定
アプリ切り替えに表示するアプリを選択します。各アプリを個別にオン/オフできますが、少なくとも 1 つは有効にする必要があります。
設定可能なアプリ：Claude、Codex、Gemini、OpenCode、OpenClaw。
使用シーン：Claude Code と Codex CLI のみを使用する場合、他のアプリを非表示にしてインターフェースをシンプルに保てます。
Skills 同期方式
スキルを各アプリディレクトリにインストールする際の同期方式を設定します：
| 方式 | 説明 |
|---|---|
| シンボリックリンク | スキルのソースファイルへのシンボリックリンクを作成、容量が少なく、リアルタイム同期 |
| ファイルコピー | スキルファイルをターゲットディレクトリに完全コピー |
推奨：デフォルトではシンボリックリンク方式を使用します。権限の問題が発生する場合は、コピー方式に切り替えてください。
ターミナル設定
CC Switch がターミナルを開く際に使用するターミナルアプリケーションを選択します。
対応ターミナル（プラットフォーム別）：
| プラットフォーム | ターミナル選択肢 |
|---|---|
| macOS | Terminal、iTerm2、Alacritty、Kitty、Ghostty、WezTerm |
| Windows | CMD、PowerShell、Windows Terminal |
| Linux | GNOME Terminal、Konsole、Xfce4 Terminal、Alacritty、Kitty、Ghostty |
ディレクトリ設定
アプリ設定ディレクトリ
CC Switch 自体のデータの保存場所で、デフォルトは ~/.cc-switch/ です。
CLI ツールディレクトリ
各 CLI ツールの設定ディレクトリをカスタマイズできます：
| 設定 | デフォルト値 | 説明 |
|---|---|---|
| Claude ディレクトリ | ~/.claude/ |
Claude Code 設定ディレクトリ |
| Codex ディレクトリ | ~/.codex/ |
Codex 設定ディレクトリ |
| Gemini ディレクトリ | ~/.gemini/ |
Gemini CLI 設定ディレクトリ |
| OpenCode ディレクトリ | ~/.opencode/ |
OpenCode 設定ディレクトリ |
| OpenClaw ディレクトリ | ~/.openclaw/ |
OpenClaw 設定ディレクトリ |
注意：ディレクトリを変更した後はアプリの再起動が必要で、対応する CLI ツールも同じディレクトリを設定する必要があります。
データ管理
設定のエクスポート
「エクスポート」ボタンをクリックして、以下の内容を含むバックアップファイルを保存します：
- すべてのプロバイダー設定
- MCP サーバー設定
- Prompts プリセット
- アプリ設定
バックアップファイルは JSON 形式で、テキストエディタで確認できます。
設定のインポート
- 「ファイルを選択」をクリック
- 以前にエクスポートしたバックアップファイルを選択
- 「インポート」をクリック
- 既存の設定の上書きを確認
注意：インポートは既存の設定を上書きするため、事前に現在の設定をエクスポートしてバックアップすることをお勧めします。
プロキシ設定
設定 → プロキシ タブ
プロキシ タブではすべてのプロキシ関連機能を集中管理します：
ローカルプロキシ
ローカルプロキシサービスの起動/停止、リスニングアドレスとポートの設定。詳しくは 4.1 プロキシサービス をご覧ください。
フェイルオーバー
アプリ（Claude/Codex/Gemini）ごとにフェイルオーバーキューと自動切り替え戦略を設定。詳しくは 4.3 フェイルオーバー をご覧ください。
料金補正器
モデル料金補正ルールを設定し、プロキシの課金統計を調整します。
グローバル送信プロキシ
CC Switch の送信 HTTP/HTTPS プロキシを設定します。外部 API にプロキシ経由でアクセスする必要がある場合に使用します。
詳細設定
設定 → 詳細 タブ
設定ディレクトリ
各アプリの設定ファイルディレクトリをカスタマイズ。下記の「ディレクトリ設定」セクションを参照してください。
データ管理
設定バックアップのインポート/エクスポート。下記の「データ管理」セクションを参照してください。
バックアップと復元
バックアップ管理パネルでは、データベースバックアップを完全に管理できます。
自動バックアップ設定
| 設定 | オプション | デフォルト |
|---|---|---|
| バックアップ間隔 | 無効、6時間、12時間、24時間、48時間、7日 | 24時間 |
| 保持数 | 3、5、10、15、20、30、50 | 10件 |
間隔を設定すると、CC Switch はスケジュールに従って自動的にデータベースをバックアップします。保持数を超えた古いバックアップは自動的に削除されます。
バックアップリスト
パネルには既存のすべてのバックアップが以下の情報とともに表示されます：
- 表示名（タイムスタンプから自動生成、例：
db_backup_20260315_143000） - 作成日時
- ファイルサイズ（例：「1.5 MB」）
バックアップ操作
| 操作 | 説明 |
|---|---|
| 今すぐバックアップ | 即座にバックアップを作成 |
| 復元 | 選択したバックアップからデータベースを復元。復元前に現在のデータベースの安全バックアップが自動的に作成される |
| 名前変更 | バックアップの表示名を変更 |
| 削除 | バックアップを完全に削除（確認あり） |
重要：バックアップの復元は現在のデータベースを上書きします。復元前に安全バックアップが自動作成されるため、必要に応じて元に戻すことができます。
クラウド同期（WebDAV）
WebDAV プロトコルを使用して複数のデバイス間で設定を同期します。信頼性の向上のため、デュアルレイヤーバージョニングを備えた v2 プロトコル を使用しています。
| 設定項目 | 説明 |
|---|---|
| サービスプリセット | 坚果云 / Nextcloud / Synology / カスタム |
| サーバー URL | WebDAV サーバー URL |
| ユーザー名 | ログインユーザー名 |
| パスワード | ログインパスワード（アプリ専用パスワード、保存済みの場合は未変更で保持） |
| リモートディレクトリ | リモート保存パス（デフォルト cc-switch-sync） |
| プロファイル名 | デバイスプロファイル名（デフォルト default） |
| 自動同期 | 設定可能な間隔で自動同期を有効化 |
操作
| 操作 | 説明 |
|---|---|
| 接続テスト | WebDAV の URL、ユーザー名、パスワードが有効か確認 |
| アップロード | ローカルデータベースをリモートにアップロード。進捗スピナーを表示 |
| ダウンロード | リモートデータベースをダウンロード。確認前にリモートスナップショット情報（プロトコルバージョン、DB バージョン、タイムスタンプ、サイズ）を表示。上書き前にローカルデータベースの安全バックアップを自動作成 |
自動同期
自動同期 を有効にすると：
- 初回有効化時に確認ダイアログが表示される
- CC Switch は設定された間隔で自動的にデータベースを WebDAV に同期
- 同期ステータスがパネルに表示される
リモートスナップショット情報
ダウンロード前に、CC Switch はリモートスナップショットの詳細を表示します：
- プロトコルバージョン（v2）
- データベース互換バージョン
- リモートバックアップのタイムスタンプ
- ファイルサイズ
- 互換性ステータス（非互換の場合は警告）
注意：アップロードはリモートデータを、ダウンロードはローカルデータを上書きします。ダウンロード前に安全バックアップが自動作成されます。
ログ設定
| 設定項目 | 説明 |
|---|---|
| ログを有効化 | アプリのログ記録のオン/オフ |
| ログレベル | error / warn / info / debug / trace |
ログレベルの説明：
- error - エラーのみ記録
- warn - 警告とエラーを記録
- info - 一般情報を記録（推奨）
- debug - デバッグ情報を記録
- trace - すべての詳細情報を記録
OAuth 認証センター（Beta）
設定 → OAuth 認証センター タブ
v3.13.0 で追加された OAuth 認証センター（Beta）は、サードパーティの OAuth 認証情報を一元管理します。現在、以下の 2 種類のアカウントタイプをサポートしています：
| アカウントタイプ | 用途 |
|---|---|
| GitHub Copilot | Copilot リバースプロキシと組み合わせて使用 |
| ChatGPT (Codex OAuth) | Codex OAuth リバースプロキシと組み合わせて使用、ChatGPT アカウントを管理 |
ここでできること：
- Device Code フローで ChatGPT / GitHub アカウントにログイン
- ログイン済みアカウント一覧と認証状態の確認
- マルチアカウント時のデフォルトアカウント設定
- 個別アカウントの削除や全アカウントの一括ログアウト
注意：これら 2 つの機能はリバースエンジニアリングされた OAuth フローを使用するため、アカウントリスクおよび利用規約リスクが存在します。ご利用前に 2.1 プロバイダーの追加 → Codex OAuth リバースプロキシ の完全なリスク通知をお読みください。
バージョン情報ページ
設定 → バージョン情報 タブ
バージョン情報
現在の CC Switch バージョン番号を表示し、以下をサポートします：
- リリースノートの表示
- 更新の確認
- 新バージョンのダウンロードとインストール
ローカル環境チェック
インストール済みの CLI ツールのバージョンを自動検出：
| ツール | 検出内容 |
|---|---|
| Claude | 現在のバージョン、最新バージョン |
| Codex | 現在のバージョン、最新バージョン |
| Gemini | 現在のバージョン、最新バージョン |
| OpenCode | 現在のバージョン、最新バージョン |
| OpenClaw | 現在のバージョン、最新バージョン |
「更新」ボタンをクリックして再検出できます。
ワンクリックインストールコマンド
CLI ツールを素早くインストール/更新するコマンドを提供：
npm i -g @anthropic-ai/claude-code@latest
npm i -g @openai/codex@latest
npm i -g @google/gemini-cli@latest
npm i -g opencode@latest
npm i -g openclaw@latest
「コピー」ボタンでクリップボードにコピーできます。