Code Review analiza tus solicitudes de extracción de GitHub y publica los hallazgos como comentarios en línea en las líneas de código donde encontró problemas. Una flota de agentes especializados examina los cambios de código en el contexto de tu base de código completa, buscando errores lógicos, vulnerabilidades de seguridad, casos límite rotos y regresiones.
Este artículo cubre cómo habilitar Code Review, configurar disparadores de revisión, personalizar qué se marca y solucionar problemas comunes de configuración.
Nota: Code Review está en vista previa de investigación y disponible en planes Team y Enterprise. No está disponible para organizaciones con retención de datos cero habilitada. El uso de Code Review se factura por separado a través de uso adicional y no cuenta contra el uso incluido en tu plan.
Cómo funciona Code Review
Una vez que una organización habilita Code Review, puede activarse automáticamente cuando se abre una solicitud de extracción, en cada inserción, o solo cuando alguien solicita manualmente una revisión. Cuando se ejecuta una revisión, múltiples agentes analizan el diff y el código circundante en paralelo. Cada agente busca una clase diferente de problema, luego un paso de verificación comprueba los resultados contra el comportamiento real del código para filtrar falsos positivos.
Los hallazgos se desduplican, se clasifican por gravedad y se publican como comentarios en línea en las líneas específicas donde se encontraron problemas. Si no se encuentran problemas, Claude publica un breve comentario de confirmación en la PR. Las revisiones no aprueban ni bloquean tu PR, por lo que los flujos de trabajo de revisión existentes permanecen intactos.
Las revisiones escalan en costo con el tamaño y la complejidad de la PR, completándose en un promedio de 20 minutos.
Niveles de gravedad
Cada hallazgo se etiqueta con un nivel de gravedad:
Marcador | Gravedad | Significado |
🔴 | Normal | Un error que debe corregirse antes de fusionar |
🟡 | Detalle | Un problema menor, vale la pena corregir pero no es bloqueante |
🟣 | Preexistente | Un error que existe en la base de código pero no fue introducido por esta PR |
Los hallazgos incluyen una sección de razonamiento extendido que se puede expandir para ver por qué Claude marcó el problema y cómo verificó el problema.
Qué verifica Code Review
Por defecto, Code Review se enfoca en la corrección: errores que romperían la producción, no preferencias de formato o cobertura de pruebas faltante. Puedes expandir lo que verifica agregando archivos de orientación a tu repositorio.
Configurar Code Review
Los propietarios y propietarios principales de planes Team y Enterprise pueden habilitar Code Review una vez para la organización y seleccionar qué repositorios incluir. Además de un rol de propietario dentro de tu organización Claude, necesitarás permiso para instalar GitHub Apps en tu organización GitHub.
Ve a Configuración de la organización > Claude Code y encuentra la sección Code Review.
Haz clic en "Configurar" para comenzar el flujo de instalación de GitHub App.
Sigue las indicaciones para instalar la Claude GitHub App en tu organización GitHub. La aplicación solicita permisos de lectura y escritura para contenidos, problemas y solicitudes de extracción.
Elige qué repositorios habilitar para Code Review. Si no ves un repositorio, confirma que le diste a la Claude GitHub App acceso durante la instalación.
Establece un disparador de revisión para cada repositorio usando el menú desplegable Review Behavior (consulta la siguiente sección para obtener detalles sobre cada opción).
Para verificar la configuración, abre una PR de prueba. Si elegiste un disparador automático, una ejecución de verificación llamada Claude Code Review debería aparecer en unos pocos minutos. Si elegiste Manual, comenta "@claude review" en la PR para iniciar la primera revisión.
Elige un disparador de revisión
Después de la configuración, la sección Code Review muestra tus repositorios en una tabla. Para cada repositorio, elige cuándo se ejecutan las revisiones:
Una vez después de la creación de PR: La revisión se ejecuta una vez cuando se abre una PR o se marca como lista para revisión.
Después de cada inserción: La revisión se ejecuta en cada inserción a la rama de PR, detectando nuevos problemas a medida que la PR evoluciona. Claude resuelve automáticamente los hilos cuando corriges problemas marcados anteriormente. Esto ejecuta la mayoría de revisiones y cuesta más.
Manual: Las revisiones comienzan solo cuando alguien comenta "@claude review" en una PR. Útil para repositorios de alto tráfico donde deseas seleccionar qué PRs se revisan.
La tabla de repositorios también muestra el costo promedio por revisión para cada repositorio según la actividad reciente.
Disparar revisiones manualmente
Comenta "@claude review" en una solicitud de extracción para iniciar una revisión e incluir esa PR en revisiones activadas por inserción en el futuro. Esto funciona independientemente del disparador configurado del repositorio.
Para que el comentario active una revisión:
Publícalo como un comentario de PR de nivel superior, no como un comentario en línea en una línea de diff.
Pon "@claude review" al inicio del comentario.
Debes tener acceso de propietario, miembro o colaborador al repositorio.
La PR debe estar abierta y no ser un borrador.
Si una revisión ya se está ejecutando, la solicitud se pone en cola hasta que se complete la revisión en progreso.
Personalizar revisiones
Code Review lee dos archivos de tu repositorio para guiar qué marca. Ambos se suman a las verificaciones de corrección predeterminadas.
CLAUDE.md
Code Review lee los archivos CLAUDE.md de tu repositorio y trata las violaciones recién introducidas como hallazgos de nivel de detalle. Si tu PR cambia el código de una manera que hace que una declaración CLAUDE.md sea obsoleta, Claude marca que los documentos también necesitan actualización.
Claude lee archivos CLAUDE.md en cada nivel de tu jerarquía de directorios, por lo que las reglas en el CLAUDE.md de un subdirectorio se aplican solo a archivos bajo esa ruta.
REVIEW.md
Agrega un archivo REVIEW.md a la raíz de tu repositorio para reglas específicas de revisión. Úsalo para codificar:
Directrices de estilo de empresa o equipo
Convenciones específicas de lenguaje o marco no cubiertas por linters
Cosas que Claude siempre debe marcar (por ejemplo, "cualquier nueva ruta de API debe tener una prueba de integración")
Cosas que Claude debe omitir (por ejemplo, "no comentes sobre código generado")
Claude descubre automáticamente REVIEW.md en la raíz del repositorio. No se necesita configuración.
Precios y uso
Code Review se factura según el uso de tokens. Cada revisión cuesta en promedio $15–25, escalando con el tamaño de la PR, la complejidad de la base de código y cuántos problemas requieren verificación.
El uso de Code Review se factura por separado a través de uso adicional y no cuenta contra el uso incluido en tu plan. El disparador de revisión que elijas afecta el costo total:
Una vez después de la creación de PR se ejecuta una vez por PR.
Después de cada inserción se ejecuta en cada inserción, multiplicando el costo por el número de inserciones.
Manual no incurre en costo hasta que alguien comenta "@claude review". Después de ese comentario, las inserciones adicionales a la PR activan revisiones automáticamente.
Los costos aparecen en tu factura de Anthropic independientemente de si tu organización usa AWS Bedrock o Google Vertex AI para otras características de Claude Code.
Para establecer un límite de gasto mensual, ve a Configuración de la organización > Uso y configura el límite para el servicio Claude Code Review.
Monitorea el gasto a través del gráfico de costo semanal en el panel de análisis o la columna de costo promedio por repositorio en la configuración de administración.
Ver uso
Ve al panel de análisis de Code Review para ver la actividad en tu organización. El panel muestra:
PRs revisadas: Conteo diario de solicitudes de extracción revisadas durante el rango de tiempo seleccionado.
Costo semanal: Gasto semanal en Code Review.
Retroalimentación: Conteo de comentarios de revisión que se resolvieron automáticamente porque alguien abordó el problema.
Desglose de repositorio: Conteos por repositorio de PRs revisadas y comentarios resueltos.
Solución de problemas
Los repositorios no aparecen después de instalar la GitHub App
Si has instalado la Claude GitHub App pero tus repositorios no aparecen en el panel de administración:
Confirma que la Claude GitHub App tiene acceso a los repositorios que esperas. Ve a la configuración de tu organización GitHub, encuentra la Claude GitHub App bajo GitHub Apps instaladas, y verifica si tiene acceso a todos los repositorios o solo a los seleccionados.
Si tu organización usa GitHub Enterprise Cloud con Usuarios Administrados Empresariales (EMU), asegúrate de que la Claude GitHub OAuth App esté autorizada a nivel empresarial. Las empresas EMU pueden restringir qué aplicaciones OAuth están aprobadas, y la aplicación Claude debe estar explícitamente permitida.
Intenta desconectar y reconectar la integración de GitHub. Ve a Configuración de la organización > Claude Code, elimina la configuración del repositorio y ejecuta la configuración nuevamente.
Si el problema persiste, contacta a nuestro equipo de soporte con el nombre de tu organización y el nombre de tu organización GitHub para que podamos investigar.
Code Review no comienza en una nueva PR
Si no aparece ninguna ejecución de verificación después de abrir una PR:
Confirma que el repositorio está listado y habilitado en tu configuración de administración.
Verifica la configuración del disparador de revisión. Si está configurado en Manual, necesitarás comentar "@claude review" en la PR para iniciar una revisión.
Asegúrate de que la PR no sea un borrador. Code Review no se ejecuta en PRs de borrador.
Verifica que la Claude GitHub App aún tenga acceso al repositorio en la configuración de tu organización GitHub.
GitHub Enterprise Cloud con restricciones de IP
Si tu organización GitHub Enterprise Cloud restringe el acceso por dirección IP, la Claude GitHub App puede no poder acceder a tus repositorios. Para solucionar esto, habilita la herencia de lista de permitidos de IP para GitHub Apps instaladas en la configuración de tu empresa GitHub. La Claude GitHub App registra sus rangos de IP, por lo que habilitar esta configuración permite el acceso sin configuración manual. Para agregar los rangos a tu lista de permitidos manualmente en su lugar, o para configurar otros firewalls, consulta las direcciones IP de la API de Anthropic.
GitHub Enterprise Server (autohospedado)
Code Review actualmente requiere repositorios alojados en github.com, por lo que GitHub Enterprise Server autohospedado aún no es compatible.
Preguntas frecuentes
¿Está Code Review disponible como capacidad al crear un rol personalizado?
No, Code Review no está disponible para agregar a un rol personalizado en este momento.
Recursos relacionados
Complementos — Explora el mercado de complementos, incluido un complemento de revisión de código para ejecutar revisiones bajo demanda localmente antes de insertar.
Acciones de GitHub — Ejecuta Claude en tus propios flujos de trabajo de Acciones de GitHub para automatización personalizada más allá de Code Review.
GitLab CI/CD — Integración de Claude autohospedada para canalizaciones de GitLab.