#連携のトラブルシューティング

#ツールが古いプロバイダーを使用し続ける

• ツールを再起動します。
• 別のプロファイルまたは設定ファイルを読み込んでいないか確認します。
• 環境変数が対話型シェルだけでなく、GUI アプリやバックグラウンドサービスからも参照できることを確認します。
• CC Switch では、正しい対象アプリに対してプロバイダーが有効になっていることを確認します。

#モデル一覧が空

多くのツールでは、モデル ID を手動で入力して使用できます。Models からコピーしてください。モデル一覧が空でも、Chat Completions または Responses が利用できないとは限りません。

#Chat は動作するが Codex は失敗する

チャットクライアントは通常 /v1/chat/completions を使用しますが、Codex は /v1/responses を使用します。Responses 対応モデルを選び、Codex プロバイダーに wire_api = "responses" を設定してください。

#Chat は動作するがツール呼び出しは失敗する

次の 3 つのレイヤーをすべて確認します。

1. モデルがツール呼び出しをサポートしている
2. GetRouter が選択したプロトコルでその機能を公開している
3. ツールが返されたツール呼び出しイベントを処理できる

#URL またはパスが重複している

誤ったリクエストの例:

/v1/v1/chat/completions
/v1/responses/responses
/v1/chat/completions/chat/completions

対象ツールの連携ガイドを参照し、重複した部分を削除してください。

#設定変更が反映されない

• JSON または TOML の構文を検証します。
• ツールに必要な入れ子構造を保持します。
• プロセスを再起動します。
• ユーザー設定を上書きするプロジェクトローカル設定がないか確認します。
• CC Switch や別の管理ツールがファイルを書き換えていないことを確認します。

#安全にエスカレーション

バージョン、プロトコル、モデル ID、Request ID、タイムスタンプ、マスキングした設定を共有してください。共有前にキーを YOUR_API_KEY に置き換えてください。