Para mais informações sobre como ativar o GitHub em sua conta, consulte Use conectores para estender os recursos do Claude.
Conecte seus repositórios do GitHub diretamente ao Claude para fornecer contexto abrangente para suas tarefas de desenvolvimento de software. Você pode adicionar facilmente repositórios selecionando-os de uma lista, ajudando o Claude a entender melhor e assistir com sua base de código.
Como adicionar repositórios do GitHub
Nota: Se você não estiver autenticado no GitHub, será redirecionado para o GitHub para se autenticar antes de poder usar esta integração.
Chats
Clique no botão "+" no canto inferior esquerdo da interface de chat.
Selecione "Adicionar do GitHub" no menu suspenso.
Use o navegador de arquivos para selecionar arquivos e pastas específicos.
Quando você enviar sua mensagem, o Claude acessará e processará o conteúdo para informar sua resposta.
Projetos
Clique no botão "+" no canto superior direito da seção de conhecimento do seu projeto.
Selecione "GitHub" no menu suspenso.
Pesquise seus repositórios acessíveis ou cole uma URL de repositório.
Use o navegador de arquivos para selecionar arquivos e pastas específicos.
Seu conteúdo selecionado será adicionado ao conhecimento do projeto para o Claude acessar e processar.
Você pode usar o ícone "Sincronizar" para garantir que está trabalhando com a versão mais atualizada de sua base de código.
Você pode usar o ícone "Configurar arquivos" para modificar quais arquivos e pastas o Claude analisa.
Conectar a repositórios privados
Se o Claude não conseguir acessar um repositório após você inserir uma URL válida, provavelmente significa que você está tentando conectar o Claude a um repositório privado: Siga o link para nosso GitHub App, onde você pode conceder acesso aos repositórios se for um administrador do GitHub, ou envie uma solicitação aos administradores da sua organização do GitHub.
Conceda acesso você mesmo se puder: Você pode escolher entre permitir que o Claude acesse todos os repositórios ou apenas repositórios específicos.
Solicite acesso se você não tiver as permissões necessárias: Os administradores da sua organização do GitHub receberão uma notificação por email sobre sua solicitação. Depois que aprovarem a solicitação, você poderá sincronizar e acessar o repositório no Claude.
Melhores práticas
Comece pequeno: Comece selecionando um pequeno subconjunto de sua base de código para analisar. Isso ajudará você a se familiarizar com a forma como o Claude interpreta e discute seu código.
Itere e refine: Se a resposta inicial do Claude não abordar completamente sua pergunta, não hesite em fazer perguntas de acompanhamento ou solicitar esclarecimentos.
Combine com expertise humana: Use os insights do Claude como ponto de partida para investigação e discussão adicional com sua equipe. Por favor, revise o trabalho do Claude.
Seleção cuidadosa de arquivos: Ao usar "Configurar arquivos", seja estratégico em suas seleções. Inclua arquivos e diretórios-chave que sejam centrais para sua tarefa ou projeto atual, mas evite selecionar arquivos desnecessários para manter dentro dos limites de token e manter o foco.
Atualizações regulares: Lembre-se de atualizar periodicamente a sincronização do GitHub do seu projeto para garantir que o Claude esteja trabalhando com a versão mais atualizada de sua base de código e especialmente antes de iniciar uma nova análise ou quando você souber que houve mudanças significativas em seu repositório.
Solução de problemas
Repositórios de uma organização não aparecem após a conexão
Se sua conexão do GitHub aparecer como conectada, mas repositórios privados de uma organização específica não aparecerem, essa organização pode exigir logon único (SSO). Quando o SSO é necessário, cada usuário deve autorizar separadamente o aplicativo Claude para essa organização. Até que você faça isso, o GitHub filtra os repositórios privados dessa organização de sua visualização, mesmo que sua conexão esteja funcionando corretamente.
Quando o Claude detecta esse estado, o seletor de repositório mostra um banner solicitando que você autorize o SSO. Para autorizar o aplicativo Claude para sua organização:
Vá para github.com/settings/applications e abra a entrada Claude.
Em Acesso da organização, clique em "Conceder" ao lado da organização do GitHub relevante.
Se o botão disser "Solicitar" em vez de "Conceder", você não tem permissão para autorizar o aplicativo você mesmo. Um administrador da organização do GitHub deve aprovar sua solicitação nas configurações de política de aplicativo OAuth da organização.
Importante: Desconectar e reconectar o GitHub nas configurações do Claude não resolverá isso. Uma conexão nova não autoriza automaticamente organizações que exigem SSO, portanto você precisará concluir as etapas de autorização acima.
Se sua organização usa GitHub Enterprise Cloud com Enterprise Managed Users (EMU), o aplicativo Claude também deve ser aprovado no nível da empresa. Saiba mais em Configurar revisão de código para Claude Code.
Perguntas frequentes
Quais informações são recuperadas do GitHub?
Apenas arquivos (nomes e conteúdos) em um repositório em um branch específico são sincronizados. Não recuperamos histórico de commits, PRs ou outros metadados.
O que acontece se meu repositório for atualizado após adicioná-lo a um projeto?
Você pode clicar em "Sincronizar agora" para buscar as alterações mais recentes do seu repositório. Isso atualizará todos os arquivos e pastas selecionados anteriormente.
Posso adicionar vários repositórios a um único projeto ou chat?
Sim, você pode adicionar vários repositórios para fornecer ao Claude contexto abrangente para suas tarefas de desenvolvimento. Os repositórios devem caber na janela de contexto do Claude.
O que acontece se eu perder acesso a um repositório?
Se você perder acesso a um repositório, não poderá visualizar seu conteúdo em projetos onde foi adicionado anteriormente. A visualização do repositório será removida, embora o histórico de conversas seja mantido.
Procure todos os conectores disponíveis no Diretório de Conectores.