Claude Code GitHub Actions

• Code Review: ulasan otomatis pada setiap pull request, tanpa menulis alur kerja
• Claude Code di cloud: sesi Claude Code yang berjalan pada infrastruktur cloud alih-alih mesin Anda
• Claude Agent SDK: otomasi kustom di luar GitHub Actions. Claude Code GitHub Action dibangun di atas SDK
• GitHub Enterprise Server: Claude Code dengan GitHub yang di-host sendiri

​

Penyiapan

• Penyiapan cepat: jalankan /install-github-app dari Claude Code. Claude Code menginstal GitHub App, menambahkan rahasia autentikasi Anda, dan menyiapkan pull request alur kerja untuk Anda
• Penyiapan manual: instal aplikasi, tambahkan rahasia, dan salin file alur kerja ke repositori Anda sendiri. Gunakan jalur ini ketika Anda tidak menjalankan Claude Code secara lokal, ketika perintah gagal, atau ketika Anda menginginkan kontrol penuh atas file alur kerja

​

Penyiapan cepat

• Jika Claude Code sudah memiliki kunci API, Claude Code menggunakan kembali kunci tersebut, dan menawarkan untuk menyimpan rahasia ANTHROPIC_API_KEY yang ada di repositori jika sudah diatur
• Jika tidak, pilih antara membuat token jangka panjang dengan langganan Claude Anda dan menempel kunci API

• Jalankan /install-github-app lagi. Ketika repositori sudah memiliki claude.yml, pilih Update workflow file with latest version. Claude Code push salinan segar file alur kerja ke branch baru dan membuka pull request, sama seperti instalasi pertama.
• Tambahkan argumen --comment dan baris claude_args dari contoh alur kerja ulasan ke file yang di-check-in sendiri, yang menjaga edit lain yang Anda buat padanya.

​

Penyiapan manual

​

Penyiapan untuk organisasi

• Instal Claude GitHub App sekali di tingkat organisasi, memilih semua repositori atau daftar yang dipilih
• Simpan rahasia autentikasi sebagai rahasia Actions tingkat organisasi sehingga setiap repositori tidak perlu salinannya sendiri
• Tambahkan file alur kerja ke setiap repositori yang harus menjalankan Claude Code GitHub Action, atau tentukan pekerjaan sekali sebagai alur kerja yang dapat digunakan kembali yang setiap repositori panggil

• anthropic_federation_rule_id: ID aturan federasi, fdrl_...
• anthropic_organization_id: ID organisasi Anthropic Anda
• anthropic_service_account_id: ID akun layanan, svac_.... Opsional, karena aturan federasi yang Anda buat di Console sudah menargetkan akun layanan
• anthropic_workspace_id: ID workspace, wrkspc_.... Opsional ketika aturan federasi menargetkan workspace tunggal

​

Uninstal

• File alur kerja: hapus alur kerja yang menggunakan anthropics/claude-code-action dari .github/workflows/. Jika Anda menggunakan penyiapan cepat, cari claude.yml dan, jika Anda memilih alur kerja ulasan, claude-code-review.yml. Dengan alur kerja dihapus, Claude Code GitHub Action tidak lagi berjalan
• Rahasia: hapus rahasia ANTHROPIC_API_KEY atau CLAUDE_CODE_OAUTH_TOKEN dari repositori, dan dari rahasia Actions tingkat organisasi jika Anda membagikannya di seluruh repositori. Jika Anda menghapus rahasia, kredensial yang disimpannya tetap valid. Untuk pensiun kunci API sepenuhnya, juga hapus kunci di Claude Console
• GitHub App: uninstal Claude GitHub App di pengaturan repositori atau organisasi Anda di bawah GitHub Apps, tetapi hanya jika Anda tidak menggunakannya untuk fitur Claude lain, seperti Code Review atau web auto-fix

​

Izin GitHub App

​

Mode interaktif dan otomasi

