Skip to main content
Cuando 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.

​
Comprueba hasta dónde llegó la revisión

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

​
Una revisión no se inició

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.

​
Un comando en un comentario no inició una revisión

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.
  • 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 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.

​
La revisión no se ejecutó y el PR muestra un mensaje de presupuesto

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, 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. 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 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, por lo que quien comenta necesita acceso de escritura.

​
Vuelve a iniciar una revisión que falló o agotó el tiempo de espera

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, 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.

​
Encuentra problemas que no aparecen como comentarios en línea

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.

​
El check run menciona REVIEW.md

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 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.

​
Problemas de configuración

Estos casos se le presentan a un Owner mientras configura Code Review.

​
Un repositorio no aparece en Add a repository

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.

​
No aparece ningún check run en el pull request de prueba

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.