github/cc-switch
1
0
Fork 0
mirror of https://github.com/farion1231/cc-switch.git synced 2026-04-19 09:52:56 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
bbed2a1fe16937a6f54daadbf7a2e5c0ddeca0db
cc-switch/docs/user-manual/ja/4-proxy/4.2-takeover.md
Jason bbed2a1fe1 docs: restructure user manual for i18n and add EN/JA translations 
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.
2026-03-03 08:40:52 +08:00

5.7 KiB
Raw Blame History

4.2 アプリケーション接管

機能説明

アプリケーション接管とは、CC Switch のプロキシが特定アプリの API リクエストを接管することです。

接管を有効にすると：

  • アプリの API リクエストがローカルプロキシ経由で転送される
  • リクエストログと使用量の統計を記録できる
  • フェイルオーバー機能を使用できる

前提条件

アプリケーション接管機能を使用する前に、プロキシサービスを起動する必要があります。

接管の有効化

操作場所

設定 → 詳細 → プロキシサービス → アプリケーション接管エリア

操作手順

  1. プロキシサービスが起動していることを確認
  2. 「アプリケーション接管」エリアを見つける
  3. 必要なアプリのスイッチをオンにする

接管スイッチ

スイッチ 作用
Claude 接管 Claude Code のリクエストを接管
Codex 接管 Codex のリクエストを接管
Gemini 接管 Gemini CLI のリクエストを接管

複数のアプリの接管を同時に有効にできます。

接管の仕組み

設定の変更

接管を有効にすると、CC Switch はアプリの設定ファイルを変更し、API エンドポイントをローカルプロキシに向けます。

Claude 設定の変更：

// 接管前
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com"
  }
}

// 接管後
{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:15721"
  }
}

Codex 設定の変更：

# 接管前
base_url = "https://api.openai.com/v1"

# 接管後
base_url = "http://127.0.0.1:15721/v1"

Gemini 設定の変更：

# 接管前
GOOGLE_GEMINI_BASE_URL=https://generativelanguage.googleapis.com

# 接管後
GOOGLE_GEMINI_BASE_URL=http://127.0.0.1:15721

リクエストの転送

プロキシがリクエストを受信すると：

  1. リクエスト元を識別（Claude/Codex/Gemini）
  2. そのアプリで現在有効なプロバイダーを検索
  3. プロバイダーの実際のエンドポイントにリクエストを転送
  4. リクエストログを記録
  5. アプリにレスポンスを返却

接管ステータスの表示

メイン画面の表示

接管を有効にすると、メイン画面に以下の変化があります：

  • プロキシ Logo の色：無色から緑に変化
  • プロバイダーカード：現在アクティブなプロバイダーに緑の枠が表示

プロバイダーカードの状態

状態 枠の色 説明
現在有効 青 設定ファイル内のプロバイダー（非プロキシモード）
プロキシアクティブ 緑 プロキシが実際に使用しているプロバイダー
通常 デフォルト 使用されていないプロバイダー

接管の無効化

操作手順

  1. プロキシパネルで対応するアプリの接管スイッチをオフにする
  2. またはプロキシサービスを直接停止

設定の復元

接管を無効にすると、CC Switch は以下を実行します：

  1. アプリの設定を接管前の状態に復元
  2. 現在のリクエストログを保存

接管とプロバイダーの切り替え

接管モードでのプロバイダー切り替え

接管モードでプロバイダーを切り替える場合：

  1. メイン画面でプロバイダーの「有効化」ボタンをクリック
  2. プロキシが新しいプロバイダーを使用してリクエストを即座に転送
  3. CLI ツールの再起動は不要

これが接管モードの大きなメリットです：プロバイダーの切り替えが即座に反映されます。

非接管モードでのプロバイダー切り替え

非接管モードでプロバイダーを切り替える場合：

  1. 設定ファイルを変更
  2. CLI ツールの再起動が必要

複数アプリの接管

複数のアプリを同時に接管でき、それぞれ独立して管理されます：

  • 独立したプロバイダー設定
  • 独立したフェイルオーバーキュー
  • 独立したリクエスト統計

使用シーン

シーン 1：使用量の監視

接管 + ログ記録を有効にして、API の使用状況を監視します。

シーン 2：素早い切り替え

接管を有効にすると、プロバイダーの切り替えに CLI ツールの再起動が不要になります。

シーン 3：フェイルオーバー

接管の有効化はフェイルオーバー機能を使用するための前提条件です。

注意事項

パフォーマンスへの影響

プロキシにより少量のレイテンシ（通常 < 10ms）が追加されますが、ほとんどのシーンでは無視できます。

ネットワーク要件

接管モードでは、CLI ツールがローカルプロキシアドレスにアクセスできる必要があります。

設定のバックアップ

接管を有効にする前に、CC Switch は元の設定をバックアップし、無効化時に復元します。

よくある質問

接管後にリクエストが失敗する

確認事項：

  • プロキシサービスが正常に実行されているか
  • プロバイダーの設定が正しいか
  • ネットワークが正常か

接管を無効にしても設定が復元されない

考えられる原因：

  • プロキシの異常終了
  • 設定ファイルが他のプログラムに変更された

解決方法：

  • プロバイダーを手動で編集して保存し直す
  • または接管を再度有効にしてから無効にする
Reference in New Issue View Git Blame Copy Permalink