> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kodus.io/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Kody コードレビューのトラブルシューティング

## Kody コードレビューが機能しない場合の修正手順

### トークンの問題

トークン経由で接続されている場合は、以下の点を確認してください：

* **GitHub ユーザー**：トークンが組織で有効になっていることを確認します：
  1. 組織のオーナーである必要があります。
  2. GitHub で組織の設定に移動します：
     * 以下の URL を使用し、`YOUR_ORG_NAME` を組織名に置き換えてください：
       <small>
         `https://github.com/organizations/YOUR_ORG_NAME/settings/member_privileges`
       </small>
  3. **Fine-Grained Personal Access Tokens** の下で、**「Allow access via fine-grained personal access tokens」** が選択されていることを確認します。
* **個人用アクセストークン（PAT）**：トークンが組織用に設定されており、必要な権限を持っていることを確認します。[トークンを管理](https://github.com/settings/tokens?type=beta)。
* **トークンの有効期限**：トークンが有効であることを確認します。[トークンのステータスを確認](https://github.com/settings/tokens?type=beta)。

<Frame caption="トークンには組織のロゴが表示されるはずです。個人のプロフィール写真が表示されている場合、トークンは組織アクセスではなく個人アクセスに設定されています。">
  <img src="https://mintcdn.com/kodus/AvHTi3FgfIMZisRO/images/token.png?fit=max&auto=format&n=AvHTi3FgfIMZisRO&q=85&s=bdaadc025aca2778f3b083f4ff35ad9a" alt="トークンの例" width="1560" height="164" data-path="images/token.png" />
</Frame>

***

### 設定の問題

* **自動レビュー**：[グローバル設定](https://app.kodus.io/automations/AutomationCodeReview/global/general)で自動レビューが有効になっていることを確認します。無効の場合は、`@kody start-review` で手動でレビューを開始します。
* **レビュータイプ**：Kody がサジェストを提供するために少なくとも 1 つのレビュータイプが選択されていることを確認します。[レビュータイプを設定](https://app.kodus.io/automations/AutomationCodeReview/global/general)。
* **ブランチレビュー**：デフォルトでは、Kody はデフォルトブランチにマージされる PR をレビューします。追加のブランチを含めるには、[設定を更新](https://app.kodus.io/automations/AutomationCodeReview/global/general)してください。
* **大きな PR**：変更数が多い PR は処理に時間がかかる場合があります。

***

### グローバル設定対リポジトリ設定

Kody は階層的な設定システムを使用します。仕組みは以下の通りです：

* **グローバル設定**：デフォルトですべてのリポジトリに適用されます。
* **リポジトリ固有の設定**：設定されている場合、その特定のリポジトリのグローバル設定をオーバーライドします。

#### トラブルシューティングの手順

1. **グローバル設定を確認**：グローバル設定が正しいことをレビューして確認します。[グローバル設定にアクセス](https://app.kodus.io/automations/AutomationCodeReview/global/general)。
2. **リポジトリ設定を確認**：
   * 設定の**リポジトリ別**セクションに移動します。
   * 対象のリポジトリにカスタム設定が設定されているかどうかを確認します。
3. **設定を整合または削除**：
   * グローバル設定を適用するには、リポジトリ固有の設定をクリアします。
   * あるいは、ニーズに合わせてリポジトリ固有の設定を調整します。

#### 一般的な症状

* リポジトリの自動レビューがトリガーされない。
* Kody が予期しない設定やサジェストを適用する。
* グローバル設定が特定のリポジトリに反映されない。

## Kody からの応答やコメントがない場合

この簡単なチェックリストを実行してください：

1. PR にレビュー可能なコードの変更が含まれているか（ドキュメントや画像のみでないか）？関連して分析するものがない場合、Kody はスキップする場合があります。
2. ブランチがスコープ内にあるか？デフォルトでは、追加のベースブランチが設定されていない限り、デフォルトブランチを対象とする PR のみがレビューされます。
3. **大きな PR：** Kody は最大 200 の**レビュー可能なファイル**（無視パターン適用後）を含む PR をレビューします。例：合計 250 ファイルの PR で 60 が `.lock` ファイルの場合 → Kody は残りの 190 ファイルをレビューします ✅
4. モード：自動レビューが無効の場合は、`@kody start-review` で手動でトリガーします。
5. プッシュの頻度：自動一時停止を使用している場合は、クールダウンを待つか手動レビューをリクエストします。
6. リポジトリのオーバーライド：リポジトリ固有の設定がグローバル設定をオーバーライドできます。必要に応じてクリアまたは整合させてください。

<Card title="レビューモードと頻度" icon="clock" href="/how_to_use/ja/code_review/configs/general">
  自動レビュー、頻度、ブランチフィルターを確認します。
</Card>

<Card title="制限と料金" icon="scale-balanced" href="/how_to_use/ja/pricing">
  サジェストされる制限とそれがレビューに与える影響について学びます。
</Card>