Recursos para Desenvolvedores

Claude Code GitHub Actions

Configure o Claude Code GitHub Actions com um segredo do RunAPI, modelo, permissões, gatilhos e um fluxo de trabalho mínimo.

Ver Markdown

Visão geral

A anthropics/claude-code-action oficial executa o Claude Code em um fluxo de trabalho do GitHub Actions. Este guia armazena uma chave do RunAPI como um Secret do GitHub, define a URL base não sensível nas configurações do Claude Code, seleciona um modelo e responde a comentários autorizados com @claude.

Antes de começar

Você precisa de acesso de administrador do repositório para instalar o App Claude do GitHub, criar segredos do Actions e adicionar um workflow.
Crie uma Chave de API RunAPI padrão no Guia de Autenticação.
Copie um identificador de modelo que suporte Anthropic Messages do Catálogo de Modelos.
Revise a configuração do Claude Code GitHub Actions e a política de workflow da sua organização.

Instalar

No Claude Code, no repositório de destino, execute /install-github-app e siga as instruções para instalar o GitHub App. Quando ele oferecer a criação de uma credencial Anthropic, pare antes de salvar: este guia usa um segredo de repositório ou organização do RunAPI.

Para configuração manual, instale o Claude GitHub App e, em seguida, adicione o workflow abaixo em .github/workflows/claude.yml.

Configurar o RunAPI

Crie um segredo de Actions de repositório ou organização chamado RUNAPI_API_KEY. Passe-o apenas pela entrada de segredo da action:

YAML

anthropic_api_key: ${{ secrets.RUNAPI_API_KEY }}

Não coloque a chave no arquivo de workflow nem no JSON settings da action. A action processa as configurações separadamente; apenas a URL Base não sensível pertence lá.

O fluxo de trabalho interativo mínimo a seguir escuta novos comentários em issues e em revisões de pull request:

YAML

name: Claude Code

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]

jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write
      actions: read
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.RUNAPI_API_KEY }}
          settings: |
            {
              "env": {
                "ANTHROPIC_BASE_URL": "https://runapi.ai"
              }
            }
          claude_args: "--model YOUR_RUNAPI_MODEL_ID"

Segredos

O GitHub não repassa segredos comuns do Actions para fluxos de trabalho acionados a partir de pull requests de forks ou eventos do Dependabot. Se uma execução não tiver credencial, confirme a origem do evento antes de rotacionar a chave do RunAPI. Use o guia de segredos do Actions do GitHub para escopo de repositório e organização.

Permissões

contents: write permite que a action faça commit de alterações de código.
pull-requests: write e issues: write permitem que ela leia e responda à conversa que a acionou.
id-token: write dá suporte à autenticação padrão do GitHub App da action.
actions: read permite que ela inspecione os resultados do workflow.

Use essas permissões explícitas em vez de write-all. Remova as capacidades de que o seu fluxo de trabalho não precisa.

Eventos de gatilho

issue_comment abrange comentários em issues e conversas de pull request; pull_request_review_comment abrange comentários em linhas de diff. O arquivo de workflow deve existir no branch padrão antes que issue_comment possa acioná-lo. A action também verifica quem iniciou a execução; use o comportamento de segurança oficial como referência canônica.

Escolher um modelo

Substitua YOUR_RUNAPI_MODEL_ID em claude_args pelo identificador exato do Catálogo de Modelos. Manter a seleção de modelo fora de settings.env torna o modelo escolhido pelo fluxo de trabalho visível na configuração da ação.

Verificar

Confirme que o segredo RUNAPI_API_KEY existe sem exibir seu valor.
Faça merge do workflow na branch padrão e confirme que o Actions está habilitado.
A partir de uma conta com acesso de escrita no repositório, adicione @claude describe this repository in one sentence em um comentário de issue.
Abra a execução do workflow, confirme que a action foi concluída com sucesso e verifique que o Claude respondeu na mesma issue.

Solucionar problemas

Nenhum workflow é iniciado: confirme que o arquivo está no branch padrão, que o evento de comentário corresponde e que o Actions está habilitado.
O job é ignorado: confirme que o comentário contém @claude e que o ator tem o acesso necessário ao repositório.
A autenticação falha: confirme que o workflow referencia secrets.RUNAPI_API_KEY e rotacione a chave pelo Guia de Autenticação se necessário.
Um pull request de fork não consegue usar a chave: o GitHub intencionalmente não fornece segredos comuns a execuções acionadas por forks. Não substitua o segredo por um valor literal.
O modelo está indisponível: copie o identificador exato do Catálogo de Modelos.
Commits do Claude não iniciam outro workflow: consulte o troubleshooting de token do GitHub da action oficial.

Próximas etapas

Use o Início rápido da LLM API para o comportamento do protocolo e a Referência da API Anthropic Messages para os campos de requisição. Para mais gatilhos e entradas de ação, use os exemplos oficiais e a referência de configuração.