よくあるエラーと接続確認
401 / invalid_api_key
リクエストが当サイト Base URL に送信され、Authorization に Bearer sk-... を使用していることを確認してください。キーが完全であるか、取り消されていないか、所属グループが正しいかを確認します。
404 / model not found
モデルID、プロトコルアドレス、キーグループを順番に確認してください。OpenAI Compatible は通常 /v1 を含むアドレスを使用し、Claude Code は通常 /v1 を含まないルートアドレスを使用します。
403 またはリスク管理によるブロック
スクリプトに明確な User-Agent を設定し、空の User-Agent がゲートウェイによってブロックされる確率を下げます。制限を回避するために繰り返しリトライしないでください。
リクエストが遅い
短い質問でまずテストしてください。短い質問は速いが複雑なタスクが遅い場合、通常はコンテキストまたはモデル推論に時間がかかっています。短い質問も遅い場合は、ローカルネットワーク、回線、サービスの状態を確認してください。
接続は成功しているがクライアントが変化しない
クライアントを完全に終了させてから再度開きます。複数の設定ファイル、古い環境変数が新しい設定を上書きしている、または CC Switch がターゲットベンダーを本当に有効にしていない可能性を確認してください。
公開前チェックリスト
- 最小リクエストでキー、Base URL、モデルの3項目を確認します。
- タイムアウト、リトライ、同時実行、予算上限を設定します。
- 代替回線または代替モデルを準備します。
- ログの匿名化、完全なキーを記録しないようにします。