Claude Code con GitHub Enterprise Server

La compatibilidad con GitHub Enterprise Server está disponible para planes Team y Enterprise.

La compatibilidad con GitHub Enterprise Server (GHES) permite que su organización use Claude Code con repositorios alojados en su instancia de GitHub autogestionada en lugar de github.com. Una vez que un propietario conecta su instancia de GHES, los desarrolladores pueden ejecutar sesiones en la nube y obtener revisiones de código automatizadas sin ninguna configuración por repositorio. Los mercados de plugins alojados en su instancia también son compatibles; los requisitos de credenciales varían según la superficie, como se describe en Plugin marketplaces on GHES. Para repositorios en github.com, consulte Claude Code en la nube y Revisión de código. Para ejecutar Claude en su propia infraestructura de CI, consulte GitHub Actions.

Qué funciona con GitHub Enterprise Server

La tabla a continuación muestra qué características de Claude Code admiten GHES y cualquier diferencia del comportamiento de github.com.

Característica	Compatibilidad con GHES	Notas
Sesiones en la nube	✅ Compatible	Un propietario conecta la instancia de GHES una vez; los desarrolladores usan `claude --cloud` o claude.ai/code como de costumbre
Revisión de código	✅ Compatible	Las mismas revisiones automatizadas de PR que en github.com
Claude Security	✅ Compatible	Disponible en versión beta pública para planes Enterprise en claude.ai/security
Sesiones de Teleport	✅ Compatible	Mover sesiones entre nube y terminal con `--teleport`
Mercados de plugins	✅ Compatible	Los requisitos de credenciales difieren según la superficie. Consulte Mercados de plugins en GHES
Métricas de contribución	✅ Compatible	Entregadas a través de webhooks al panel de análisis
GitHub Actions	✅ Compatible	Requiere configuración manual del flujo de trabajo; `/install-github-app` es solo para github.com
Servidor GitHub MCP	❌ No compatible	El servidor GitHub MCP no funciona con instancias de GHES

Configuración del administrador

Un propietario conecta tu instancia de GHES a Claude Code una sola vez. Después de eso, los desarrolladores de tu organización pueden usar repositorios de GHES sin ninguna configuración adicional. Necesitas el rol de Propietario o Propietario Principal en tu organización de Claude y permiso para crear GitHub Apps en tu instancia de GHES. La configuración guiada genera un manifiesto de GitHub App y te redirige a tu instancia de GHES para crear la aplicación en un clic. Si tu entorno bloquea el flujo de redirección, hay una configuración manual alternativa disponible.

Abrir la configuración de proveedores de Git

Ve a Configuración de la organización > Proveedores de Git y encuentra la sección GitHub Enterprise.

Iniciar la configuración guiada

Haz clic en Conectar, o en Agregar instancia si ya hay una instancia conectada, y luego selecciona Configurar automáticamente. Ingresa un nombre para mostrar de hasta 20 caracteres para la conexión y el nombre de host de tu GHES, por ejemplo github.example.com. Si tu instancia de GHES usa un certificado autofirmado o una autoridad de certificación privada, pega el certificado de CA en el campo opcional.

Crear la GitHub App

Haz clic en Continuar a GitHub Enterprise. Tu navegador se redirige a tu instancia de GHES con un manifiesto de aplicación previamente rellenado. Revisa la configuración y haz clic en Crear GitHub App. GHES te redirige de vuelta a Claude con las credenciales de la aplicación almacenadas automáticamente.

Instalar la aplicación en tus repositorios

Desde la página de GitHub App en tu instancia de GHES, instala la aplicación en los repositorios u organizaciones a los que quieres que Claude tenga acceso. Puedes comenzar con un subconjunto y agregar más adelante.

Habilitar características

Ve a claude.ai/admin-settings/claude-code y habilita Code Review y las métricas de contribución para tus repositorios de GHES usando la misma configuración que github.com.

Permisos de GitHub App

El manifiesto configura la GitHub App con los permisos y eventos de webhook que se muestran a continuación, que en conjunto cubren sesiones en la nube, Code Review, Claude Security, marketplaces de plugins y métricas de contribución:

