Noções Básicas de Integração com GitHub

8 exemplos para você começar com Integração com GitHub e CI - 5 básicos e 3 intermediários.

Pré-requisitos

• Instale o gh CLI (ferramenta oficial de linha de comando do GitHub) - brew install gh no macOS, ou consulte a documentação de instalação do GitHub para sua plataforma.
• Autentique-o uma vez por máquina com gh auth login, seguindo os prompts interativos para conectar sua conta do GitHub.
• Execute o Claude Code dentro de um repositório git que tenha um remote do GitHub configurado, para que os comandos gh e git sejam resolvidos corretamente.
• Nenhuma configuração especial do Claude Code é necessária - o Claude Code simplesmente executa comandos gh e git da mesma forma que você os digitaria.

Exemplos Básicos

1. Verifique se o gh CLI Está Conectado

Confirme se o gh está instalado e autenticado antes de pedir ao Claude Code para usá-lo.

gh auth status

• Imprime a conta autenticada e os escopos do token para o host atual.
• Execute isso uma vez após gh auth login e sempre que os comandos do GitHub de uma sessão falharem inesperadamente.
• Um token ausente ou expirado é o motivo mais comum para uma sessão do Claude Code não conseguir abrir ou comentar em um PR.

2. Visualize os PRs do Repositório Atual

Liste os pull requests abertos antes de pedir ao Claude Code para agir sobre um deles.

gh pr list

• Mostra título, branch e status de todos os PRs abertos no repositório atual.
• Contexto útil para fornecer ao Claude Code antes de apontá-lo para um número de PR específico.
• Adicione --state all para incluir PRs mesclados e fechados na lista.

3. Abra um Pull Request de uma Sessão

Peça ao Claude Code para confirmar as alterações preparadas e abrir um PR em uma única etapa.

git add -A
git commit -m "Add rate limiting to the search endpoint"
gh pr create --title "Add rate limiting to the search endpoint" --body "Fixes #482"

• gh pr create abre o PR contra o branch base padrão do repositório, a menos que você passe --base.
• --title e --body pulam o prompt interativo para que o comando seja executado de forma limpa dentro de uma sessão.
• O Claude Code executa essa sequência exata quando você pede para "confirmar isso e abrir um PR".

4. Visualize os Detalhes de um PR Específico

Obtenha o contexto completo de um PR antes de pedir ao Claude Code para revisá-lo ou atualizá-lo.

gh pr view 482

• Imprime título, descrição, verificações de status e estado de revisão para o PR #482.
• Adicione --comments para incluir a thread de comentários de revisão na saída.
• O Claude Code lê essa saída para entender o que um PR já contém antes de fazer alterações.

5. Faça o Checkout do Branch de um PR Localmente

Baixe o branch de um PR para o seu diretório de trabalho para que o Claude Code possa editar seus arquivos diretamente.

gh pr checkout 482

• Busca o branch do PR e muda seu diretório de trabalho local para ele.
• Necessário antes que o Claude Code possa enviar um commit de acompanhamento para esse PR exato.
• Execute git status depois para confirmar que você está no branch esperado antes de fazer alterações.

Exemplos Intermediários

6. Leia Comentários de Revisão e Envie uma Correção

Busque os comentários de revisão de um PR e, em seguida, peça ao Claude Code para abordá-los e enviar um commit de acompanhamento.

gh pr view 482 --comments
# Peça ao Claude Code: "Aborde os comentários de revisão no PR #482 e envie uma correção."
git add -A
git commit -m "Address review feedback: validate rate limit window bounds"
git push

• gh pr view --comments expõe a redação exata do revisor para que o Claude Code possa abordar cada ponto especificamente.
• O commit de acompanhamento é adicionado ao mesmo branch, aparecendo diretamente no PR existente - nenhum novo PR é criado.
• Mensagens de commit que referenciam o que foi alterado (não apenas "abordar feedback") tornam o histórico do PR mais fácil de verificar posteriormente.

Relacionado: Respondendo Automaticamente a Comentários de Revisão de PR - o fluxo completo que este exemplo antecipa.

7. Execute o Claude Code Headless Contra um PR

Invoque o Claude Code de forma não interativa para resumir um PR, útil como um primeiro passo para automação de CI.

claude -p "Summarize the changes in PR #482 and flag any obvious risks." --output-format text

• -p (modo de impressão) executa um prompt e sai, sem abrir o REPL interativo.
• Esta é a mesma forma de invocação que um job do GitHub Actions usa para executar o Claude Code headless em cada PR.
• Útil para testar um prompt de revisão localmente antes de conectá-lo à CI.

Relacionado: Modo Headless Explicado: Executando o Claude Code Sem um Terminal - como este modo funciona em profundidade.

8. Deixe um Comentário de Revisão via gh

Poste um comentário diretamente em um PR a partir da linha de comando, a mesma chamada que um job de CI faria.

gh pr comment 482 --body "Looks good overall - one suggestion: consider caching the rate-limit window lookup."

• gh pr comment posta um comentário de nível superior na thread de conversação do PR.
• Este é o comando exato que um job de revisão automatizado executa para deixar feedback sem que um humano o digite.
• Combine com a saída do modo headless (exemplo 7) para postar a própria revisão do Claude Code como um comentário de PR.

Relacionado: Executando o Claude Code como um Bot de Revisão de Código Automatizado em CI - conectando isso a um job de CI real.

Versões da Stack: Escrito contra a linha de modelos Claude atual em ~junho de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (o padrão) e Claude Haiku 4.5. Nomes de modelos, preços e recursos de produtos mudam rapidamente - verifique os detalhes atuais em platform.claude.com/docs antes de confiar neles.