--- title: Claude Code GitHub Actions | RunAPI description: RunAPIシークレット、モデル、権限、トリガー、および最小限のワークフローでClaude Code GitHub Actionsを設定します。 url: https://runapi.ai/ja/docs/resources/tool-integrations/claude-code-github-actions.md canonical: https://runapi.ai/ja/docs/resources/tool-integrations/claude-code-github-actions locale: ja --- > HTML 版: https://runapi.ai/ja/docs/resources/tool-integrations/claude-code-github-actions > エージェント向けサイトインデックス: https://runapi.ai/llms.txt # Claude Code GitHub Actions ## 概要 公式の`anthropics/claude-code-action`はGitHub ActionsワークフローでClaude Codeを実行します。このガイドでは、RunAPIキーをGitHub Secretとして保存し、非機密のBase URLをClaude Code設定に設定し、モデルを選択して、承認された`@claude`コメントに応答します。 ## 始める前に * Claude GitHub Appのインストール、Actionsシークレットの作成、ワークフローの追加には、リポジトリの管理者アクセス権が必要です。 * [認証ガイド](https://runapi.ai/ja/docs/guides/authentication.md)で標準RunAPI APIキーを作成してください。 * [モデルカタログ](https://runapi.ai/ja/models)から、Anthropic Messagesをサポートするモデルの識別子をコピーしてください。 * [Claude Code GitHub Actionsのセットアップ][1]と組織のワークフローポリシーを確認してください。 [1]: https://code.claude.com/docs/en/github-actions ## インストール 対象リポジトリの Claude Code から `/install-github-app` を実行し、プロンプトに従って GitHub App をインストールします。Anthropic 認証情報の作成を促された場合は、保存する前に停止してください。このガイドでは Anthropic 認証情報の代わりに RunAPI リポジトリまたは組織のシークレットを使用します。 手動設定の場合は、[Claude GitHub App][1]をインストールし、`.github/workflows/claude.yml`に以下のワークフローを追加してください。 [1]: https://github.com/apps/claude ## RunAPIを設定する `RUNAPI_API_KEY`という名前のリポジトリまたは組織のActionsシークレットを作成します。アクションのシークレット入力のみを通じて渡してください： ```yaml anthropic_api_key: ${{ secrets.RUNAPI_API_KEY }} ``` ワークフローファイルやアクションの`settings` JSONにキーを記載しないでください。 アクションはsettingsを別途処理します。機密性のないBase URLのみをそこに記載してください。 以下の最小限のインタラクティブワークフローは、新しいissueとプルリクエストのレビューコメントを待ち受けます： ```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" ``` ### シークレット GitHub は、フォークプルリクエストや Dependabot イベントからトリガーされたワークフローには通常の Actions シークレットを渡しません。実行に認証情報がない場合は、RunAPI キーをローテーションする前にイベントソースを確認してください。リポジトリおよび組織スコープについては、GitHub の [Actions シークレットガイド][1]を参照してください。 [1]: https://docs.github.com/en/actions/how-tos/write-workflows/choose-what-workflows-do/use-secrets ### 権限 * `contents: write` により、アクションはコードの変更をコミットできます。 * `pull-requests: write` および `issues: write` により、トリガーとなった会話の読み取りと返信ができます。 * `id-token: write` は、アクションのデフォルトGitHub App認証をサポートします。 * `actions: read` により、ワークフローの結果を確認できます。 `write-all` の代わりにこれらの明示的な権限を使用してください。ワークフローで必要のない機能は削除してください。 ### トリガーイベント `issue_comment` はIssueおよびプルリクエストの会話内のコメントを対象とし、`pull_request_review_comment` はdiff行のコメントを対象とします。`issue_comment` でワークフローをトリガーするには、ワークフローファイルがデフォルトブランチに存在している必要があります。このアクションは実行を開始したユーザーも確認します。正規のリファレンスとして [公式のセキュリティ動作][1] を参照してください。 [1]: https://code.claude.com/docs/en/github-actions#who-can-trigger-runs ## モデルを選択する `claude_args` 内の `YOUR_RUNAPI_MODEL_ID` を[モデルカタログ](https://runapi.ai/ja/models)の正確な識別子に置き換えてください。モデルの選択を `settings.env` の外に置くことで、ワークフローで選択したモデルがアクション設定に表示されます。 ## 検証 1. `RUNAPI_API_KEY` シークレットが値を表示せずに存在することを確認してください。 2. ワークフローをデフォルトブランチにマージし、Actionsが有効になっていることを確認してください。 3. リポジトリへの書き込みアクセス権を持つアカウントから、Issueのコメントに `@claude describe this repository in one sentence` を追加してください。 4. ワークフローの実行を開き、アクションが成功したことを確認し、Claudeが同じIssueに返信していることを確認してください。 ## トラブルシューティング * **ワークフローが開始しない:** ファイルがデフォルトブランチにあること、コメントイベントが一致すること、Actions が有効であることを確認してください。 * **ジョブがスキップされる:** コメントに `@claude` が含まれており、アクターが必要なリポジトリのアクセス権を持っていることを確認してください。 * **認証に失敗する:** ワークフローが `secrets.RUNAPI_API_KEY` を参照していることを確認し、必要であれば[認証ガイド](https://runapi.ai/ja/docs/guides/authentication.md)からキーをローテーションしてください。 * **フォークのプルリクエストがキーを使用できない:** GitHub はフォークによってトリガーされた実行では通常のシークレットを意図的に提供しません。シークレットをリテラルに置き換えないでください。 * **モデルが利用できない:** [モデルカタログ](https://runapi.ai/ja/models)から正確な識別子をコピーしてください。 * **Claude のコミットが別のワークフローを開始しない:** 公式アクションの [GitHub token troubleshooting][1] を確認してください。 [1]: https://code.claude.com/docs/en/github-actions#ci-not-running-on-claudes-commits ## 次のステップ プロトコルの動作については [LLM API quickstart](https://runapi.ai/ja/docs/guides/llm-api/quickstart.md) を、リクエストフィールドについては [Anthropic Messages API Reference](https://runapi.ai/ja/docs/api/anthropic/messages.md) を参照してください。さらに多くのトリガーやアクション入力については、[公式サンプル][1] および [設定リファレンス][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 --- ## RunAPI のその他の情報 - [ホーム](https://runapi.ai/ja/.md) - [モデルカタログ](https://runapi.ai/ja/models.md) - [料金](https://runapi.ai/ja/pricing.md) - [プロバイダー](https://runapi.ai/ja/models) - [ドキュメント](https://runapi.ai/ja/docs/guides) - [SDK](https://runapi.ai/ja/sdk.md) - [CLI](https://runapi.ai/ja/cli.md) - [MCP Server](https://runapi.ai/ja/mcp.md) - [Claude Code と Cursor](https://runapi.ai/ja/claude-code-vs-cursor.md) - [Cursor API セットアップ](https://runapi.ai/ja/cursor-api-setup.md) - [RunAPI と OpenRouter の比較](https://runapi.ai/ja/openrouter-alternative.md) - [エンタープライズ](https://runapi.ai/ja/contact.md) - [お問い合わせ](https://runapi.ai/ja/contact.md) - [利用規約](https://runapi.ai/ja/terms.md) - [プライバシー](https://runapi.ai/ja/privacy.md) - [エージェント向けサイトインデックス](https://runapi.ai/llms.txt) お問い合わせ: contact@runapi.ai ## 構造化データ ```json [ { "@context": "https://schema.org", "inLanguage": "ja", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/ja", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/ja/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "ja", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/ja", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/jaicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "ja", "@type": "TechArticle", "headline": "Claude Code GitHub Actions", "description": "RunAPIシークレット、モデル、権限、トリガー、および最小限のワークフローでClaude Code GitHub Actionsを設定します。", "url": "https://runapi.ai/ja/docs/resources/tool-integrations/claude-code-github-actions", "mainEntityOfPage": "https://runapi.ai/ja/docs/resources/tool-integrations/claude-code-github-actions" } ] ```