Lewati ke konten utama

Gunakan integrasi GitHub

Hubungkan repositori GitHub Anda langsung ke Claude untuk memberikan konteks komprehensif bagi tugas pengembangan perangkat lunak Anda. Anda dapat dengan mudah menambahkan repositori dengan memilihnya dari daftar, membantu Claude lebih memahami dan membantu dengan basis kode Anda.

Untuk informasi lebih lanjut tentang mengaktifkan GitHub dalam akun Anda, lihat Gunakan konektor untuk memperluas kemampuan Claude.

Cara menambahkan repositori GitHub

Catatan: Jika Anda saat ini tidak terautentikasi dengan GitHub, Anda akan dialihkan ke GitHub untuk autentikasi sebelum Anda dapat menggunakan integrasi ini.

Obrolan

  1. Klik tombol "+" di sudut kiri bawah antarmuka obrolan.

  2. Pilih "Tambahkan dari GitHub" dari menu tarik-turun.

  3. Gunakan browser file untuk memilih file dan folder tertentu.

  4. Saat Anda mengirim pesan, Claude akan mengakses dan memproses konten untuk menginformasikan responsnya.

Proyek

  1. Klik tombol "+" di sudut kanan atas bagian pengetahuan proyek Anda.

  2. Pilih "GitHub" dari menu tarik-turun.

  3. Cari melalui repositori yang dapat diakses, atau tempel URL repositori.

  4. Gunakan browser file untuk memilih file dan folder tertentu.

  5. Konten pilihan Anda akan ditambahkan ke pengetahuan proyek untuk diakses dan diproses oleh Claude.

  6. Anda dapat menggunakan ikon "Sinkronkan" untuk memastikan Anda bekerja dengan versi basis kode terbaru.

  7. Anda dapat menggunakan ikon "Konfigurasi file" untuk mengubah file dan folder mana yang dianalisis Claude.

Terhubung ke repositori pribadi

  • Jika Claude tidak dapat mengakses repositori setelah Anda memasukkan URL yang valid, kemungkinan besar berarti Anda mencoba menghubungkan Claude ke repositori pribadi: Ikuti tautan ke Aplikasi GitHub kami, di mana Anda dapat memberikan akses ke repo jika Anda adalah administrator GitHub, atau kirim permintaan kepada administrator organisasi GitHub Anda.

  • Berikan akses sendiri jika Anda bisa: Anda dapat memilih antara membiarkan Claude mengakses semua repo atau repo tertentu.

  • Minta akses jika Anda tidak memiliki izin yang diperlukan: Administrator organisasi GitHub Anda akan menerima notifikasi email tentang permintaan Anda. Setelah mereka menyetujui permintaan, Anda akan dapat menyinkronkan dan mengakses repositori di Claude.


Praktik terbaik

  1. Mulai dari yang kecil: Mulai dengan memilih subset kecil dari basis kode Anda untuk dianalisis. Ini akan membantu Anda memahami cara Claude menginterpretasi dan mendiskusikan kode Anda.

  2. Iterasi dan perbaikan: Jika respons awal Claude tidak sepenuhnya menjawab pertanyaan Anda, jangan ragu untuk mengajukan pertanyaan lanjutan atau meminta klarifikasi.

  3. Gabungkan dengan keahlian manusia: Gunakan wawasan Claude sebagai titik awal untuk penyelidikan dan diskusi lebih lanjut dengan tim Anda. Harap tinjau pekerjaan Claude.

  4. Pemilihan file yang bijaksana: Saat menggunakan "Konfigurasi file," bersikaplah strategis tentang pilihan Anda. Sertakan file dan direktori kunci yang pusat untuk tugas atau proyek Anda saat ini, tetapi hindari memilih file yang tidak perlu untuk tetap dalam batas token dan mempertahankan fokus.

  5. Pembaruan rutin: Ingat untuk menyegarkan sinkronisasi GitHub proyek Anda secara berkala untuk memastikan Claude bekerja dengan versi basis kode terbaru dan terutama sebelum memulai analisis baru atau ketika Anda tahu ada perubahan signifikan pada repo Anda.


Pemecahan masalah

Repositori dari organisasi tidak muncul setelah terhubung

