Revisión de código en GitHub de Claude Code: bot vs. revisión local

- El precio, el estado de research preview y la tabla de severidad de abajo se contrastaron directamente con code.claude.com/docs/en/code-review al momento de escribir (2026-08-20); Anthropic señala que esta función cambia rápido, así que verifica la documentación en vivo antes de depender de cifras exactas.

Qué es realmente el bot nativo de GitHub Code Review

Es un GitHub App que un Owner instala a nivel de organización, eligiendo qué repositorios lo reciben. Una vez habilitado, las revisiones se disparan automáticamente cuando se abre un PR, en cada push, o cuando alguien comenta @claude review en un PR - según cómo esté configurado el disparador de cada repositorio.

Cuando corre una revisión, varios agentes analizan el diff en paralelo, cada uno buscando una clase distinta de problema, en el contexto de toda tu base de código. Luego, un paso de verificación coteja los candidatos contra el comportamiento real del código para filtrar falsos positivos. Los resultados se deduplican, se ordenan por severidad y se publican como comentarios inline en las líneas exactas donde se encontraron los problemas, con un resumen arriba. Junto a eso, un check run llamado Claude Code Review aparece al lado de tus otras verificaciones de CI - si no se encontró nada, el check run también se actualiza para decirlo. Fuente: code.claude.com/docs/en/code-review.

Además de los comentarios inline, la vista Details del check run lista todos los hallazgos en un solo lugar, ordenados por severidad - una fila 🔴 Important que apunta, por ejemplo, a src/auth/session.ts:142 justo encima de una fila 🟡 Nit unas líneas más abajo - útil cuando quieres los hallazgos de todo el PR en una sola pantalla en vez de recorrer el diff. Los mismos hallazgos también aparecen como anotaciones directamente en la pestaña Files changed. Si haces un nuevo commit mientras una revisión todavía analiza un diff más antiguo, una línea señalada que se movió no desaparece sin más - reaparece bajo un título Additional findings en el cuerpo de la revisión.

Bot vs. /code-review local - la comparación que casi nadie hace

La mayoría de lo que se escribe sobre esta función describe solo el bot o lo compara con herramientas SaaS de terceros. Casi nadie lo pone lado a lado con el comando de revisión gratuito que Claude Code ya incluye. Aquí va la comparación directa:

Si también usas Codex, su comando de revisión equivalente es /review - presets distintos, configuración distinta - lo tratamos aparte en Codex Code Review (/review).

Los niveles de severidad, explicados

Cada hallazgo recibe exactamente una de tres etiquetas, tal cual figura en la documentación:

Cada hallazgo también trae una sección de razonamiento plegable que explica por qué Claude lo señaló y cómo verificó el problema. Puedes reaccionar con 👍/👎 directamente en un comentario - Anthropic agrega esas reacciones después de que el PR se fusiona para ajustar al revisor, aunque una reacción no dispara una nueva revisión ni cambia nada en el propio PR.

REVIEW.md - cómo ajustar lo que se señala

El REVIEW.md vive en la raíz de tu repositorio y se inyecta directo en el system prompt de cada agente del pipeline de revisión, como el bloque de instrucciones de mayor prioridad, sobrescribiendo la guía de revisión por defecto. Como se pega literalmente, la sintaxis de import @path no se expande dentro de él - todo lo que quieras que el revisor sepa hay que escribirlo directamente en el archivo.

El CLAUDE.md se sigue leyendo junto a él, pero solo como contexto del proyecto, y las violaciones recién introducidas reciben como mucho la etiqueta Nit, nunca más alta. También funciona en ambos sentidos: si tu PR deja desactualizada una afirmación del CLAUDE.md, Claude señala que la documentación también hay que actualizarla.

La parte fácil de pasar por alto: el comando local /code-review NO lee REVIEW.md. Solo sigue el CLAUDE.md, igual que cualquier sesión normal de Claude Code. Si quieres ajustar específicamente el bot gestionado, REVIEW.md es el único archivo que tiene algún efecto ahí.

Un ejemplo condensado, parafraseado de la documentación (redefine Important, limita los nits, omite archivos generados):

# Review instructions

## What Important means here
Reserve Important for findings that would break behavior, leak data,
or block a rollback. Style/naming/refactor suggestions are Nit at most.

## Cap the nits
Report at most 5 Nits per review; roll up the rest as "plus N similar items"
in the summary.

## Do not report
- Anything CI already enforces: lint, formatting, type errors
- Generated files under src/gen/ and any *.lock file

Configuración - cómo lo activa un Owner

Ve a claude.ai/admin-settings/claude-code, busca la sección Code Review - necesitas el rol de Owner o Primary Owner en tu organización de Claude, además de permiso para instalar GitHub Apps en tu org de GitHub. Haz clic en Setup para iniciar el flujo de instalación del GitHub App: elige la org de GitHub que es dueña de tus repos, selecciona a qué repos puede acceder y aprueba los permisos solicitados. Una vez instalado, selecciona qué repos habilitar y, para cada uno, elige un Review Behavior: Once after PR creation, After every push, o Manual (solo corre cuando alguien comenta @claude review).

Condición importante: esto no es algo que un dev en solitario con Pro/Max pueda habilitar por su cuenta - requiere una organización Team/Enterprise, y alguien tiene que tener el rol de Owner.

Una vez en marcha, los Owners pueden seguir la adopción desde el panel de analytics en claude.ai/analytics/code-review: PRs revisados por día, gasto semanal y cuántos comentarios de revisión se resolvieron automáticamente porque alguien corrigió el problema señalado, todo desglosado por repositorio. Trata los números del panel como estimaciones para detectar tendencias - para un gasto exacto de factura, revisa tu cuenta real de Anthropic.

