github/cc-switch
1
0
Fork 0
mirror of https://github.com/farion1231/cc-switch.git synced 2026-04-18 09:22:55 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
68da178811332353a4088bb208b70b6e8e181b0a
cc-switch/docs/user-manual/ja/5-faq/5.2-questions.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

6.9 KiB
Raw Blame History

5.2 よくある質問 FAQ

インストールに関する問題

macOS で「不明な開発者」と表示される

問題：初回起動時に「開けません。身元不明の開発者のものです」と表示される

解決方法 1：システム設定から

  1. 警告ダイアログを閉じる
  2. 「システム設定」→「プライバシーとセキュリティ」を開く
  3. CC Switch に関する表示を見つける
  4. 「このまま開く」をクリック
  5. 再度アプリを開く

解決方法 2：ターミナルコマンドから（推奨）

sudo xattr -dr com.apple.quarantine /Applications/CC\ Switch.app/

実行後、正常にアプリを開けるようになります。

Windows でインストール後に起動できない

考えられる原因：

  • WebView2 ランタイムが不足
  • ウイルス対策ソフトによるブロック

解決方法：

  1. Microsoft Edge WebView2 をインストール
  2. CC Switch をウイルス対策ソフトのホワイトリストに追加

Linux で起動エラー

問題：AppImage が起動しない

解決方法：

# 実行権限を追加
chmod +x CC-Switch-*.AppImage

# それでも失敗する場合
./CC-Switch-*.AppImage --no-sandbox

プロバイダーに関する問題

プロバイダーを切り替えても反映されない

原因：CLI ツールが設定を再読み込みする必要がある

解決方法：

  • Claude Code：ターミナルを閉じて再度開く、または IDE を再起動
  • Codex：ターミナルを閉じて再度開く
  • Gemini：トレイからの切り替えで即時反映、再起動不要

API Key が無効

確認手順：

  1. API Key が正しくコピーされているか（余分なスペースがないか）
  2. API Key が期限切れでないか
  3. エンドポイントアドレスが正しいか
  4. 速度テストで接続を確認

公式ログインに戻すには

操作手順：

  1. 「公式ログイン」プリセット（Claude/Codex）または「Google 公式」プリセット（Gemini）を選択
  2. 「有効化」をクリック
  3. 対応する CLI ツールを再起動
  4. CLI ツールのログインフローに従って操作

プロキシに関する問題

プロキシサービスの起動に失敗する

考えられる原因：ポートが使用中

解決方法：

  1. ポートの使用状況を確認： 
    # macOS/Linux
lsof -i :49152

# Windows
netstat -ano | findstr :49152
  2. ポートを使用しているプログラムを終了
  3. または設定を変更してデフォルトポートに復旧：
    • 「設定 → プロキシサービス」を開く
    • 「デフォルトに戻す」ボタンをクリック

プロキシモードでリクエストがタイムアウトする

考えられる原因：

  • ネットワークの問題
  • プロバイダーのサーバーの問題
  • プロキシ設定のエラー

解決方法：

  1. ネットワーク接続を確認
  2. プロバイダーの API に直接アクセスを試みる（プロキシを無効にして）
  3. プロバイダーの設定が正しいか確認

プロキシを無効にしても設定が復元されない

考えられる原因：プロキシの異常終了

解決方法：

  1. 現在のプロバイダーを編集
  2. エンドポイントアドレスが正しいか確認
  3. 保存して設定を更新

フェイルオーバーに関する問題

フェイルオーバーがトリガーされない

チェックリスト：

  • プロキシサービスが実行中か
  • アプリケーション接管が有効か
  • 自動フェイルオーバーが有効か
  • キューにバックアッププロバイダーがあるか

フェイルオーバーが頻繁にトリガーされる

考えられる原因：

  • メインプロバイダーが不安定
  • サーキットブレーカーの閾値が低すぎる

解決方法：

  1. メインプロバイダーの状態を確認
  2. 失敗閾値を引き上げる（例：3 → 5）
  3. メインプロバイダーの変更を検討

すべてのプロバイダーがサーキットブレーカー発動中

解決方法：

  1. サーキットブレーカー期間満了を待つ（デフォルト 60 秒）
  2. またはプロキシサービスを再起動して状態をリセット

データに関する問題

設定が消えた

考えられる原因：

  • 設定ディレクトリが削除された
  • データベースが破損

解決方法：

  1. ~/.cc-switch/ ディレクトリが存在するか確認
  2. バックアップから復元：~/.cc-switch/backups/
  3. または以前にエクスポートした設定ファイルからインポート

設定のインポートに失敗する

考えられる原因：

  • ファイル形式のエラー
  • バージョンの非互換性

解決方法：

  1. ファイルが CC Switch からエクスポートされた JSON ファイルであることを確認
  2. ファイル内容が完全であるか確認
  3. テキストエディタで開いてフォーマットを確認

使用量統計のデータが空

チェックリスト：

  • プロキシサービスが実行中か
  • アプリケーション接管が有効か
  • ログ記録が有効か
  • プロキシ経由でリクエストがあったか

その他の問題

トレイアイコンが表示されない

macOS：

  • システム設定のメニューバーアイコン設定を確認

Windows：

  • タスクバーの設定で、CC Switch のアイコンが非表示になっていないか確認

Linux：

  • システムトレイのサポート（例：libappindicator）がインストールされている必要あり

インターフェースの表示が異常

解決方法：

  1. テーマを切り替えてみる（ライト/ダーク）
  2. アプリを再起動
  3. ~/.cc-switch/settings.json を削除して設定をリセット

更新に失敗する

解決方法：

  1. ネットワーク接続を確認
  2. 最新版を手動でダウンロードしてインストール
  3. Homebrew を使用する場合：brew upgrade --cask cc-switch

ヘルプの入手

Issue の提出

上記の方法で問題が解決しない場合：

  1. GitHub Issues にアクセス
  2. 類似の問題がないか検索
  3. なければ新しい Issue を作成
  4. 以下の情報を提供：
    • オペレーティングシステムとバージョン
    • CC Switch のバージョン
    • 問題の説明と再現手順
    • エラーメッセージ（ある場合）

ログファイル

Issue を提出する際にログファイルを添付できます：

  • macOS/Linux：~/.cc-switch/logs/
  • Windows：%APPDATA%\cc-switch\logs\
Reference in New Issue View Git Blame Copy Permalink