• Mode interaktif: ketika alur kerja tidak menyediakan input prompt, Claude menunggu frasa pemicu, @claude secara default, dalam komentar issue atau pull request, dalam ulasan pull request, atau dalam badan atau judul issue yang baru dibuka, kemudian merespons permintaan tersebut. Kemajuan dan hasil muncul sebagai komentar pada issue atau PR yang memicu.
• Mode otomasi: ketika alur kerja menyediakan input prompt, Claude berjalan tanpa menunggu penyebutan, tunduk hanya pada pemeriksaan siapa yang dapat memicu run. Secara default, hasil muncul dalam log run alur kerja daripada komentar. Claude dapat memposting ke issue atau pull request ketika prompt mengarahkannya dan memiliki alat yang dapat memposting, seperti dalam contoh code-review.

​

Siapa yang dapat memicu run

• Akses tulis: pada event issue dan pull request, pengguna pemicu harus memiliki akses tulis ke repositori. Untuk memungkinkan pengguna tertentu tanpa akses tulis, atur allowed_non_write_users dan teruskan input github_token Anda sendiri. Event yang tidak ada pengguna yang mengarang, seperti pemicu schedule, lewati pemeriksaan ini.
• Aktor manusia: pada setiap event, Claude Code GitHub Action menolak aktor bot kecuali Anda mencantumkannya di allowed_bots, yang menjaga bot agar tidak memicu Claude dalam loop. Pemeriksaan ini juga berlaku untuk run terjadwal, yang GitHub atribusikan ke pengguna repositori, biasanya yang terakhir mengubah jadwal cron alur kerja. Jika pengguna itu adalah bot, cantumkan di allowed_bots.

​

Contoh kasus penggunaan

​

Merespons penyebutan @claude

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.ANTHROPIC_API_KEY }}

• id-token: write: diperlukan untuk autentikasi GitHub App default Claude Code GitHub Action
• actions: read: memungkinkan Claude membaca hasil CI pada PR
• actions/checkout: memberikan Claude salinan lokal repositori untuk dikerjakan
• if: menjaga runner agar tidak dimulai pada komentar yang tidak menyebutkan @claude. Claude Code GitHub Action juga memeriksa frasa pemicu itu sendiri sebelum merespons

@claude implement this feature based on the issue description
@claude how should I implement user authentication for this endpoint?
@claude fix the TypeError in the user dashboard component

​

Jalankan skill

• Untuk skill di direktori .claude/skills/ repositori Anda, jalankan actions/checkout sebelum langkah anthropics/claude-code-action sehingga file skill tersedia di runner, kemudian teruskan /skill-name sebagai prompt.
• Untuk skill yang dikemas dalam plugin, instal plugin dengan input plugin_marketplaces dan plugins, kemudian teruskan /plugin-name:skill-name dengan namespace sebagai prompt. Input plugins mengambil plugin-name@marketplace-name, di mana nama marketplace berasal dari manifest marketplace itu sendiri daripada URL repositorinya.

name: Code Review
on:
  pull_request:
    types: [opened, synchronize, ready_for_review, reopened]
jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: read
      issues: read
      id-token: write
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          plugin_marketplaces: "https://github.com/anthropics/claude-code.git"
          plugins: "code-review@claude-code-plugins"
          prompt: "/code-review:code-review --comment ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"
          claude_args: '--allowedTools "mcp__github_inline_comment__create_inline_comment"'

• --comment: Claude memposting ulasannya di pull request, sebagai komentar inline pada setiap issue yang ditemukannya atau sebagai satu komentar ringkasan ketika tidak menemukan apa pun. Tanpanya, Claude tidak memposting apa pun, dan Anda membaca temuan dalam log run alur kerja.
• claude_args: simpan baris ini meskipun frontmatter allowed-tools skill itu sendiri menamai alat yang sama, karena Claude Code GitHub Action memulai server MCP yang memposting komentar inline hanya ketika --allowedTools di claude_args menamakannya.

​

Jalankan pada jadwal

name: Daily Report
on:
  schedule:
    - cron: "0 9 * * *"
jobs:
  report:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      issues: read
      id-token: write
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "Generate a summary of yesterday's commits and open issues"
          claude_args: |
            --model claude-opus-5-5
            --allowedTools "mcp__github__list_commits,mcp__github__list_issues"

​

Praktik terbaik

​

Tentukan standar proyek di CLAUDE.md

​

Lindungi kredensial Anda

