Per ulteriori informazioni sull'abilitazione di GitHub nel tuo account, consulta Usa i connettori per estendere le capacità di Claude.
Connetti i tuoi repository GitHub direttamente a Claude per fornire un contesto completo per i tuoi compiti di sviluppo software. Puoi facilmente aggiungere repository selezionandoli da un elenco, aiutando Claude a comprendere meglio e assistere il tuo codebase.
Come aggiungere repository GitHub
Nota: Se non sei attualmente autenticato con GitHub, verrai reindirizzato a GitHub per autenticarti prima di poter utilizzare questa integrazione.
Chat
Fai clic sul pulsante "+" nell'angolo inferiore sinistro dell'interfaccia della chat.
Seleziona "Aggiungi da GitHub" dal menu a discesa.
Usa il browser dei file per selezionare file e cartelle specifici.
Quando invii il tuo messaggio, Claude accederà ed elaborerà il contenuto per informare la sua risposta.
Progetti
Fai clic sul pulsante "+" nell'angolo superiore destro della sezione di conoscenza del tuo progetto.
Seleziona "GitHub" dal menu a discesa.
Cerca nei tuoi repository accessibili o incolla un URL del repository.
Usa il browser dei file per selezionare file e cartelle specifici.
Il contenuto selezionato verrà aggiunto alla conoscenza del progetto affinché Claude possa accedervi ed elaborarlo.
Puoi utilizzare l'icona "Sincronizza" per assicurarti di lavorare con la versione più aggiornata del tuo codebase.
Puoi utilizzare l'icona "Configura file" per modificare quali file e cartelle Claude analizza.
Connettiti a repository privati
Se Claude non riesce ad accedere a un repository dopo aver inserito un URL valido, molto probabilmente significa che stai tentando di connettere Claude a un repository privato: Segui il link alla nostra app GitHub, dove puoi concedere l'accesso ai repository se sei un amministratore di GitHub, o invia una richiesta agli amministratori della tua organizzazione GitHub.
Concedi l'accesso tu stesso se puoi: Puoi scegliere tra consentire a Claude di accedere a tutti i repository o a quelli specifici.
Richiedi l'accesso se non disponi delle autorizzazioni necessarie: Gli amministratori della tua organizzazione GitHub riceveranno una notifica email sulla tua richiesta. Una volta approvata la richiesta, potrai sincronizzare e accedere al repository in Claude.
Migliori pratiche
Inizia in piccolo: Inizia selezionando un piccolo sottoinsieme del tuo codebase da analizzare. Questo ti aiuterà a familiarizzare con il modo in cui Claude interpreta e discute il tuo codice.
Itera e perfeziona: Se la risposta iniziale di Claude non affronta completamente la tua domanda, non esitare a porre domande di follow-up o richiedere chiarimenti.
Combina con l'expertise umana: Usa gli insight di Claude come punto di partenza per ulteriori indagini e discussioni con il tuo team. Si prega di rivedere il lavoro di Claude.
Selezione file consapevole: Quando utilizzi "Configura file," sii strategico nelle tue selezioni. Includi i file e le directory chiave che sono centrali al tuo compito o progetto attuale, ma evita di selezionare file non necessari per rimanere entro i limiti di token e mantenere la concentrazione.
Aggiornamenti regolari: Ricorda di aggiornare periodicamente la sincronizzazione GitHub del tuo progetto per assicurarti che Claude stia lavorando con la versione più aggiornata del tuo codebase e soprattutto prima di iniziare una nuova analisi o quando sai che ci sono stati cambiamenti significativi al tuo repository.
Risoluzione dei problemi
I repository di un'organizzazione non vengono visualizzati dopo la connessione
Se la tua connessione GitHub viene visualizzata come connessa ma i repository privati di un'organizzazione specifica non vengono visualizzati, tale organizzazione potrebbe richiedere l'accesso singolo (SSO). Quando SSO è richiesto, ogni utente deve autorizzare separatamente l'app Claude per tale organizzazione. Finché non lo fai, GitHub filtra i repository privati di tale organizzazione dalla tua vista, anche se la tua connessione funziona altrimenti.
Quando Claude rileva questo stato, il selettore di repository mostra un banner che ti richiede di autorizzare SSO. Per autorizzare l'app Claude per la tua organizzazione:
Vai a github.com/settings/applications e apri la voce Claude.
In Accesso organizzazione, fai clic su "Concedi" accanto all'organizzazione GitHub pertinente.
Se il pulsante dice "Richiedi" invece di "Concedi," non hai il permesso di autorizzare l'app tu stesso. Un amministratore dell'organizzazione GitHub deve approvare la tua richiesta dalle impostazioni della politica dell'applicazione OAuth dell'organizzazione.
Importante: Disconnettere e riconnettere GitHub nelle impostazioni di Claude non risolverà questo problema. Una nuova connessione non autorizza automaticamente le organizzazioni che richiedono SSO, quindi dovrai completare i passaggi di autorizzazione di cui sopra.
Se la tua organizzazione utilizza GitHub Enterprise Cloud con Enterprise Managed Users (EMU), l'app Claude deve essere approvata anche a livello aziendale. Scopri di più in Configura Code Review per Claude Code.
Domande frequenti
Quali informazioni vengono recuperate da GitHub?
Solo i file (nomi e contenuti) in un repository su un ramo specifico vengono sincronizzati. Non recuperiamo la cronologia dei commit, i PR o altri metadati.
Cosa succede se il mio repository viene aggiornato dopo averlo aggiunto a un progetto?
Puoi fare clic su "Sincronizza ora" per recuperare gli ultimi cambiamenti dal tuo repository. Questo aggiornerà tutti i file e le cartelle precedentemente selezionati.
Posso aggiungere più repository a un singolo progetto o chat?
Sì, puoi aggiungere più repository per fornire a Claude un contesto completo per i tuoi compiti di sviluppo. I repository devono rientrare nella finestra di contesto di Claude.
Cosa succede se perdo l'accesso a un repository?
Se perdi l'accesso a un repository, non potrai visualizzare i suoi contenuti nei progetti in cui era stato precedentemente aggiunto. L'anteprima del repository verrà rimossa, anche se la cronologia della conversazione verrà mantenuta.
Sfoglia tutti i connettori disponibili nella Directory dei connettori.