> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code con GitHub Enterprise Server

> Conecte Claude Code a su instancia de GitHub Enterprise Server autohospedada para sesiones web, revisión de código y mercados de plugins.

<Note>
  La compatibilidad con GitHub Enterprise Server está disponible para planes Team y Enterprise.
</Note>

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 administrador conecta su instancia de GHES, los desarrolladores pueden ejecutar sesiones web, obtener revisiones de código automatizadas e instalar plugins desde mercados internos sin ninguna configuración por repositorio.

Para repositorios en github.com, consulte [Claude Code en la web](/es/claude-code-on-the-web) y [Revisión de código](/es/code-review). Para ejecutar Claude en su propia infraestructura de CI, consulte [GitHub Actions](/es/github-actions).

<h2 id="what-works-with-github-enterprise-server">
  Qué funciona con GitHub Enterprise Server
</h2>

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                                                                                                                                                          |
| :----------------------- | :---------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Claude Code en la web    | ✅ Compatible            | El administrador conecta la instancia de GHES una vez; los desarrolladores usan `claude --remote` o [claude.ai/code](https://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](https://claude.ai/security)                                                  |
| Sesiones de Teleport     | ✅ Compatible            | Mover sesiones entre web y terminal con `--teleport`                                                                                                           |
| Mercados de plugins      | ✅ Compatible            | Usar URLs de git completas en lugar de la abreviatura `owner/repo`                                                                                             |
| Métricas de contribución | ✅ Compatible            | Entregadas a través de webhooks al [panel de análisis](/es/analytics)                                                                                          |
| 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                                                                                                      |

<h2 id="admin-setup">
  Configuración del administrador
</h2>

Un propietario conecta su instancia de GHES a Claude Code una sola vez. Después de eso, los desarrolladores en su organización pueden usar repositorios de GHES sin ninguna configuración adicional. Necesita el rol de Propietario o Propietario Principal en su organización de Claude y permiso para crear GitHub Apps en su instancia de GHES.

La configuración guiada genera un manifiesto de GitHub App y lo redirige a su instancia de GHES para crear la aplicación en un clic. Si su entorno bloquea el flujo de redirección, hay una [configuración manual alternativa](#manual-setup) disponible.

<Steps>
  <Step title="Abrir la configuración de administrador de Claude Code">
    Vaya a [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) y encuentre la sección GitHub Enterprise Server.
  </Step>

  <Step title="Iniciar la configuración guiada">
    Haga clic en **Conectar**. Ingrese un nombre para mostrar para la conexión y el nombre de host de su GHES, por ejemplo `github.example.com`. Si su instancia de GHES usa un certificado autofirmado o una autoridad de certificación privada, pegue el certificado de CA en el campo opcional.
  </Step>

  <Step title="Crear la GitHub App">
    Haga clic en **Continuar a GitHub Enterprise**. Su navegador se redirige a su instancia de GHES con un manifiesto de aplicación previamente rellenado. Revise la configuración y haga clic en **Crear GitHub App**. GHES lo redirige de vuelta a Claude con las credenciales de la aplicación almacenadas automáticamente.
  </Step>

  <Step title="Instalar la aplicación en sus repositorios">
    Desde la página de GitHub App en su instancia de GHES, instale la aplicación en los repositorios u organizaciones a los que desea que Claude tenga acceso. Puede comenzar con un subconjunto y agregar más más adelante.
  </Step>

  <Step title="Habilitar características">
    Vuelva a [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) y habilite [Revisión de código](/es/code-review#set-up-code-review), Claude Security y [métricas de contribución](/es/analytics#enable-contribution-metrics) para sus repositorios de GHES usando la misma configuración que github.com.
  </Step>
</Steps>

<h3 id="github-app-permissions">
  Permisos de GitHub App
</h3>

El manifiesto configura la GitHub App con los permisos y eventos de webhook que Claude necesita en sesiones web, Revisión de código, Claude Security y métricas de contribución:

| Permiso          | Acceso              | Usado para                                                 |
| :--------------- | :------------------ | :--------------------------------------------------------- |
| Contents         | Lectura y escritura | Clonar repositorios e insertar ramas                       |
| Pull requests    | Lectura y escritura | Crear PR y publicar comentarios de revisión                |
| Issues           | Lectura y escritura | Responder a menciones de problemas                         |
| Checks           | Lectura y escritura | Publicar ejecuciones de verificación de Revisión de código |
| Actions          | Lectura             | Leer estado de CI para corrección automática               |
| Repository hooks | Lectura y escritura | Recibir webhooks para métricas de contribución             |
| Metadata         | Lectura             | Requerido por GitHub para todas las aplicaciones           |

La aplicación se suscribe a eventos `pull_request`, `issue_comment`, `pull_request_review_comment`, `pull_request_review` y `check_run`.

<h3 id="manual-setup">
  Configuración manual
</h3>

Si el flujo de redirección guiado está bloqueado por su configuración de red, haga clic en **Agregar manualmente** en lugar de Conectar. Cree una GitHub App en su instancia de GHES con los [permisos y eventos anteriores](#github-app-permissions), luego ingrese las credenciales de la aplicación en el formulario: nombre de host, ID de cliente OAuth y secreto, ID de GitHub App, ID de cliente, secreto de cliente, secreto de webhook y clave privada.

<h3 id="network-requirements">
  Requisitos de red
</h3>

Su instancia de GHES debe ser accesible desde la infraestructura de Anthropic para que Claude pueda clonar repositorios y publicar comentarios de revisión. Si su instancia de GHES está detrás de un firewall, agregue a la lista blanca las [direcciones IP de la API de Anthropic](https://platform.claude.com/docs/en/api/ip-addresses).

<h2 id="developer-workflow">
  Flujo de trabajo del desarrollador
</h2>

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:

```bash theme={null}
git clone git@github.example.com:platform/api-service.git
cd api-service
```

Luego inicie una sesión web. 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:

```bash theme={null}
claude --remote "Add retry logic to the payment webhook handler"
```

La sesión se ejecuta en la infraestructura de Anthropic, clona su repositorio desde GHES e inserta cambios en una rama. Monitoree el progreso con `/tasks` o en [claude.ai/code](https://claude.ai/code). Consulte [Claude Code en la web](/es/claude-code-on-the-web) para el flujo de trabajo completo de sesión remota, incluida revisión de diferencias, corrección automática y rutinas.

<h3 id="teleport-sessions-to-your-terminal">
  Sesiones de Teleport a su terminal
</h3>

Extraiga una sesión web 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](/es/claude-code-on-the-web#teleport-requirements) para obtener detalles.

<h2 id="plugin-marketplaces-on-ghes">
  Mercados de plugins en GHES
</h2>

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; la única diferencia es cómo los referencia.

<h3 id="add-a-ghes-marketplace">
  Agregar un mercado de GHES
</h3>

La abreviatura `owner/repo` siempre se resuelve en github.com. Para mercados alojados en GHES, use la URL de git completa:

```bash theme={null}
/plugin marketplace add git@github.example.com:platform/claude-plugins.git
```

Las URLs de HTTPS también funcionan:

```bash theme={null}
/plugin marketplace add https://github.example.com/platform/claude-plugins.git
```

Consulte [Crear y distribuir un mercado de plugins](/es/plugin-marketplaces) para la guía completa sobre cómo construir mercados.

<h3 id="allowlist-ghes-marketplaces-in-managed-settings">
  Agregar mercados de GHES a la lista blanca en configuración administrada
</h3>

Si su organización usa [configuración administrada](/es/settings) 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:

```json theme={null}
{
  "strictKnownMarketplaces": [
    {
      "source": "hostPattern",
      "hostPattern": "^github\\.example\\.com$"
    }
  ]
}
```

También puede preregistrar mercados para los desarrolladores para que aparezcan sin configuración manual. Este ejemplo hace que un mercado de herramientas internas esté disponible en toda la organización:

```json theme={null}
{
  "extraKnownMarketplaces": {
    "internal-tools": {
      "source": {
        "source": "git",
        "url": "git@github.example.com:platform/claude-plugins.git"
      }
    }
  }
}
```

Consulte la referencia de configuración [strictKnownMarketplaces](/es/settings#strictknownmarketplaces) y [extraKnownMarketplaces](/es/settings#extraknownmarketplaces) para el esquema completo.

<h2 id="limitations">
  Limitaciones
</h2>

Algunas características se comportan de manera diferente en GHES que en github.com. La [tabla de características](#what-works-with-github-enterprise-server) resume la compatibilidad; esta sección cubre las soluciones alternativas.

* **Comando `/install-github-app`**: siga el flujo de [configuración del administrador](#admin-setup) 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](https://github.com/anthropics/claude-code-action/blob/main/examples/claude.yml) 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.

<h2 id="troubleshooting">
  Solución de problemas
</h2>

<h3 id="web-session-fails-to-clone-repository">
  La sesión web falla al clonar el repositorio
</h3>

Si `claude --remote` 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.

<h3 id="marketplace-add-fails-with-a-policy-error">
  Agregar mercado falla con un error de política
</h3>

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](#allowlist-ghes-marketplaces-in-managed-settings).

<h3 id="ghes-instance-not-reachable">
  Instancia de GHES no accesible
</h3>

Si las revisiones o sesiones web 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 la API de Anthropic](https://platform.claude.com/docs/es/api/ip-addresses).

<h2 id="related-resources">
  Recursos relacionados
</h2>

Estas páginas cubren las características referenciadas en toda esta guía con más profundidad:

* [Claude Code en la web](/es/claude-code-on-the-web): ejecutar sesiones de Claude Code en infraestructura en la nube
* [Revisión de código](/es/code-review): revisiones automatizadas de PR
* [Mercados de plugins](/es/plugin-marketplaces): construir y distribuir catálogos de plugins
* [Analytics](/es/analytics): rastrear uso y métricas de contribución
* [Configuración administrada](/es/settings): configuración de política en toda la organización
* [Configuración de red](/es/network-config): requisitos de firewall y lista blanca de IP