@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.
Claude Code GitHub Actions dibangun di atas Claude Agent SDK, yang memungkinkan integrasi programatik Claude Code ke dalam aplikasi Anda. Anda dapat menggunakan SDK untuk membangun alur kerja otomasi kustom di luar GitHub Actions.
Claude Opus 4.6 sekarang tersedia. Claude Code GitHub Actions default ke Sonnet. Untuk menggunakan Opus 4.6, konfigurasikan parameter model untuk menggunakan
claude-opus-4-6.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.mdAnda 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.
- Anda harus menjadi admin repositori untuk menginstal aplikasi GitHub dan menambahkan rahasia
- Aplikasi GitHub akan meminta izin baca & tulis untuk Contents, Issues, dan Pull requests
- Metode quickstart ini hanya tersedia untuk pengguna Claude API langsung. Jika Anda menggunakan AWS Bedrock atau Google Vertex AI, silakan lihat bagian Using with AWS Bedrock & Google Vertex AI.
Penyiapan manual
Jika perintah/install-github-app gagal atau Anda lebih suka penyiapan manual, silakan ikuti instruksi penyiapan manual ini:
-
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)
- Tambahkan ANTHROPIC_API_KEY ke rahasia repositori Anda (Pelajari cara menggunakan rahasia di GitHub Actions)
-
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:- Perbarui versi action: Ubah
@betamenjadi@v1 - Hapus konfigurasi mode: Hapus
mode: "tag"ataumode: "agent"(sekarang terdeteksi otomatis) - Perbarui input prompt: Ganti
direct_promptdenganprompt - Pindahkan opsi CLI: Konversi
max_turns,model,custom_instructions, dll. keclaude_args
Breaking Changes Reference
| Old Beta Input | New v1.0 Input |
|---|---|
mode | (Removed - auto-detected) |
direct_prompt | prompt |
override_prompt | prompt with GitHub variables |
custom_instructions | claude_args: --append-system-prompt |
max_turns | claude_args: --max-turns |
model | claude_args: --model |
allowed_tools | claude_args: --allowedTools |
disallowed_tools | claude_args: --disallowedTools |
claude_env | settings JSON format |
Contoh Sebelum dan Sesudah
Versi beta:Contoh kasus penggunaan
Claude Code GitHub Actions dapat membantu Anda dengan berbagai tugas. Direktori examples berisi workflow siap pakai untuk skenario berbeda.Workflow dasar
Menggunakan skills
Otomasi kustom dengan prompt
Kasus penggunaan umum
Dalam komentar issue atau PR:Praktik terbaik
Konfigurasi CLAUDE.md
Buat fileCLAUDE.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
${{ secrets.ANTHROPIC_API_KEY }}) daripada hardcoding kunci API langsung dalam file workflow Anda.
Mengoptimalkan kinerja
Gunakan template issue untuk memberikan konteks, jagaCLAUDE.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
- 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
- Gunakan perintah
@claudespesifik untuk mengurangi panggilan API yang tidak perlu - Konfigurasikan
--max-turnsyang sesuai dalamclaude_argsuntuk 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:- Antarmuka prompt terpadu - Gunakan
promptuntuk 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
Menggunakan dengan AWS 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:
- 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
- GitHub OIDC Identity Provider dikonfigurasi di AWS
- Peran IAM dengan izin Bedrock
- Aplikasi GitHub (direkomendasikan) atau gunakan GITHUB_TOKEN default
Buat aplikasi GitHub kustom (Direkomendasikan untuk Penyedia Pihak Ketiga)
Untuk kontrol dan keamanan terbaik saat menggunakan penyedia pihak ketiga seperti Vertex AI atau Bedrock, kami merekomendasikan membuat aplikasi GitHub Anda sendiri:Alternatif untuk Claude API atau jika Anda tidak ingin menyiapkan aplikasi Github Anda sendiri: Gunakan aplikasi Anthropic resmi:
- Buka https://github.com/settings/apps/new
- Isi informasi dasar:
- GitHub App name: Pilih nama unik (misalnya, “YourOrg Claude Assistant”)
- Homepage URL: Website organisasi Anda atau URL repositori
- Konfigurasikan pengaturan aplikasi:
- Webhooks: Hapus centang “Active” (tidak diperlukan untuk integrasi ini)
- Atur izin yang diperlukan:
- Repository permissions:
- Contents: Read & Write
- Issues: Read & Write
- Pull requests: Read & Write
- Repository permissions:
- Klik “Create GitHub App”
- Setelah pembuatan, klik “Generate a private key” dan simpan file
.pemyang diunduh - Catat App ID Anda dari halaman pengaturan aplikasi
- Instal aplikasi ke repositori Anda:
- Dari halaman pengaturan aplikasi Anda, klik “Install App” di sidebar kiri
- Pilih akun atau organisasi Anda
- Pilih “Only select repositories” dan pilih repositori spesifik
- Klik “Install”
- Tambahkan kunci pribadi sebagai rahasia ke repositori Anda:
- Buka Settings → Secrets and variables → Actions repositori Anda
- Buat rahasia baru bernama
APP_PRIVATE_KEYdengan isi file.pem
- Tambahkan App ID sebagai rahasia:
- Buat rahasia baru bernama
APP_IDdengan ID aplikasi GitHub Anda
Aplikasi ini akan digunakan dengan action actions/create-github-app-token untuk menghasilkan token autentikasi dalam workflow Anda.
- Instal dari: https://github.com/apps/claude
- Tidak ada konfigurasi tambahan yang diperlukan untuk autentikasi
Konfigurasikan autentikasi penyedia cloud
Pilih penyedia cloud Anda dan siapkan autentikasi aman:
AWS Bedrock
AWS Bedrock
Konfigurasikan AWS untuk memungkinkan GitHub Actions mengautentikasi dengan aman tanpa menyimpan kredensial.
Security Note: Gunakan konfigurasi khusus repositori dan berikan hanya izin minimum yang diperlukan.Required Setup:
-
Enable Amazon Bedrock:
- Minta akses ke model Claude di Amazon Bedrock
- Untuk model lintas region, minta akses di semua region yang diperlukan
-
Set up GitHub OIDC Identity Provider:
- Provider URL:
https://token.actions.githubusercontent.com - Audience:
sts.amazonaws.com
- Provider URL:
-
Create IAM Role for GitHub Actions:
- Trusted entity type: Web identity
- Identity provider:
token.actions.githubusercontent.com - Permissions:
AmazonBedrockFullAccesspolicy - Configure trust policy for your specific repository
- AWS_ROLE_TO_ASSUME: ARN dari peran IAM yang Anda buat
Google Vertex AI
Google Vertex AI
Konfigurasikan Google Cloud untuk memungkinkan GitHub Actions mengautentikasi dengan aman tanpa menyimpan kredensial.
Security Note: Gunakan konfigurasi khusus repositori dan berikan hanya izin minimum yang diperlukan.Required Setup:
-
Enable APIs di proyek Google Cloud Anda:
- IAM Credentials API
- Security Token Service (STS) API
- Vertex AI API
-
Create Workload Identity Federation resources:
- Buat Workload Identity Pool
- Tambahkan penyedia OIDC GitHub dengan:
- Issuer:
https://token.actions.githubusercontent.com - Attribute mappings untuk repositori dan pemilik
- Security recommendation: Gunakan kondisi atribut khusus repositori
- Issuer:
-
Create a Service Account:
- Berikan hanya peran
Vertex AI User - Security recommendation: Buat akun layanan khusus per repositori
- Berikan hanya peran
-
Configure IAM bindings:
- Izinkan Workload Identity Pool untuk menyamar sebagai akun layanan
- Security recommendation: Gunakan set principal khusus repositori
- GCP_WORKLOAD_IDENTITY_PROVIDER: Nama sumber daya penyedia lengkap
- GCP_SERVICE_ACCOUNT: Alamat email akun layanan
Tambahkan Rahasia yang Diperlukan
Tambahkan rahasia berikut ke repositori Anda (Settings → Secrets and variables → Actions):
Untuk Claude API (Langsung):
-
Untuk Autentikasi API:
ANTHROPIC_API_KEY: Kunci Claude API 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 Autentikasi GCP:
GCP_WORKLOAD_IDENTITY_PROVIDERGCP_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 Autentikasi 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 workflow
Buat file workflow GitHub Actions yang terintegrasi dengan penyedia cloud Anda. Contoh di bawah menunjukkan konfigurasi lengkap untuk AWS Bedrock dan Google Vertex AI:
Workflow AWS Bedrock
Workflow 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
| Secret Name | Description |
|---|---|
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 |
Workflow Google Vertex AI
Workflow Google Vertex AI
Prasyarat:
- Vertex AI API diaktifkan di proyek GCP Anda
- Workload Identity Federation dikonfigurasi untuk GitHub
- Akun layanan dengan izin Vertex AI
| Secret Name | Description |
|---|---|
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 |
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:| Parameter | Description | Required |
|---|---|---|
prompt | Instruksi untuk Claude (teks biasa atau nama skill) | No* |
claude_args | Argumen CLI yang diteruskan ke Claude Code | No |
anthropic_api_key | Kunci Claude API | Yes** |
github_token | Token GitHub untuk akses API | No |
trigger_phrase | Frasa pemicu kustom (default: “@claude”) | No |
use_bedrock | Gunakan AWS Bedrock alih-alih Claude API | No |
use_vertex | Gunakan Google Vertex AI alih-alih Claude API | No |
**Diperlukan untuk Claude API langsung, bukan untuk Bedrock/Vertex
Teruskan argumen CLI
Parameterclaude_args menerima argumen Claude Code CLI apa pun:
--max-turns: Maksimum conversation turns (default: 10)--model: Model yang digunakan (misalnya,claude-sonnet-4-6)--mcp-config: Path ke konfigurasi MCP--allowed-tools: Daftar tools yang diizinkan dipisahkan koma--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
Menyesuaikan perilaku Claude
Anda dapat mengonfigurasi perilaku Claude dengan dua cara:- CLAUDE.md: Tentukan standar coding, kriteria ulasan, dan aturan khusus proyek dalam file
CLAUDE.mddi root repositori Anda. Claude akan mengikuti panduan ini saat membuat PR dan merespons permintaan. Lihat dokumentasi Memory kami untuk detail lebih lanjut. - Custom prompts: Gunakan parameter
promptdalam file workflow untuk memberikan instruksi khusus workflow. Ini memungkinkan Anda menyesuaikan perilaku Claude untuk workflow atau tugas berbeda.