--- title: Claude Code GitHub Actions | RunAPI description: Configure o Claude Code GitHub Actions com um segredo do RunAPI, modelo, permissões, gatilhos e um fluxo de trabalho mínimo. url: https://runapi.ai/pt-BR/docs/resources/tool-integrations/claude-code-github-actions.md canonical: https://runapi.ai/pt-BR/docs/resources/tool-integrations/claude-code-github-actions locale: pt-BR --- > Versão HTML: https://runapi.ai/pt-BR/docs/resources/tool-integrations/claude-code-github-actions > Índice do site para agentes: https://runapi.ai/llms.txt # Claude Code GitHub Actions ## 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](https://runapi.ai/pt-BR/docs/guides/authentication.md). * Copie um identificador de modelo que suporte Anthropic Messages do [Catálogo de Modelos](https://runapi.ai/pt-BR/models). * Revise a [configuração do Claude Code GitHub Actions][1] e a política de workflow da sua organização. [1]: https://code.claude.com/docs/en/github-actions ## 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][1] e, em seguida, adicione o workflow abaixo em `.github/workflows/claude.yml`. [1]: https://github.com/apps/claude ## 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][1] do GitHub para escopo de repositório e organização. [1]: https://docs.github.com/en/actions/how-tos/write-workflows/choose-what-workflows-do/use-secrets ### 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][1] como referência canônica. [1]: https://code.claude.com/docs/en/github-actions#who-can-trigger-runs ## Escolher um modelo Substitua `YOUR_RUNAPI_MODEL_ID` em `claude_args` pelo identificador exato do [Catálogo de Modelos](https://runapi.ai/pt-BR/models). 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 1. Confirme que o segredo `RUNAPI_API_KEY` existe sem exibir seu valor. 2. Faça merge do workflow na branch padrão e confirme que o Actions está habilitado. 3. 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. 4. 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](https://runapi.ai/pt-BR/docs/guides/authentication.md) 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](https://runapi.ai/pt-BR/models). * **Commits do Claude não iniciam outro workflow:** consulte o [troubleshooting de token do GitHub][1] da action oficial. [1]: https://code.claude.com/docs/en/github-actions#ci-not-running-on-claudes-commits ## Próximas etapas Use o [Início rápido da LLM API](https://runapi.ai/pt-BR/docs/guides/llm-api/quickstart.md) para o comportamento do protocolo e a [Referência da API Anthropic Messages](https://runapi.ai/pt-BR/docs/api/anthropic/messages.md) para os campos de requisição. Para mais gatilhos e entradas de ação, use os [exemplos oficiais][1] e a [referência de configuração][2]. [1]: https://github.com/anthropics/claude-code-action/tree/main/examples [2]: https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md --- ## Mais de RunAPI - [Início](https://runapi.ai/pt-BR/.md) - [Catálogo de modelos](https://runapi.ai/pt-BR/models.md) - [Preços](https://runapi.ai/pt-BR/pricing.md) - [Provedores](https://runapi.ai/pt-BR/models) - [Documentação](https://runapi.ai/pt-BR/docs/guides) - [SDKs](https://runapi.ai/pt-BR/sdk.md) - [CLI](https://runapi.ai/pt-BR/cli.md) - [Servidor MCP](https://runapi.ai/pt-BR/mcp.md) - [Claude Code vs Cursor](https://runapi.ai/pt-BR/claude-code-vs-cursor.md) - [Configuração da API do Cursor](https://runapi.ai/pt-BR/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/pt-BR/openrouter-alternative.md) - [Enterprise](https://runapi.ai/pt-BR/contact.md) - [Contato](https://runapi.ai/pt-BR/contact.md) - [Termos](https://runapi.ai/pt-BR/terms.md) - [Privacidade](https://runapi.ai/pt-BR/privacy.md) - [Índice do site para agentes](https://runapi.ai/llms.txt) Contato: contact@runapi.ai ## Dados estruturados ```json [ { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/pt-BR", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/pt-BR/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/pt-BR", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/pt-BRicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "TechArticle", "headline": "Claude Code GitHub Actions", "description": "Configure o Claude Code GitHub Actions com um segredo do RunAPI, modelo, permissões, gatilhos e um fluxo de trabalho mínimo.", "url": "https://runapi.ai/pt-BR/docs/resources/tool-integrations/claude-code-github-actions", "mainEntityOfPage": "https://runapi.ai/pt-BR/docs/resources/tool-integrations/claude-code-github-actions" } ] ```