Para obtener más información sobre cómo habilitar GitHub en tu cuenta, consulta Usar conectores para ampliar las capacidades de Claude.
Conecta tus repositorios de GitHub directamente a Claude para proporcionar contexto integral para tus tareas de desarrollo de software. Puedes agregar fácilmente repositorios seleccionándolos de una lista, lo que ayuda a Claude a comprender mejor y asistir con tu base de código.
Cómo agregar repositorios de GitHub
Nota: Si actualmente no estás autenticado en GitHub, serás redirigido a GitHub para autenticarte antes de poder usar esta integración.
Chats
Haz clic en el botón "+" en la esquina inferior izquierda de la interfaz de chat.
Selecciona "Agregar desde GitHub" del menú desplegable.
Usa el navegador de archivos para seleccionar archivos y carpetas específicos.
Cuando envíes tu mensaje, Claude accederá y procesará el contenido para informar su respuesta.
Proyectos
Haz clic en el botón "+" en la esquina superior derecha de tu sección de conocimiento del proyecto.
Selecciona "GitHub" del menú desplegable.
Busca en tus repositorios accesibles o pega una URL de repositorio.
Usa el navegador de archivos para seleccionar archivos y carpetas específicos.
Tu contenido seleccionado se agregará al conocimiento del proyecto para que Claude acceda y procese.
Puedes usar el icono "Sincronizar" para asegurar que estés trabajando con la versión más actualizada de tu base de código.
Puedes usar el icono "Configurar archivos" para modificar qué archivos y carpetas analiza Claude.
Conectar a repositorios privados
Si Claude no puede acceder a un repositorio después de que ingreses una URL válida, lo más probable es que estés intentando conectar Claude a un repositorio privado: Sigue el enlace a nuestra aplicación de GitHub, donde puedes otorgar acceso a repositorios si eres administrador de GitHub, o envía una solicitud a los administradores de tu organización de GitHub.
Otorga acceso tú mismo si puedes: Puedes elegir entre permitir que Claude acceda a todos los repositorios o a repositorios específicos.
Solicita acceso si no tienes los permisos necesarios: Los administradores de tu organización de GitHub recibirán una notificación por correo electrónico sobre tu solicitud. Una vez que aprueben la solicitud, podrás sincronizar y acceder al repositorio en Claude.
Mejores prácticas
Comienza con poco: Comienza seleccionando un pequeño subconjunto de tu base de código para analizar. Esto te ayudará a familiarizarte con cómo Claude interpreta y discute tu código.
Itera y refina: Si la respuesta inicial de Claude no aborda completamente tu pregunta, no dudes en hacer preguntas de seguimiento o solicitar aclaraciones.
Combina con experiencia humana: Usa los conocimientos de Claude como punto de partida para una investigación y discusión adicional con tu equipo. Por favor, revisa el trabajo de Claude.
Selección de archivos reflexiva: Al usar "Configurar archivos," sé estratégico con tus selecciones. Incluye archivos y directorios clave que sean centrales para tu tarea o proyecto actual, pero evita seleccionar archivos innecesarios para mantenerte dentro de los límites de tokens y mantener el enfoque.
Actualizaciones regulares: Recuerda actualizar la sincronización de GitHub de tu proyecto periódicamente para asegurar que Claude esté trabajando con la versión más actualizada de tu base de código y especialmente antes de comenzar un nuevo análisis o cuando sepas que ha habido cambios significativos en tu repositorio.
Solución de problemas
Los repositorios de una organización no aparecen después de conectar
Si tu conexión de GitHub se muestra como conectada pero los repositorios privados de una organización específica no aparecen, esa organización puede requerir inicio de sesión único (SSO). Cuando se requiere SSO, cada usuario debe autorizar por separado la aplicación de Claude para esa organización. Hasta que lo hagas, GitHub filtra los repositorios privados de esa organización de tu vista, aunque tu conexión esté funcionando correctamente.
Cuando Claude detecta este estado, el selector de repositorio muestra un banner que te solicita autorizar SSO. Para autorizar la aplicación de Claude para tu organización:
Ve a github.com/settings/applications y abre la entrada Claude.
En Acceso de organización, haz clic en "Otorgar" junto a la organización de GitHub relevante.
Si el botón dice "Solicitar" en lugar de "Otorgar," no tienes permiso para autorizar la aplicación tú mismo. Un administrador de la organización de GitHub debe aprobar tu solicitud desde la configuración de política de aplicación OAuth de la organización.
Importante: Desconectar y reconectar GitHub en tu configuración de Claude no solucionará esto. Una conexión nueva no autoriza automáticamente las organizaciones que requieren SSO, por lo que deberás completar los pasos de autorización anteriores.
Si tu organización usa GitHub Enterprise Cloud con Usuarios Administrados por Empresa (EMU), la aplicación de Claude también debe ser aprobada a nivel empresarial. Obtén más información en Configurar revisión de código para Claude Code.
Preguntas frecuentes
¿Qué información se recupera de GitHub?
Solo se sincronizan los archivos (nombres y contenidos) en un repositorio en una rama específica. No recuperamos historial de commits, PRs u otros metadatos.
¿Qué sucede si mi repositorio se actualiza después de agregarlo a un proyecto?
Puedes hacer clic en "Sincronizar ahora" para obtener los últimos cambios de tu repositorio. Esto actualizará todos los archivos y carpetas seleccionados anteriormente.
¿Puedo agregar múltiples repositorios a un solo proyecto o chat?
Sí, puedes agregar múltiples repositorios para proporcionar a Claude contexto integral para tus tareas de desarrollo. Los repositorios deben caber dentro de la ventana de contexto de Claude.
¿Qué sucede si pierdo acceso a un repositorio?
Si pierdes acceso a un repositorio, no podrás ver su contenido en proyectos donde fue agregado anteriormente. La vista previa del repositorio se eliminará, aunque el historial de conversación se mantendrá.
Explora todos los conectores disponibles en el Directorio de Conectores.