Jika koneksi GitHub Anda menunjukkan sebagai terhubung tetapi repositori pribadi dari organisasi tertentu tidak muncul, organisasi tersebut mungkin memerlukan single sign-on (SSO). Ketika SSO diperlukan, setiap pengguna harus secara terpisah mengotorisasi aplikasi Claude untuk organisasi tersebut. Sampai Anda melakukannya, GitHub memfilter repositori pribadi organisasi tersebut dari tampilan Anda, meskipun koneksi Anda sebaliknya berfungsi.

Ketika Claude mendeteksi keadaan ini, pemilih repositori menampilkan spanduk yang mendorong Anda untuk mengotorisasi SSO. Untuk mengotorisasi aplikasi Claude untuk organisasi Anda:

  1. Buka github.com/settings/applications dan buka entri Claude.

  2. Di bawah Akses Organisasi, klik "Berikan" di sebelah organisasi GitHub yang relevan.

  3. Jika tombol berbunyi "Minta" bukan "Berikan," Anda tidak memiliki izin untuk mengotorisasi aplikasi sendiri. Administrator organisasi GitHub harus menyetujui permintaan Anda dari pengaturan kebijakan aplikasi OAuth organisasi.

Penting: Memutuskan dan menghubungkan kembali GitHub dalam pengaturan Claude Anda tidak akan memperbaiki ini. Koneksi baru tidak secara otomatis mengotorisasi organisasi yang memerlukan SSO, jadi Anda perlu menyelesaikan langkah otorisasi di atas.

Jika organisasi Anda menggunakan GitHub Enterprise Cloud dengan Enterprise Managed Users (EMU), hubungkan GitHub saat Anda masuk dengan akun terkelola Anda dan memiliki sesi SSO aktif. Pemilik organisasi dapat memeriksa aplikasi Claude di bawah Pengaturan > Akses Pihak Ketiga > Aplikasi GitHub di organisasi GitHub Anda, dan konfirmasi bahwa aplikasi tersebut memiliki akses ke repositori yang Anda butuhkan dan tidak memiliki permintaan izin yang tertunda.

Tidak dapat menghubungkan GitHub ke organisasi dengan retensi data nol

Jika organisasi Anda memiliki retensi data nol (ZDR) diaktifkan untuk Claude Code, Anda tidak dapat menghubungkan Aplikasi GitHub Claude ke organisasi Claude Anda. Ini adalah pembatasan ZDR, bukan masalah izin GitHub: menghubungkan memerlukan Anthropic untuk menyimpan koneksi GitHub organisasi Anda, yang ZDR tidak izinkan.

Saat Anda mencoba menghubungkan GitHub di Pengaturan Organisasi > Penyedia Git, Anda mungkin melihat kesalahan yang mengatakan Anda perlu menjadi pemilik organisasi GitHub, bahkan jika Anda sudah menjadi pemilik.

Penting: Mengubah peran atau izin aplikasi di GitHub, atau memutuskan dan menghubungkan kembali GitHub, tidak akan memperbaiki ini. Metrik kontribusi dalam analitik Claude Code tidak tersedia untuk organisasi ZDR karena alasan yang sama.

Jika organisasi Anda memerlukan penghubung GitHub, hubungi tim akun Anthropic Anda untuk membahas konfigurasi ZDR Anda. Pelajari lebih lanjut tentang retensi data nol untuk Claude Code.


Pertanyaan yang sering diajukan

Informasi apa yang diambil dari GitHub?

Hanya file (nama dan konten) di repo pada cabang tertentu yang disinkronkan. Kami tidak mengambil riwayat komit, PR, atau metadata lainnya.

Apa yang terjadi jika repositori saya diperbarui setelah menambahkannya ke proyek?

Anda dapat mengklik "Sinkronkan sekarang" untuk mengambil perubahan terbaru dari repositori Anda. Ini akan memperbarui semua file dan folder yang dipilih sebelumnya.

Bisakah saya menambahkan beberapa repositori ke satu proyek atau obrolan?

Ya, Anda dapat menambahkan beberapa repositori untuk memberikan Claude konteks komprehensif untuk tugas pengembangan Anda. Repositori harus sesuai dalam jendela konteks Claude.

Apa yang terjadi jika saya kehilangan akses ke repositori?

Jika Anda kehilangan akses ke repositori, Anda tidak akan dapat melihat kontennya di proyek tempat repositori tersebut sebelumnya ditambahkan. Pratinjau repositori akan dihapus, meskipun riwayat percakapan akan dipertahankan.

Jelajahi semua konektor yang tersedia di Direktori Konektor.

Apakah pertanyaan Anda terjawab?