Permiso	Acceso	Usado para
Contents	Lectura y escritura	Clonar repositorios y hacer push de ramas
Pull requests	Lectura y escritura	Crear PR y publicar comentarios de revisión
Issues	Lectura y escritura	Responder a menciones en issues
Checks	Lectura y escritura	Publicar ejecuciones de verificación de Code Review
Actions	Lectura	Leer el estado de CI para la corrección automática
Commit statuses	Lectura	Leer el estado de CI de proveedores que reportan estados de commit en lugar de ejecuciones de verificación
Repository hooks	Lectura y escritura	Crear un webhook en un repositorio de marketplace de plugins cuando Sincronizar automáticamente está activado para un marketplace en Configuración de la organización > Plugins & skills
Metadata	Lectura	Requerido por GitHub para todas las aplicaciones
Organization members	Lectura	Coincidir con la GitHub App de Claude en github.com, que lo usa para verificar el rol en la organización de un usuario que se conecta al vincular una instalación

La aplicación se suscribe a los eventos pull_request, issue_comment, pull_request_review_comment, pull_request_review, check_run y status. GitHub aplica un manifiesto solo cuando se crea la aplicación, por lo que una aplicación creada a partir de una versión anterior del manifiesto mantiene los permisos y eventos con los que se creó. Si a tu aplicación le falta alguno de los permisos o eventos anteriores, agrégalos en la configuración de la aplicación en tu instancia de GHES. Luego GitHub le pide a un propietario de cada instalación que apruebe los nuevos permisos, y la instalación mantiene sus permisos antiguos hasta que lo haga.

Configuración manual

Si tu configuración de red bloquea el flujo de redirección guiado, haz clic en Conectar o Agregar instancia y luego selecciona Agregar manualmente en lugar de Configurar automáticamente. Crea una GitHub App en tu instancia de GHES con los permisos y eventos anteriores y luego ingresa los detalles de la conexión en el formulario: un nombre para mostrar, el nombre de host de tu GHES y un puerto opcional, y el ID de la aplicación, el ID de cliente, el secreto de cliente, el secreto de webhook y la clave privada. El formulario también acepta un certificado de CA personalizado opcional y nombres de host de réplicas de lectura. Claude genera la URL del webhook de la aplicación cuando guardas la conexión. Después de hacer clic en Agregar configuración, abre el menú Más opciones de la conexión, selecciona Copiar URL del webhook y pega la URL en la configuración del webhook de la aplicación en tu instancia de GHES. Usa el mismo secreto de webhook que ingresaste en el formulario.

Requisitos de red

Para las sesiones alojadas en Anthropic, tu instancia de GHES debe ser accesible desde la infraestructura de Anthropic para que Claude pueda clonar repositorios y publicar comentarios de revisión. Si tu instancia de GHES está detrás de un firewall, agrega a la lista de permitidos las direcciones IP salientes de Anthropic. Las sesiones en un entorno autohospedado, en cambio, clonan desde dentro de tu red, a menos que el ejecutor opte por el proxy de Git de Anthropic, que obtiene los datos desde el lado de Anthropic y necesita la misma accesibilidad. Los flujos alojados previos a la sesión, como el selector de repositorios, se ejecutan en el lado de Anthropic antes de que comience una sesión. Necesitan que tu instancia de GHES sea accesible desde la infraestructura de Anthropic incluso cuando la sesión se ejecuta en un entorno autohospedado. El conector de SCM no está disponible, por lo que esos flujos no pueden alcanzar un host de GHES que solo sea enrutable internamente.

Flujo de trabajo del desarrollador

Una vez que su administrador ha conectado la instancia de GHES, no se necesita ninguna configuración del lado del desarrollador. Claude Code detecta automáticamente el nombre de host de su GHES desde el remoto de git en su directorio de trabajo. Clone un repositorio de su instancia de GHES como lo haría normalmente, reemplazando github.example.com y la ruta del repositorio con su nombre de host de GHES y repositorio:

git clone git@github.example.com:platform/api-service.git
cd api-service

Luego inicie una sesión en la nube. Claude detecta el host de GHES desde su remoto de git y enruta la sesión a través de su instancia configurada de la organización:

claude --cloud "Add retry logic to the payment webhook handler"