Precio - cuánto cuesta de verdad

Cada revisión cuesta en promedio US$ 15-25, cobrado según el uso real de tokens, escalando con el tamaño del PR y la complejidad de la base de código. Ese costo se cobra aparte mediante usage credits y no cuenta contra el uso incluido en tu plan Team/Enterprise. Tu elección de disparador multiplica el total de forma notable: Once after PR creation corre exactamente una vez por PR, Manual solo corre cuando alguien comenta, y After every push vuelve a correr en cada push - el más caro de los tres. Las orgs pueden fijar un tope de gasto mensual en admin settings; cuando se alcanza, las revisiones se pausan y se reanudan automáticamente en el siguiente periodo de facturación (o de inmediato si un admin sube el tope).

Para comparar: el comando local /code-review no cuesta nada más allá del uso que ya estás pagando.

¿Bloquea el merge?

No - nunca. El check run siempre termina con una conclusión neutral, así que la branch protection no puede condicionarse a él directamente, aunque quisieras. Ese es un detalle genuinamente sorprendente para un equipo que evalúa esto como un candado de merge estricto: para imponerlo de verdad, tienes que parsear tú mismo el desglose de severidad legible por máquina al final de la salida del check run, en tu propio CI, por ejemplo:

gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID \
  --jq '.output.text | split("bughunter-severity: ")[1] | split(" -->")[0] | fromjson'
# => {"normal": 2, "nit": 1, "pre_existing": 0}

La clave normal es el conteo de hallazgos Important; un valor distinto de cero significa que hay al menos un bug que vale corregir antes del merge.

Un matiz más que conviene conocer: las revisiones son best-effort. Si la ejecución choca con un error interno o se agota el tiempo, el título del check run cambia a Code review encountered an error o Code review timed out - pero la conclusión sigue siendo neutral de todos modos, así que una ejecución fallida no te bloquea más que una limpia. Comenta @claude review para reintentar; el botón Re-run de la propia pestaña Checks de GitHub no vuelve a disparar el Code Review.

Una tercera opción - un revisor local y personalizable

Más allá del bot gestionado y del comando local gratuito, hay un tercer camino que vale la pena nombrar con honestidad: el Engineer Kit de AgentKit incluye un agente de revisión local (code-reviewer), invocado vía /ak:review - parecido a correr /code-review, pero empaquetado junto con los demás agentes/flujos del kit y personalizable al modo en que defines tu proceso, sin estar limitado a Team/Enterprise y sin cobro por revisión - es un precio único del kit, en cambio. Esto no es una afirmación de paridad de funciones frente al propio bot de Anthropic - solo un tercer punto de comparación honesto para quienes no quieren ninguna de las otras dos. Para el comando local en profundidad, mira el recorrido del /code-review local. Para una visión general del producto, lee la reseña de AgentKit.

¿Cuál deberías usar?

No son mutuamente excluyentes - muchos equipos usan más de uno:

• Dev en solitario, cualquier plan: el comando local /code-review - gratis, suficiente.
• Equipo que quiere cobertura automática en cada PR sin enseñar un comando: el bot gestionado - presupuesta US$ 15-25/revisión.
• Quieres un revisor personalizable sin cobro por revisión, en cualquier plan: el agente de revisión basado en kit.

Preguntas frecuentes (FAQ)

¿Qué es el GitHub Code Review nativo de Claude Code?

Un bot de GitHub App, habilitado por un Owner de la organización, que revisa automáticamente los pull requests en GitHub y publica comentarios inline etiquetados por severidad. Actualmente está en research preview.

¿Es gratis?

No. Promedia US$ 15-25 por revisión, cobrado aparte mediante usage credits, sin contar contra el uso incluido en tu plan. El comando local /code-review es la opción gratuita.

¿Qué planes tienen Code Review?

Solo Team y Enterprise (research preview), y no está disponible para organizaciones con Zero Data Retention activado. Pro/Max no pueden habilitar el bot por su cuenta, pero todo plan puede usar el comando local /code-review.

¿Bloquea el merge?

Nunca. El check run siempre termina con una conclusión neutral, así que la branch protection no puede condicionarse a él directamente - un candado estricto exige parsear tú mismo el desglose de severidad legible por máquina en el CI.

¿Cuál es la diferencia entre REVIEW.md y CLAUDE.md?

REVIEW.md es solo para revisión y se inyecta como la instrucción de mayor prioridad en cada agente de revisión. CLAUDE.md es contexto general del proyecto, y las nuevas violaciones ahí solo reciben la etiqueta Nit. El comando local /code-review lee CLAUDE.md pero no REVIEW.md.

¿Puedo usar el comando local /code-review en su lugar?

Sí, y es gratis en todo plan. La contrapartida: tienes que correrlo tú, no obtienes la cobertura automática en cada PR como la que ofrece el bot, y no lee REVIEW.md.

Conclusión

Tres opciones, tres situaciones: el bot de GitHub Code Review es research preview en Team/Enterprise, US$ 15-25/revisión, y nunca bloquea un merge; el comando local /code-review es gratis en todo plan, pero lo corres tú; el agente de revisión basado en kit es la opción personalizable y de precio único. ¿Quieres el comando local en profundidad? Mira revisión de código con IA usando /code-review. ¿Necesitas una capa de revisión totalmente distinta, enfocada en seguridad? Mira auditorías de seguridad con /security-review.