​

Kelola biaya

• Menit GitHub Actions: Claude Code GitHub Action berjalan di runner yang dihosting GitHub, yang mengonsumsi menit GitHub Actions Anda. Lihat dokumentasi penagihan GitHub untuk harga dan batas menit.
• Token API: setiap interaksi mengonsumsi token berdasarkan panjang prompt dan respons, kompleksitas tugas, dan ukuran codebase. Lihat halaman harga Claude untuk tarif token saat ini. Jika Anda mengautentikasi dengan token OAuth, run menggunakan langganan Claude Anda daripada penagihan API.

• Tulis permintaan @claude spesifik sehingga Claude memerlukan lebih sedikit turn untuk menyelesaikan
• Gunakan template issue untuk memberikan konteks di muka
• Jaga CLAUDE.md Anda ringkas, karena Claude membacanya pada setiap run
• Atur --max-turns di claude_args untuk membatasi iterasi
• Atur timeout tingkat alur kerja untuk menghindari pekerjaan yang tidak terkontrol
• Gunakan kontrol concurrency GitHub untuk membatasi run paralel

​

Gunakan penyedia cloud

• Amazon Bedrock: use_bedrock: "true"
• Google Cloud’s Agent Platform: use_vertex: "true"
• Microsoft Foundry: use_foundry: "true"

​

Troubleshooting

​

Claude tidak merespons perintah @claude

• Verifikasi GitHub App diinstal di repositori
• Periksa bahwa alur kerja diaktifkan untuk repositori
• Pastikan kunci API atau token OAuth diatur dalam rahasia repositori
• Konfirmkan komentar berisi @claude sebagai kata lengkap, bukan /claude atau @claude-bot
• Konfirmkan pengguna yang berkomentar memiliki akses tulis ke repositori. Lihat Siapa yang dapat memicu run untuk pengecualian

​

CI tidak berjalan pada commit Claude

• GitHub tidak memicu alur kerja pada commit yang dibuat dengan GITHUB_TOKEN default. Jika Anda meneruskan github_token: ${{ secrets.GITHUB_TOKEN }} ke Claude Code GitHub Action, hapus sehingga mengautentikasi sebagai Claude GitHub App, atau teruskan token aplikasi kustom sebagai gantinya
• Periksa bahwa pemicu alur kerja CI Anda mencakup event yang push Claude hasilkan, seperti push atau pull_request

​

Kesalahan autentikasi

• Konfirmkan kunci API atau token OAuth valid dengan mengujinya secara lokal dengan claude sebelum men-debug alur kerja
• Untuk Bedrock, Agent Platform, dan Foundry, lihat bagian troubleshooting halaman penyedia cloud

​

Konfigurasi lanjutan

​

Parameter action

​

Teruskan argumen CLI

claude_args: "--max-turns 5 --model claude-sonnet-5 --mcp-config /path/to/config.json"

• --max-turns: batasi jumlah conversation turn
• --model: model yang digunakan, misalnya claude-sonnet-5. Tanpa argumen ini, Claude Code GitHub Action menggunakan model default Claude Code
• --mcp-config: path ke konfigurasi MCP
• --allowedTools: daftar alat yang diizinkan yang dipisahkan koma. Alias --allowed-tools juga berfungsi
• --debug: aktifkan output debug

​

Upgrade dari beta

1. Ubah @beta menjadi @v1 dalam baris uses
2. Hapus input mode, karena Claude Code GitHub Action sekarang mendeteksi mode secara otomatis
3. Ganti direct_prompt dengan prompt
4. Pindahkan opsi CLI seperti max_turns dan model ke claude_args. custom_instructions tidak memiliki flag dengan nama yang sama dan menjadi --append-system-prompt

​

Apa selanjutnya

• Gunakan Claude Code GitHub Actions dengan penyedia cloud: rutekan inferensi melalui Amazon Bedrock, Google Cloud’s Agent Platform, atau Microsoft Foundry
• Referensi konfigurasi: daftar lengkap input action
• Direktori examples: alur kerja siap pakai untuk skenario lebih lanjut
• Code Review: ulasan pull request otomatis tanpa memelihara file alur kerja