> ## 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

> Connetti Claude Code alla tua istanza GitHub Enterprise Server auto-ospitata per sessioni web, revisione del codice e marketplace di plugin.

<Note>
  Il supporto per GitHub Enterprise Server è disponibile per i piani Team ed Enterprise.
</Note>

Il supporto per GitHub Enterprise Server (GHES) consente alla tua organizzazione di utilizzare Claude Code con repository ospitati sulla tua istanza GitHub auto-gestita invece di github.com. Una volta che un amministratore connette la tua istanza GHES, gli sviluppatori possono eseguire sessioni web, ottenere revisioni automatiche del codice e installare plugin da marketplace interni senza alcuna configurazione per repository.

Per i repository su github.com, vedi [Claude Code sul web](/it/claude-code-on-the-web) e [Code Review](/it/code-review). Per eseguire Claude nella tua infrastruttura CI, vedi [GitHub Actions](/it/github-actions).

<h2 id="what-works-with-github-enterprise-server">
  Cosa funziona con GitHub Enterprise Server
</h2>

La tabella seguente mostra quali funzionalità di Claude Code supportano GHES e eventuali differenze dal comportamento di github.com.

| Funzionalità              | Supporto GHES    | Note                                                                                                                                                       |
| :------------------------ | :--------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Claude Code sul web       | ✅ Supportato     | Un proprietario connette l'istanza GHES una volta; gli sviluppatori utilizzano `claude --remote` o [claude.ai/code](https://claude.ai/code) come al solito |
| Code Review               | ✅ Supportato     | Stesse revisioni automatiche dei PR di github.com                                                                                                          |
| Claude Security           | ✅ Supportato     | Disponibile in beta pubblica per i piani Enterprise su [claude.ai/security](https://claude.ai/security)                                                    |
| Sessioni Teleport         | ✅ Supportato     | Sposta le sessioni tra web e terminale con `--teleport`                                                                                                    |
| Marketplace di plugin     | ✅ Supportato     | Utilizza URL git completi invece della scorciatoia `owner/repo`                                                                                            |
| Metriche di contribuzione | ✅ Supportato     | Consegnate tramite webhook al [dashboard di analisi](/it/analytics)                                                                                        |
| GitHub Actions            | ✅ Supportato     | Richiede configurazione manuale del workflow; `/install-github-app` è solo per github.com                                                                  |
| Server GitHub MCP         | ❌ Non supportato | Il server GitHub MCP non funziona con istanze GHES                                                                                                         |

<h2 id="admin-setup">
  Configurazione amministratore
</h2>

Un proprietario connette la tua istanza GHES a Claude Code una volta. Dopo di che, gli sviluppatori della tua organizzazione possono utilizzare i repository GHES senza alcuna configurazione aggiuntiva. Hai bisogno del ruolo Proprietario o Proprietario principale nella tua organizzazione Claude e del permesso di creare GitHub App sulla tua istanza GHES.

La configurazione guidata genera un manifesto GitHub App e ti reindirizza alla tua istanza GHES per creare l'app in un clic. Se il tuo ambiente blocca il flusso di reindirizzamento, è disponibile una [configurazione manuale alternativa](#manual-setup).

<Steps>
  <Step title="Apri le impostazioni amministratore di Claude Code">
    Vai a [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) e trova la sezione GitHub Enterprise Server.
  </Step>

  <Step title="Avvia la configurazione guidata">
    Fai clic su **Connetti**. Inserisci un nome visualizzato per la connessione e il nome host GHES, ad esempio `github.example.com`. Se la tua istanza GHES utilizza un certificato autofirmato o un'autorità di certificazione privata, incolla il certificato CA nel campo facoltativo.
  </Step>

  <Step title="Crea l'app GitHub">
    Fai clic su **Continua verso GitHub Enterprise**. Il tuo browser si reindirizza alla tua istanza GHES con un manifesto app pre-compilato. Rivedi la configurazione e fai clic su **Crea GitHub App**. GHES ti reindirizza di nuovo a Claude con le credenziali dell'app archiviate automaticamente.
  </Step>

  <Step title="Installa l'app sui tuoi repository">
    Dalla pagina GitHub App sulla tua istanza GHES, installa l'app sui repository o sulle organizzazioni a cui desideri che Claude acceda. Puoi iniziare con un sottoinsieme e aggiungerne altri in seguito.
  </Step>

  <Step title="Abilita le funzionalità">
    Torna a [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) e abilita [Code Review](/it/code-review#set-up-code-review), Claude Security e [metriche di contribuzione](/it/analytics#enable-contribution-metrics) per i tuoi repository GHES utilizzando la stessa configurazione di github.com.
  </Step>
</Steps>

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

Il manifesto configura l'app GitHub con i permessi e gli eventi webhook di cui Claude ha bisogno per sessioni web, Code Review, Claude Security e metriche di contribuzione:

| Permesso         | Accesso             | Utilizzato per                                           |
| :--------------- | :------------------ | :------------------------------------------------------- |
| Contents         | Lettura e scrittura | Clonazione di repository e push di branch                |
| Pull requests    | Lettura e scrittura | Creazione di PR e pubblicazione di commenti di revisione |
| Issues           | Lettura e scrittura | Risposta a menzioni di problemi                          |
| Checks           | Lettura e scrittura | Pubblicazione di esecuzioni di controllo Code Review     |
| Actions          | Lettura             | Lettura dello stato CI per auto-fix                      |
| Repository hooks | Lettura e scrittura | Ricezione di webhook per metriche di contribuzione       |
| Metadata         | Lettura             | Richiesto da GitHub per tutte le app                     |

L'app si iscrive agli eventi `pull_request`, `issue_comment`, `pull_request_review_comment`, `pull_request_review` e `check_run`.

<h3 id="manual-setup">
  Configurazione manuale
</h3>

Se il flusso di reindirizzamento guidato è bloccato dalla configurazione di rete, fai clic su **Aggiungi manualmente** invece di Connetti. Crea un'app GitHub sulla tua istanza GHES con i [permessi e gli eventi sopra](#github-app-permissions), quindi inserisci le credenziali dell'app nel modulo: nome host, ID client OAuth e segreto, ID app GitHub, ID client, segreto client, segreto webhook e chiave privata.

<h3 id="network-requirements">
  Requisiti di rete
</h3>

La tua istanza GHES deve essere raggiungibile dall'infrastruttura Anthropic in modo che Claude possa clonare repository e pubblicare commenti di revisione. Se la tua istanza GHES è dietro un firewall, inserisci nella whitelist gli [indirizzi IP dell'API Anthropic](https://platform.claude.com/docs/en/api/ip-addresses).

<h2 id="developer-workflow">
  Flusso di lavoro dello sviluppatore
</h2>

Una volta che il tuo amministratore ha connesso l'istanza GHES, non è necessaria alcuna configurazione lato sviluppatore. Claude Code rileva automaticamente il nome host GHES dal git remote nella tua directory di lavoro.

Clona un repository dalla tua istanza GHES come faresti normalmente:

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

Quindi avvia una sessione web. Claude rileva l'host GHES dal tuo git remote e instrada la sessione attraverso la tua istanza configurata dell'organizzazione:

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

La sessione viene eseguita sull'infrastruttura Anthropic, clona il tuo repository da GHES e spinge i cambiamenti di nuovo a un branch. Monitora l'avanzamento con `/tasks` o su [claude.ai/code](https://claude.ai/code). Vedi [Claude Code sul web](/it/claude-code-on-the-web) per il flusso di lavoro completo della sessione remota inclusa la revisione diff, auto-fix e routine.

<h3 id="teleport-sessions-to-your-terminal">
  Teleport delle sessioni al tuo terminale
</h3>

Estrai una sessione web nel tuo terminale locale con `claude --teleport`. Teleport verifica che tu sia in un checkout dello stesso repository GHES prima di recuperare il branch e caricare la cronologia della sessione. Vedi [requisiti di teleport](/it/claude-code-on-the-web#teleport-requirements) per i dettagli.

<h2 id="plugin-marketplaces-on-ghes">
  Marketplace di plugin su GHES
</h2>

Ospita marketplace di plugin sulla tua istanza GHES per distribuire strumenti interni in tutta la tua organizzazione. La struttura del marketplace è identica ai marketplace ospitati su github.com; l'unica differenza è il modo in cui li referenzi.

<h3 id="add-a-ghes-marketplace">
  Aggiungi un marketplace GHES
</h3>

La scorciatoia `owner/repo` si risolve sempre in github.com. Per i marketplace ospitati su GHES, utilizza l'URL git completo:

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

Funzionano anche gli URL HTTPS:

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

Vedi [Crea e distribuisci un marketplace di plugin](/it/plugin-marketplaces) per la guida completa alla creazione di marketplace.

<h3 id="allowlist-ghes-marketplaces-in-managed-settings">
  Inserisci nella whitelist i marketplace GHES nelle impostazioni gestite
</h3>

Se la tua organizzazione utilizza [impostazioni gestite](/it/settings) per limitare quali marketplace gli sviluppatori possono aggiungere, utilizza il tipo di origine `hostPattern` per consentire tutti i marketplace dalla tua istanza GHES senza enumerare ogni repository:

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

Puoi anche pre-registrare i marketplace per gli sviluppatori in modo che appaiano senza configurazione manuale. Questo esempio rende disponibile un marketplace di strumenti interni a livello di organizzazione:

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

Vedi il riferimento alle impostazioni [strictKnownMarketplaces](/it/settings#strictknownmarketplaces) e [extraKnownMarketplaces](/it/settings#extraknownmarketplaces) per lo schema completo.

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

Alcune funzionalità si comportano diversamente su GHES rispetto a github.com. La [tabella delle funzionalità](#what-works-with-github-enterprise-server) riassume il supporto; questa sezione copre le soluzioni alternative.

* **Comando `/install-github-app`**: segui il flusso di [configurazione amministratore](#admin-setup) su claude.ai. Se desideri anche workflow GitHub Actions su GHES, adatta manualmente il [workflow di esempio](https://github.com/anthropics/claude-code-action/blob/main/examples/claude.yml).
* **Server GitHub MCP**: utilizza invece la CLI `gh` configurata per il tuo host GHES. Esegui `gh auth login --hostname github.example.com` per autenticarti, quindi Claude può utilizzare i comandi `gh` nelle sessioni.

<h2 id="troubleshooting">
  Risoluzione dei problemi
</h2>

<h3 id="web-session-fails-to-clone-repository">
  La sessione web non riesce a clonare il repository
</h3>

Se `claude --remote` fallisce con un errore di clone, verifica che un Owner abbia completato la configurazione per la tua istanza GHES e che l'app GitHub sia installata sul repository su cui stai lavorando. Chiedi all'Owner che ha connesso l'istanza di confermare che il nome host registrato nelle impostazioni di Claude corrisponda al nome host nel tuo git remote.

<h3 id="marketplace-add-fails-with-a-policy-error">
  L'aggiunta del marketplace fallisce con un errore di policy
</h3>

Se `/plugin marketplace add` è bloccato per il tuo URL GHES, la tua organizzazione ha limitato le origini del marketplace. Chiedi al tuo amministratore di aggiungere una voce `hostPattern` per il nome host GHES nelle [impostazioni gestite](#allowlist-ghes-marketplaces-in-managed-settings).

<h3 id="ghes-instance-not-reachable">
  Istanza GHES non raggiungibile
</h3>

Se le revisioni o le sessioni web si esauriscono, la tua istanza GHES potrebbe non essere raggiungibile dall'infrastruttura Anthropic. Conferma che il tuo firewall consente connessioni in entrata dagli [indirizzi IP dell'API Anthropic](https://platform.claude.com/docs/it/api/ip-addresses).

<h2 id="related-resources">
  Risorse correlate
</h2>

Queste pagine coprono le funzionalità referenziate in questa guida in maggior dettaglio:

* [Claude Code sul web](/it/claude-code-on-the-web): esegui sessioni Claude Code sull'infrastruttura cloud
* [Code Review](/it/code-review): revisioni automatiche dei PR
* [Marketplace di plugin](/it/plugin-marketplaces): crea e distribuisci cataloghi di plugin
* [Analytics](/it/analytics): traccia l'utilizzo e le metriche di contribuzione
* [Impostazioni gestite](/it/settings): configurazione della policy a livello di organizzazione
* [Configurazione di rete](/it/network-config): requisiti di firewall e whitelist IP