Claude Code GitHub Actions

Pelajari tentang integrasi Claude Code ke dalam alur kerja pengembangan Anda dengan Claude Code GitHub Actions

Claude Code GitHub Actions membawa otomasi bertenaga AI ke alur kerja GitHub Anda. Dengan penyebutan @claude sederhana di PR atau issue apa pun, Claude dapat menganalisis kode Anda, membuat pull request, mengimplementasikan fitur, dan memperbaiki bug - semuanya sambil mengikuti standar proyek Anda. Untuk ulasan otomatis yang diposting di setiap PR tanpa pemicu, lihat GitHub Code Review.

Mengapa menggunakan Claude Code GitHub Actions?

• Pembuatan PR instan: Jelaskan apa yang Anda butuhkan, dan Claude membuat PR lengkap dengan semua perubahan yang diperlukan
• Implementasi kode otomatis: Ubah issue menjadi kode yang berfungsi dengan satu perintah
• Mengikuti standar Anda: Claude menghormati panduan CLAUDE.md Anda dan pola kode yang ada
• Penyiapan sederhana: Mulai dalam hitungan menit dengan installer dan kunci API kami
• Aman secara default: Kode Anda tetap berada di runner Github

Apa yang dapat dilakukan Claude?

Claude Code menyediakan GitHub Action yang kuat yang mengubah cara Anda bekerja dengan kode:

Claude Code Action

GitHub Action ini memungkinkan Anda menjalankan Claude Code dalam alur kerja GitHub Actions Anda. Anda dapat menggunakannya untuk membangun alur kerja kustom apa pun di atas Claude Code.

Lihat repositori →

Penyiapan

Penyiapan cepat

Cara termudah untuk menyiapkan action ini adalah melalui Claude Code di terminal. Cukup buka claude dan jalankan /install-github-app.

Perintah ini akan memandu Anda melalui penyiapan aplikasi GitHub dan rahasia yang diperlukan.

Penyiapan manual

Jika perintah /install-github-app gagal atau Anda lebih suka penyiapan manual, silakan ikuti instruksi penyiapan manual ini:

1. Instal aplikasi Claude GitHub ke repositori Anda: https://github.com/apps/claude

   Aplikasi Claude GitHub memerlukan izin repositori berikut:

   • Contents: Baca & tulis (untuk memodifikasi file repositori)
   • Issues: Baca & tulis (untuk merespons issue)
   • Pull requests: Baca & tulis (untuk membuat PR dan push perubahan)

   Untuk detail lebih lanjut tentang keamanan dan izin, lihat dokumentasi keamanan.

2. Tambahkan ANTHROPIC_API_KEY ke rahasia repositori Anda (Pelajari cara menggunakan rahasia di GitHub Actions)

3. Salin file workflow dari examples/claude.yml ke dalam direktori .github/workflows/ repositori Anda

Upgrade dari Beta

Jika Anda saat ini menggunakan versi beta Claude Code GitHub Actions, kami merekomendasikan untuk memperbarui workflow Anda agar menggunakan versi GA. Versi baru menyederhanakan konfigurasi sambil menambahkan fitur baru yang kuat seperti deteksi mode otomatis.

Perubahan penting

Semua pengguna beta harus membuat perubahan ini pada file workflow mereka untuk upgrade:

1. Perbarui versi action: Ubah @beta menjadi @v1
2. Hapus konfigurasi mode: Hapus mode: "tag" atau mode: "agent" (sekarang terdeteksi otomatis)
3. Perbarui input prompt: Ganti direct_prompt dengan prompt
4. Pindahkan opsi CLI: Konversi max_turns, model, custom_instructions, dll. ke claude_args

Breaking Changes Reference

Contoh Sebelum dan Sesudah

Versi beta:

- uses: anthropics/claude-code-action@beta
  with:
    mode: "tag"
    direct_prompt: "Review this PR for security issues"
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    custom_instructions: "Follow our coding standards"
    max_turns: "10"
    model: "claude-sonnet-4-6"

Versi GA (v1.0):

- uses: anthropics/claude-code-action@v1
  with:
    prompt: "Review this PR for security issues"
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    claude_args: |
      --append-system-prompt "Follow our coding standards"
      --max-turns 10
      --model claude-sonnet-4-6

Contoh kasus penggunaan

Claude Code GitHub Actions dapat membantu Anda dengan berbagai tugas. Direktori examples berisi workflow siap pakai untuk skenario berbeda.

Workflow dasar

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          # Responds to @claude mentions in comments

Menggunakan skills

Input prompt menerima skill invocation serta teks biasa:

• Untuk skill di direktori .claude/skills/ repositori Anda, jalankan actions/checkout sebelum langkah action dan berikan /skill-name.
• Untuk skill yang dikemas dalam plugin, instal plugin dengan input plugin_marketplaces dan plugins serta berikan /plugin-name:skill-name dengan namespace.

Workflow berikut menginstal plugin code-review dan menjalankan skillnya pada setiap pull request baru atau yang diperbarui:

