Claude Code GitHub Actions + Databricksのセットアップ手順

はじめに

Claude Code GitHub Actionsは、GitHub上でIssueやPull Requestに@claudeとメンションするだけでClaudeに開発タスクを依頼できるGitHub Actionです。本記事では、Databricksの基盤モデルAPIとしてホストされているClaudeをClaude Code GitHub Actionsのバックエンドとして利用する方法を紹介します。

なお、Claude Code + Databricksのセットアップ手順については以下記事をご覧ください。

注釈：本記事について

本記事の内容は独自検証の結果によるものです。Claude Code GitHub Actionsのaction.ymlを見ると、環境変数によってエンドポイント等を制御できる実装になっており、これを利用してDatabricksエンドポイントに接続しています。

ただし、DatabricksおよびAnthropicの公式ドキュメントに記載された方法ではないため、将来的に動作しなくなる可能性があります。

Claude Code GitHub Actionsのaction.ymlの抜粋

前提条件

• Databricksワークスペースへのアクセス権があること
• Databricksワークスペース上で個人アクセストークンを取得済みであること
• GitHubリポジトリがあり、Secrets/Variablesを設定できること

設定手順

1. GitHub Secretsの設定

リポジトリの Settings → Secrets and variables → Actions → Secrets タブで以下を設定します。

Name	Value
DATABRICKS_TOKEN	Databricks個人アクセストークン

2. GitHub Variablesの設定

同じ画面の Variables タブで以下を設定します。モデル名は2026年1月時点の例です。最新のモデル名はDatabricksワークスペースのサービングエンドポイントの一覧画面で確認してください。

Name	Value
ANTHROPIC_BASE_URL	https://your-workspace.cloud.databricks.com/serving-endpoints/anthropic
ANTHROPIC_CUSTOM_HEADERS	x-databricks-disable-beta-headers: true
ANTHROPIC_DEFAULT_OPUS_MODEL	databricks-claude-opus-4-5
ANTHROPIC_DEFAULT_SONNET_MODEL	databricks-claude-sonnet-4-5
ANTHROPIC_DEFAULT_HAIKU_MODEL	databricks-claude-haiku-4-5

3. ワークフローYAMLの作成

リポジトリに .github/workflows/claude.yml を作成し、以下の内容を記載します。

name: Claude Code (Databricks)
on:
  issues:
    types: [opened, assigned, labeled]
  issue_comment:
    types: [created]
  pull_request_review:
    types: [submitted]
  pull_request_review_comment:
    types: [created]

jobs:
  claude:
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write
      actions: read

    env:
      ANTHROPIC_AUTH_TOKEN: ${{ secrets.DATABRICKS_TOKEN }}
      ANTHROPIC_BASE_URL: ${{ vars.ANTHROPIC_BASE_URL }}
      ANTHROPIC_CUSTOM_HEADERS: ${{ vars.ANTHROPIC_CUSTOM_HEADERS }}
      ANTHROPIC_DEFAULT_OPUS_MODEL: ${{ vars.ANTHROPIC_DEFAULT_OPUS_MODEL }}
      ANTHROPIC_DEFAULT_SONNET_MODEL: ${{ vars.ANTHROPIC_DEFAULT_SONNET_MODEL }}
      ANTHROPIC_DEFAULT_HAIKU_MODEL: ${{ vars.ANTHROPIC_DEFAULT_HAIKU_MODEL }}

    steps:
      - name: Checkout repository
        uses: actions/checkout@v5
        with:
          fetch-depth: 1

      - name: Run Claude Code
        id: claude
        uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.DATABRICKS_TOKEN }}

ポイント:

• anthropic_api_key: actionのバリデーションを通すために必要
• ANTHROPIC_AUTH_TOKEN: Databricksエンドポイントの認証用（環境変数として設定）
• 両方に同じトークンを指定します

使い方

Issueで使う

Issueを作成し、本文または コメントに@claudeを含めます。

@claude このリポジトリのREADMEを改善してください

Pull Requestで使う

PRのコメントやレビューコメントに@claudeを含めます。

@claude このコードをレビューしてください

Claudeが処理を開始すると、コメントに進捗状況が表示されます。

ActionsからClaudeの処理内容を確認できます。

トラブルシューティング

デバッグ方法: show_full_outputを有効化

エラーの詳細を確認するには、show_full_output: "true"を一時的に有効化します。

      - name: Run Claude Code
        id: claude
        uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.DATABRICKS_TOKEN }}
          show_full_output: "true"  # デバッグ用に追加

注意: show_full_output: "true"はセンシティブな情報がログに出力される可能性があるため、デバッグ後は必ず削除してください。

401エラー: 認証エラー

API Error: 401 Credential was not sent or was of an unsupported type

原因: 認証情報が正しく渡されていない

対処法: 環境変数にANTHROPIC_AUTH_TOKENが設定されているか確認してください。

    env:
      ANTHROPIC_AUTH_TOKEN: ${{ secrets.DATABRICKS_TOKEN }}

403エラー: IP Access Listによるブロック

API Error: 403 Source IP address: xx.xx.xx.xx is blocked by Databricks IP ACL

原因: GitHub ActionsのIPアドレスがDatabricksワークスペースでブロックされている

対処法: DatabricksワークスペースのIP Access List設定を確認するか、Self-hosted runnerの利用を検討してください。

おわりに

本記事では、Databricksの基盤モデルAPIでホストされているClaudeをClaude Code Actionから利用する方法を紹介しました。

この構成により、以下のことが可能になります。

• GitHub上でIssueやPRに@claudeとメンションするだけでClaudeを呼び出せる
• Databricksでホストされているモデルを使うことで、既存のインフラを活用できる

繰り返しになりますが、本記事は独自検証の結果であり、公式にドキュメント化された方法ではありません。本番環境で使用する場合は、十分な検証を行ってください。