Como o Claude Code se Encaixa no Seu Fluxo de Trabalho de Pull Request do GitHub
Um pull request é a unidade de trabalho em torno da qual a maioria das equipes já se organiza: um branch, um diff, uma revisão e um merge.
//
Busque em todas as páginas da documentação
Um pull request é a unidade de trabalho em torno da qual a maioria das equipes já se organiza: um branch, um diff, uma revisão e um merge.
O Claude Code não introduz um novo fluxo de trabalho ao lado desse.
Em vez disso, ele se integra ao ciclo de vida de pull request que você já executa, em três pontos específicos: abrindo um PR, revisando um PR e enviando commits de acompanhamento que abordam o feedback da revisão.
Entender exatamente onde esses três pontos de contato se situam é o que faz o restante dos artigos desta seção fazerem sentido.
gh ou um job de CI.gh, modo sem interface gráfica (headless), revisão automatizada, commit de acompanhamento.gh, modo sem interface gráfica, revisão automatizada de CI, GitHub Actions.Um pull request típico passa por um pequeno número de estágios reconhecíveis: um branch é criado, as alterações são commitadas, um PR é aberto contra um branch base, os revisores deixam comentários, o autor envia commits de acompanhamento e, eventualmente, o PR é mesclado.
O Claude Code pode atuar em três desses estágios.
Abrindo um PR. Após o Claude Code fazer alterações em uma sessão de trabalho, ele pode commitar essas alterações e abrir um pull request diretamente, usando o comando pr create da CLI gh de dentro da mesma sessão.
Revisando um PR. O Claude Code também pode ser executado em um PR existente para deixar comentários de revisão, seja interativamente a pedido de um desenvolvedor ou automaticamente como parte de um job de CI acionado sempre que um PR é aberto ou atualizado.
Respondendo a comentários de revisão. Uma vez que um humano (ou uma revisão automatizada) deixa comentários em um PR, o Claude Code pode ler esses comentários, fazer as alterações de código correspondentes e enviar um commit de acompanhamento para o mesmo branch.
A maneira mais simples de visualizar isso: onde quer que uma pessoa normalmente digite um comando git ou gh manualmente, o Claude Code pode executar o mesmo comando em seu nome, de dentro de uma sessão que ele já tem aberta.
Os três pontos de contato diferem em quem os inicia e onde o Claude Code é executado.
Abrir um PR e responder a comentários de revisão são ambos geralmente iniciados por uma pessoa trabalhando com o Claude Code interativamente em um terminal. O desenvolvedor pede ao Claude Code para commitar e abrir um PR, ou para abordar os comentários em um PR específico, e a sessão executa os comandos gh necessários como parte da resposta a essa solicitação.
A revisão automatizada é diferente: ela é tipicamente acionada pelo próprio GitHub, através de um fluxo de trabalho do GitHub Actions que dispara sempre que um pull request é aberto ou atualizado. Nesse contexto, não há uma pessoa assistindo à sessão em tempo real, então ela é executada em modo sem interface gráfica (headless) - o Claude Code é invocado não interativamente, em vez de através de seu REPL normal de terminal.
# Interativo: um desenvolvedor pede ao Claude Code para abrir um PR da sessão atual.
# O Claude Code executa o comando gh subjacente como parte do cumprimento da solicitação.
gh pr create --title "Adicionar limitação de taxa ao endpoint de busca" --body "Corrige #482"Esse mesmo comando gh pr create é exatamente o que um job do GitHub Actions também poderia executar - a diferença não é o comando, mas sim se há um humano presente para digitar a solicitação ou se a solicitação veio de um gatilho de CI e um prompt scriptado.
Esta é a mudança mental chave: abrir, revisar e responder a PRs não são três integrações separadas. São a mesma capacidade subjacente - uma sessão do Claude Code que pode executar comandos gh e git - invocada de dois contextos diferentes: uma sessão de terminal interativa e um job de CI sem interface gráfica.
Uma vez que uma equipe tenha o Claude Code abrindo PRs interativamente, o próximo passo natural é muitas vezes automatizar o lado da revisão: um job do GitHub Actions que executa o Claude Code sem interface gráfica em cada PR e deixa comentários sem que ninguém precise pedir.
Essa revisão automatizada não substitui o processo de revisão existente de uma equipe. Ela é executada ao lado de revisores humanos obrigatórios e quaisquer regras de proteção de branch já configuradas no repositório - ela adiciona um sinal, não remove um portão.
Os três pontos de contato também se compõem ao longo da vida de um único PR. Uma sessão pode abrir o PR, então horas ou dias depois, uma vez que um humano ou a revisão automatizada deixa comentários, uma sessão separada (interativa ou sem interface gráfica) retoma o PR para enviar um commit de acompanhamento abordando esse feedback. Nada exige que a mesma sessão lide com todas as etapas.
| Ponto de Contato | Normalmente Iniciado Por | Modo Típico |
|---|---|---|
| Abrindo um PR | Um desenvolvedor, no meio da sessão | Interativo |
| Revisando um PR | Um gatilho de CI, ou uma solicitação do desenvolvedor | Sem interface gráfica (CI) ou interativo |
| Respondendo a comentários | Um desenvolvedor, após os revisores darem feedback | Interativo, às vezes sem interface gráfica |
Uma equipe que adota todos os três pontos de contato acaba tendo o Claude Code presente em quase todas as etapas da vida de um PR, exceto a decisão real de merge, que permanece uma chamada humana, aplicada da mesma forma que sempre foi através das configurações de proteção de branch e aprovação exigida do GitHub.
gh que um desenvolvedor digitaria manualmente; não há uma ferramenta separada para abrir versus revisar.Ele precisa do que a própria CLI gh precisa - um repositório para o qual a conta autenticada pode fazer push e abrir PRs, o mesmo que se uma pessoa executasse os comandos manualmente.
O Claude Code pode executar os comandos para abrir, revisar ou comentar em um PR, mas a mesclagem ainda passa pelas regras de aprovação e proteção de branch que o repositório já impõe.
A capacidade subjacente é a mesma; a diferença é apenas o gatilho e o modo - um desenvolvedor pedindo uma revisão é executado interativamente, enquanto um job de CI o executa sem interface gráfica sempre que um evento de PR é acionado.
Não. Abrir um PR e responder a comentários de revisão funcionam bem a partir de uma sessão interativa usando a CLI gh - o GitHub Actions só se torna necessário quando você deseja que a etapa de revisão seja executada automaticamente sem uma pessoa presente.
Através da CLI gh, a própria ferramenta oficial de linha de comando do GitHub, que o Claude Code executa da mesma forma que um desenvolvedor a executaria manualmente a partir de um terminal.
Essa é uma preocupação de configuração, não uma propriedade inerente - um job de CI pode ser configurado para deixar um único comentário consolidado por atualização de PR em vez de um comentário por linha, dependendo de como o prompt de revisão e o fluxo de trabalho são escritos.
O fluxo típico é fazer a alteração de código solicitada e enviar um commit de acompanhamento; isso é o que realmente aborda o feedback em vez de apenas responder a ele.
Não - qualquer modelo na linha atual pode executar esses comandos gh e git; a escolha do modelo afeta a qualidade da revisão ou das alterações de código, não se a integração do GitHub em si funciona.
Nada muda nessa regra - o comentário de revisão ou o commit de acompanhamento do Claude Code ainda precisa da aprovação humana exigida antes que o PR possa ser mesclado, exatamente como seria se uma pessoa tivesse feito essas mesmas alterações.
Não em resultado - é o mesmo comando gh pr create produzindo o mesmo tipo de pull request; a diferença é apenas que o Claude Code digitou o comando como parte da conclusão de uma tarefa que você solicitou.
Sim - um desenvolvedor pode abrir o PR interativamente, então uma revisão sem interface gráfica acionada por CI é executada automaticamente assim que é enviada, e mais tarde o desenvolvedor (ou outra sessão) envia um commit de acompanhamento abordando os comentários dessa revisão.
gh e percorra a abertura e revisão do seu primeiro PR.Versões de Stack: Escrito com base na 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 do produto mudam rapidamente - verifique os detalhes atuais em platform.claude.com/docs antes de confiar neles.
Revisado por Chris St. John·Última atualização: 16 de jul. de 2026