name: Code Review
on:
  pull_request:
    types: [opened, synchronize]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - 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 ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"

Otomasi kustom dengan prompt

name: Daily Report
on:
  schedule:
    - cron: "0 9 * * *"
jobs:
  report:
    runs-on: ubuntu-latest
    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 opus"

Kasus penggunaan umum

Dalam komentar issue atau PR:

@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

Claude akan secara otomatis menganalisis konteks dan merespons dengan tepat.

Praktik terbaik

Konfigurasi CLAUDE.md

Buat file CLAUDE.md di root repositori Anda untuk mendefinisikan panduan gaya kode, kriteria ulasan, aturan khusus proyek, dan pola yang disukai. File ini memandu pemahaman Claude tentang standar proyek Anda.

Pertimbangan keamanan

Untuk panduan keamanan komprehensif termasuk izin, autentikasi, dan praktik terbaik, lihat dokumentasi keamanan Claude Code Action.

Selalu gunakan GitHub Secrets untuk kunci API:

• Tambahkan kunci API Anda sebagai rahasia repositori bernama ANTHROPIC_API_KEY
• Referensikan dalam workflow: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
• Batasi izin action hanya untuk apa yang diperlukan
• Tinjau saran Claude sebelum merge

Selalu gunakan GitHub Secrets (misalnya, ${{ secrets.ANTHROPIC_API_KEY }}) daripada hardcoding kunci API langsung dalam file workflow Anda.

Mengoptimalkan kinerja

Gunakan template issue untuk memberikan konteks, jaga CLAUDE.md Anda ringkas dan terfokus, dan konfigurasikan timeout yang sesuai untuk workflow Anda.

Biaya CI

Saat menggunakan Claude Code GitHub Actions, waspadai biaya terkait:

Biaya GitHub Actions:

• Claude Code berjalan di runner yang dihosting GitHub, yang mengonsumsi menit GitHub Actions Anda
• Lihat dokumentasi penagihan GitHub untuk harga terperinci dan batas menit

Biaya API:

• Setiap interaksi Claude mengonsumsi token API berdasarkan panjang prompt dan respons
• Penggunaan token bervariasi menurut kompleksitas tugas dan ukuran codebase
• Lihat halaman harga Claude untuk tarif token saat ini

Tips optimasi biaya:

• Gunakan perintah @claude spesifik untuk mengurangi panggilan API yang tidak perlu
• Konfigurasikan --max-turns yang sesuai dalam claude_args untuk mencegah iterasi berlebihan
• Atur timeout tingkat workflow untuk menghindari pekerjaan yang tidak terkontrol
• Pertimbangkan menggunakan kontrol concurrency GitHub untuk membatasi run paralel

Contoh konfigurasi

Claude Code Action v1 menyederhanakan konfigurasi dengan parameter terpadu:

- uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    prompt: "Your instructions here" # Optional
    claude_args: "--max-turns 5" # Optional CLI arguments

Fitur utama:

• Antarmuka prompt terpadu - Gunakan prompt untuk semua instruksi
• Skills - Panggil skills yang terinstal langsung dari prompt
• Passthrough CLI - Argumen Claude Code CLI apa pun melalui claude_args
• Pemicu fleksibel - Bekerja dengan event GitHub apa pun

Kunjungi direktori examples untuk file workflow lengkap.

Menggunakan dengan Amazon Bedrock & Google Vertex AI

Untuk lingkungan enterprise, Anda dapat menggunakan Claude Code GitHub Actions dengan infrastruktur cloud Anda sendiri. Pendekatan ini memberi Anda kontrol atas residensi data dan penagihan sambil mempertahankan fungsionalitas yang sama.

Prasyarat

Sebelum menyiapkan Claude Code GitHub Actions dengan penyedia cloud, Anda memerlukan:

Untuk Google Cloud Vertex AI:

1. Proyek Google Cloud dengan Vertex AI diaktifkan
2. Workload Identity Federation dikonfigurasi untuk GitHub Actions
3. Akun layanan dengan izin yang diperlukan
4. Aplikasi GitHub (direkomendasikan) atau gunakan GITHUB_TOKEN default

Untuk Amazon Bedrock:

1. Akun AWS dengan Amazon Bedrock diaktifkan
2. GitHub OIDC Identity Provider dikonfigurasi di AWS
3. Peran IAM dengan izin Bedrock
4. Aplikasi GitHub (direkomendasikan) atau gunakan GITHUB_TOKEN default

name: Claude PR Action

permissions:
contents: write
pull-requests: write
issues: write
id-token: write

on:
issue_comment:
types: [created]
pull_request_review_comment:
types: [created]
issues:
types: [opened, assigned]

