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.

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 Owner connette la tua istanza GHES, gli sviluppatori possono eseguire sessioni web e ottenere revisioni automatiche del codice senza alcuna configurazione per repository. I marketplace di plugin ospitati sulla tua istanza sono supportati; i requisiti delle credenziali variano in base alla superficie, come descritto in Plugin marketplaces on GHES.

Per i repository su github.com, vedi Claude Code sul web e Code Review. Per eseguire Claude nella tua infrastruttura CI, vedi GitHub Actions.

Cosa funziona con GitHub Enterprise Server

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

Configurazione amministratore

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.

Permessi GitHub App

Il manifesto configura l'app GitHub con i permessi e gli eventi webhook di seguito, che insieme coprono sessioni web, Code Review, Claude Security, marketplace di plugin e metriche di contribuzione:

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

GitHub applica un manifesto solo quando l'app viene creata, quindi un'app creata da una versione precedente del manifesto mantiene i permessi e gli eventi con cui è stata creata. Se la tua app non dispone di alcuno dei permessi o degli eventi di cui sopra, aggiungili nelle impostazioni dell'app sulla tua istanza GHES. GitHub chiede quindi a un proprietario di ogni installazione di approvare i nuovi permessi e l'installazione mantiene i suoi vecchi permessi fino a quando non lo fanno.

Configurazione manuale

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 di cui sopra, quindi inserisci i dettagli della connessione nel modulo: un nome visualizzato, il nome host GHES e la porta facoltativa, e l'ID dell'app, l'ID client, il segreto client, il segreto webhook e la chiave privata. Il modulo accetta anche un certificato CA personalizzato facoltativo e nomi host di replica in lettura.

Claude genera l'URL webhook dell'app quando salvi la connessione. Dopo aver fatto clic su Aggiungi configurazione, apri il menu Altre opzioni della connessione, seleziona Copia URL webhook e incolla l'URL nelle impostazioni webhook dell'app sulla tua istanza GHES. Utilizza lo stesso segreto webhook che hai inserito nel modulo.

Requisiti di rete

Per le sessioni ospitate da Anthropic, 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 in uscita di Anthropic. Le sessioni in un ambiente self-hosted clonano dall'interno della tua rete, a meno che il runner non opti per il proxy git Anthropic, che recupera dal lato di Anthropic e necessita della stessa raggiungibilità; il connettore SCM copre i flussi pre-sessione ospitati, come il selettore di repository, per un host GHES che è instradabile solo internamente.

Flusso di lavoro dello sviluppatore

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, sostituendo github.example.com e il percorso del repository con il tuo nome host GHES e il repository:

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:

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

La sessione clona il tuo repository da GHES e spinge i cambiamenti di nuovo a un branch. Monitora l'avanzamento su claude.ai/code. Vedi Claude Code sul web per il flusso di lavoro completo della sessione cloud inclusa la revisione diff, auto-fix e routine.

Teleport delle sessioni al tuo terminale

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 per i dettagli.

Marketplace di plugin su GHES

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, ma l'installazione funziona diversamente a seconda di dove aggiungi il marketplace, e le credenziali differiscono tra le superfici:

Aggiungi un marketplace GHES

La scorciatoia owner/repo si risolve sempre in github.com. Per i marketplace ospitati su GHES, utilizza l'URL git completo, sostituendo github.example.com e il percorso del repository con i tuoi. Gli URL HTTPS sono consigliati:

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

Gli URL SSH funzionano se la macchina già si fida del tuo host GHES:

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

Claude Code esegue git in modo non interattivo e rifiuta le connessioni SSH agli host che non si trovano nel file known_hosts della macchina. Un URL HTTPS con un git credential helper evita il requisito known_hosts.

Vedi Crea e distribuisci un marketplace di plugin per la guida completa alla creazione di marketplace.

Pre-registra i marketplace GHES con le impostazioni gestite

L'impostazione extraKnownMarketplaces pre-registra un marketplace in modo che gli sviluppatori lo ottengano senza configurazione manuale. Funziona da qualsiasi file di impostazioni, incluso il .claude/settings.json di un repository; le impostazioni gestite lo distribuiscono a livello di organizzazione:

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

Claude Code installa questi marketplace localmente: registra ogni voce e clona il repository con le credenziali git esistenti della macchina. Questo percorso non passa attraverso claude.ai, quindi la connessione GitHub Enterprise per utente non è richiesta. Per un rollout di successo:

