> ## Documentation Index > Fetch the complete documentation index at: https://cli.fuxicode.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Fuxi Code con GitHub Enterprise Server > Connetti Fuxi 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 è disponibile per i piani Team ed Enterprise. Il supporto per GitHub Enterprise Server (GHES) consente alla tua organizzazione di utilizzare Fuxi 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](#plugin-marketplaces-on-ghes). Per i repository su github.com, vedi [Fuxi Code sul web](/it/fuxi-code-on-the-web) e [Code Review](/it/code-review). Per eseguire Fuxi nella tua infrastruttura CI, vedi [GitHub Actions](/it/github-actions).

Cosa funziona con GitHub Enterprise Server

La tabella seguente mostra quali funzionalità di Fuxi Code supportano GHES e eventuali differenze dal comportamento di github.com. | Funzionalità | Supporto GHES | Note | | :------------------------ | :--------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------- | | Fuxi Code sul web | ✅ Supportato | Un proprietario connette l'istanza GHES una volta; gli sviluppatori utilizzano `fuxi --cloud` o [fuxi.ai/code](https://fuxi.ai/code) come al solito | | Code Review | ✅ Supportato | Stesse revisioni automatiche dei PR di github.com | | Fuxi Security | ✅ Supportato | Disponibile in beta pubblica per i piani Enterprise su [fuxi.ai/security](https://fuxi.ai/security) | | Sessioni Teleport | ✅ Supportato | Sposta le sessioni tra web e terminale con `--teleport` | | Marketplace di plugin | ✅ Supportato | I requisiti delle credenziali differiscono per superficie. Vedere [Plugin marketplaces on GHES](#plugin-marketplaces-on-ghes) | | 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 |

Configurazione amministratore

