Ringkasan Utama
Claude Code GitHub Action menaruh agen di dalam repositori Anda, di mana menyebut claude pada sebuah issue atau pull request memberitahunya untuk membaca thread, menulis kode, dan membuka pull request. Pasang GitHub app, tambahkan API key Anda sebagai secret, dan sebuah permintaan berbahasa biasa dalam issue bisa menjadi PR yang dapat direview tanpa meninggalkan GitHub.
Menjalankan Claude Code dari terminal Anda mengikat agen ke mesin Anda. Tetapi banyak pekerjaan rekayasa dimulai sebagai issue GitHub dan berakhir sebagai pull request yang di-merge, dan seluruh loop itu hidup di GitHub, bukan di terminal Anda. Memindahkan agen ke tempat kerja itu sudah berlangsung mengubah issue yang telah dipilah menjadi draf PR yang bisa direview tim Anda.
Claude Code GitHub Action melakukan itu. Ia menjalankan agen yang sama di dalam workflow GitHub Actions, dipicu oleh komentar pada issue dan pull request. Panduan ini menuntun Anda memasangnya, apa yang terjadi ketika Anda menyebutnya, dan cara menjaga kontributor otomatis tetap aman di dalam proses review Anda.
Apa yang dilakukan GitHub Action
Action ini adalah Claude Code yang dikemas untuk berjalan di GitHub Actions dan menanggapi aktivitas di repositori Anda. Di baliknya ia adalah agen headless yang sama, dirangkai ke event GitHub sehingga komentar manusia menjadi promptnya dan hasil kerjanya menjadi commit dan pull request. Tak seorang pun harus duduk di terminal agar ia berjalan.
Ia dibangun untuk momen yang sudah menyela alur kerja Anda di GitHub:
- Mengubah sebuah issue yang menjelaskan bug atau fitur kecil menjadi sebuah branch dan pull request yang mengimplementasikannya.
- Menanggapi umpan balik review pada sebuah pull request dengan mendorong commit lanjutan ke branch yang sama.
- Menjawab pertanyaan tentang basis kode langsung dalam sebuah komentar, memakai repositori sebagai konteksnya.
Pasang dan picu sebuah run
Penyiapan tercepat adalah perintah install-github-app dari sesi Claude Code interaktif, yang memasang GitHub app serta membantu menambahkan berkas workflow dan secret yang diperlukan. Anda juga bisa menambahkan workflow secara manual dan menyimpan Anthropic API key Anda sebagai repository secret yang dibaca job saat runtime.
Setelah terpasang, Anda memicu agen dengan menyebutnya dalam sebuah komentar. Sebuah workflow yang menanggapi sebutan kira-kira berbentuk seperti ini:
name: Claude
on:
issue_comment:
types: [created]
jobs:
claude:
runs-on: ubuntu-latest
steps:
- uses: anthropics/claude-code-action@v1
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}Beri action ini kredensial yang dibatasi sendiri dan izin GitHub paling kecil yang dibutuhkannya untuk mengerjakan tugas. Sebuah workflow yang hanya perlu membuka pull request seharusnya tidak membawa hak yang tak akan pernah dipakainya, sehingga prompt yang dimanipulasi atau sebuah kesalahan punya radius ledakan sekecil mungkin di repositori Anda.
Bagaimana permintaan menjadi PR
Alur ujung ke ujung ini sengaja dibuat familiar, karena ia meniru bagaimana kontributor manusia akan mengambil sebuah issue.
- Seorang rekan tim membuka sebuah issue atau berkomentar dengan permintaan dan menyebut agen untuk memanggilnya.
- Workflow dimulai, dan agen membaca issue, thread yang tertaut, serta bagian relevan dari repositori.
- Ia membuat sebuah branch, melakukan perubahan, dan mendorong commit dengan deskripsi apa yang dilakukannya.
- Ia membuka sebuah pull request yang melewati proses CI, review, dan merge normal Anda seperti PR lainnya.
Jaga tetap di dalam code review
Action ini kuat justru karena ia bisa menulis ke repositori Anda, dan itu pula alasan ia butuh pengaman. Pembingkaian teraman adalah memperlakukannya sebagai kontributor junior yang setiap perubahannya mendarat sebagai pull request yang tetap harus disetujui manusia, bukan sebagai proses yang me-merge kerjanya sendiri.
Pembingkaian itu tidak unik bagi Claude. Cloud coding agent milik GitHub sendiri bekerja dengan cara berhati-hati yang sama: ia berjalan dalam lingkungan sementara dan menghasilkan pull request untuk direview alih-alih commit langsung ke sebuah branch, menurut dokumentasi GitHub. Menjaga manusia di tombol merge adalah model keamanan bersama di antara tool-tool ini.
Berhati-hatilah soal siapa yang bisa memicu action dan pada event mana. Jika ia menanggapi komentar dari siapa saja, kontributor luar bisa mengarahkannya lewat issue yang dirancang, dan instruksi yang tersembunyi dalam repositori atau halaman yang tertaut bisa mencoba prompt injection. Batasi pemicu ke pengguna tepercaya dan pertahankan review yang diwajibkan pada branch yang dilindungi.
Di mana ia paling bernilai
Action ini menguntungkan pada pekerjaan berulang yang tercakup baik yang menyumbat backlog dan jarang butuh pertimbangan desain mendalam.
- Perbaikan bug dan tugas kecil yang ditentukan dengan jelas, yang merepotkan untuk berpindah konteks tetapi mudah dijelaskan.
- Review pull request tahap pertama yang menandai masalah jelas sebelum reviewer manusia mencurahkan perhatian pada perubahan itu.
- Pemeliharaan rutin seperti menaikkan versi dependensi atau memperbarui dokumentasi, masing-masing mendarat sebagai PR sendiri yang bisa direview.
Claude Code GitHub Action memindahkan agen ke tempat tim Anda sudah berkolaborasi, mengubah sebuah sebutan menjadi branch, commit, dan pull request. Pasang app-nya, batasi kredensialnya secara ketat, batasi siapa yang bisa memicunya, dan biarkan setiap perubahan mengalir lewat review yang selama ini ada. Diperlakukan sebagai kontributor alih-alih autopilot, ia membereskan pekerjaan kecil agar orang bisa fokus pada bagian yang sulit.