メインコンテンツへスキップ
プロバイダーの接続やそのプロバイダーでのレビュー実行時に発生するエラーの対処法と、よくある質問への回答をまとめています。

トラブルシューティング

  • キーは、余分なスペース、引用符、末尾の改行を含めずにコピーしてください。
  • 課金が有効で、アカウントにクレジットがあることを確認します。
  • GLM Coding Plan / Kimi Code Plan のキーの場合は、ベース URL がプランに対応していることを確認してください。サブスクリプションのキーは Developer API のエンドポイントでは動作せず、その逆も同様です。
  • Test はモデルに実際のリクエストを送信するため、誤ったモデル ID やスペルミスのあるモデル ID はここで失敗します。これは想定どおりの動作であり、レビュー時に失敗するよりも望ましいことです。
  • プロバイダーのダッシュボードから、モデル ID を正確にコピーしてください。プロバイダーによっては、深いパス(例:Fireworks の accounts/fireworks/models/kimi-k2p7-code)を使用したり、バージョンの表記が異なったり(k2p7 と k2.7)します。
  • ベース URL がプロバイダーのものと完全に一致していることを確認します(プロバイダーによっては末尾のスラッシュが重要です)。
  • OpenAI-compatible のプロバイダーでは、エンドポイントは通常 {baseURL}/chat/completions です(Kodus がパスを追加します)。そのため、ベース URL はパスを付けずに貼り付けてください。/chat/completions、/messages、/responses で終わる URL は拒否され、代わりに使用すべきアドレスがメッセージに表示されます。
  • バージョンのない OpenAI または OpenAI-compatible の URL で 404 が返される場合は、通常 /v1 が必要です。メッセージに修正後の URL が提案されます。
  • URL は https:// を使用し、パブリックなアドレスに解決される必要があります。プライベートまたは予約済みのアドレスに解決される URL は拒否されます。
  • 一部のモデルは temperature を固定していたり、常に reasoning を行ったりします(Kimi k2p7-code/k3、GLM-5.3。Claude 4.7 以降/GPT-5 は temperature を完全に廃止しています)。Test は設定したチューニングをモデルのルールに照らして検証し、具体的なメッセージを返します。その指示に従ってください(temperature を未設定にするか、必要な値を使用します。常に reasoning を行うモデルでは reasoning を Off にしないでください)。Temperature を参照してください。
  • Advanced settings の Max concurrent requests を下げます。
  • GLM Coding Plan の利用が承認されている場合は、プランの上限を Z.AI に確認してください。同時実行数の調整を参照してください。
  • Kimi Code Plan で同時リクエスト数の上限エラーが出たら、設定値を下げてください。同時実行数の調整を参照してください。
  • Kodus が環境変数で設定されている場合、モデルが接続されていない間、AI providers ページには Kodus is currently using an LLM configured via environment variables と、モデルとプロバイダー(プロバイダーが API_LLM_PROVIDER で設定されたものか推測されたものかを含む)が表示されます。キーが表示されることはありません。
  • モデルを接続して保存すると、環境変数の設定が上書きされます。
  • reasoning はトークンを増やします。コストが急増している場合は、Thinking / Reasoning を Medium から Low に下げるか、軽いタスクを Code review → Routing の Other task models でより安価なモデルにルーティングしてください。
  • 各モデル、PR、レビュー、開発者にかかったコストはトークン使用量で確認できます。モデルごとの内訳はプロバイダーのダッシュボードで確認し、Budget タブで支出アラート付きの月次予算を設定してください(アラートのみです。ハードキャップはプロバイダー側で設定してください)。

よくある質問

はい。変更は次のレビューから反映されます。再デプロイは不要です。
Fallback model が設定されている場合、レビューはそちらに切り替わります。設定されていない場合、レビューは失敗してエラーが返されます。フォールバックを設定してください。
Routing で別のモデルを選択しない限り、すべてのタスクはデフォルトモデルを使用します。タスクのモデルが、別のモデルなら解決できる原因(無効または期限切れのキー、クレジット不足、プロバイダー自身のリトライ後のプロバイダーのダウン)で失敗した場合、Kody は Fallback model で 1 回だけ再試行します。待てば解消するレート制限、モデルにとって大きすぎるプロンプト、タイムアウトでは、モデルは切り替わりません。課金されるのは、実際に呼び出しを処理したプロバイダー分のみです。
はい。そのための機能が Code review → Routing です。コードレビューには強力なモデル、要約やチャットには安価なモデルというように、タスクごとにモデルを選択できます。ルーティングを意味のあるものにするには、接続済みのモデルが少なくとも 2 つ必要です。
はい。キーは保存時と転送時の両方で暗号化され、平文でログに記録されることはありません。BYOK のステータスエンドポイントが生のキーを返すこともありません。
はい。OpenAI-compatible プロバイダー(Custom の下)を使用します。エンドポイントのベース URL、そのエンドポイントが公開しているモデル ID、プレースホルダーの APIキーを入力してください(ほとんどのセルフホストのランタイムはキーのヘッダーを無視しますが、指定は必須です)。AI providers ページが受け付けるのは、パブリックなアドレスに解決される https:// の URL のみです。そのため、localhost やプライベートネットワークのアドレスは拒否されます。セルフホストの Kodus では、プライベートネットワーク上のエンドポイントを環境変数で設定してください。インストールを参照してください。