jobs:
claude-pr:
if: |
(github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
(github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
(github.event_name == 'issues' && contains(github.event.issue.body, '@claude'))
runs-on: ubuntu-latest
env:
AWS_REGION: us-west-2
steps:
- name: Checkout repository
uses: actions/checkout@v4

- name: Generate GitHub App token
id: app-token
uses: actions/create-github-app-token@v2
with:
app-id: ${{ secrets.APP_ID }}
private-key: ${{ secrets.APP_PRIVATE_KEY }}

- name: Configure AWS Credentials (OIDC)
uses: aws-actions/configure-aws-credentials@v4
with:
role-to-assume: ${{ secrets.AWS_ROLE_TO_ASSUME }}
aws-region: us-west-2

- uses: anthropics/claude-code-action@v1
with:
github_token: ${{ steps.app-token.outputs.token }}
use_bedrock: "true"
claude_args: '--model us.anthropic.claude-sonnet-4-6 --max-turns 10'

name: Claude PR Action

permissions:
contents: write
pull-requests: write
issues: write
id-token: write

on:
issue_comment:
types: [created]
pull_request_review_comment:
types: [created]
issues:
types: [opened, assigned]

jobs:
claude-pr:
if: |
(github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
(github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
(github.event_name == 'issues' && contains(github.event.issue.body, '@claude'))
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v4

- name: Generate GitHub App token
id: app-token
uses: actions/create-github-app-token@v2
with:
app-id: ${{ secrets.APP_ID }}
private-key: ${{ secrets.APP_PRIVATE_KEY }}

- name: Authenticate to Google Cloud
id: auth
uses: google-github-actions/auth@v2
with:
workload_identity_provider: ${{ secrets.GCP_WORKLOAD_IDENTITY_PROVIDER }}
service_account: ${{ secrets.GCP_SERVICE_ACCOUNT }}

- uses: anthropics/claude-code-action@v1
with:
github_token: ${{ steps.app-token.outputs.token }}
trigger_phrase: "@claude"
use_vertex: "true"
claude_args: '--model claude-sonnet-4-5@20250929 --max-turns 10'
env:
ANTHROPIC_VERTEX_PROJECT_ID: ${{ steps.auth.outputs.project_id }}
CLOUD_ML_REGION: us-east5
VERTEX_REGION_CLAUDE_4_5_SONNET: us-east5

Troubleshooting

Claude tidak merespons perintah @claude

Verifikasi aplikasi GitHub terinstal dengan benar, periksa bahwa workflow diaktifkan, pastikan kunci API diatur dalam rahasia repositori, dan konfirmkan komentar berisi @claude (bukan /claude).

CI tidak berjalan pada commit Claude

Pastikan Anda menggunakan aplikasi GitHub atau aplikasi kustom (bukan pengguna Actions), periksa pemicu workflow mencakup event yang diperlukan, dan verifikasi izin aplikasi mencakup pemicu CI.

Kesalahan autentikasi

Konfirmkan kunci API valid dan memiliki izin yang cukup. Untuk Bedrock/Vertex, periksa konfigurasi kredensial dan pastikan rahasia dinamai dengan benar dalam workflow.

Konfigurasi lanjutan

Parameter action

Claude Code Action v1 menggunakan konfigurasi yang disederhanakan:

*Prompt opsional - saat dihilangkan untuk komentar issue/PR, Claude merespons frasa pemicu
**Diperlukan untuk Claude API langsung, bukan untuk Bedrock/Vertex

Teruskan argumen CLI

Parameter claude_args menerima argumen Claude Code CLI apa pun:

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

Argumen umum:

• --max-turns: Maksimum conversation turns (default: 10)
• --model: Model yang digunakan (misalnya, claude-sonnet-4-6)
• --mcp-config: Path ke konfigurasi MCP
• --allowedTools: Daftar tools yang diizinkan dipisahkan koma. Alias --allowed-tools juga berfungsi.
• --debug: Aktifkan output debug

Metode integrasi alternatif

Meskipun perintah /install-github-app adalah pendekatan yang direkomendasikan, Anda juga dapat:

• Custom GitHub App: Untuk organisasi yang memerlukan nama pengguna bermerek atau alur autentikasi kustom. Buat aplikasi GitHub Anda sendiri dengan izin yang diperlukan (contents, issues, pull requests) dan gunakan action actions/create-github-app-token untuk menghasilkan token dalam workflow Anda.
• Manual GitHub Actions: Konfigurasi workflow langsung untuk fleksibilitas maksimal
• MCP Configuration: Pemuatan dinamis server Model Context Protocol

Lihat dokumentasi Claude Code Action untuk panduan terperinci tentang autentikasi, keamanan, dan konfigurasi lanjutan.

Menyesuaikan perilaku Claude

Anda dapat mengonfigurasi perilaku Claude dengan dua cara:

1. CLAUDE.md: Tentukan standar coding, kriteria ulasan, dan aturan khusus proyek dalam file CLAUDE.md di root repositori Anda. Claude akan mengikuti panduan ini saat membuat PR dan merespons permintaan. Lihat dokumentasi Memory kami untuk detail lebih lanjut.
2. Custom prompts: Gunakan parameter prompt dalam file workflow untuk memberikan instruksi khusus workflow. Ini memungkinkan Anda menyesuaikan perilaku Claude untuk workflow atau tugas berbeda.

Claude akan mengikuti panduan ini saat membuat PR dan merespons permintaan.