Claude Code com GitHub Enterprise Server
Conecte Claude Code à sua instância auto-hospedada do GitHub Enterprise Server para sessões web, revisão de código e marketplaces de plugins.
O suporte ao GitHub Enterprise Server (GHES) permite que sua organização use Claude Code com repositórios hospedados em sua instância GitHub auto-gerenciada em vez de github.com. Depois que um administrador conecta sua instância GHES, os desenvolvedores podem executar sessões web, obter revisões de código automatizadas e instalar plugins de marketplaces internos sem nenhuma configuração por repositório.
Para repositórios em github.com, consulte Claude Code na web e Code Review. Para executar Claude em sua própria infraestrutura de CI, consulte GitHub Actions.
O que funciona com GitHub Enterprise Server
A tabela abaixo mostra quais recursos do Claude Code suportam GHES e quaisquer diferenças do comportamento do github.com.
| Recurso | Suporte GHES | Notas |
|---|---|---|
| Claude Code na web | ✅ Suportado | O administrador conecta a instância GHES uma vez; os desenvolvedores usam claude --remote ou claude.ai/code como de costume |
| Code Review | ✅ Suportado | Mesmas revisões automatizadas de PR que github.com |
| Claude Security | ✅ Suportado | Disponível em beta público para planos Enterprise em claude.ai/security |
| Sessões Teleport | ✅ Suportado | Mova sessões entre web e terminal com --teleport |
| Marketplaces de plugins | ✅ Suportado | Use URLs git completas em vez do atalho owner/repo |
| Métricas de contribuição | ✅ Suportado | Entregues via webhooks para o painel de análise |
| GitHub Actions | ✅ Suportado | Requer configuração manual de workflow; /install-github-app é apenas para github.com |
| Servidor GitHub MCP | ❌ Não suportado | O servidor GitHub MCP não funciona com instâncias GHES |
Configuração do administrador
Um administrador conecta sua instância GHES ao Claude Code uma vez. Depois disso, os desenvolvedores em sua organização podem usar repositórios GHES sem nenhuma configuração adicional. Você precisa de acesso de administrador à sua organização Claude e permissão para criar GitHub Apps em sua instância GHES.
A configuração guiada gera um manifesto de GitHub App e o redireciona para sua instância GHES para criar o app em um clique. Se seu ambiente bloquear o fluxo de redirecionamento, uma configuração manual alternativa está disponível.
Abra as configurações de administrador do Claude Code
Vá para claude.ai/admin-settings/claude-code e encontre a seção GitHub Enterprise Server.
Inicie a configuração guiada
Clique em Connect. Digite um nome de exibição para a conexão e o nome do host GHES, por exemplo github.example.com. Se sua instância GHES usar um certificado auto-assinado ou autoridade de certificação privada, cole o certificado CA no campo opcional.
Crie o GitHub App
Clique em Continue to GitHub Enterprise. Seu navegador redireciona para sua instância GHES com um manifesto de app pré-preenchido. Revise a configuração e clique em Create GitHub App. GHES o redireciona de volta para Claude com as credenciais do app armazenadas automaticamente.
Instale o app em seus repositórios
Na página do GitHub App em sua instância GHES, instale o app nos repositórios ou organizações que você deseja que Claude acesse. Você pode começar com um subconjunto e adicionar mais depois.
Ative os recursos
Retorne a claude.ai/admin-settings/claude-code e ative Code Review, Claude Security e métricas de contribuição para seus repositórios GHES usando a mesma configuração que github.com.
Permissões do GitHub App
O manifesto configura o GitHub App com as permissões e eventos de webhook que Claude precisa em sessões web, Code Review, Claude Security e métricas de contribuição:
| Permissão | Acesso | Usado para |
|---|---|---|
| Contents | Leitura e escrita | Clonagem de repositórios e push de branches |
| Pull requests | Leitura e escrita | Criação de PRs e postagem de comentários de revisão |
| Issues | Leitura e escrita | Resposta a menções de issues |
| Checks | Leitura e escrita | Postagem de execuções de verificação do Code Review |
| Actions | Leitura | Leitura do status de CI para auto-fix |
| Repository hooks | Leitura e escrita | Recebimento de webhooks para métricas de contribuição |
| Metadata | Leitura | Obrigatório pelo GitHub para todos os apps |
O app se inscreve em eventos pull_request, issue_comment, pull_request_review_comment, pull_request_review e check_run.
Configuração manual
Se o fluxo de redirecionamento guiado for bloqueado pela configuração de rede, clique em Add manually em vez de Connect. Crie um GitHub App em sua instância GHES com as permissões e eventos acima, depois insira as credenciais do app no formulário: nome do host, ID do cliente OAuth e segredo, ID do GitHub App, ID do cliente, segredo do cliente, segredo do webhook e chave privada.
Requisitos de rede
Sua instância GHES deve ser acessível a partir da infraestrutura Anthropic para que Claude possa clonar repositórios e postar comentários de revisão. Se sua instância GHES estiver atrás de um firewall, coloque na lista de permissões os endereços IP da API Anthropic.
Fluxo de trabalho do desenvolvedor
Depois que seu administrador conectar a instância GHES, nenhuma configuração do lado do desenvolvedor é necessária. Claude Code detecta automaticamente o nome do host GHES a partir do git remote em seu diretório de trabalho.
Clone um repositório de sua instância GHES como você normalmente faria:
git clone git@github.example.com:platform/api-service.git
cd api-service
Depois inicie uma sessão web. Claude detecta o host GHES a partir de seu git remote e roteia a sessão através da instância configurada de sua organização:
claude --remote "Add retry logic to the payment webhook handler"
A sessão é executada na infraestrutura Anthropic, clona seu repositório do GHES e envia alterações de volta para um branch. Monitore o progresso com /tasks ou em claude.ai/code. Consulte Claude Code na web para o fluxo de trabalho completo de sessão remota, incluindo revisão de diff, auto-fix e rotinas.
Teleporte de sessões para seu terminal
Puxe uma sessão web para seu terminal local com claude --teleport. Teleport verifica se você está em um checkout do mesmo repositório GHES antes de buscar o branch e carregar o histórico da sessão. Consulte requisitos de teleport para detalhes.
Marketplaces de plugins em GHES
Hospede marketplaces de plugins em sua instância GHES para distribuir ferramentas internas em toda sua organização. A estrutura do marketplace é idêntica aos marketplaces hospedados em github.com; a única diferença é como você os referencia.
Adicione um marketplace GHES
O atalho owner/repo sempre resolve para github.com. Para marketplaces hospedados em GHES, use a URL git completa:
/plugin marketplace add git@github.example.com:platform/claude-plugins.git
URLs HTTPS também funcionam:
/plugin marketplace add https://github.example.com/platform/claude-plugins.git
Consulte Criar e distribuir um marketplace de plugins para o guia completo de construção de marketplaces.
Coloque na lista de permissões marketplaces GHES em configurações gerenciadas
Se sua organização usa configurações gerenciadas para restringir quais marketplaces os desenvolvedores podem adicionar, use o tipo de fonte hostPattern para permitir todos os marketplaces de sua instância GHES sem enumerar cada repositório:
{
"strictKnownMarketplaces": [
{
"source": "hostPattern",
"hostPattern": "^github\\.example\\.com$"
}
]
}
Você também pode pré-registrar marketplaces para desenvolvedores para que apareçam sem configuração manual. Este exemplo disponibiliza um marketplace de ferramentas internas em toda a organização:
{
"extraKnownMarketplaces": {
"internal-tools": {
"source": {
"source": "git",
"url": "git@github.example.com:platform/claude-plugins.git"
}
}
}
}
Consulte a referência de configurações strictKnownMarketplaces e extraKnownMarketplaces para o esquema completo.
Limitações
Alguns recursos se comportam de forma diferente em GHES do que em github.com. A tabela de recursos resume o suporte; esta seção cobre as soluções alternativas.
- Comando
/install-github-app: siga o fluxo de configuração do administrador em claude.ai. Se você também deseja workflows do GitHub Actions em GHES, adapte o workflow de exemplo manualmente. - Servidor GitHub MCP: use o CLI
ghconfigurado para seu host GHES. Executegh auth login --hostname github.example.compara autenticar, depois Claude pode usar comandosghem sessões.
Troubleshooting
A sessão web falha ao clonar o repositório
Se claude --remote falhar com um erro de clone, verifique se seu administrador concluiu a configuração para sua instância GHES e se o GitHub App está instalado no repositório em que você está trabalhando. Verifique com seu administrador se o nome do host da instância registrado nas configurações do Claude corresponde ao nome do host em seu git remote.
Falha ao adicionar marketplace com erro de política
Se /plugin marketplace add for bloqueado para sua URL GHES, sua organização restringiu as fontes de marketplace. Peça ao seu administrador para adicionar uma entrada hostPattern para seu nome do host GHES em configurações gerenciadas.
Instância GHES não acessível
Se revisões ou sessões web expirarem, sua instância GHES pode não ser acessível a partir da infraestrutura Anthropic. Confirme se seu firewall permite conexões de entrada dos endereços IP da API Anthropic.
Recursos relacionados
Estas páginas cobrem os recursos referenciados ao longo deste guia com mais profundidade:
- Claude Code na web: execute sessões do Claude Code em infraestrutura em nuvem
- Code Review: revisões automatizadas de PR
- Marketplaces de plugins: construir e distribuir catálogos de plugins
- Analytics: rastrear uso e métricas de contribuição
- Configurações gerenciadas: configuração de política em toda a organização
- Configuração de rede: requisitos de firewall e lista de permissões de IP