La sesión clona su repositorio desde GHES e inserta cambios en una rama. Monitoree el progreso en claude.ai/code. Consulte Claude Code en la nube para el flujo de trabajo completo de sesión en la nube, incluida revisión de diferencias, corrección automática y rutinas.

Sesiones de Teleport a su terminal

Extraiga una sesión en la nube a su terminal local con claude --teleport. Teleport verifica que esté en un checkout del mismo repositorio de GHES antes de obtener la rama y cargar el historial de sesiones. Consulte requisitos de teleport para obtener detalles.

Mercados de plugins en GHES

Aloje mercados de plugins en su instancia de GHES para distribuir herramientas internas en toda su organización. La estructura del mercado es idéntica a los mercados alojados en github.com, pero la instalación funciona de manera diferente según dónde agregue el mercado, y las credenciales varían según la superficie:

Superficie	Cómo funciona la instalación	Lo que cada usuario necesita
Claude Code CLI y escritorio	Claude Code clona el repositorio del mercado usando las credenciales de git existentes de la máquina	Acceso a Git a su host de GHES desde su máquina
Configuración administrada (`extraKnownMarketplaces`)	Claude Code registra la entrada y clona el repositorio usando las credenciales de git existentes de la máquina	Acceso a Git a su host de GHES desde su máquina
Configuración de plugins de la organización en claude.ai	Un Propietario selecciona la instancia de GHES como fuente; el backend de Anthropic obtiene y sincroniza el repositorio usando la GitHub App de configuración de administrador	Nada por usuario una vez agregado. El Propietario que lo agrega necesita su propia cuenta de GitHub Enterprise conectada como verificación de acceso, y la GitHub App debe estar instalada en el repositorio del mercado
Configuración de usuario en claude.ai	El backend de Anthropic obtiene el repositorio usando la conexión de GitHub Enterprise del usuario que lo envía	Su propia cuenta de GitHub Enterprise conectada a Claude
Sesiones en la nube	Las sesiones en la nube clonan mercados dentro del sandbox de la sesión. El sandbox solo puede alcanzar su instancia de GHES cuando el repositorio de la sesión está en esa misma instancia, y sus credenciales de git se limitan a los repositorios de la sesión	No es confiable para mercados alojados en GHES: un host diferente al repositorio de la sesión no es accesible, e incluso las instalaciones en la misma instancia pueden fallar. Use la CLI, la configuración administrada o claude.ai en su lugar

Las conexiones de GitHub Enterprise en claude.ai son por usuario cuando se agrega un mercado desde la configuración de usuario. La configuración de administrador conecta su instancia de GHES a su organización, pero no conecta cuentas de usuario individuales: cada usuario que agregue un mercado de GHES desde su propia configuración debe conectar primero su propia cuenta de GitHub Enterprise, y la conexión de un usuario, incluida la del Propietario, no cubre a nadie más. Los mercados agregados por un Propietario en la configuración de plugins de la organización no imponen este requisito a los usuarios, porque las obtenciones continuas usan la GitHub App de la organización. El Propietario que agrega el mercado aún necesita su propia cuenta de GitHub Enterprise conectada en el momento de la adición.

Agregar un mercado de GHES

La abreviatura owner/repo siempre se resuelve en github.com. Para mercados alojados en GHES, use la URL de git completa, reemplazando github.example.com y la ruta del repositorio con la suya propia. Se recomiendan las URLs de HTTPS:

/plugin marketplace add https://github.example.com/platform/claude-plugins.git

Las URLs de SSH funcionan si la máquina ya confía en su host de GHES:

/plugin marketplace add git@github.example.com:platform/claude-plugins.git

Claude Code ejecuta git de forma no interactiva y rechaza las conexiones SSH a hosts que no están en el archivo known_hosts de la máquina. Una URL de HTTPS con un asistente de credenciales de git evita el requisito de known_hosts. Consulte Crear y distribuir un mercado de plugins para la guía completa sobre cómo construir mercados.

Preregistrar mercados de GHES con configuración administrada

La configuración extraKnownMarketplaces preregistra un mercado para que los desarrolladores lo obtengan sin configuración manual. Funciona desde cualquier archivo de configuración, incluido el .claude/settings.json de un repositorio; la configuración administrada lo entrega en toda la organización:

{
  "extraKnownMarketplaces": {
    "internal-tools": {
      "source": {
        "source": "git",
        "url": "https://github.example.com/platform/claude-plugins.git"
      }
    }
  }
}

Claude Code instala estos mercados localmente: registra cada entrada y clona el repositorio con las credenciales de git existentes de la máquina. Esta ruta no pasa por claude.ai, por lo que no se requiere la conexión de GitHub Enterprise por usuario. Para un despliegue exitoso:

Use una URL de git completa. La abreviatura owner/repo siempre se resuelve en github.com y no puede hacer referencia a un host de GHES.
Prefiera URLs de HTTPS. Los clones de SSH fallan en máquinas que no confían en la clave de host de GHES. Una URL de HTTPS con el asistente de credenciales de git estándar de su organización funciona en cualquier máquina con credenciales configuradas.
Confirme que cada máquina pueda clonar desde su host de GHES. Si una máquina carece de credenciales, el mercado se registra pero nunca se instala, y sus plugins se reportan como no encontrados en lugar de solicitar credenciales.
Confirme que la configuración llega a cada máquina. Un archivo de configuración administrada solo tiene efecto en las máquinas en las que se implementa, por ejemplo a través de su sistema de administración de dispositivos. Consulte Implementar configuración administrada para ubicaciones de archivos.

Agregar mercados de GHES a la lista blanca en configuración administrada

Si su organización usa configuración administrada para restringir qué mercados pueden agregar los desarrolladores, use el tipo de fuente hostPattern para permitir todos los mercados de su instancia de GHES sin enumerar cada repositorio. Consulte Mecanismos de entrega para ubicaciones de archivos en cada plataforma. Agregue el JSON a su archivo managed-settings.json o política MDM equivalente:

{
  "strictKnownMarketplaces": [
    {
      "source": "hostPattern",
      "hostPattern": "^github\\.example\\.com$"
    }
  ]
}

Consulte la referencia de configuración strictKnownMarketplaces y extraKnownMarketplaces para el esquema completo.

Limitaciones

Algunas características se comportan de manera diferente en GHES que en github.com. La tabla de características resume la compatibilidad; esta sección cubre las soluciones alternativas.

Comando /install-github-app: siga el flujo de configuración del administrador en claude.ai en su lugar. Si también desea flujos de trabajo de GitHub Actions en GHES, adapte el flujo de trabajo de ejemplo manualmente.
Servidor GitHub MCP: use la CLI gh configurada para su host de GHES en su lugar. Ejecute gh auth login --hostname github.example.com para autenticarse, luego Claude puede usar comandos gh en sesiones.

Solución de problemas

La sesión en la nube falla al clonar el repositorio

Si claude --cloud falla con un error de clonación, verifique que un Propietario haya completado la configuración para su instancia de GHES y que la GitHub App esté instalada en el repositorio en el que está trabajando. Pida al Propietario que conectó la instancia que confirme que el nombre de host registrado en la configuración de Claude coincida con el nombre de host en su remoto de git.

Agregar mercado falla con un error de política

Si /plugin marketplace add está bloqueado para su URL de GHES, su organización ha restringido las fuentes del mercado. Pida a su administrador que agregue una entrada hostPattern para su nombre de host de GHES en configuración administrada.

Agregar mercado en claude.ai falla con un error de acceso a GitHub

Si agregar un mercado de GHES desde la configuración de usuario falla con un error genérico como “No se pudo agregar el mercado”, primero verifique su conexión de GitHub Enterprise. Esto es lo que aparece cuando su propia cuenta de GitHub Enterprise no está conectada a Claude, incluso si la instancia de GHES de su organización está configurada y otros usuarios están conectados. El diálogo no apunta al flujo de conexión de GitHub Enterprise, y la opción “Conectar a GitHub” en la pestaña Examinar inicia sesión en github.com, lo que no otorga acceso a repositorios de GHES. Conecta tu cuenta de GitHub Enterprise en uno de estos lugares y luego agrega el marketplace nuevamente:

Selector de repositorio: en claude.ai/code, el selector de repositorio ofrece una opción de conexión para cada instancia de GHES configurada.
Página de proveedores de Git: si eres Propietario, ve a la sección de GitHub de Organization settings > Git providers y haz clic en Connect, o en Add organization una vez que haya una cuenta conectada. Selecciona el nombre de host de GHES en GitHub instance y luego haz clic en Connect.