• Utilizza un URL git completo. La scorciatoia owner/repo si risolve sempre in github.com e non può fare riferimento a un host GHES.
• Preferisci gli URL HTTPS. I cloni SSH falliscono su macchine che non si fidano già della chiave host GHES. Un URL HTTPS con il git credential helper standard della tua organizzazione funziona su qualsiasi macchina con credenziali configurate.
• Conferma che ogni macchina possa clonare dal tuo host GHES. Se una macchina manca di credenziali, il marketplace viene registrato ma mai installato, e i suoi plugin vengono segnalati come non trovati invece di richiedere credenziali.
• Conferma che l'impostazione raggiunga ogni macchina. Un file di impostazioni gestite ha effetto solo sulle macchine su cui viene distribuito, ad esempio attraverso il tuo sistema di gestione dei dispositivi. Vedi Distribuisci impostazioni gestite per i percorsi dei file.

Inserisci nella whitelist i marketplace GHES nelle impostazioni gestite

Se la tua organizzazione utilizza impostazioni gestite 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. Vedi Meccanismi di distribuzione per i percorsi dei file su ogni piattaforma. Aggiungi il JSON al tuo file managed-settings.json o alla policy MDM equivalente:

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

Vedi il riferimento alle impostazioni strictKnownMarketplaces e extraKnownMarketplaces per lo schema completo.

Limitazioni

Alcune funzionalità si comportano diversamente su GHES rispetto a github.com. La tabella delle funzionalità riassume il supporto; questa sezione copre le soluzioni alternative.

• Comando /install-github-app: segui il flusso di configurazione amministratore su claude.ai. Se desideri anche workflow GitHub Actions su GHES, adatta manualmente il workflow di esempio.
• 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.

Risoluzione dei problemi

La sessione web non riesce a clonare il repository

Se claude --cloud 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.

L'aggiunta del marketplace fallisce con un errore di policy

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.

L'aggiunta del marketplace su claude.ai fallisce con un errore di accesso a GitHub

Se l'aggiunta di un marketplace GHES dalle impostazioni utente fallisce con un errore generico come "Marketplace couldn't be added", controlla prima la tua connessione GitHub Enterprise. Questo è quello che appare quando il tuo account GitHub Enterprise non è connesso a Claude, anche se l'istanza GHES della tua organizzazione è configurata e altri utenti sono connessi. La finestra di dialogo non punta al flusso di connessione di GitHub Enterprise, e l'opzione "Connect to GitHub" nella scheda Browse accede a github.com, che non concede accesso ai repository GHES.

Per connettere il tuo account GitHub Enterprise: il selettore di repository su claude.ai/code offre un'opzione di connessione per ogni istanza GHES configurata, e gli Owner possono anche connettersi dalla sezione GitHub Enterprise delle impostazioni amministratore di Claude Code. Quindi aggiungi di nuovo il marketplace. In alternativa, chiedi a un Owner di aggiungere il marketplace nelle impostazioni del plugin dell'organizzazione, il che rimuove il requisito di connessione per utente.

Su altre superfici di claude.ai, un errore "Repository not found. If it's private, GitHub access is required" su un marketplace GHES di solito indica la stessa connessione mancante. Connetti il tuo account GitHub Enterprise attraverso uno dei percorsi sopra, quindi riprova.

Istanza GHES non raggiungibile

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 in uscita di Anthropic. Le sessioni in un ambiente self-hosted raggiungono GHES dall'interno della tua rete, quindi per loro controlla il percorso di rete del runner stesso e il connettore SCM invece.

L'avvio della sessione fallisce con `Unable to get organization UUID`

Le sessioni web richiedono un'organizzazione Team o Enterprise. Accedi con /login utilizzando il tuo account dell'organizzazione. Se ti autentichi con una chiave API, le sessioni web falliscono prima con un messaggio che ti chiede di eseguire /login.

Risorse correlate

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

• Claude Code sul web: esegui sessioni Claude Code sull'infrastruttura cloud
• Code Review: revisioni automatiche dei PR
• Marketplace di plugin: crea e distribuisci cataloghi di plugin
• Analytics: traccia l'utilizzo e le metriche di contribuzione
• Impostazioni gestite: configurazione della policy a livello di organizzazione
• Configurazione di rete: requisiti di firewall e whitelist IP