mirror of
https://github.com/farion1231/cc-switch.git
synced 2026-05-06 22:01:44 +08:00
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
4.9 KiB
4.9 KiB
2.2 プロバイダーの切り替え
メイン画面での切り替え
プロバイダーリストで、対象のプロバイダーカードの「有効化」ボタンをクリックします。
切り替えフロー
- 「有効化」ボタンをクリック
- CC Switch が設定ファイルを更新
- カードのステータスが「現在有効」に変更
- Claude/Gemini は即時反映、Codex はターミナルの再起動が必要
ステータス表示
| ステータス | 表示 | 説明 |
|---|---|---|
| 現在有効 | 青い枠 + ラベル | 設定ファイル内の現在のプロバイダー |
| プロキシアクティブ | 緑の枠 | プロキシモードで実際に使用中のプロバイダー |
| 通常 | デフォルトのスタイル | 有効化されていないプロバイダー |
トレイでの素早い切り替え
システムトレイから素早く切り替えられ、メイン画面を開く必要がありません。
操作手順
- システムトレイの CC Switch アイコンを右クリック
- 対応するアプリのサブメニュー（例：「Claude · 現在のプロバイダー」）にマウスを合わせる
- 切り替えたいプロバイダー名をクリック
- 切り替え完了、トレイに短い通知が表示
トレイメニュー構造
v3.13.0 より、トレイメニューがフラットなリストから アプリ別サブメニュー にリファクタリングされ、各アプリに独立したサブメニューが用意されました：
| サブメニュー | 説明 |
|---|---|
| Claude | Claude のすべてのプロバイダー（Codex OAuth リバースプロキシを含む） |
| Codex | Codex のすべてのプロバイダー |
| Gemini | Gemini のすべてのプロバイダー |
| OpenCode | OpenCode のすべてのプロバイダー |
| OpenClaw | OpenClaw のすべてのプロバイダー |
リファクタリングの利点：
- メニューのオーバーフロー防止：プロバイダーが多数ある場合、フラットなリストでは画面の高さを超えますが、アプリ別サブメニューは自然にスケールします
- サブメニューのタイトルに現在有効なプロバイダーを表示：サブメニューを開かなくても、各アプリがどのプロバイダーを使用中か一目でわかります
- アプリ別の分離：Claude のプロバイダーを切り替えても Codex のビューには影響しません
ヒント：バックグラウンド常駐 + 軽量モード + アプリ別サブメニューの組み合わせは、複数のアプリを頻繁に切り替えるヘビーユーザーに特に適しています。1.5 個人設定 → 軽量モード を参照してください。
反映方法
Claude Code
切り替え後に即時反映、再起動は不要です。
Claude Code はホットリロードに対応しており、設定ファイルの変更を自動検出して再読み込みします。
Codex
切り替え後は再起動が必要：
- 現在のターミナルウィンドウを閉じる
- ターミナルを再度開く
Gemini CLI
切り替え後に即時反映、再起動は不要です。
Gemini CLI はリクエストごとに .env ファイルを再読み込みします。
設定ファイルの変更
プロバイダーを切り替える際、CC Switch は以下のファイルを変更します：
Claude
~/.claude/settings.json
変更内容：
{
"env": {
"ANTHROPIC_API_KEY": "新しい API Key",
"ANTHROPIC_BASE_URL": "新しいエンドポイント"
}
}
Codex
~/.codex/auth.json
~/.codex/config.toml（追加設定がある場合）
Gemini
~/.gemini/.env
~/.gemini/settings.json
切り替え失敗時の対処
切り替えに失敗した場合、考えられる原因：
設定ファイルがロックされている
他のプログラムが設定ファイルを使用中です。
解決方法：実行中の CLI ツールを閉じてから、再度切り替えを試みてください。
権限不足
設定ファイルへの書き込み権限がありません。
解決方法：設定ディレクトリの権限設定を確認してください。
設定形式エラー
プロバイダー設定の JSON 形式に誤りがあります。
解決方法：プロバイダーを編集して、JSON 形式を確認・修正してください。