Un proprietario connette la tua istanza GHES a Fuxi 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 Fuxi 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). Vai a [fuxi.ai/admin-settings/fuxi-code](https://fuxi.ai/admin-settings/fuxi-code) e trova la sezione GitHub Enterprise Server. 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. 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 Fuxi con le credenziali dell'app archiviate automaticamente. Dalla pagina GitHub App sulla tua istanza GHES, installa l'app sui repository o sulle organizzazioni a cui desideri che Fuxi acceda. Puoi iniziare con un sottoinsieme e aggiungerne altri in seguito. Torna a [fuxi.ai/admin-settings/fuxi-code](https://fuxi.ai/admin-settings/fuxi-code) e abilita [Code Review](/it/code-review#set-up-code-review), Fuxi Security e [metriche di contribuzione](/it/analytics#enable-contribution-metrics) per i tuoi repository GHES utilizzando la stessa configurazione di github.com.

Permessi GitHub App

Il manifesto configura l'app GitHub con i permessi e gli eventi webhook di cui Fuxi ha bisogno per sessioni web, Code Review, Fuxi 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`.

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

Requisiti di rete

La tua istanza GHES deve essere raggiungibile dall'infrastruttura Anthropic in modo che Fuxi 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.fuxi.com/docs/en/api/ip-addresses).

Flusso di lavoro dello sviluppatore

Una volta che il tuo amministratore ha connesso l'istanza GHES, non è necessaria alcuna configurazione lato sviluppatore. Fuxi 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. Fuxi rileva l'host GHES dal tuo git remote e instrada la sessione attraverso la tua istanza configurata dell'organizzazione: ```bash theme={null} fuxi --cloud "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 [fuxi.ai/code](https://fuxi.ai/code). Vedi [Fuxi Code sul web](/it/fuxi-code-on-the-web) per il flusso di lavoro completo della sessione remota inclusa la revisione diff, auto-fix e routine.

Teleport delle sessioni al tuo terminale

Estrai una sessione web nel tuo terminale locale con `fuxi --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/fuxi-code-on-the-web#teleport-requirements) 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: | Superficie | Come funziona l'installazione | Cosa serve a ogni utente | | :--------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Fuxi Code CLI e desktop | Fuxi Code clona il repository del marketplace utilizzando le credenziali git esistenti della macchina | Accesso Git al tuo host GHES dalla loro macchina | | Impostazioni gestite (`extraKnownMarketplaces`) | Fuxi Code registra la voce e clona il repository utilizzando le credenziali git esistenti della macchina | Accesso Git al tuo host GHES dalla loro macchina | | Impostazioni plugin dell'organizzazione su fuxi.ai | Un Owner seleziona l'istanza GHES come fonte; il backend di Anthropic recupera e sincronizza il repository utilizzando la GitHub App da [admin setup](#admin-setup) | Nulla per utente una volta aggiunto. L'Owner che lo aggiunge ha bisogno del proprio account GitHub Enterprise connesso come controllo di accesso, e la GitHub App deve essere installata sul repository del marketplace | | Impostazioni utente su fuxi.ai | Il backend di Anthropic recupera il repository utilizzando la connessione GitHub Enterprise dell'utente che lo invia | Il proprio account GitHub Enterprise connesso a Fuxi | | Fuxi Code sul web | Le sessioni cloud clonano i marketplace all'interno della sandbox della sessione. La sandbox può raggiungere la tua istanza GHES solo quando il repository della sessione si trova su quella stessa istanza, e le sue credenziali git sono limitate ai repository della sessione | Non affidabile per i marketplace ospitati su GHES: un host diverso dal repository della sessione non è raggiungibile, e anche gli install sulla stessa istanza possono fallire. Utilizza invece la CLI, le impostazioni gestite o fuxi.ai | Le connessioni GitHub Enterprise su fuxi.ai sono per utente quando un marketplace viene aggiunto dalle impostazioni utente. La [admin setup](#admin-setup) connette la tua istanza GHES alla tua organizzazione, ma non connette i singoli account utente: ogni utente che aggiunge un marketplace GHES dalle proprie impostazioni deve prima connettere il proprio account GitHub Enterprise, e la connessione di un utente, inclusa quella dell'Owner, non copre nessun altro. I marketplace aggiunti da un Owner nelle impostazioni plugin dell'organizzazione non pongono questo requisito agli utenti, perché i recuperi continui utilizzano la GitHub App dell'organizzazione. L'Owner che aggiunge il marketplace ha comunque bisogno del proprio account GitHub Enterprise connesso al momento dell'aggiunta.

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. Gli URL HTTPS sono consigliati: ```bash theme={null} /plugin marketplace add https://github.example.com/platform/fuxi-plugins.git ``` Gli URL SSH funzionano se la macchina già si fida del tuo host GHES: ```bash theme={null} /plugin marketplace add git@github.example.com:platform/fuxi-plugins.git ``` Fuxi 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](/it/plugin-marketplaces) 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](/it/settings#extraknownmarketplaces), incluso il `.fuxi/settings.json` di un repository; le impostazioni gestite lo distribuiscono a livello di organizzazione: ```json theme={null} { "extraKnownMarketplaces": { "internal-tools": { "source": { "source": "git", "url": "https://github.example.com/platform/fuxi-plugins.git" } } } } ``` Fuxi Code installa questi marketplace localmente: registra ogni voce e clona il repository con le credenziali git esistenti della macchina. Questo percorso non passa attraverso fuxi.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 [impostazioni gestite](/it/settings#settings-files) per i percorsi dei file.

Inserisci nella whitelist i marketplace GHES nelle impostazioni gestite

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$" } ] } ``` Vedi il riferimento alle impostazioni [strictKnownMarketplaces](/it/settings#strictknownmarketplaces) e [extraKnownMarketplaces](/it/settings#extraknownmarketplaces) per lo schema completo.

Limitazioni

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 fuxi.ai. Se desideri anche workflow GitHub Actions su GHES, adatta manualmente il [workflow di esempio](https://github.com/anthropics/fuxi-code-action/blob/main/examples/fuxi.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 Fuxi può utilizzare i comandi `gh` nelle sessioni.

Risoluzione dei problemi

La sessione web non riesce a clonare il repository

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

L'aggiunta del marketplace su fuxi.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 Fuxi, 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 [fuxi.ai/code](https://fuxi.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 Fuxi Code](https://fuxi.ai/admin-settings/fuxi-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 fuxi.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 dell'API Anthropic](https://platform.fuxi.com/docs/it/api/ip-addresses). Queste pagine coprono le funzionalità referenziate in questa guida in maggior dettaglio: * [Fuxi Code sul web](/it/fuxi-code-on-the-web): esegui sessioni Fuxi 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