Pernahkah Anda mencoba menjelaskan apa itu kepada teman Anda yang bukan orang IT dan melihat mata mereka kosong seperti melihat ban berjalan Krispy Kreme? Sekarang bayangkan memberi tahu mereka bahwa AI tidak hanya dapat memahami repo Anda tetapi juga membuka PR untuk Anda. Selamat datang di tahun 2025, di mana editor kode Anda sedikit menjadi co-pilot, sedikit menjadi pengemudi dari kursi belakang, dan—jika Anda mengaturnya dengan benar—cukup lumayan seperti seorang .
Panduan ini menunjukkan cara menghubungkan GitHub ke Claude Code dan membuat secara otomatis. Kita akan beralih dari “Hah?” menjadi “Kirim!” dengan penyiapan langkah demi langkah, alur kerja dunia nyata, dan beberapa lubang yang perlu dihindari. Anda akan menghubungkan GitHub, membiarkan Claude Code melihat apa yang terjadi, dan membuatnya membuka dan memperbarui PR yang benar-benar dapat Anda gabungkan tanpa merasa seperti membuat kesepakatan dengan iblis algoritmik.
Perhatian: Anda akan melihat dua jalur utama di sini—menggunakan integrasi GitHub Actions dari Claude Code dan menggunakan Model Context Protocol (MCP) server untuk memberi Claude akses yang aman dan terbatas ke GitHub API. Mana yang harus Anda pilih? Jika Anda menginginkan bantuan PR langsung di GitHub, jalur Actions adalah pilihan terbaik Anda. Jika Anda menginginkan kontrol repo lokal berbasis obrolan dengan izin granular, MCP adalah alat canggih Anda.
Apa yang sedang kita bangun
- Hubungkan GitHub ke Claude Code dengan aman.
- Biarkan Claude menganalisis repo Anda, mengusulkan perubahan, dan membuka PR.
- Otomatiskan peninjauan, label, daftar periksa, dan bahkan lanjutan.
- Tambahkan pagar pembatas agar tidak mengganti nama seluruh monorepo Anda menjadi “final_final_v2.”
Mengapa ini penting
Karena peralihan konteks adalah pajak produktivitas yang tidak dipilih oleh siapa pun. AI yang dapat membuka PR dengan ketelitian yang sama seperti yang Anda harapkan dari (di hari baiknya) benar-benar menghemat waktu. Bukan untuk menggantikan manusia—tenang—tetapi untuk menggantikan bagian-bagian “ugh, ” dari rekayasa perangkat lunak.
Jalur A: Buat PR secara otomatis dengan Claude Code GitHub Actions
Jika Anda menghabiskan waktu di dalam GitHub sepanjang hari (bergabunglah dengan klub), jalur ini memberi Anda bot yang dapat menganalisis kode dalam dan PR, menyarankan perubahan, dan bahkan membuka atau memperbarui PR—langsung dari repo Anda.
Apa yang Anda butuhkan
- Repo GitHub yang Anda kendalikan (atau yang dapat Anda rusak tanpa menangis).
- Akses admin repo untuk mengonfigurasi Actions dan .
- Kunci Claude API jika atau Anda membutuhkannya.
Langkah 1: Aktifkan GitHub Actions di repo Anda
- Buka repositori Anda → Settings → Actions → General.
- Aktifkan “Allow all actions and reusable workflows” (atau batasi ke yang disetujui organisasi Anda jika petugas keamanan Anda sudah memelototi Anda).
Langkah 2: Tambahkan Claude Code
Buat .github/workflows/claude-pr-bot.yml dengan pemicu berdasarkan pilihan Anda. Berikut adalah dua pola umum:
Opsi 1: PR berbasis
- Saat Anda membuka dengan label khusus (misalnya, ai-pr), berjalan.
- Ia membaca perintah (misalnya, “Tambahkan ”), membuat baru, mengedit file menggunakan Claude, mendorong , dan membuka PR dengan ringkasan terperinci.
Opsi 2: Edit berbasis komentar pada PR yang ada
- Saat Anda berkomentar @claude please refactor the settings modal, berjalan.
- Ia menganalisis , mengusulkan perubahan, dan mendorong pembaruan ke PR.
pemula (sketsa tingkat tinggi)
name: Claude PR Bot
on:
issues:
types: .
- Panduan singkat tentang integrasi dan kasus penggunaan memberi Anda pandangan dari atas tentang apa yang masuk akal untuk diotomatiskan (dan apa yang tidak) di tim yang sebenarnya.
- Jika Anda seorang pembelajar visual, ini menunjukkan PR AI yang dibuat secara otomatis dalam tindakan, dari awal hingga akhir.
Jalur B: Hubungkan GitHub ke Claude Code melalui MCP (untuk lokal)
Jika Anda ingin Claude bekerja dengan konteks repo lokal Anda—file di mesin Anda, yang sedang Anda kelola, perintah yang Anda percayai—MCP memberi Anda jembatan yang diizinkan. Anggap saja sebagai penjaga pintu untuk repo Anda: ia memutuskan pintu mana yang dapat dibuka oleh Claude.
Apa yang Anda butuhkan
- Claude Desktop atau integrasi IDE yang mendukung perkakas MCP.
- Server GitHub MCP yang Anda jalankan secara lokal, dikonfigurasi dengan yang membatasi cakupan.
- (PAT) dengan hanya cakupan yang benar-benar Anda butuhkan (misalnya, repo:status, public_repo, pull_request write).
Langkah 1: Dapatkan server GitHub MCP
- Ada server resmi yang mengekspos operasi GitHub API terpilih (cari , buat , buka PR, dll.). Ini dapat dikonfigurasi sehingga Anda hanya mengaktifkan apa yang Anda butuhkan, yang juga mengurangi kebingungan AI dan membuat keamanan senang. Untuk tampilan yang lebih luas dari server MCP dan contohnya, lihat direktori pusat.
Langkah 2: Konfigurasikan klien Anda untuk berbicara dengan server
- Dalam file konfigurasi klien Anda (misalnya, konfigurasi JSON untuk aplikasi AI Anda), daftarkan server GitHub MCP, berikan Anda melalui variabel lingkungan, dan masukkan daftar putih repo yang diizinkan.
- : Masukkan ke dalam sistem Anda atau file , bukan file konfigurasi Anda. Jangan menjadi contoh peringatan di Anda berikutnya.
Langkah 3: Uji area permukaan alat
- Minta Claude untuk membuat daftar yang terbuka, membaca file tertentu, atau membuat . Verifikasi ia tidak dapat melakukan apa pun yang tidak Anda izinkan secara eksplisit.
- Hanya setelah Anda memeriksa kewarasan perintah dasar, Anda harus mengaktifkan create_pull_request.
Langkah 4: Biarkan Claude mengusulkan dan membuka PR
- Contoh perintah: “Di repo org/app-frontend, buat baru feat/dark-toggle, implementasikan untuk di SettingsPanel.tsx, perbarui pengujian, dan buka PR dengan daftar periksa untuk QA.”
- Server mengatur: membaca status repo, menulis perubahan (jika Anda mengonfigurasi alat file lokal), mendorong , membuka PR dengan templat Anda, dan memposting ringkasan.
Pembicaraan jujur: Pagar pembatas yang benar-benar Anda butuhkan
- hanya baca: Minta Claude menghasilkan (git diff) sebelum akses tulis. Gabungkan setelah Anda memeriksanya.
- Badan PR : Sertakan catatan risiko, rencana pengujian, dan langkah-langkah peluncuran. Buat bot menyelesaikan templat; buat manusia meninjaunya.
- Aturan pelabelan: Terapkan label secara otomatis seperti ai-generated dan needs-tests agar tetap mudah ditemukan dan jujur.
- Penamaan : Wajibkan awalan (ai/ atau bot/) dengan aturan perlindungan . Robot juga membutuhkan seragam.
Saatnya anekdot: Saya meminta AI untuk “memperbaiki .” Ia “memperbaikinya” dengan menghapus autentikasi. Bagus untuk produktivitas! Mengerikan untuk segalanya. Jaga cakupan tetap sempit, perintah spesifik, dan pengujian CI kejam.
Dari nol hingga PR: Skenario ujung ke ujung yang realistis
Skenario: Perbaiki pengujian yang tidak stabil dalam proyek React
- Anda membuka : “Debounce util: pada batas 200ms di CI.” Anda menandainya dengan ai-pr.
- Pemicu . Ia mencari debounce.ts dan pengujian terkait.
- Claude mengusulkan : menyesuaikan pewaktu dengan jest.useFakeTimers, menambahkan margin dalam , memperbarui dokumentasi.
- Bot membuka PR dengan: judul, ringkasan, alasan, rencana pengujian, dan peringkat risiko.
- Anda meninjau , mendorong kembali: “Kasus ekstrem ketika delay=0.”
- Anda berkomentar @claude handle delay=0 with immediate flush; add test. berjalan kembali, mendorong .
- CI lulus. Anda dan gabungkan. Di suatu tempat, pengujian menangis “paman.”
Seperti apa perintah yang baik (dan apa yang harus dihindari)
- Bagus: “Tambahkan ke SettingsPanel.tsx; pertahankan ke localStorage; perbarui SettingsPanel.test.tsx; ikuti aturan ESLint kami; modifikasi hanya /src/ui/ dan /src/utils/; maks 250 baris.”
- Lumayan: “Implementasikan .”
Jadikan aman: Pemeriksaan cepat keamanan dan kepatuhan
- Cakupan : Gunakan repo:contents write hanya jika diperlukan; lebih suka pull_request write untuk pembuatan PR.
- Daftar izin repositori: Kunci bot ke satu repo atau organisasi.
- Pencatatan: Pastikan bot mencatat tindakannya dan perintah (dikurangi ). Anda akan menginginkan bukti ketika ia “meningkatkan” Dockerfile Anda.
- Perlindungan : Wajibkan dua persetujuan manusia untuk ai/*.
Pemecahan masalah: Saat bot tidak mau nge-bot
- Ia tidak dapat mendorong : Periksa izin Actions untuk contents: write dan Anda memiliki akses repo write.
- Ia membuka PR kosong: Pembuat konteks Anda tidak memberinya file yang tepat. Perketat logika pemilihan file Anda.
- Waktunya habis di repo besar: Batasi konteks ke jalur yang diubah atau manifes. AI mengalami gangguan pencernaan pada monorepo 10GB, sama seperti kita semua.
- Ia mengabaikan templat PR Anda: Konfirmasikan templat ada di .github/pull_request_template.md atau ditautkan di pengaturan repo Anda.
Kapan menggunakan jalur yang mana
- Gunakan GitHub Actions jika Anda menginginkan cara ringan untuk membuat PR secara otomatis dari atau komentar, dengan semua yang terjadi di GitHub.
- Gunakan MCP jika Anda ingin Claude beroperasi di lingkungan lokal Anda atau di beberapa alat dengan kontrol yang sangat spesifik.
Perlu dicatat: Jika Anda ingin pemeriksaan kewarasan cepat pada atau membuat perintah pemula yang solid, Sider.AI dapat membantu Anda membuat draf templat PR dan perintah pagar pembatas, lalu melakukan iterasi pada mereka dengan repo yang sebenarnya. Ini seperti memiliki editor yang berkepala dingin yang benar-benar menulis kode. Dan tidak mencuri kursi meja Anda. Pola umum yang ingin Anda salin
- Label PR AI dan CODEOWNERS: Arahkan PR ai/* ke grup peninjau yang senang berdebat dengan robot.
- langkah demi langkah: Minta Claude membuat kecil dan atomik dengan pesan yang jelas alih-alih satu bernama “macam-macam.”
- Mode : Minta membuat pengujian terlebih dahulu, menjalankan CI, lalu membuat implementasi. Lebih lambat. Lebih baik.
- Pekerjaan rumah pasca-penggabungan: Tambahkan untuk secara otomatis membuka lanjutan untuk dokumentasi, , atau pembersihan.
Pemeriksaan cepat kompetitif
- Beberapa orang menghubungkan LLM lain ke alur GitHub serupa. Mereka bekerja—tetapi penalaran kode dan kesediaan Claude Code untuk mengatakan “Saya tidak yakin” dapat menghemat waktu berjam-jam untuk tebak-dan-periksa. Integrasi GitHub Actions membuatnya tetap di tempat peninjauan terjadi secara alami, dan rute MCP fleksibel untuk .
Daftar periksa penyiapan 10 menit
- Pilih jalur: GitHub Actions (lebih cepat) atau MCP (lebih banyak kontrol).
- Buat Anda dengan cakupan minimal.
- Tambahkan atau konfigurasikan server MCP.
- Bangun pembuat konteks yang ketat: daftar file, batasan, dan aturan.
- Tambahkan perlindungan dan label .
- Uji pada perubahan kecil terlebih dahulu. Gabungkan. Rayakan. Beri tahu PM Anda bahwa Anda “meningkatkan .”
Referensi cepat yang perlu disimpan
- Dokumentasi Claude Code GitHub Actions (pola, pemicu, contoh).
- Panduan praktis untuk integrasi dan praktik terbaik.
- : PR yang dibuat oleh AI dari ujung ke ujung.
- Server GitHub MCP untuk akses granular dan diizinkan.
- Direktori dan contoh server MCP untuk inspirasi.
Penutup dari Stern
Otomatisasi PR dengan Claude Code tidak akan menggantikan tim rekayasa Anda. Ia akan menggantikan tugas-tugas yang paling tidak disukai tim rekayasa Anda. Mulailah dengan cakupan yang ketat, perintah yang jelas, dan peninjauan yang ketat. Biarkan bot menangani perancah sementara Anda menangani pemikiran. Kemudian kembali ke hal-hal yang menyenangkan—seperti akhirnya menghapus file utils2.ts yang telah Anda hindari karena Anda tahu itu menyatukan aplikasi dengan selotip dan mimpi.
Sekarang buat diri Anda di masa depan sedikit kurang pemarah. Dan jika bot menjadi jahat? Anda tahu di mana tombol Revert berada.
FAQ
P1: Bisakah Claude Code membuka sendiri?
Ya. Dengan GitHub Actions atau penyiapan MCP, Claude Code dapat membuat , mendorong perubahan, dan membuka dengan ringkasan dan daftar periksa. Jaga izin tetap ketat dan wajibkan peninjauan manusia sehingga ia tidak “mengoptimalkan” keamanan Anda dengan menghapusnya.
P2: Apa cara teraman untuk menghubungkan GitHub ke Claude Code?
Gunakan dengan cakupan minimal, daftar izin repositori, dan perlindungan . Apakah Anda menggunakan Actions atau MCP, aktifkan dan wajibkan pengujian untuk lulus sebelum menggabungkan yang dibuat AI.
P3: Bagaimana cara menghentikan PR AI agar tidak menyentuh seluruh monorepo saya?
Batasi konteks dengan direktori yang diizinkan dan manifes file dan batasi jumlah file per . Perintah yang baik juga membantu—bersikap spesifik tentang jalur dan batasan ukuran.
P4: Mengapa AI saya kosong atau berkualitas rendah?
Pembuat konteks Anda mungkin memberi Claude file yang salah atau terlalu sedikit detail. Berikan tujuan, batasan, dan harapan pengujian yang jelas—dan pertimbangkan alur dua tahap: buat pengujian terlebih dahulu, lalu implementasinya.
P5: Haruskah saya menggunakan GitHub Actions atau MCP untuk Claude Code?
Jika Anda menginginkan otomasi cepat dan untuk PR dan peninjauan, gunakan GitHub Actions. Jika Anda memerlukan kontrol lokal, alat khusus, atau izin yang sangat terperinci, MCP memberi Anda lebih banyak kekuatan—dengan sedikit lebih banyak penyiapan.
