admin/CC-Switch
1
0
Fork 0
mirror of https://github.com/farion1231/cc-switch.git synced 2026-08-04 11:43:57 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs: restructure user manual for i18n and add EN/JA translations

Browse Source 
Reorganize docs/user-manual/ from flat structure to language subdirectories
(zh/, en/, ja/) with shared assets/. Move existing Chinese docs into zh/,
fix image paths, add multilingual navigation README, and translate all 23
markdown files (~4500 lines each) to English and Japanese.
This commit is contained in:
Jason
2026-03-03 08:40:52 +08:00
parent ce9c23833a
commit bbed2a1fe1
70 changed files with 8916 additions and 124 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/user-manual/ja/1-getting-started/1.1-introduction.md
+65
View File
@@ -0,0 +1,65 @@
# 1.1 ソフトウェア紹介
## CC Switch とは
CC Switch はクロスプラットフォームのデスクトップアプリケーションで、AI プログラミングツールを使用する開発者向けに設計されています。**Claude Code**、**Codex**、**Gemini CLI**、**OpenCode**、**OpenClaw** の 5 つの AI プログラミングツールの設定を統一的に管理できます。
## どのような問題を解決するか
日常の開発で、以下のような課題に直面することがあります：
- **複数プロバイダーの切り替えが面倒**：異なる API プロバイダー（公式、中継サービスなど）を使用する際、設定ファイルを手動で変更する必要がある
- **設定が分散して管理しづらい**：Claude、Codex、Gemini、OpenCode、OpenClaw がそれぞれ独立した設定ファイルを持ち、フォーマットも異なる
- **使用量を監視できない**：API をどれだけ呼び出したか、いくらかかったかが分からない
- **サービスが不安定**：単一プロバイダーに問題が発生すると、ワークフロー全体が中断する
CC Switch は統一されたインターフェースでこれらの問題を解決します。
## 主要機能
### プロバイダー管理
- ワンクリックで複数の API プロバイダー設定を切り替え
- プリセットテンプレートで一般的なプロバイダーを素早く追加
- 統一プロバイダー機能で、アプリ間で設定を共有
- 使用量クエリと残額表示
- エンドポイント速度テスト
### 拡張機能
- **MCP サーバー**：Model Context Protocol サーバーを管理し、AI の機能を拡張
- **Prompts**：システムプロンプトのプリセットを管理し、さまざまなシーンで素早く切り替え
- **Skills**：スキル拡張のインストールと管理
### プロキシと高可用性
- ローカルプロキシサービスで、リクエストログと使用量統計を記録
- 自動フェイルオーバー、メインプロバイダーの障害時にバックアップへ自動切り替え
- サーキットブレーカー機能で、障害プロバイダーへの頻繁なリトライを防止
- 詳細な Token 使用量トラッキングとコスト見積もり
## 対応アプリケーション
| アプリ | 説明 |
|------|------|
| **Claude Code** | Anthropic 公式の AI プログラミングアシスタント |
| **Codex** | OpenAI のコード生成ツール |
| **Gemini CLI** | Google の AI コマンドラインツール |
| **OpenCode** | オープンソース AI プログラミングターミナルツール |
| **OpenClaw** | オープンソース AI プログラミングアシスタント（マルチプロバイダーゲートウェイ） |
## 対応プラットフォーム
- **Windows** 10 以上
- **macOS** 10.15 (Catalina) 以上
- **Linux** Ubuntu 22.04+ / Debian 11+ / Fedora 34+
## 技術アーキテクチャ
CC Switch はモダンな技術スタックで構築されています：
- **フロントエンド**：React 18 + TypeScript + Tailwind CSS
- **バックエンド**：Tauri 2 + Rust
- **データストレージ**：SQLite（プロバイダー、MCP、Prompts）+ JSON（デバイス設定）
このアーキテクチャにより：
- クロスプラットフォームでの一貫した体験
- ネイティブレベルのパフォーマンス
- 安全なローカルデータストレージ
docs/user-manual/ja/1-getting-started/1.2-installation.md
+229
View File
@@ -0,0 +1,229 @@
# 1.2 インストールガイド
## 前提条件
### Node.js のインストール
CC Switch が管理する CLI ツール（Claude Code、Codex、Gemini CLI）には Node.js 環境が必要です。
**推奨バージョン**：Node.js 18 LTS 以上
#### Windows
1. [Node.js 公式サイト](https://nodejs.org/) にアクセス
2. LTS バージョンのインストーラーをダウンロード
3. インストーラーを実行し、指示に従ってインストール
4. インストールの確認：
```bash
node --version
npm --version
```
#### macOS
```bash
# Homebrew でインストール
brew install node
# または nvm を使用（推奨）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install --lts
```
#### Linux
```bash
# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
# または nvm を使用
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install --lts
```
### CLI ツールのインストール
#### Claude Code
**方法 1：Homebrew（macOS 推奨）**
```bash
brew install claude-code
```
**方法 2：npm**
```bash
npm install -g @anthropic-ai/claude-code
```
#### Codex
**方法 1：Homebrew（macOS 推奨）**
```bash
brew install codex
```
**方法 2：npm**
```bash
npm install -g @openai/codex
```
#### Gemini CLI
**方法 1：Homebrew（macOS 推奨）**
```bash
brew install gemini-cli
```
**方法 2：npm**
```bash
npm install -g @google/gemini-cli
```
---
## Windows
### インストーラー方式
1. [Releases ページ](https://github.com/farion1231/cc-switch/releases) にアクセス
2. `CC-Switch-v{バージョン}-Windows.msi` をダウンロード
3. インストーラーをダブルクリックして実行
4. 指示に従ってインストール
### ポータブル版（インストール不要）
1. `CC-Switch-v{バージョン}-Windows-Portable.zip` をダウンロード
2. 任意のディレクトリに展開
3. `CC-Switch.exe` を実行
## macOS
### 方法 1：Homebrew（推奨）
```bash
# tap を追加
brew tap farion1231/ccswitch
# インストール
brew install --cask cc-switch
```
最新バージョンに更新：
```bash
brew upgrade --cask cc-switch
```
### 方法 2：手動ダウンロード
1. `CC-Switch-v{バージョン}-macOS.zip` をダウンロード
2. 展開して `CC Switch.app` を取得
3. 「アプリケーション」フォルダにドラッグ
### 初回起動時の警告
開発者が Apple 開発者アカウントを持っていないため、初回起動時に「不明な開発者」の警告が表示される場合があります：
**推奨される解決方法**：
ターミナルで以下のコマンドを実行してください：
```bash
sudo xattr -dr com.apple.quarantine /Applications/CC\ Switch.app/
```
**別の解決方法（システム設定から）**：
1. 警告ダイアログを閉じる
2. 「システム設定」→「プライバシーとセキュリティ」を開く
3. CC Switch に関する表示を見つけ、「このまま開く」をクリック
4. 再度アプリを開くと正常に使用可能
## Linux
### ArchLinux
AUR ヘルパーを使用してインストール：
```bash
# paru を使用
paru -S cc-switch-bin
# または yay を使用
yay -S cc-switch-bin
```
### Debian / Ubuntu
1. `CC-Switch-v{バージョン}-Linux.deb` をダウンロード
2. インストール：
```bash
sudo dpkg -i CC-Switch-v{バージョン}-Linux.deb
# 依存関係に問題がある場合
sudo apt-get install -f
```
### AppImage（汎用）
1. `CC-Switch-v{バージョン}-Linux.AppImage` をダウンロード
2. 実行権限を追加：
```bash
chmod +x CC-Switch-v{バージョン}-Linux.AppImage
```
3. 実行：
```bash
./CC-Switch-v{バージョン}-Linux.AppImage
```
## インストールの確認
インストール完了後、CC Switch を起動します：
1. アプリウィンドウが正常に表示される
2. システムトレイに CC Switch のアイコンが表示される
3. Claude / Codex / Gemini の 3 つのアプリを切り替えられる
## 自動更新
CC Switch には自動更新機能が内蔵されています：
- 起動時に自動で更新を確認
- 新しいバージョンがある場合、画面に更新通知を表示
- クリックするとダウンロードしてインストール
「設定 → バージョン情報」から手動で更新を確認することもできます。
## アンインストール
### Windows
- 「設定 → アプリ」からアンインストール
- またはインストールディレクトリのアンインストーラーを実行
### macOS
- `CC Switch.app` をゴミ箱に移動
- オプション：設定ディレクトリ `~/.cc-switch/` を削除
### Linux
```bash
# Debian/Ubuntu
sudo apt remove cc-switch
# ArchLinux
paru -R cc-switch-bin
```
docs/user-manual/ja/1-getting-started/1.3-interface.md
+170
View File
@@ -0,0 +1,170 @@
# 1.3 インターフェース概要
## メイン画面のレイアウト
![image-20260108001629138](../../assets/image-20260108001629138.png)
## 上部ナビゲーションバー
| 番号 | 要素 | 機能説明 |
|------|------|----------|
| ① | Logo | クリックで GitHub プロジェクトページにアクセス |
| ② | 設定ボタン | 設定ページを開く（ショートカット `Cmd/Ctrl + ,`） |
| ③ | プロキシスイッチ | ローカルプロキシサービスの起動/停止 |
| ④ | アプリ切り替え | Claude / Codex / Gemini / OpenCode / OpenClaw を切り替え |
| ⑤ | 機能エリア | Skills / Prompts / MCP の入口 |
| ⑥ | 追加ボタン | 新しいプロバイダーを追加 |
### アプリ切り替え
ドロップダウンメニューをクリックして、現在管理するアプリを切り替えます：
- **Claude** - Claude Code の設定を管理
- **Codex** - Codex の設定を管理
- **Gemini** - Gemini CLI の設定を管理
- **OpenCode** - OpenCode の設定を管理
- **OpenClaw** - OpenClaw の設定を管理
切り替え後、プロバイダーリストに対応アプリの設定が表示されます。
### 機能エリアボタン
| ボタン | 機能 | 表示条件 |
|------|------|----------|
| Skills | スキル拡張管理 | 常に表示 |
| Prompts | システムプロンプト管理 | 常に表示 |
| MCP | MCP サーバー管理 | 常に表示 |
## プロバイダーカード
各プロバイダーはカード形式で表示されます。左から右へ以下の要素が含まれています：
### カード要素（左から右）
| 番号 | 要素 | アイコン | 機能説明 |
|------|------|------|----------|
| ① | ドラッグハンドル | ≡ | 長押しして上下にドラッグしてプロバイダーの順序を調整 |
| ② | プロバイダーアイコン | - | プロバイダーのブランドアイコンを表示、カラーのカスタマイズ可能 |
| ③ | プロバイダー情報 | - | 名前、メモ/エンドポイントアドレス（クリックで公式サイトを開く） |
| ④ | 使用量情報 | - | 残額を表示、複数プランの場合はプラン数を表示 |
| ⑤ | 有効化ボタン | ▶ | 現在使用中のプロバイダーに切り替え |
| ⑥ | 編集ボタン | ✏️ | プロバイダー設定を編集 |
| ⑦ | 複製ボタン | - | プロバイダーを複製（コピーを作成） |
| ⑧ | テストボタン | - | モデルの可用性と応答速度をテスト |
| ⑨ | 使用量クエリ | - | 使用量クエリスクリプトを設定 |
| ⑩ | 削除ボタン | - | プロバイダーを削除（現在有効な場合は無効） |
> **ヒント**：操作ボタンエリア（⑤-⑩）はマウスホバー時に表示され、通常は非表示で画面をすっきり保ちます。
### ボタンの詳細説明
| ボタン | 状態変化 | 説明 |
|------|----------|------|
| **有効化** | 有効化済みの場合は ✓ を表示して無効化 | フェイルオーバーモードでは「参加/参加済み」に変化 |
| **編集** | 常に使用可能 | 編集パネルを開いて設定を変更 |
| **複製** | 常に使用可能 | プロバイダーのコピーを作成、名前に `copy` が付加 |
| **テスト** | テスト中はローディングアニメーション | プロキシサービス実行中のみ使用可能 |
| **使用量クエリ** | 常に使用可能 | カスタム使用量クエリスクリプトを設定 |
| **削除** | 現在有効な場合は半透明で無効 | 先に他のプロバイダーに切り替える必要あり |
### カードの状態
| 状態 | 枠の色 | 説明 |
|------|----------|------|
| **現在有効** | 青い枠 | 通常モードで現在使用中のプロバイダー |
| **プロキシアクティブ** | 緑の枠 | プロキシ接管モードで実際に使用中のプロバイダー |
| **通常状態** | デフォルトの枠 | 有効化されていないプロバイダー |
| **フェイルオーバー中** | 優先度バッジを表示 | P1、P2 などのフェイルオーバー優先度を表示 |
### ヘルスステータスバッジ
プロキシモードでは、フェイルオーバーキューに参加しているプロバイダーにヘルスステータスが表示されます：
| バッジ | 色 | 説明 |
|------|------|------|
| 健康 | 緑 | 連続失敗回数 0 |
| 警告 | 黄 | 連続失敗回数 1-2 |
| 不健康 | 赤 | 連続失敗回数 ≥3、サーキットブレーカーが発動する可能性あり |
## システムトレイ
CC Switch はシステムトレイにアイコンを表示し、クイック操作の入口を提供します。
### トレイメニュー構造
![image-20260108002153668](../../assets/image-20260108002153668.png)
### メニュー機能
| メニュー項目 | 機能 |
|--------|------|
| メインウィンドウを開く | メインウィンドウを表示してフォーカス |
| アプリグループ | Claude/Codex/Gemini/OpenCode/OpenClaw ごとにプロバイダーを表示 |
| プロバイダーリスト | クリックで切り替え、現在有効なものにはチェックマークを表示 |
| 終了 | アプリを完全に終了 |
### 多言語対応
トレイメニューは 3 つの言語に対応し、設定に応じて自動的に切り替わります：
| 言語 | メインウィンドウを開く | 終了 |
|------|-----------|------|
| 中文 | 打开主界面 | 退出 |
| English | Open main window | Quit |
| 日本語 | メインウィンドウを開く | 終了 |
### 使用シーン
トレイからのプロバイダー切り替えはメイン画面を開く必要がなく、以下の場面に適しています：
- 頻繁にプロバイダーを切り替える場合
- メインウィンドウが最小化されているときの素早い操作
- バックグラウンド実行中の設定管理
## 設定ページ
設定ページは複数のタブに分かれています：
### 一般タブ
- 言語設定（中文/English/日本語）
- テーマ設定（システムに合わせる/ライト/ダーク）
- ウィンドウ動作（起動時に自動実行、閉じる動作）
### 詳細タブ
- 設定ディレクトリの設定
- プロキシサービスの設定
- フェイルオーバーの設定
- 料金設定
- データのインポート/エクスポート
### 使用量タブ
- リクエスト統計の概要
- トレンドグラフ
- リクエストログ
- プロバイダー/モデル統計
### バージョン情報タブ
- バージョン情報
- 更新の確認
- オープンソースライセンス
## ショートカットキー
| ショートカット | 機能 |
|--------|------|
| `Cmd/Ctrl + ,` | 設定を開く |
| `Cmd/Ctrl + F` | プロバイダーを検索 |
| `Esc` | ダイアログ/検索を閉じる |
## 検索機能
`Cmd/Ctrl + F` で検索ボックスを開きます：
- 名前、メモ、URL で検索可能
- プロバイダーリストをリアルタイムでフィルタリング
- `Esc` で検索を閉じる
docs/user-manual/ja/1-getting-started/1.4-quickstart.md
+92
View File
@@ -0,0 +1,92 @@
# 1.4 クイックスタート
このセクションでは、5 分で初回設定を完了する方法を説明します。
## ステップ 1：プロバイダーの追加
1. メイン画面右上の **+** ボタンをクリック
2. 「プリセット」ドロップダウンからプロバイダーを選択
- よく使われるプリセット：智谱 GLM、MiniMax、DeepSeek、Kimi、PackyCode
- または「カスタム」を選択して手動設定
3. **API Key** を入力
4. 「追加」をクリック
![image-20260108002807657](../../assets/image-20260108002807657.png)
> **ヒント**：プリセットではエンドポイントアドレスが自動入力されるため、API Key のみ入力すれば使用できます。
## ステップ 2：プロバイダーの切り替え
追加が完了すると、プロバイダーがリストに表示されます。
**方法 1：メイン画面で切り替え**
- プロバイダーカードの「有効化」ボタンをクリック
**方法 2：トレイで素早く切り替え**
- システムトレイアイコンを右クリック
- プロバイダー名を直接クリック
## ステップ 3：反映方法
プロバイダーを切り替えた後、各 CLI ツールの反映方法は異なります：
| アプリ | 反映方法 |
|------|----------|
| Claude Code | 即時反映（ホットリロード対応） |
| Codex | ターミナルを閉じて再度開く必要あり |
| Gemini | 即時反映（リクエストごとに設定を再読み込み） |
### Claude Code の初回インストール時の注意
Claude Code を初めて起動するときに**ログイン**の要求や初期化ガイドが表示される場合は、CC Switch で「Claude Code の初回確認をスキップ」オプションを有効にしてください：
1. CC Switch の「設定 → 一般」を開く
2. 「Claude Code の初回確認をスキップ」スイッチをオンにする
3. Claude Code を再起動
![image-20260108002626389](../../assets/image-20260108002626389.png)
> **注意**：このオプションは `~/.claude/settings.json` の `skipIntroduction` フィールドに書き込まれ、公式の初回ガイドフローをスキップします。
## 設定の確認
再起動後、対応する CLI ツールを起動して簡単な質問でテストします：
```bash
# Claude Code - 起動後にテスト質問を入力
claude
> こんにちは、簡単に自己紹介してください
# Codex - 起動後にテスト質問を入力
codex
> こんにちは、簡単に自己紹介してください
# Gemini - 起動後にテスト質問を入力
gemini
> こんにちは、簡単に自己紹介してください
```
AI が正常に回答すれば、設定は成功です。
## 次のステップ
基本設定が完了しました。次に以下のことができます：
- [プロバイダーの追加](../2-providers/2.1-add.md) - 複数のプロバイダーを設定して簡単に切り替え
- [MCP サーバーの設定](../3-extensions/3.1-mcp.md) - AI ツールの機能を拡張
- [システムプロンプトの設定](../3-extensions/3.2-prompts.md) - AI の動作をカスタマイズ
- [プロキシサービスの有効化](../4-proxy/4.1-service.md) - 使用量の監視と自動フェイルオーバー
## よくある質問
### 切り替えても反映されない場合
ターミナルまたは CLI ツールを再起動してください。設定ファイルは切り替え時に更新されますが、実行中のプログラムは自動的に設定を再読み込みしません。
### プリセットが見つからない場合
プロバイダーがプリセットリストにない場合は、「カスタム」を選択して手動設定してください。設定形式については [プロバイダーの追加](../2-providers/2.1-add.md) を参照してください。
### 公式ログインに戻すには
「公式ログイン」プリセット（Claude/Codex）または「Google 公式」プリセット（Gemini）を選択し、クライアントを再起動してログインフローに従ってください。
docs/user-manual/ja/1-getting-started/1.5-settings.md
+255
View File
@@ -0,0 +1,255 @@
# 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
```
「コピー」ボタンでクリップボードにコピーできます。