GitHub Actions - Anthropic

Claude Code GitHub Actions membawa otomatisasi berbasis AI ke alur kerja GitHub Anda. Dengan menyebutkan @claude di PR atau masalah apa pun, Claude dapat menganalisis kode Anda, membuat pull request, mengimplementasikan fitur, dan memperbaiki bug - semuanya sambil mengikuti standar proyek Anda.

Claude Code GitHub Actions saat ini dalam versi beta. Fitur dan fungsionalitas mungkin berkembang seiring kami menyempurnakan pengalaman.

Claude Code GitHub Actions dibangun di atas Claude Code SDK, yang memungkinkan integrasi terprogram Claude Code ke dalam aplikasi Anda. Anda dapat menggunakan SDK untuk membangun alur kerja otomatisasi kustom di luar GitHub Actions.

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 masalah menjadi kode yang berfungsi dengan satu perintah
Mengikuti standar Anda: Claude menghormati pedoman CLAUDE.md dan pola kode yang ada
Pengaturan 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 Actions 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 menggunakan ini untuk membangun alur kerja kustom apa pun di atas Claude Code.

Lihat repositori →

Claude Code Action (Base)

Fondasi untuk membangun alur kerja GitHub kustom dengan Claude. Kerangka kerja yang dapat diperluas ini memberi Anda akses penuh ke kemampuan Claude untuk membuat otomatisasi yang disesuaikan.

Lihat repositori →

Mulai cepat

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

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

Anda harus menjadi admin repositori untuk menginstal aplikasi GitHub dan menambahkan rahasia
Metode mulai cepat ini hanya tersedia untuk pengguna API Anthropic langsung. Jika Anda menggunakan AWS Bedrock atau Google Vertex AI, silakan lihat bagian Menggunakan dengan AWS Bedrock & Google Vertex AI.

Jika skrip pengaturan gagal

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

Instal aplikasi GitHub Claude ke repositori Anda: https://github.com/apps/claude
Tambahkan ANTHROPIC_API_KEY ke rahasia repositori Anda (Pelajari cara menggunakan rahasia di GitHub Actions)
Salin file alur kerja dari examples/claude.yml ke .github/workflows/ repositori Anda

Uji tindakan

Setelah menyelesaikan pengaturan cepat atau manual, uji tindakan dengan menandai @claude dalam komentar masalah atau PR!

Contoh kasus penggunaan

Claude Code GitHub Actions dapat membantu Anda dengan berbagai tugas. Untuk contoh kerja lengkap, lihat direktori contoh.

Ubah masalah menjadi PR

# In an issue comment:
@claude implement this feature based on the issue description

Claude akan menganalisis masalah, menulis kode, dan membuat PR untuk ditinjau.

Dapatkan bantuan implementasi

# In a PR comment:
@claude how should I implement user authentication for this endpoint?

Claude akan menganalisis kode Anda dan memberikan panduan implementasi yang spesifik.

Perbaiki bug dengan cepat

# In an issue:
@claude fix the TypeError in the user dashboard component

Claude akan menemukan bug, mengimplementasikan perbaikan, dan membuat PR.

Praktik terbaik

Konfigurasi CLAUDE.md

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

Pertimbangan keamanan

⚠️ PENTING: Jangan pernah menyimpan kunci API langsung ke repositori Anda!

Selalu gunakan GitHub Secrets untuk kunci API:

Tambahkan kunci API Anda sebagai rahasia repositori bernama ANTHROPIC_API_KEY
Referensikan dalam alur kerja: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
Batasi izin tindakan hanya pada yang diperlukan
Tinjau saran Claude sebelum menggabungkan

Selalu gunakan GitHub Secrets (misalnya, ${{ secrets.ANTHROPIC_API_KEY }}) daripada mengkodekan kunci API secara langsung dalam file alur kerja Anda.

Mengoptimalkan kinerja

Gunakan template masalah untuk memberikan konteks, jaga CLAUDE.md Anda tetap ringkas dan fokus, dan konfigurasikan batas waktu yang sesuai untuk alur kerja Anda.

Biaya CI

Saat menggunakan Claude Code GitHub Actions, perhatikan biaya terkait:

Biaya GitHub Actions:

Claude Code berjalan pada runner yang dihosting GitHub, yang mengkonsumsi menit GitHub Actions Anda
Lihat dokumentasi penagihan GitHub untuk harga terperinci dan batas menit

Biaya API:

Setiap interaksi Claude mengkonsumsi token API berdasarkan panjang prompt dan respons
Penggunaan token bervariasi berdasarkan kompleksitas tugas dan ukuran basis kode
Lihat halaman harga Claude untuk tarif token saat ini

Tips optimasi biaya:

Gunakan perintah @claude spesifik untuk mengurangi panggilan API yang tidak perlu
Konfigurasikan batas max_turns yang sesuai untuk mencegah iterasi berlebihan
Tetapkan timeout_minutes yang wajar untuk menghindari alur kerja yang tidak terkendali
Pertimbangkan untuk menggunakan kontrol konkurensi GitHub untuk membatasi proses paralel

Contoh konfigurasi

Untuk konfigurasi alur kerja siap pakai untuk berbagai kasus penggunaan, termasuk:

Pengaturan alur kerja dasar untuk komentar masalah dan PR
Tinjauan kode otomatis pada pull request
Implementasi kustom untuk kebutuhan spesifik

Kunjungi direktori contoh di repositori Claude Code Action.

Repositori contoh mencakup alur kerja lengkap dan teruji yang dapat Anda salin langsung ke direktori .github/workflows/ Anda.

Menggunakan dengan AWS Bedrock & Google Vertex AI

Untuk lingkungan perusahaan, 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 mengatur Claude Code GitHub Actions dengan penyedia cloud, Anda memerlukan:

Untuk Google Cloud Vertex AI:

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

Untuk AWS Bedrock:

Akun AWS dengan Amazon Bedrock diaktifkan
Penyedia Identitas GitHub OIDC dikonfigurasi di AWS
Peran IAM dengan izin Bedrock
Aplikasi GitHub (direkomendasikan) atau gunakan GITHUB_TOKEN default

Buat aplikasi GitHub kustom (Direkomendasikan untuk Penyedia 3P)

Untuk kontrol dan keamanan terbaik saat menggunakan penyedia 3P seperti Vertex AI atau Bedrock, kami merekomendasikan membuat aplikasi GitHub Anda sendiri:

Buka https://github.com/settings/apps/new
Isi informasi dasar:
- Nama aplikasi GitHub: Pilih nama unik (misalnya, “YourOrg Claude Assistant”)
- URL Beranda: Situs web organisasi Anda atau URL repositori
Konfigurasikan pengaturan aplikasi:
- Webhooks: Hapus centang “Active” (tidak diperlukan untuk integrasi ini)
Tetapkan izin yang diperlukan:
- Izin repositori:
  - Konten: Baca & Tulis
  - Masalah: Baca & Tulis
  - Pull request: Baca & Tulis
Klik “Buat Aplikasi GitHub”
Setelah pembuatan, klik “Hasilkan kunci pribadi” dan simpan file .pem yang diunduh
Catat ID Aplikasi Anda dari halaman pengaturan aplikasi
Instal aplikasi ke repositori Anda:
- Dari halaman pengaturan aplikasi Anda, klik “Instal Aplikasi” di sidebar kiri
- Pilih akun atau organisasi Anda
- Pilih “Hanya pilih repositori” dan pilih repositori tertentu
- Klik “Instal”
Tambahkan kunci pribadi sebagai rahasia ke repositori Anda:
- Buka Pengaturan repositori Anda → Rahasia dan variabel → Tindakan
- Buat rahasia baru bernama APP_PRIVATE_KEY dengan isi file .pem
Tambahkan ID Aplikasi sebagai rahasia:

Buat rahasia baru bernama APP_ID dengan ID Aplikasi GitHub Anda

Aplikasi ini akan digunakan dengan tindakan actions/create-github-app-token untuk menghasilkan token otentikasi dalam alur kerja Anda.

Alternatif untuk API Anthropic atau jika Anda tidak ingin mengatur aplikasi Github sendiri: Gunakan aplikasi resmi Anthropic:

Instal dari: https://github.com/apps/claude
Tidak diperlukan konfigurasi tambahan untuk otentikasi

Konfigurasikan otentikasi penyedia cloud

Pilih penyedia cloud Anda dan siapkan otentikasi yang aman:

AWS Bedrock

Google Vertex AI

Tambahkan Rahasia yang Diperlukan

Tambahkan rahasia berikut ke repositori Anda (Pengaturan → Rahasia dan variabel → Tindakan):

Untuk API Anthropic (Langsung):

