Skip to main content

Como usar a CLI do GitHub nas plataformas do GitHub

Saiba como executar comandos quando você está autenticado em contas em diferentes plataformas do GitHub.

Se você tiver contas em várias plataformas do GitHub, como uma conta pessoal no GitHub.com e um conta de usuário gerenciada no GHE.com, autentique-se com gh auth login para cada conta.

Você precisará se autenticar para executar qualquer comando em um ambiente específico. Por exemplo, mesmo que esteja executando um comando que só exija acesso de leitura em um repositório público do GitHub.com, você não poderá usar esse comando se só estiver autenticado em uma conta do GHE.com. Portanto, você deve se autenticar em todas as contas que deseja usar com a GitHub CLI.

Como fazer para executar comandos para cada conta?

Depois de se autenticar com várias contas, quando você executar um comando, a GitHub CLI às vezes poderá detectar automaticamente a plataforma que você está tentando acessar. Em outros casos, você precisará fornecer mais informações no comando.

A GitHub CLI detecta automaticamente sua conta pretendida quando você está no contexto de um repositório específico. Por exemplo, se você executar cd para entrar no diretório my-repo e executar gh repo view, o comando será direcionado à plataforma correta desse repositório.

A GitHub CLI não pode detectar automaticamente sua conta pretendida quando ela não tem esse contexto. Por exemplo, se você executar gh repo list para listar os repositórios da sua conta, a GitHub CLI não saberá a conta que você deseja acessar. Em casos como este:

  • A GitHub CLI usará o GitHub.com como padrão.
  • Você pode definir a variável de ambiente GH_HOST para alterar o destino padrão para esses tipos de solicitações. Confira gh environment no manual da GitHub CLI.
  • Alguns comandos permitem que você especifique o ambiente de destino com a opção --hostname, como gh api, ou transmita a URL completa para um repositório, como gh pr view.

Posso usar várias contas na mesma plataforma?

Você também pode se autenticar com várias contas na mesma plataforma. Para alternar entre essas contas, use o comando gh auth switch. Confira gh auth switch no manual da GitHub CLI.