Loading...

Cómo usar Claude para revisar y analizar código

Claude puede leer y analizar código para ayudarte a encontrar errores, revisar seguridad, sugerir mejoras o explicar una función que no escribiste tú. Puedes hacerlo en el chat (subiendo archivos o con un Proyecto) o, si trabajas con repositorios, con Claude Code y GitHub.

Última verificación: octubre 2026

¿Cuándo conviene pedirle una revisión a Claude?

Antes de un merge importante, cuando heredas código y necesitas entenderlo rápido, cuando buscas una segunda opinión sobre seguridad o buenas prácticas, o cuando quieres explorar un refactor sin comprometer producción.

Pasos para revisar código con Claude en el chat

1

Sube o pega los archivos de código

Arrastra archivos al cuadro de mensaje o usa el ícono de adjuntar (clip), o pega fragmentos cortos directamente. Claude admite la mayoría de lenguajes y formatos de texto.

2

Pide una revisión enfocada

En lugar de "revisa este código", sé específico: "busca errores lógicos", "identifica posibles vulnerabilidades de seguridad" o "evalúa si sigue las convenciones de este lenguaje". Entre más enfocada la petición, más útil la respuesta.

3

Usa un Proyecto para mantener el contexto

Si vas a trabajar varias sesiones sobre el mismo código, crea un Proyecto y sube los archivos relevantes como conocimiento. Así no los adjuntas en cada conversación.

4

Pide que explique una función específica

Por ejemplo: "explica qué hace esta función línea por línea" o "explícala como si se la describieras a alguien que recién se une al equipo".

5

Pide una propuesta de refactor

Indica el objetivo: "hazlo más legible", "redúcelo sin cambiar el comportamiento" o "sepáralo en funciones más pequeñas". Revisa siempre la propuesta antes de aplicarla.

6

Dale contexto suficiente sobre el proyecto

Comparte la arquitectura general, las convenciones del equipo y qué archivos o lógica no debe modificar. Esto evita sugerencias que no encajan con el resto del sistema.


Buenas prácticas

  • Divide repositorios grandes en partes relevantes. Sube solo los archivos relacionados con lo que quieres revisar.
  • Verifica siempre el código sugerido: ejecútalo y revísalo como el aporte de cualquier compañero.
  • Usa un Proyecto por repositorio para no mezclar convenciones.
  • Sé explícito sobre lo que no debe tocarse.
  • Documenta las convenciones del equipo en las instrucciones del Proyecto para que apliquen en todas las revisiones.

Si usas Claude Code o GitHub

Además del chat, hay opciones pensadas para repositorios. Su disponibilidad depende de tu plan y de lo que active tu organización.

Opción Qué hace
/code-review (Claude Code) Revisa los cambios de tu rama desde tu sesión de Claude Code. Se puede usar sin que un administrador active nada adicional.
/security-review (Claude Code) Hace una revisión de seguridad bajo demanda de los cambios pendientes.
Code Review para pull requests (GitHub) Revisa automáticamente los pull requests y deja comentarios en las líneas concernidas, con un resumen. No aprueba ni bloquea el pull request: la decisión de hacer merge sigue siendo de tu equipo. Lo activa un Owner de la organización y está disponible en ciertos planes de organización.

Estas revisiones usan IA y pueden pasar por alto errores o vulnerabilidades: que no reporten hallazgos no significa que el código esté libre de fallas. Si quieres usar alguna en tu curso o proyecto, consulta con Phygital Lab.

Tipos de revisión y cuándo usarlos

Tipo de revisión Cuándo pedirla
Errores lógicos Antes de hacer merge, cuando algo no se comporta como esperas
Seguridad Antes de exponer un endpoint, manejar datos de usuarios o desplegar
Estilo y convenciones Al integrar código de varios colaboradores
Explicación de código heredado Cuando te asignan un módulo que no escribiste
Refactor Cuando el código funciona pero es difícil de mantener
Sobre datos sensibles

No subas código propietario, claves de acceso, credenciales ni información confidencial de la institución sin confirmar con Phygital Lab las políticas de privacidad y seguridad vigentes para tu cuenta institucional.

¿Necesitas apoyo para revisar el código de tu proyecto?

Si quieres ayuda para configurar un Proyecto de revisión de código para tu equipo, contáctanos.

Contáctanos