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 20 minutos en promedio.
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 menor | 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 pasos a continuación cubren la configuración para repositorios en github.com. Si tus repositorios están en una instancia de GitHub Enterprise Server (GHES) autohospedada, consulta Claude Code con GitHub Enterprise Server para la guía de configuración completa.
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 aplicaciones de GitHub en tu organización de 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 la aplicación de GitHub.
Sigue las indicaciones para instalar la aplicación Claude GitHub en tu organización de 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 acceso a la aplicación Claude GitHub durante la instalación.
Establece un disparador de revisión para cada repositorio usando el menú desplegable Comportamiento de revisión (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 en 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 lo que 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 menor. Si tu PR cambia el código de una manera que hace que una declaración de CLAUDE.md quede 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 los archivos bajo esa ruta.
REVIEW.md
Añade 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 la empresa o equipo
Convenciones específicas del lenguaje o marco de trabajo 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 según 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 del 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 push se ejecuta en cada push, multiplicando el costo por el número de pushes.
Manual no incurre en costo hasta que alguien comente "@claude review". Después de ese comentario, los pushes 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 funciones 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 toda 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.
Comentarios: 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 aplicación de GitHub
Si has instalado la aplicación de GitHub de Claude pero tus repositorios no aparecen en el panel de administración:
Confirma que la aplicación de GitHub de Claude tiene acceso a los repositorios que esperas. Ve a la configuración de tu organización de GitHub, encuentra la aplicación de GitHub de Claude en Aplicaciones de GitHub instaladas, y verifica si tiene acceso a todos los repositorios o solo a algunos seleccionados.
Si tu organización usa GitHub Enterprise Cloud con Usuarios Administrados por Empresa (EMU), asegúrate de que la aplicación OAuth de GitHub de Claude esté autorizada a nivel empresarial. Las empresas EMU pueden restringir qué aplicaciones OAuth están aprobadas, y la aplicación de 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 de GitHub para que podamos investigar.
Code Review no comienza en una nueva PR
Si no aparece una 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, deberá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 aplicación de GitHub de Claude aún tenga acceso al repositorio en la configuración de tu organización de GitHub.
GitHub Enterprise Cloud con restricciones de IP
Si tu organización de GitHub Enterprise Cloud restringe el acceso por dirección IP, la aplicación de GitHub de Claude puede no poder acceder a tus repositorios. Para solucionar esto, habilita la herencia de lista de permitidos de IP para aplicaciones de GitHub instaladas en la configuración de tu empresa de GitHub. La aplicación de GitHub de Claude registra sus rangos de IP, por lo que habilitar esta configuración permite el acceso sin configuración manual. Para añadir 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)
GitHub Enterprise Server (GHES) autohospedado es compatible a través de un flujo de configuración separado. Consulta Claude Code con GitHub Enterprise Server para obtener instrucciones completas.
Problemas comunes de configuración de GHES:
Error "Public cannot be private" durante la configuración: Tu nombre de host de GHES debe resolverse a una dirección IP enrutable públicamente. Code Review accede a tu servidor a través de internet, por lo que las direcciones de red privada o interna no funcionarán. Actualiza DNS o tu configuración de red para que el nombre de host se resuelva a una IP pública, luego reinténtalo.
GitHub Enterprise Cloud con Residencia de Datos es un producto diferente. Los inquilinos de Residencia de Datos (nombres de host que coinciden con
*.ghe.com) no son compatibles con Code Review. Solo se admiten GitHub Enterprise Server autohospedado y repositorios estándar de github.com.
Preguntas frecuentes
¿Está Code Review disponible como capacidad al crear un rol personalizado?
No, Code Review no está disponible para añadir 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 enviar.
Acciones de GitHub — Ejecuta Claude en tus propios flujos de trabajo de Acciones de GitHub para automatización personalizada más allá de Revisión de Código.
GitLab CI/CD — Integración de Claude autohospedada para canalizaciones de GitLab.