GitHub Actions
Integrasikan Claude Code dengan alur kerja GitHub Anda untuk tinjauan kode otomatis, manajemen PR, dan triase masalah.
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.
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.
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
Claude akan menganalisis masalah, menulis kode, dan membuat PR untuk ditinjau.
Dapatkan bantuan implementasi
Claude akan menganalisis kode Anda dan memberikan panduan implementasi yang spesifik.
Perbaiki bug dengan cepat
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
- Izin repositori:
- 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:
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 AndaAPP_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 AndaAPP_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 AndaAPP_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:
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.