Untuk Otentikasi API:
- ANTHROPIC_API_KEY: Kunci API Anthropic Anda dari console.anthropic.com
Untuk Aplikasi GitHub (jika menggunakan aplikasi Anda sendiri):
- APP_ID: ID Aplikasi GitHub Anda
- APP_PRIVATE_KEY: Konten kunci pribadi (.pem)

Untuk Google Cloud Vertex AI

Untuk Otentikasi GCP:
- GCP_WORKLOAD_IDENTITY_PROVIDER
- GCP_SERVICE_ACCOUNT
Untuk Aplikasi GitHub (jika menggunakan aplikasi Anda sendiri):
- APP_ID: ID Aplikasi GitHub Anda
- APP_PRIVATE_KEY: Konten kunci pribadi (.pem)

Untuk AWS Bedrock

Untuk Otentikasi AWS:
- AWS_ROLE_TO_ASSUME
Untuk Aplikasi GitHub (jika menggunakan aplikasi Anda sendiri):
- APP_ID: ID Aplikasi GitHub Anda
- APP_PRIVATE_KEY: Konten kunci pribadi (.pem)

Buat file alur kerja

Buat file alur kerja GitHub Actions yang terintegrasi dengan penyedia cloud Anda. Contoh di bawah ini menunjukkan konfigurasi lengkap untuk AWS Bedrock dan Google Vertex AI:

Alur kerja AWS Bedrock

Prasyarat:

Akses AWS Bedrock diaktifkan dengan izin model Claude
GitHub dikonfigurasi sebagai penyedia identitas OIDC di AWS
Peran IAM dengan izin Bedrock yang mempercayai GitHub Actions

Rahasia GitHub yang diperlukan:

Nama Rahasia	Deskripsi
`AWS_ROLE_TO_ASSUME`	ARN dari peran IAM untuk akses Bedrock
`APP_ID`	ID Aplikasi GitHub Anda (dari pengaturan aplikasi)
`APP_PRIVATE_KEY`	Kunci pribadi yang Anda hasilkan untuk Aplikasi GitHub Anda

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: ./.github/actions/claude-pr-action
        with:
          trigger_phrase: "@claude"
          timeout_minutes: "60"
          github_token: ${{ steps.app-token.outputs.token }}
          use_bedrock: "true"
          model: "us.anthropic.claude-3-7-sonnet-20250219-v1:0"

Format ID model untuk Bedrock mencakup prefiks wilayah (misalnya, us.anthropic.claude...) dan akhiran versi.

Alur kerja Google Vertex AI

Prasyarat:

API Vertex AI diaktifkan di proyek GCP Anda
Workload Identity Federation dikonfigurasi untuk GitHub
Akun layanan dengan izin Vertex AI

Rahasia GitHub yang diperlukan:

Nama Rahasia	Deskripsi
`GCP_WORKLOAD_IDENTITY_PROVIDER`	Nama sumber daya penyedia identitas workload
`GCP_SERVICE_ACCOUNT`	Email akun layanan dengan akses Vertex AI
`APP_ID`	ID Aplikasi GitHub Anda (dari pengaturan aplikasi)
`APP_PRIVATE_KEY`	Kunci pribadi yang Anda hasilkan untuk Aplikasi GitHub Anda

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: ./.github/actions/claude-pr-action
        with:
          trigger_phrase: "@claude"
          timeout_minutes: "60"
          github_token: ${{ steps.app-token.outputs.token }}
          use_vertex: "true"
          model: "claude-3-7-sonnet@20250219"
        env:
          ANTHROPIC_VERTEX_PROJECT_ID: ${{ steps.auth.outputs.project_id }}
          CLOUD_ML_REGION: us-east5
          VERTEX_REGION_CLAUDE_3_7_SONNET: us-east5

ID proyek diambil secara otomatis dari langkah otentikasi Google Cloud, sehingga Anda tidak perlu mengkodekannya secara langsung.

Pemecahan masalah

Claude tidak merespons perintah @claude

Verifikasi bahwa Aplikasi GitHub diinstal dengan benar, periksa bahwa alur kerja diaktifkan, pastikan kunci API diatur dalam rahasia repositori, dan konfirmasi bahwa komentar berisi @claude (bukan /claude).

CI tidak berjalan pada commit Claude

Pastikan Anda menggunakan Aplikasi GitHub atau aplikasi kustom (bukan pengguna Actions), periksa pemicu alur kerja termasuk peristiwa yang diperlukan, dan verifikasi izin aplikasi termasuk pemicu CI.

Kesalahan otentikasi

