mirror of
https://github.com/farion1231/cc-switch.git
synced 2026-07-31 11:01:36 +08:00
Jason
d9c0e4c452
Add documentation for features introduced since v3.12.0: New docs: - 3.4 Session Manager: browse, search, resume, delete sessions - 3.5 Workspace & Daily Memory: OpenClaw workspace file editing Updated docs: - Add Lightweight Mode to interface overview and FAQ - Add tray submenu structure (providers grouped by app) - Add API Format selection (Anthropic/OpenAI Chat/OpenAI Responses) - Add Auto-Fetch Models button documentation - Add Claude Common Config quick toggles - Add Codex 1M Context Window toggle - Add Skill backup/restore lifecycle - Expand Backup Management panel documentation - Update WebDAV sync to v2 protocol with dual-layer versioning - Add OpenCode/OpenClaw to quickstart activation table - Update README version to v3.12.3 All changes synced across en, zh, and ja locales.
293 lines
13 KiB
Markdown
293 lines
13 KiB
Markdown
# 1.5 個人設定
|
||
|
||
このセクションでは、個人の好みに合わせて CC Switch を設定する方法を説明します。
|
||
|
||
## 設定を開く
|
||
|
||
- 左上の **⚙️** ボタンをクリック
|
||
- またはショートカット `Cmd/Ctrl + ,`
|
||
|
||
## 言語設定
|
||
|
||
CC Switch は 3 つの言語に対応しています：
|
||
|
||
| 言語 | 説明 |
|
||
| -------- | -------- |
|
||
| 簡体中文 | デフォルト言語 |
|
||
| English | 英語インターフェース |
|
||
| 日本語 | 日本語インターフェース |
|
||
|
||
言語を切り替えると即座に反映され、再起動は不要です。
|
||
|
||
## テーマ設定
|
||
|
||
| オプション | 説明 |
|
||
| -------- | --------------------------- |
|
||
| システムに合わせる | システムのダーク/ライトモードに自動的に合わせる |
|
||
| ライト | 常にライトテーマを使用 |
|
||
| ダーク | 常にダークテーマを使用 |
|
||
|
||
## ウィンドウ動作
|
||
|
||
### 起動時に自動実行
|
||
|
||
有効にすると、システム起動時に CC Switch が自動的に起動します。
|
||
|
||
- **Windows**：レジストリを使用
|
||
- **macOS**：LaunchAgent を使用
|
||
- **Linux**：XDG autostart を使用
|
||
|
||
### 閉じる動作
|
||
|
||
| オプション | 説明 |
|
||
| ------------ | ---------------------------- |
|
||
| トレイへ最小化 | 閉じるボタンをクリックするとシステムトレイに隠す |
|
||
| 直接終了 | 閉じるボタンをクリックするとアプリを完全に終了 |
|
||
|
||
トレイからプロバイダーを素早く切り替えられるため、「トレイへ最小化」の使用を推奨します。
|
||
|
||
### 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 形式で、テキストエディタで確認できます。
|
||
|
||
### 設定のインポート
|
||
|
||
1. 「ファイルを選択」をクリック
|
||
2. 以前にエクスポートしたバックアップファイルを選択
|
||
3. 「インポート」をクリック
|
||
4. 既存の設定の上書きを確認
|
||
|
||
> **注意**：インポートは既存の設定を上書きするため、事前に現在の設定をエクスポートしてバックアップすることをお勧めします。
|
||
|
||
## プロキシ設定
|
||
|
||
設定 → プロキシ タブ
|
||
|
||
プロキシ タブではすべてのプロキシ関連機能を集中管理します：
|
||
|
||
### ローカルプロキシ
|
||
|
||
ローカルプロキシサービスの起動/停止、リスニングアドレスとポートの設定。詳しくは [4.1 プロキシサービス](../4-proxy/4.1-service.md) をご覧ください。
|
||
|
||
### フェイルオーバー
|
||
|
||
アプリ（Claude/Codex/Gemini）ごとにフェイルオーバーキューと自動切り替え戦略を設定。詳しくは [4.3 フェイルオーバー](../4-proxy/4.3-failover.md) をご覧ください。
|
||
|
||
### 料金補正器
|
||
|
||
モデル料金補正ルールを設定し、プロキシの課金統計を調整します。
|
||
|
||
### グローバル送信プロキシ
|
||
|
||
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** - すべての詳細情報を記録
|
||
|
||
## バージョン情報ページ
|
||
|
||
設定 → バージョン情報 タブ
|
||
|
||
### バージョン情報
|
||
|
||
現在の CC Switch バージョン番号を表示し、以下をサポートします：
|
||
|
||
- リリースノートの表示
|
||
- 更新の確認
|
||
- 新バージョンのダウンロードとインストール
|
||
|
||
### ローカル環境チェック
|
||
|
||
インストール済みの CLI ツールのバージョンを自動検出：
|
||
|
||
| ツール | 検出内容 |
|
||
| -------- | ------------------ |
|
||
| Claude | 現在のバージョン、最新バージョン |
|
||
| Codex | 現在のバージョン、最新バージョン |
|
||
| Gemini | 現在のバージョン、最新バージョン |
|
||
| OpenCode | 現在のバージョン、最新バージョン |
|
||
| OpenClaw | 現在のバージョン、最新バージョン |
|
||
|
||
「更新」ボタンをクリックして再検出できます。
|
||
|
||
### ワンクリックインストールコマンド
|
||
|
||
CLI ツールを素早くインストール/更新するコマンドを提供：
|
||
|
||
```bash
|
||
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
|
||
```
|
||
|
||
「コピー」ボタンでクリップボードにコピーできます。
|