# 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 にプロキシ経由でアクセスする必要がある場合に使用します。

## 詳細設定

設定 → 詳細 タブ

### 設定ディレクトリ

各アプリの設定ファイルディレクトリをカスタマイズ。下記の「ディレクトリ設定」セクションを参照してください。

### データ管理

設定バックアップのインポート/エクスポート。下記の「データ管理」セクションを参照してください。

### バックアップと復元

自動バックアップの管理：

| 設定     | 説明                       |
| -------- | -------------------------- |
| バックアップ間隔 | 自動バックアップの時間間隔（時間） |
| 保持数量 | 保持するバックアップの数             |

バックアップリストの表示とバックアップからの復元をサポートします。

### クラウド同期（WebDAV）

WebDAV プロトコルを使用して複数のデバイス間で設定を同期します。

| 設定項目   | 説明                                  |
| -------- | ------------------------------------- |
| サービスプリセット | 坚果云 / Nextcloud / Synology / カスタム    |
| サーバー URL | WebDAV サーバー URL                     |
| ユーザー名   | ログインユーザー名                            |
| パスワード   | ログインパスワード（アプリ専用パスワード）              |
| リモートディレクトリ | リモート保存パス（デフォルト `cc-switch-sync`） |
| プロファイル名 | デバイスプロファイル名（デフォルト `default`）      |
| 自動同期 | 有効にすると変更を自動アップロード                    |

操作：

- **接続テスト**：WebDAV 設定が正しいか確認
- **保存**：設定を保存して自動テスト
- **アップロード**：ローカルデータをリモートにアップロード
- **ダウンロード**：リモートからローカルにデータをダウンロード

> **注意**：アップロードはリモートデータを、ダウンロードはローカルデータを上書きします。操作前にご確認ください。

### ログ設定

| 設定項目   | 説明                                |
| -------- | ----------------------------------- |
| ログを有効化 | アプリのログ記録のオン/オフ               |
| ログレベル | 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
```

「コピー」ボタンでクリップボードにコピーできます。