> ## 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 com GitHub Enterprise Server
> Conecte Fuxi 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 está disponível para planos Team e Enterprise.
O suporte ao GitHub Enterprise Server (GHES) permite que sua organização use Fuxi Code com repositórios hospedados em sua instância GitHub auto-gerenciada em vez de github.com. Depois que um Proprietário conecta sua instância GHES, os desenvolvedores podem executar sessões web e obter revisões de código automatizadas sem nenhuma configuração por repositório. Os marketplaces de plugins hospedados em sua instância também são suportados; os requisitos de credenciais variam por superfície, conforme descrito em [Plugin marketplaces on GHES](#plugin-marketplaces-on-ghes).
Para repositórios em github.com, consulte [Fuxi Code na web](/pt/fuxi-code-on-the-web) e [Code Review](/pt/code-review). Para executar Fuxi em sua própria infraestrutura de CI, consulte [GitHub Actions](/pt/github-actions).
O que funciona com GitHub Enterprise Server
A tabela abaixo mostra quais recursos do Fuxi Code suportam GHES e quaisquer diferenças do comportamento do github.com.
| Recurso | Suporte GHES | Notas |
| :----------------------- | :-------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Fuxi Code na web | ✅ Suportado | Um proprietário conecta a instância GHES uma vez; os desenvolvedores usam `fuxi --cloud` ou [fuxi.ai/code](https://fuxi.ai/code) como de costume |
| Code Review | ✅ Suportado | Mesmas revisões automatizadas de PR que github.com |
| Fuxi Security | ✅ Suportado | Disponível em beta público para planos Enterprise em [fuxi.ai/security](https://fuxi.ai/security) |
| Sessões Teleport | ✅ Suportado | Mova sessões entre web e terminal com `--teleport` |
| Marketplaces de plugins | ✅ Suportado | Os requisitos de credenciais diferem por superfície. Veja [Plugin marketplaces on GHES](#plugin-marketplaces-on-ghes) |
| Métricas de contribuição | ✅ Suportado | Entregues via webhooks para o [painel de análise](/pt/analytics) |
| 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 Proprietário conecta sua instância GHES ao Fuxi Code uma vez. Depois disso, os desenvolvedores em sua organização podem usar repositórios GHES sem nenhuma configuração adicional. Você precisa da função Proprietário ou Proprietário Primário em sua organização Fuxi 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](#manual-setup) está disponível.
Vá para [fuxi.ai/admin-settings/fuxi-code](https://fuxi.ai/admin-settings/fuxi-code) e encontre a seção GitHub Enterprise Server.
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.
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 Fuxi com as credenciais do app armazenadas automaticamente.
Na página do GitHub App em sua instância GHES, instale o app nos repositórios ou organizações que você deseja que Fuxi acesse. Você pode começar com um subconjunto e adicionar mais depois.
Retorne a [fuxi.ai/admin-settings/fuxi-code](https://fuxi.ai/admin-settings/fuxi-code) e ative [Code Review](/pt/code-review#set-up-code-review), Fuxi Security e [métricas de contribuição](/pt/analytics#enable-contribution-metrics) 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 Fuxi precisa em sessões web, Code Review, Fuxi 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](#github-app-permissions), 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 Fuxi 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](https://platform.fuxi.com/docs/en/api/ip-addresses).
Fluxo de trabalho do desenvolvedor
Depois que um Proprietário conectar a instância GHES, nenhuma configuração do lado do desenvolvedor é necessária. Fuxi 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:
```bash theme={null}
git clone git@github.example.com:platform/api-service.git
cd api-service
```
Depois inicie uma sessão web. Fuxi 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:
```bash theme={null}
fuxi --cloud "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 [fuxi.ai/code](https://fuxi.ai/code). Consulte [Fuxi Code na web](/pt/fuxi-code-on-the-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 `fuxi --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](/pt/fuxi-code-on-the-web#teleport-requirements) 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, mas a instalação funciona de forma diferente dependendo de onde você adiciona o marketplace, e as credenciais diferem entre as superfícies:
| Superfície | Como a instalação funciona | O que cada usuário precisa |
| :--------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Fuxi Code CLI e desktop | Fuxi Code clona o repositório do marketplace usando as credenciais git existentes da máquina | Acesso Git ao seu host GHES a partir de sua máquina |
| Configurações gerenciadas (`extraKnownMarketplaces`) | Fuxi Code registra a entrada e clona o repositório usando as credenciais git existentes da máquina | Acesso Git ao seu host GHES a partir de sua máquina |
| Configurações de plugin da organização fuxi.ai | Um Proprietário seleciona a instância GHES como a fonte; o backend da Anthropic busca e sincroniza o repositório usando o GitHub App de [configuração de administrador](#admin-setup) | Nada por usuário uma vez adicionado. O Proprietário que o adiciona precisa de sua própria conta GitHub Enterprise conectada como uma verificação de acesso, e o GitHub App deve estar instalado no repositório do marketplace |
| Configurações de usuário fuxi.ai | O backend da Anthropic busca o repositório usando a conexão GitHub Enterprise do usuário que o envia | Sua própria conta GitHub Enterprise conectada ao Fuxi |
| Fuxi Code na web | As sessões em nuvem clonam marketplaces dentro da sandbox da sessão. A sandbox pode alcançar sua instância GHES apenas quando o repositório da sessão está nessa mesma instância, e suas credenciais git estão limitadas aos repositórios da sessão | Não é confiável para marketplaces hospedados em GHES: um host diferente do repositório da sessão não é alcançável, e até mesmo instalações na mesma instância podem falhar. Use a CLI, configurações gerenciadas ou fuxi.ai em vez disso |
As conexões GitHub Enterprise em fuxi.ai são por usuário quando um marketplace é adicionado a partir das configurações de usuário. A [configuração de administrador](#admin-setup) conecta sua instância GHES à sua organização, mas não conecta contas de usuários individuais: cada usuário que adiciona um marketplace GHES a partir de suas próprias configurações deve primeiro conectar sua própria conta GitHub Enterprise, e a conexão de um usuário, incluindo a do Proprietário, não cobre ninguém mais. Os marketplaces adicionados por um Proprietário nas configurações de plugin da organização não colocam esse requisito nos usuários, porque as buscas contínuas usam o GitHub App da organização. O Proprietário que adiciona o marketplace ainda precisa de sua própria conta GitHub Enterprise conectada no momento da adição.
Adicione um marketplace GHES
O atalho `owner/repo` sempre resolve para github.com. Para marketplaces hospedados em GHES, use a URL git completa. URLs HTTPS são recomendadas:
```bash theme={null}
/plugin marketplace add https://github.example.com/platform/fuxi-plugins.git
```
URLs SSH funcionam se a máquina já confia em seu host GHES:
```bash theme={null}
/plugin marketplace add git@github.example.com:platform/fuxi-plugins.git
```
Fuxi Code executa git de forma não interativa e rejeita conexões SSH para hosts que não estão no arquivo `known_hosts` da máquina. Uma URL HTTPS com um auxiliar de credenciais git evita o requisito `known_hosts`.
Consulte [Criar e distribuir um marketplace de plugins](/pt/plugin-marketplaces) para o guia completo de construção de marketplaces.
Pré-registre marketplaces GHES com configurações gerenciadas
A configuração `extraKnownMarketplaces` pré-registra um marketplace para que os desenvolvedores o obtenham sem configuração manual. Funciona a partir de [qualquer arquivo de configurações](/pt/settings#extraknownmarketplaces), incluindo `.fuxi/settings.json` de um repositório; as configurações gerenciadas a entregam em toda a organização:
```json theme={null}
{
"extraKnownMarketplaces": {
"internal-tools": {
"source": {
"source": "git",
"url": "https://github.example.com/platform/fuxi-plugins.git"
}
}
}
}
```
Fuxi Code instala esses marketplaces localmente: registra cada entrada e clona o repositório com as credenciais git existentes da máquina. Este caminho não passa por fuxi.ai, portanto a conexão GitHub Enterprise por usuário não é necessária. Para um lançamento bem-sucedido:
* **Use uma URL git completa.** O atalho `owner/repo` sempre resolve para github.com e não pode referenciar um host GHES.
* **Prefira URLs HTTPS.** Clones SSH falham em máquinas que ainda não confiam na chave do host GHES. Uma URL HTTPS com o auxiliar de credenciais git padrão de sua organização funciona em qualquer máquina com credenciais configuradas.
* **Confirme que cada máquina pode clonar a partir de seu host GHES.** Se uma máquina não tiver credenciais, o marketplace é registrado mas nunca instalado, e seus plugins são relatados como não encontrados em vez de solicitar credenciais.
* **Confirme que a configuração atinge cada máquina.** Um arquivo de configurações gerenciadas só entra em vigor nas máquinas em que é implantado, por exemplo através de seu sistema de gerenciamento de dispositivos. Consulte [configurações gerenciadas](/pt/settings#settings-files) para locais de arquivos.
Coloque na lista de permissões marketplaces GHES em configurações gerenciadas
Se sua organização usa [configurações gerenciadas](/pt/settings) 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:
```json theme={null}
{
"strictKnownMarketplaces": [
{
"source": "hostPattern",
"hostPattern": "^github\\.example\\.com$"
}
]
}
```
Consulte a referência de configurações [strictKnownMarketplaces](/pt/settings#strictknownmarketplaces) e [extraKnownMarketplaces](/pt/settings#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](#what-works-with-github-enterprise-server) resume o suporte; esta seção cobre as soluções alternativas.
* **Comando `/install-github-app`**: siga o fluxo de [configuração do administrador](#admin-setup) em fuxi.ai. Se você também deseja workflows do GitHub Actions em GHES, adapte o [workflow de exemplo](https://github.com/anthropics/fuxi-code-action/blob/main/examples/fuxi.yml) manualmente.
* **Servidor GitHub MCP**: use o CLI `gh` configurado para seu host GHES. Execute `gh auth login --hostname github.example.com` para autenticar, depois Fuxi pode usar comandos `gh` em sessões.
Troubleshooting
A sessão web falha ao clonar o repositório
Se `fuxi --cloud` falhar com um erro de clone, verifique se um Owner concluiu a configuração para sua instância GHES e se o GitHub App está instalado no repositório em que você está trabalhando. Peça ao Owner que conectou a instância para confirmar que o nome do host registrado nas configurações do Fuxi 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](#allowlist-ghes-marketplaces-in-managed-settings).
Falha ao adicionar marketplace em fuxi.ai com erro de acesso ao GitHub
Se adicionar um marketplace GHES a partir de suas configurações de usuário falhar com um erro genérico como "Marketplace não pôde ser adicionado", verifique primeiro sua conexão GitHub Enterprise. Isso é o que aparece quando sua própria conta GitHub Enterprise não está conectada ao Fuxi, mesmo que a instância GHES de sua organização esteja configurada e outros usuários estejam conectados. O diálogo não aponta para o fluxo de conexão do GitHub Enterprise, e a opção "Conectar ao GitHub" na aba Browse faz login em github.com, o que não concede acesso aos repositórios GHES.
Para conectar sua conta GitHub Enterprise: o seletor de repositório em [fuxi.ai/code](https://fuxi.ai/code) oferece uma opção de conexão para cada instância GHES configurada, e Owners também podem conectar a partir da seção GitHub Enterprise das [configurações de administrador do Fuxi Code](https://fuxi.ai/admin-settings/fuxi-code). Em seguida, adicione o marketplace novamente. Alternativamente, peça a um Owner para adicionar o marketplace nas configurações de plugin da organização, o que remove o requisito de conexão por usuário.
Em outras superfícies do fuxi.ai, um erro "Repositório não encontrado. Se for privado, acesso ao GitHub é necessário" em um marketplace GHES geralmente indica a mesma conexão ausente. Conecte sua conta GitHub Enterprise através de um dos caminhos acima e tente novamente.
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](https://platform.fuxi.com/docs/pt/api/ip-addresses).
Estas páginas cobrem os recursos referenciados ao longo deste guia com mais profundidade:
* [Fuxi Code na web](/pt/fuxi-code-on-the-web): execute sessões do Fuxi Code em infraestrutura em nuvem
* [Code Review](/pt/code-review): revisões automatizadas de PR
* [Marketplaces de plugins](/pt/plugin-marketplaces): construir e distribuir catálogos de plugins
* [Analytics](/pt/analytics): rastrear uso e métricas de contribuição
* [Configurações gerenciadas](/pt/settings): configuração de política em toda a organização
* [Configuração de rede](/pt/network-config): requisitos de firewall e lista de permissões de IP