Konfirmasi kunci API valid dan memiliki izin yang cukup. Untuk Bedrock/Vertex, periksa konfigurasi kredensial dan pastikan rahasia diberi nama dengan benar dalam alur kerja.

Konfigurasi lanjutan

Parameter tindakan

Claude Code Action mendukung parameter kunci ini:

Parameter	Deskripsi	Diperlukan
`prompt`	Prompt yang dikirim ke Claude	Ya*
`prompt_file`	Jalur ke file yang berisi prompt	Ya*
`anthropic_api_key`	Kunci API Anthropic	Ya**
`max_turns`	Putaran percakapan maksimum	Tidak
`timeout_minutes`	Batas waktu eksekusi	Tidak

*Salah satu prompt atau prompt_file diperlukan
**Diperlukan untuk API Anthropic langsung, tidak untuk Bedrock/Vertex

Metode integrasi alternatif

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

Aplikasi GitHub Kustom: Untuk organisasi yang membutuhkan nama pengguna bermerek atau alur otentikasi kustom. Buat Aplikasi GitHub Anda sendiri dengan izin yang diperlukan (konten, masalah, pull request) dan gunakan tindakan actions/create-github-app-token untuk menghasilkan token dalam alur kerja Anda.
GitHub Actions Manual: Konfigurasi alur kerja langsung untuk fleksibilitas maksimum
Konfigurasi MCP: Pemuatan dinamis server Model Context Protocol

Lihat repositori Claude Code Action untuk dokumentasi terperinci.

Menyesuaikan perilaku Claude

Anda dapat mengonfigurasi perilaku Claude dengan dua cara:

CLAUDE.md: Tentukan standar pengkodean, kriteria tinjauan, dan aturan khusus proyek dalam file CLAUDE.md di root repositori Anda. Claude akan mengikuti pedoman ini saat membuat PR dan merespons permintaan. Lihat dokumentasi Memory kami untuk detail lebih lanjut.
Prompt kustom: Gunakan parameter prompt dalam file alur kerja untuk memberikan instruksi khusus alur kerja. Ini memungkinkan Anda menyesuaikan perilaku Claude untuk alur kerja atau tugas yang berbeda.

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

Claude Code

​Mengapa menggunakan Claude Code GitHub Actions?

​Apa yang dapat dilakukan Claude?

​Claude Code Action

​Claude Code Action (Base)

​Mulai cepat

​Jika skrip pengaturan gagal

​Contoh kasus penggunaan

​Ubah masalah menjadi PR

​Dapatkan bantuan implementasi

​Perbaiki bug dengan cepat

​Praktik terbaik

​Konfigurasi CLAUDE.md

​Pertimbangan keamanan

​Mengoptimalkan kinerja

​Biaya CI

​Contoh konfigurasi

​Menggunakan dengan AWS Bedrock & Google Vertex AI

​Prasyarat

​Untuk Google Cloud Vertex AI:

​Untuk AWS Bedrock:

​Untuk API Anthropic (Langsung):

​Untuk Google Cloud Vertex AI

​Untuk AWS Bedrock

​Pemecahan masalah

​Claude tidak merespons perintah @claude

​CI tidak berjalan pada commit Claude

​Kesalahan otentikasi

​Konfigurasi lanjutan

​Parameter tindakan

​Metode integrasi alternatif

​Menyesuaikan perilaku Claude

Mengapa menggunakan Claude Code GitHub Actions?

Apa yang dapat dilakukan Claude?

Claude Code Action

Claude Code Action (Base)

Mulai cepat

Jika skrip pengaturan gagal

Contoh kasus penggunaan

Ubah masalah menjadi PR

Dapatkan bantuan implementasi

Perbaiki bug dengan cepat

Praktik terbaik

Konfigurasi CLAUDE.md

Pertimbangan keamanan

Mengoptimalkan kinerja

Biaya CI

Contoh konfigurasi

Menggunakan dengan AWS Bedrock & Google Vertex AI

Prasyarat

Untuk Google Cloud Vertex AI:

Untuk AWS Bedrock:

Untuk API Anthropic (Langsung):

Untuk Google Cloud Vertex AI

Untuk AWS Bedrock

Pemecahan masalah

Claude tidak merespons perintah @claude

CI tidak berjalan pada commit Claude

Kesalahan otentikasi

Konfigurasi lanjutan

Parameter tindakan

Metode integrasi alternatif

Menyesuaikan perilaku Claude