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

# Solución de problemas de Code Review

> Corrige una revisión de Code Review que no se inició, falló o se omitió por presupuesto, encuentra hallazgos que faltan y resuelve problemas de configuración y de `REVIEW.md`.

Cuando [Code Review](/docs/es/code-review) no hace lo que esperas en un pull request, empieza por el check run **Claude Code Review**. Su título indica hasta dónde llegó la revisión.

<h2 id="check-how-far-the-review-got">
  Comprueba hasta dónde llegó la revisión
</h2>

Busca el check run **Claude Code Review** en tu pull request y luego compara su título con uno de estos títulos comunes:

| Título del check run | Qué significa | Qué hacer |
| :- | :- | :- |
| **Code review queued...** o **Code review in progress...** | La revisión no ha terminado | Espera a que cambie el título |
| **Code review found no issues** | La revisión terminó y no encontró nada que señalar | Nada |
| Un título que dice que se encontraron problemas | La revisión terminó con hallazgos | Si no los ves en el diff, consulta [Encuentra problemas que no aparecen como comentarios en línea](#find-issues-that-aren’t-showing-as-inline-comments) |
| **Code review skipped — no new changes** | No se ejecutó una revisión automática en tu último push | Para obtener una revisión de todos modos, comenta `@claude review` |
| **Code review failed** o **Code review timed out** | La revisión no terminó | Para ejecutarla de nuevo, consulta [Vuelve a iniciar una revisión que falló o agotó el tiempo de espera](#retrigger-a-failed-or-timed-out-review) |
| **Code review declined** | La revisión no se ejecutó | Lee el resumen del check run. Si menciona un presupuesto o un límite de gasto, consulta [La revisión no se ejecutó y el PR muestra un mensaje de presupuesto](#review-didn’t-run-and-the-pr-shows-a-budget-message) |
| Ningún check run | No se inició ninguna revisión | Comenta `@claude review`. Si después de eso no aparece ningún check run, consulta [Un comando en un comentario no inició una revisión](#a-comment-command-didn’t-start-a-review) |

<h2 id="a-review-didn’t-start">
  Una revisión no se inició
</h2>

Revisa estos casos cuando no aparece ningún check run **Claude Code Review**, o cuando Claude publica un comentario que dice que se omitió la revisión.

<h3 id="a-comment-command-didn’t-start-a-review">
  Un comando en un comentario no inició una revisión
</h3>

Después de comentar `@claude review`, busca en el pull request un check run **Claude Code Review** con el título **Code review queued...** o **Code review in progress...**. Una reacción 👀 en tu comentario no confirma que se vaya a realizar una revisión. Si no aparece ningún check run, comprueba cada una de estas causas:

* **Code Review no está activado para este repositorio**: Claude no publica ningún comentario ni check run en respuesta al comando. Pide a un Owner que [agregue el repositorio](/docs/es/code-review-setup#add-more-repositories).
* **El comentario no cumple una condición**: era un comentario en línea o el cuerpo de una revisión en lugar de un nuevo comentario de nivel superior, o el comando no estaba al inicio del comentario. Editar un comentario anterior en lugar de publicar uno nuevo tampoco cuenta, y el pull request tiene que estar abierto. Consulta las [condiciones para los comandos en comentarios](/docs/es/code-review-pull-requests#comment-commands) y publica un nuevo comentario que las cumpla.
* **No tienes acceso de escritura**: necesitas permiso de escritura, mantenimiento o administración en el repositorio, y en un pull request desde un fork el permiso que cuenta es el del repositorio base. Si tu organización tiene activadas las sugerencias, Claude responde "No review was started: manual reviews can only be requested by someone with write access to this repository." Pide a alguien con acceso de escritura que comente en tu lugar.
* **Se agotó el presupuesto**: Claude publica un comentario que empieza con "⚠️ Code review skipped". Consulta [La revisión no se ejecutó y el PR muestra un mensaje de presupuesto](#review-didn’t-run-and-the-pr-shows-a-budget-message).

<h3 id="review-didn’t-run-and-the-pr-shows-a-budget-message">
  La revisión no se ejecutó y el PR muestra un mensaje de presupuesto
</h3>

Cuando el presupuesto de tu organización no puede cubrir una revisión, Code Review omite la revisión y Claude publica en el pull request un comentario que empieza con "⚠️ Code review skipped". En algunos de estos casos también aparece un check run con el título **Code review declined**.

El comentario enlaza a [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage), donde un administrador restablece el presupuesto. Su redacción te indica qué límite se alcanzó:

* **"has reached its monthly code review spending cap"**: se alcanzó el [límite de gasto mensual de Code Review](/docs/es/code-review-costs#limit-your-spend). Las revisiones se reanudan al inicio del siguiente período de facturación. Para obtenerlas antes, pide a un administrador que aumente el límite.
* **"has no extra usage available to pay for this review"**: el saldo de [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) de tu organización está vacío, o se alcanzó su límite de gasto mensual general. Pide a un administrador que agregue créditos de uso o que aumente ese límite.
* **"is too low to start another review"**: lo que queda del presupuesto o del saldo es menor que el costo esperado de una revisión. Pide a un administrador que aumente el límite o que agregue créditos de uso.

Después de restablecer el presupuesto, comenta `@claude review` en el pull request para obtener la revisión que se omitió. Se aplican las [condiciones para los comandos en comentarios](/docs/es/code-review-pull-requests#comment-commands), por lo que quien comenta necesita acceso de escritura.

<h2 id="retrigger-a-failed-or-timed-out-review">
  Vuelve a iniciar una revisión que falló o agotó el tiempo de espera
</h2>

Si el resumen del check run dice "The review session was interrupted before it could finish. A new review of this commit has been queued automatically.", no necesitas hacer nada. Esa revisión se reintenta una vez de forma automática.

De lo contrario, cuando el título del check run es **Code review failed** o **Code review timed out**, ejecuta la revisión de nuevo con un comentario o una nueva ejecución:

* **Comenta `@claude review`**: publícalo como comentario de nivel superior en el pull request. Esto inicia una revisión nueva sin suscribir el pull request a futuros pushes.
* **Haz clic en Re-run**: si el pull request no es [desde un fork](/docs/es/code-review-pull-requests#review-drafts-and-pull-requests-from-forks), haz clic en **Re-run** en el check **Claude Code Review** de la pestaña **Checks** de GitHub. La nueva ejecución abarca el commit head actual del pull request y tampoco suscribe el pull request.

<h2 id="find-issues-that-aren’t-showing-as-inline-comments">
  Encuentra problemas que no aparecen como comentarios en línea
</h2>

Si el título del check run dice que se encontraron problemas pero no ves comentarios de revisión en línea en el diff, busca en estas otras ubicaciones donde se muestran los hallazgos:

* **Details del check run**: haz clic en **Details** junto al check **Claude Code Review** en la pestaña **Checks**. La tabla de severidad enumera los hallazgos con su archivo, línea y resumen, independientemente de si se aceptó el comentario en línea.
* **Anotaciones en Files changed**: abre la pestaña **Files changed** del PR. Un hallazgo que tiene una línea pero que no se publicó como comentario en línea aparece allí como una anotación en las líneas correspondientes.
* **Cuerpo de la revisión**: los hallazgos que no tienen ubicación en línea, o que quedan fuera del diff actual, aparecen bajo un encabezado **Additional findings** en el cuerpo de la revisión.

<h2 id="the-check-run-mentions-review-md">
  El check run menciona REVIEW\.md
</h2>

Dos de los mensajes que un check run puede incluir sobre `REVIEW.md` tienen que ver con la protección de ramas:

* **"This review applied the repository's review instructions (REVIEW\.md) from its default branch, which is not protected against direct pushes."**: la revisión leyó solo el archivo de la raíz. Consulta [De qué rama se lee REVIEW.md](/docs/es/code-review-customize#which-branch-review-md-is-read-from) para saber qué cambia al proteger la rama.
* **"were not applied to this review: branch protection could not be confirmed"**: la revisión no leyó ningún `REVIEW.md`.

<h2 id="setup-problems">
  Problemas de configuración
</h2>

Estos casos se le presentan a un Owner mientras [configura Code Review](/docs/es/code-review-setup).

<h3 id="a-repository-isn’t-listed-in-add-a-repository">
  Un repositorio no aparece en Add a repository
</h3>

Primero busca el repositorio por nombre, porque el cuadro de diálogo no carga una lista larga completa. El cuadro de diálogo muestra un repositorio solo si la Claude GitHub App puede acceder a él. Haz clic en **Install GitHub App** y dale a la app acceso al repositorio. Cuando no aparece ningún repositorio, **Install GitHub App** es un botón en el cuadro de diálogo. De lo contrario, está al final del menú de filtro de organizaciones de GitHub del cuadro de diálogo.

<h3 id="no-check-run-appears-on-the-test-pull-request">
  No aparece ningún check run en el pull request de prueba
</h3>

Confirma que **Allow code review** esté activado, que el repositorio aparezca en **Repositories** en la sección **Code review** y que la Claude GitHub App tenga acceso a él. Las revisiones automáticas omiten los pull requests en borrador, y un repositorio configurado como **Manual (@claude review)** necesita un comentario `@claude review` para iniciar la primera revisión.

<h2 id="related-resources">
  Recursos relacionados
</h2>

* [Lee y solicita revisiones en un pull request](/docs/es/code-review-pull-requests): qué significan los hallazgos y el check run, y los comandos en comentarios
* [Configura Code Review](/docs/es/code-review-setup): para Owners, activa Code Review y administra repositorios
* [Costos y uso de Code Review](/docs/es/code-review-costs): los límites de gasto detrás de un mensaje de presupuesto
* [Personaliza Code Review](/docs/es/code-review-customize): qué copia de `REVIEW.md` lee una revisión