Alternativamente, pide a un Propietario que agregue el marketplace en la configuración de plugins de la organización, lo que elimina el requisito de conexión por usuario. En otras superficies de claude.ai, un error “Repositorio no encontrado. Si es privado, se requiere acceso a GitHub” en un mercado de GHES generalmente indica la misma conexión faltante. Conecte su cuenta de GitHub Enterprise a través de una de las rutas anteriores y luego intente de nuevo.

Instancia de GHES no accesible

Si las revisiones o sesiones en la nube alojadas por Anthropic se agotan, su instancia de GHES puede no ser accesible desde la infraestructura de Anthropic. Confirme que su firewall permite conexiones entrantes desde las direcciones IP de salida de Anthropic. Las sesiones en un entorno autohospedado alcanzan GHES desde dentro de su red, así que cuando uno de ellos no pueda clonar, verifique la ruta de red propia del ejecutor en su lugar. Para el selector de repositorio y otros flujos previos a la sesión alojados, consulte Requisitos de red.

El inicio de sesión falla con `Unable to get organization UUID`

Claude Code no pudo leer una organización de claude.ai desde sus credenciales. Inicie sesión con /login usando una cuenta en su organización de Team o Enterprise, ya que la compatibilidad con GitHub Enterprise Server se limita a esos planes. Consulte Unable to get organization UUID para conocer las causas y los otros mensajes que produce este estado. Estas páginas cubren las características referenciadas en toda esta guía con más profundidad:

Claude Code en la web: ejecutar sesiones de Claude Code en infraestructura en la nube
Revisión de código: revisiones automatizadas de PR
Mercados de plugins: construir y distribuir catálogos de plugins
Analytics: rastrear uso y métricas de contribución
Configuración administrada: configuración de política en toda la organización
Configuración de red: requisitos de firewall y lista blanca de IP

Primeros pasos

Conceptos básicos

Usar Claude Code

Plataformas e integraciones

Claude Code con GitHub Enterprise Server

Qué funciona con GitHub Enterprise Server

Configuración del administrador

Permisos de GitHub App

Configuración manual

Requisitos de red

Flujo de trabajo del desarrollador

Sesiones de Teleport a su terminal

Mercados de plugins en GHES

Agregar un mercado de GHES

Preregistrar mercados de GHES con configuración administrada

Agregar mercados de GHES a la lista blanca en configuración administrada

Limitaciones

Solución de problemas

La sesión en la nube falla al clonar el repositorio

Agregar mercado falla con un error de política

Agregar mercado en claude.ai falla con un error de acceso a GitHub

Instancia de GHES no accesible

El inicio de sesión falla con `Unable to get organization UUID`

​Qué funciona con GitHub Enterprise Server

​Configuración del administrador

​Permisos de GitHub App

​Configuración manual

​Requisitos de red

​Flujo de trabajo del desarrollador

​Sesiones de Teleport a su terminal

​Mercados de plugins en GHES

​Agregar un mercado de GHES

​Preregistrar mercados de GHES con configuración administrada

​Agregar mercados de GHES a la lista blanca en configuración administrada

​Limitaciones

​Solución de problemas

​La sesión en la nube falla al clonar el repositorio

​Agregar mercado falla con un error de política

​Agregar mercado en claude.ai falla con un error de acceso a GitHub

​Instancia de GHES no accesible

​El inicio de sesión falla con Unable to get organization UUID

​Recursos relacionados

Qué funciona con GitHub Enterprise Server

Configuración del administrador

Permisos de GitHub App

Configuración manual

Requisitos de red

Flujo de trabajo del desarrollador

Sesiones de Teleport a su terminal

Mercados de plugins en GHES

Agregar un mercado de GHES

Preregistrar mercados de GHES con configuración administrada

Agregar mercados de GHES a la lista blanca en configuración administrada

Limitaciones

Solución de problemas

La sesión en la nube falla al clonar el repositorio

Agregar mercado falla con un error de política

Agregar mercado en claude.ai falla con un error de acceso a GitHub

Instancia de GHES no accesible

El inicio de sesión falla con `Unable to get organization UUID`

Recursos relacionados