プランとの対応関係
BYOK は Community では無料、Teams では(トークン費用に加えてアクティブ開発者1人あたり月10ドル)で利用可能、Enterprise では2つのオプションのうちの1つです(もう1つは Kodus が管理する APIキー)。
はじめに
BYOK 設定にアクセス
app.kodus.io/organization/byok から組織設定に移動します
重要: プライマリプロバイダーがダウンタイムやレート制限を経験した場合でも、継続的なコードレビューを確保するために、常にフォールバックモデルを設定してください。
対応プロバイダー
- OpenAI
- Google Gemini
- Anthropic Claude
- Novita AI
- OpenRouter
- カスタムプロバイダー
おすすめの用途: 最新の GPT モデルと安定したパフォーマンスAPIキーの取得方法:
- OpenAI API Keys にアクセス
- Kodus 用の新しい APIキーを作成
- OpenAI アカウントに請求情報を追加
OpenAI は優れたモデルの多様性と最も信頼性の高いサービスを提供しています。最良のコストパフォーマンスには GPT-5-mini から始めましょう。
推奨・テスト済みモデル
Kodus でのコードレビューに向けて、広範にテストし推奨するモデルは以下の通りです:Gemini 2.5 Pro
最もテスト済み・推奨卓越したコード理解、100万以上のトークンコンテキストウィンドウ、最良のコストパフォーマンス比を持つ Google の最新モデル。
- プロバイダー: Google
- おすすめの用途: 総合的な優秀性
Gemini 2.5 Flash
最良のコストパフォーマンス品質を妥協せず超高速かつコスト効率的。大量処理チームに最適。
- プロバイダー: Google
- おすすめの用途: コスト意識の高いチーム
Claude 4.5 Sonnet
コードに最適SWE-Bench で77.2%のパフォーマンスを持つ卓越したコーディング能力。複雑なコードベースの理解に優れています。
- プロバイダー: Anthropic
- おすすめの用途: コード品質重視
Claude 4.1 Opus
プレミアム品質最も要求の高いコードレビューと複雑なアーキテクチャ分析向けのトップティアモデル。
- プロバイダー: Anthropic
- おすすめの用途: エンタープライズプロジェクト
GPT-5
最新イノベーション最先端の機能と競争力のある価格設定を持つ OpenAI の最新モデル。
- プロバイダー: OpenAI
- おすすめの用途: 最新機能
GPT-5-mini
高速で信頼性が高いOpenAI の速度、コスト、品質の優れたバランス。
- プロバイダー: OpenAI
- おすすめの用途: 予算内での信頼性
推奨: 最良の全体的なエクスペリエンスには Gemini 2.5 Pro から始めましょう。最もテストが充実したモデルで、優れた品質と優れた価格を提供します。
ベストプラクティス
セキュリティ
専用キー
使用状況の追跡とセキュリティ強化のために、Kodus 専用の APIキーを作成してください
定期的なローテーション
APIキーを定期的にローテーションし、Kodus の設定で更新してください
使用状況の監視
異常な使用パターンがないか、プロバイダーのダッシュボードを定期的に確認してください
安全な保管
APIキーをコードリポジトリに共有またはコミットしないでください
トラブルシューティング
無効な APIキー エラー
無効な APIキー エラー
解決方法:
- APIキーが余分なスペースなしに正しくコピーされているか確認
- プロバイダーアカウントで請求が有効になっているか確認
- APIキーに必要な権限があるか確認
- 問題が解決しない場合は、新しい APIキーの生成を試みてください
モデルが見つからないエラー
モデルが見つからないエラー
解決方法:
- モデル名がプロバイダーの正確なフォーマットと一致しているか確認
- モデルがあなたの地域で利用可能かどうかを確認
- アカウントに指定されたモデルへのアクセス権があるか確認
- 問題がモデル固有かどうかをテストするために別のモデルを試してください
レート制限の問題
レート制限の問題
解決方法:
- プロバイダーのレート制限を確認し、必要に応じてアップグレード
- より高いレート制限を持つプロバイダーへの切り替えを検討
- 制限を増やすためにプロバイダーサポートに連絡
- 許可されている場合は、複数の APIキーで使用量を分散
カスタム URL の接続問題
カスタム URL の接続問題
解決方法:
- ベース URL のフォーマットにプロトコル(https://)が含まれているか確認
- エンドポイントが OpenAI 互換 API をサポートしているか確認
- curl や Postman などのツールで URL を直接テスト
- 接続をブロックするファイアウォールの制限がないことを確認
予期せぬ高コスト
予期せぬ高コスト
解決方法:
- プロバイダーダッシュボードで使用状況を確認
- レート制限が適切に設定されているか確認
- よりコスト効率の良いモデルへの切り替えを検討
- 急増を早期に検出するための請求アラートを設定
よくある質問
いつでもプロバイダーを切り替えられますか?
いつでもプロバイダーを切り替えられますか?
はい。変更は新しいレビューに対して即座に有効になります。
APIキーのクレジットがなくなった場合はどうなりますか?
APIキーのクレジットがなくなった場合はどうなりますか?
レビューは自動的にフォールバックモデルに切り替わります(設定されている場合)。フォールバックがない場合、クレジットを追加するまでレビューは失敗します。常にフォールバックモデルを設定してください。
プライマリ/フォールバックシステムはどのように機能しますか?
プライマリ/フォールバックシステムはどのように機能しますか?
プライマリはデフォルトですべてのレビューを処理します。プライマリが失敗した場合(レート制限、ダウンタイム、エラー)、Kodus は自動的にフォールバックに切り替わります。各レビューを処理するモデルに対してのみ料金が発生します。
プライマリとフォールバックに同じプロバイダーを使用すべきですか?
プライマリとフォールバックに同じプロバイダーを使用すべきですか?
いいえ。プロバイダー固有の障害から保護するために、異なるプロバイダーを使用してください(例: Google をプライマリ、OpenAI をフォールバック)。
APIキーは安全に保管されますか?
APIキーは安全に保管されますか?
はい。キーは保存時および転送時に暗号化されています。平文でのキーのログ記録や保存は行いません。