Tutorial de Uso do Claude Code GitHub Actions

​

Processo de Solicitação

​

Características

• Criação instantânea de PR: descreva a necessidade, e o Claude criará automaticamente um Pull Request completo.
• Implementação automática de código: mencione @claude em um Issue, e ele transformará o Issue em código executável.
• Conformidade com as normas do projeto: lê automaticamente o CLAUDE.md, seguindo seu estilo de código e normas do projeto.
• Seguro e confiável: o código é executado no Runner do GitHub, garantindo a segurança dos dados.

​

Etapas de Configuração

​

Passo Um: Instalar o App do Claude no GitHub

​

Passo Dois: Adicionar a Chave da API

1. Acesse Settings do repositório → Secrets and variables → Actions
2. Clique em New repository secret
3. No campo Name, preencha ANTHROPIC_API_KEY, e no campo Value, insira o token da API que você obteve na AceData Cloud
4. Clique em Add secret para salvar

Dica: O token da API pode ser visualizado no console da AceData Cloud.

​

Passo Três: Criar o Arquivo de Workflow

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]
  pull_request:
    types: [opened, synchronize]

jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]

jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
        env:
          ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

​

Modo de Uso

​

Usando em Comentários de Issue ou PR

@claude implemente a funcionalidade com base na descrição deste Issue
@claude revise a segurança do código deste PR
@claude corrija o TypeError no componente do painel do usuário
@claude como deve ser implementada a autenticação do usuário neste endpoint?

​

Revisão Automática de Código

name: Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "/review"
          claude_args: "--max-turns 5"
        env:
          ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

​

Automação de Tarefas Agendadas

name: Daily Report
on:
  schedule:
    - cron: "0 9 * * *"

jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "Gerar um resumo dos commits de ontem e um relatório dos Issues não fechados"
        env:
          ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

​

Descrição dos Parâmetros da Action

​

Parâmetros Comuns de claude_args

claude_args: "--max-turns 5 --model claude-sonnet-4-5-20250929"

​

Melhores Práticas

​

Configurar o CLAUDE.md

​

Considerações de Segurança

• Nunca escreva a chave da API diretamente no arquivo de Workflow.
• Sempre use Secrets do GitHub (como ${{ secrets.ANTHROPIC_API_KEY }}).
• Limite as permissões da Action ao mínimo necessário.
• Revise manualmente as sugestões do Claude antes de mesclar.

​

Controle de Custos

• Use instruções claras de @claude para reduzir chamadas desnecessárias à API.
• Configure um limite razoável de --max-turns para o número de turnos de diálogo.
• Defina um tempo limite em nível de Workflow.
• Use o controle de concorrência do GitHub para limitar o número de execuções paralelas.

​

Perguntas Frequentes

​

O Claude não respondeu ao comando @claude?

1. Verifique se o App do Claude no GitHub está instalado corretamente.
2. Verifique se o Workflow está habilitado.
3. Confirme se a chave da API está configurada como um Secret do repositório.
4. Certifique-se de que está usando @claude nos comentários (não /claude).

​

Erro de autenticação?

1. Confirme se a chave da API é válida e tem permissões suficientes
2. Verifique se o nome do Secret está correto (ANTHROPIC_API_KEY)
3. Se estiver usando ANTHROPIC_BASE_URL, confirme se a URL está correta

​

Como verificar o saldo restante?

​

Saiba mais

• 📖 Documentação oficial do Claude Code GitHub Actions
• 📂 Repositório claude-code-action
• 📋 Exemplo de Workflow
• 🔧 Serviço Claude Code da AceData Cloud
• 💬 Se tiver alguma dúvida, sinta-se à vontade para entrar em contato conosco através do suporte da plataforma