Codex: Integração GitHub do Codex
Última atualização: 2026-08-31
A integração GitHub do Codex é sua vantagem central de ecossistema, permitindo um fluxo de trabalho totalmente automatizado de Issue a PR.
📋 Pré-requisitos: Compreensão de operações básicas do Git e GitHub
1. O Que Você Vai Aprender
- Configuração da integração GitHub
- Automação Issue → PR
- Review e comentários de PR
- Estratégias de gerenciamento de branches
2. Configuração da Integração GitHub
(1) Autorizar o Codex
1. Selecione "Connect GitHub" nas configurações do Codex
2. Autorize o Codex a acessar sua conta GitHub
3. Escolha o escopo de autorização:
- Repositórios públicos
- Todos os repositórios (incluindo privados)
- Repositórios selecionados
(2) Configuração do CLI
# GitHub Token
export GITHUB_TOKEN="ghp_xxx"
# Ou configure no auth.json
cat >> ~/.codex/auth.json << 'EOF'
{
"GITHUB_TOKEN": "ghp_xxx"
}
EOF
3. Automação Issue → PR
(1) Criar Tarefa a Partir de Issue
> Fix Issue #15: White screen after user login
# Codex automaticamente:
→ Reads Issue #15 description
→ Creates branch fix/issue-15
→ Analyzes root cause
→ Fixes code
→ Runs tests
→ Creates PR #16
→ Links Issue #15
→ Comments "Fixed in #16"
(2) Processar Issues em Lote
> Process all Issues labeled "good-first-issue"
# Codex processa cada um:
→ Issue #12: Fix typo → PR #13
→ Issue #14: Add missing type annotations → PR #15
→ Issue #18: Supplement API documentation → PR #17
▶ Exemplo 1: Fluxo de Processamento de Issues de Alice
# Fluxo GitHub de Alice
1. Comunidade submete Issue → etiquetado "bug"
2. Alice no Codex: "Fix all P1 bugs"
3. Codex processa cada um:
- Cria branch de fix
- Modifica código
- Executa testes
- Cria PR
- Vincula Issue
4. Alice revisa PR → Merge
5. Issue fecha automaticamente
Eficiência de processamento: de 3 Issues/pessoa/dia para 15
4. Automação de PR
(1) Auto-criar PR
Após o Codex completar modificações de código, ele cria automaticamente um PR:
PR Title: fix: resolve login white screen issue
Branch: codex/fix-issue-15
Base: main
Changes:
- src/auth/login.ts: Added error boundary handling
- src/components/Login.tsx: Fixed state management bug
- tests/auth.test.ts: Added 3 new test cases
Test Results: ✅ 45/45 passed
(2) Template de Descrição de PR
Defina o formato de descrição de PR no AGENTS.md:
## Regras de PR
Descrição do PR deve incluir:
- Descrição da mudança
- Issue vinculado
- Resultados de testes
- Screenshots (se houver mudanças de UI)
(3) Auto Review
> Review PR #42
# Saída do Codex:
## Code Review Report
### 🔴 Crítico
- src/api.ts:45 - SQL concatenation, injection risk
### 🟡 Médio
- src/utils.ts:23 - Unhandled Promise rejection
- src/auth.ts:67 - Overly permissive CORS configuration
### 🟢 Sugestões
- src/models.ts:12 - Type definition can be simplified
- tests/api.test.ts - Missing edge case tests
### Resumo
- 1 issue crítico deve ser corrigido antes do merge
- 2 issues médios recomendados para corrigir
- 2 sugestões de melhoria
5. Gerenciamento de Branches
(1) Nomenclatura Automática de Branches
Codex auto-cria branches com convenção de nomenclatura:
- fix/issue-{number}-{description}
- feature/{description}
- refactor/{description}
(2) Estratégia de Branches
| Estratégia | Descrição |
|---|---|
| A partir de main | Cada tarefa cria um novo branch a partir de main |
| A partir de develop | Tarefas baseadas no branch develop |
| A partir de PR | Continuar modificações em um PR existente |
▶ Exemplo 2: Fluxo de Branches de Bob
# Equipe de Bob usa Git Flow
1. Codex cria feature branch a partir de develop
2. Após funcionalidade completa, cria PR → develop
3. Code review passa → Merge
4. No release: develop → main
6. Integração com GitHub Actions
# .github/workflows/codex-pr.yml
name: Codex PR Review
on:
pull_request:
types: [opened]
jobs:
auto-review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Codex Review
run: |
npm install -g @openai/codex
codex --quiet --sandbox readonly \
"Review this PR, output review report" \
> review.md
- name: Comment PR
uses: actions/github-script@v7
with:
script: |
const fs = require('fs');
const body = fs.readFileSync('review.md', 'utf8');
github.rest.issues.createComment({
issue_number: context.issue.number,
owner: context.repo.owner,
repo: context.repo.repo,
body
});
❓ Perguntas Frequentes
P: O Codex pode lidar com repositórios privados? R: Sim, mas você precisa autorizar o Codex a acessar repos privados. Selecione "All repos" durante a autorização OAuth do GitHub.
P: PRs criados pelo Codex podem ser merged diretamente? R: Não recomendado. Revise mudanças de código primeiro, confirme que testes passaram, depois merge. Defina regras de proteção de branch exigindo review de PR.
P: Como limito o Codex a ler apenas certos repositórios? R: Selecione "Selected repos" durante a autorização OAuth do GitHub, autorize apenas repositórios necessários.
P: O Codex pode operar GitHub Actions? R: Ele pode acionar e monitorar Actions através do servidor GitHub do MCP, mas não pode modificar diretamente arquivos de workflow.
P: Múltiplos desenvolvedores usando o Codex no mesmo repo causarão conflitos? R: Não se modificarem arquivos/branches diferentes. Cada pessoa deve usar um feature branch independente, evite operações paralelas na mesma branch.
📖 Resumo
- Integração GitHub: Issue → Fix → PR → Review → Merge, totalmente automatizado
- Auto-criação de PR: inclui descrição de mudanças, resultados de testes
- Code review: multi-dimensional — segurança/performance/estilo
- Gerenciamento de branches: nomenclatura automática, criados a partir do branch alvo
- Integração GitHub Actions: auto-review em PRs
📝 Exercícios
- Básico (⭐): Conecte um repositório GitHub, faça o Codex criar um PR a partir de um Issue.
- Intermediário (⭐⭐): Configure GitHub Actions para review automático de PRs.
- Avançado (⭐⭐⭐): Desenhe um fluxo de trabalho GitHub completo — Issue → auto-fix → PR → review → merge → notificação, desenhe um fluxograma.
