--- title: Claude Code GitHub Actions | RunAPI description: Configure Claude Code GitHub Actions con un secreto de RunAPI, un modelo, permisos, activadores y un flujo de trabajo mínimo. url: https://runapi.ai/es/docs/resources/tool-integrations/claude-code-github-actions.md canonical: https://runapi.ai/es/docs/resources/tool-integrations/claude-code-github-actions locale: es --- > Versión HTML: https://runapi.ai/es/docs/resources/tool-integrations/claude-code-github-actions > Índice del sitio para agentes: https://runapi.ai/llms.txt # Claude Code GitHub Actions ## Descripción general La acción oficial `anthropics/claude-code-action` ejecuta Claude Code en un flujo de trabajo de GitHub Actions. Esta guía almacena una clave de RunAPI como secreto de GitHub, establece la URL base no sensible en la configuración de Claude Code, selecciona un modelo y responde a los comentarios `@claude` autorizados. ## Antes de comenzar * Necesita acceso de administrador del repositorio para instalar la aplicación GitHub de Claude, crear secretos de Actions y agregar un flujo de trabajo. * Cree una Clave de API de RunAPI estándar en la [Guía de Autenticación](https://runapi.ai/es/docs/guides/authentication.md). * Copie un identificador de modelo que sea compatible con Anthropic Messages desde el [Catálogo de modelos](https://runapi.ai/es/models). * Revise la [configuración de Claude Code en GitHub Actions][1] y la política de flujos de trabajo de su organización. [1]: https://code.claude.com/docs/en/github-actions ## Instalar Desde Claude Code en el repositorio de destino, ejecute `/install-github-app` y siga las instrucciones para instalar la aplicación de GitHub. Cuando le ofrezca crear una credencial de Anthropic, deténgase antes de guardarla: esta guía usa en su lugar un secreto de repositorio u organización de RunAPI. Para la configuración manual, instale la [aplicación GitHub de Claude][1] y luego agregue el flujo de trabajo a continuación en `.github/workflows/claude.yml`. [1]: https://github.com/apps/claude ## Configurar RunAPI Cree un secreto de Actions de repositorio u organización llamado `RUNAPI_API_KEY`. Páselo únicamente a través de la entrada secreta de la acción: ```yaml anthropic_api_key: ${{ secrets.RUNAPI_API_KEY }} ``` No incluya la clave en el archivo de flujo de trabajo ni en el JSON de `settings` de la acción. La acción procesa los ajustes por separado; solo la URL base no sensible pertenece allí. El siguiente flujo de trabajo interactivo mínimo escucha nuevos comentarios en issues y revisiones de pull requests: ```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" ``` ### Secretos GitHub no pasa los secretos ordinarios de Actions a los flujos de trabajo activados desde solicitudes de incorporación de cambios de bifurcación o eventos de Dependabot. Si una ejecución no tiene credencial, confirme el origen del evento antes de rotar la clave de RunAPI. Use la [guía de secretos de Actions][1] de GitHub para el ámbito de repositorio y organización. [1]: https://docs.github.com/en/actions/how-tos/write-workflows/choose-what-workflows-do/use-secrets ### Permisos * `contents: write` permite que la acción confirme cambios en el código. * `pull-requests: write` e `issues: write` le permiten leer y responder a la conversación que la activó. * `id-token: write` admite la autenticación predeterminada de la aplicación GitHub de la acción. * `actions: read` le permite inspeccionar los resultados del flujo de trabajo. Usa estos permisos explícitos en lugar de `write-all`. Elimina las capacidades que tu flujo de trabajo no necesite. ### Eventos desencadenantes `issue_comment` cubre los comentarios en issues y conversaciones de pull request; `pull_request_review_comment` cubre los comentarios en líneas de diff. El archivo de flujo de trabajo debe existir en la rama predeterminada antes de que `issue_comment` pueda activarlo. La acción también comprueba quién inició la ejecución; usa el [comportamiento de seguridad oficial][1] como referencia canónica. [1]: https://code.claude.com/docs/en/github-actions#who-can-trigger-runs ## Elegir un modelo Reemplace `YOUR_RUNAPI_MODEL_ID` en `claude_args` con el identificador exacto del [Catálogo de modelos](https://runapi.ai/es/models). Mantener la selección del modelo fuera de `settings.env` hace que el modelo elegido por el flujo de trabajo sea visible en la configuración de la acción. ## Verificar 1. Confirme que el secreto `RUNAPI_API_KEY` existe sin mostrar su valor. 2. Incorpore el flujo de trabajo en la rama predeterminada y confirme que Actions está habilitado. 3. Desde una cuenta con acceso de escritura al repositorio, agregue `@claude describe this repository in one sentence` a un comentario en un issue. 4. Abra la ejecución del flujo de trabajo, confirme que la acción se completa correctamente y verifique que Claude responde en el mismo issue. ## Solución de problemas * **Ningún flujo de trabajo se inicia:** confirma que el archivo está en la rama predeterminada, que el evento de comentario coincide y que Actions está habilitado. * **El trabajo se omite:** confirma que el comentario contiene `@claude` y que el actor tiene el acceso requerido al repositorio. * **La autenticación falla:** confirma que el flujo de trabajo hace referencia a `secrets.RUNAPI_API_KEY` y luego rota la clave a través de la [Guía de autenticación](https://runapi.ai/es/docs/guides/authentication.md) si es necesario. * **Una pull request de un fork no puede usar la clave:** GitHub retiene intencionalmente los secretos ordinarios de las ejecuciones activadas por forks. No reemplaces el secreto por un valor literal. * **El modelo no está disponible:** copia el identificador exacto del [Catálogo de modelos](https://runapi.ai/es/models). * **Los commits de Claude no inician otro flujo de trabajo:** consulta la [solución de problemas con tokens de GitHub][1] de la acción oficial. [1]: https://code.claude.com/docs/en/github-actions#ci-not-running-on-claudes-commits ## Próximos pasos Usa el [Inicio rápido de la API LLM](https://runapi.ai/es/docs/guides/llm-api/quickstart.md) para el comportamiento del protocolo y la [Referencia de la API de Mensajes de Anthropic](https://runapi.ai/es/docs/api/anthropic/messages.md) para los campos de solicitud. Para más desencadenadores y entradas de acción, usa los [ejemplos oficiales][1] y la [referencia de configuración][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 --- ## Más de RunAPI - [Inicio](https://runapi.ai/es/.md) - [Catálogo de modelos](https://runapi.ai/es/models.md) - [Precios](https://runapi.ai/es/pricing.md) - [Proveedores](https://runapi.ai/es/models) - [Documentación](https://runapi.ai/es/docs/guides) - [SDKs](https://runapi.ai/es/sdk.md) - [CLI](https://runapi.ai/es/cli.md) - [Servidor MCP](https://runapi.ai/es/mcp.md) - [Claude Code vs Cursor](https://runapi.ai/es/claude-code-vs-cursor.md) - [Configuración de Cursor API](https://runapi.ai/es/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/es/openrouter-alternative.md) - [Enterprise](https://runapi.ai/es/contact.md) - [Contacto](https://runapi.ai/es/contact.md) - [Términos](https://runapi.ai/es/terms.md) - [Privacidad](https://runapi.ai/es/privacy.md) - [Índice del sitio para agentes](https://runapi.ai/llms.txt) Contacto: contact@runapi.ai ## Datos estructurados ```json [ { "@context": "https://schema.org", "inLanguage": "es", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/es", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/es/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/es", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/esicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "TechArticle", "headline": "Claude Code GitHub Actions", "description": "Configure Claude Code GitHub Actions con un secreto de RunAPI, un modelo, permisos, activadores y un flujo de trabajo mínimo.", "url": "https://runapi.ai/es/docs/resources/tool-integrations/claude-code-github-actions", "mainEntityOfPage": "https://runapi.ai/es/docs/resources/tool-integrations/claude-code-github-actions" } ] ```