Claude Code dengan GitHub Enterprise Server
Hubungkan Claude Code ke instans GitHub Enterprise Server yang di-host sendiri untuk sesi web, tinjauan kode, dan pasar plugin.
Dukungan GitHub Enterprise Server tersedia untuk paket Team dan Enterprise.
Dukungan GitHub Enterprise Server (GHES) memungkinkan organisasi Anda menggunakan Claude Code dengan repositori yang dihosting di instans GitHub yang dikelola sendiri, bukan github.com. Setelah admin menghubungkan instans GHES Anda, pengembang dapat menjalankan sesi web, mendapatkan tinjauan kode otomatis, dan memasang plugin dari pasar internal tanpa konfigurasi per-repositori apa pun.
Untuk repositori di github.com, lihat Claude Code di web dan Code Review. Untuk menjalankan Claude di infrastruktur CI Anda sendiri, lihat GitHub Actions.
Apa yang berfungsi dengan GitHub Enterprise Server
Tabel di bawah menunjukkan fitur Claude Code mana yang mendukung GHES dan perbedaan apa pun dari perilaku github.com.
| Fitur | Dukungan GHES | Catatan |
|---|---|---|
| Claude Code di web | ✅ Didukung | Admin menghubungkan instans GHES sekali; pengembang menggunakan claude --remote atau claude.ai/code seperti biasa |
| Code Review | ✅ Didukung | Tinjauan PR otomatis yang sama seperti github.com |
| Claude Security | ✅ Didukung | Tersedia dalam beta publik untuk paket Enterprise di claude.ai/security |
| Sesi Teleport | ✅ Didukung | Pindahkan sesi antara web dan terminal dengan --teleport |
| Pasar plugin | ✅ Didukung | Gunakan URL git lengkap alih-alih shorthand owner/repo |
| Metrik kontribusi | ✅ Didukung | Dikirimkan melalui webhook ke dasbor analitik |
| GitHub Actions | ✅ Didukung | Memerlukan pengaturan alur kerja manual; /install-github-app hanya untuk github.com |
| Server GitHub MCP | ❌ Tidak didukung | Server GitHub MCP tidak berfungsi dengan instans GHES |
Pengaturan admin
Admin menghubungkan instans GHES Anda ke Claude Code sekali. Setelah itu, pengembang di organisasi Anda dapat menggunakan repositori GHES tanpa konfigurasi tambahan apa pun. Anda memerlukan akses admin ke organisasi Claude Anda dan izin untuk membuat GitHub Apps di instans GHES Anda.
Pengaturan terpandu menghasilkan manifes GitHub App dan mengarahkan ulang Anda ke instans GHES untuk membuat aplikasi dalam satu klik. Jika lingkungan Anda memblokir alur pengalihan, pengaturan manual alternatif tersedia.
Buka pengaturan admin Claude Code
Buka claude.ai/admin-settings/claude-code dan temukan bagian GitHub Enterprise Server.
Mulai pengaturan terpandu
Klik Connect. Masukkan nama tampilan untuk koneksi dan nama host GHES Anda, misalnya github.example.com. Jika instans GHES Anda menggunakan sertifikat yang ditandatangani sendiri atau otoritas sertifikat pribadi, tempel sertifikat CA di bidang opsional.
Buat GitHub App
Klik Continue to GitHub Enterprise. Browser Anda mengarahkan ulang ke instans GHES Anda dengan manifes aplikasi yang sudah diisi sebelumnya. Tinjau konfigurasi dan klik Create GitHub App. GHES mengarahkan ulang Anda kembali ke Claude dengan kredensial aplikasi disimpan secara otomatis.
Pasang aplikasi di repositori Anda
Dari halaman GitHub App di instans GHES Anda, pasang aplikasi di repositori atau organisasi yang ingin Anda akses Claude. Anda dapat memulai dengan subset dan menambahkan lebih banyak nanti.
Aktifkan fitur
Kembali ke claude.ai/admin-settings/claude-code dan aktifkan Code Review, Claude Security, dan metrik kontribusi untuk repositori GHES Anda menggunakan konfigurasi yang sama seperti github.com.
Izin GitHub App
Manifes mengonfigurasi GitHub App dengan izin dan acara webhook yang Claude butuhkan di seluruh sesi web, Code Review, Claude Security, dan metrik kontribusi:
| Izin | Akses | Digunakan untuk |
|---|---|---|
| Contents | Baca dan tulis | Kloning repositori dan push cabang |
| Pull requests | Baca dan tulis | Membuat PR dan memposting komentar tinjauan |
| Issues | Baca dan tulis | Merespons penyebutan masalah |
| Checks | Baca dan tulis | Memposting jalankan pemeriksaan Code Review |
| Actions | Baca | Membaca status CI untuk perbaikan otomatis |
| Repository hooks | Baca dan tulis | Menerima webhook untuk metrik kontribusi |
| Metadata | Baca | Diperlukan oleh GitHub untuk semua aplikasi |
Aplikasi berlangganan acara pull_request, issue_comment, pull_request_review_comment, pull_request_review, dan check_run.
Pengaturan manual
Jika alur pengalihan terpandu diblokir oleh konfigurasi jaringan Anda, klik Add manually alih-alih Connect. Buat GitHub App di instans GHES Anda dengan izin dan acara di atas, kemudian masukkan kredensial aplikasi dalam formulir: nama host, ID klien OAuth dan rahasia, ID GitHub App, ID klien, rahasia klien, rahasia webhook, dan kunci pribadi.
Persyaratan jaringan
Instans GHES Anda harus dapat dijangkau dari infrastruktur Anthropic sehingga Claude dapat mengkloning repositori dan memposting komentar tinjauan. Jika instans GHES Anda berada di belakang firewall, daftarkan alamat IP API Anthropic.
Alur kerja pengembang
Setelah admin Anda menghubungkan instans GHES, tidak ada konfigurasi sisi pengembang yang diperlukan. Claude Code mendeteksi nama host GHES Anda secara otomatis dari git remote di direktori kerja Anda.
Kloning repositori dari instans GHES Anda seperti biasa:
git clone git@github.example.com:platform/api-service.git
cd api-service
Kemudian mulai sesi web. Claude mendeteksi host GHES dari git remote Anda dan merutekan sesi melalui instans yang dikonfigurasi organisasi Anda:
claude --remote "Add retry logic to the payment webhook handler"
Sesi berjalan di infrastruktur Anthropic, mengkloning repositori Anda dari GHES, dan mendorong perubahan kembali ke cabang. Pantau kemajuan dengan /tasks atau di claude.ai/code. Lihat Claude Code di web untuk alur kerja sesi jarak jauh lengkap termasuk tinjauan diff, perbaikan otomatis, dan rutinitas.
Teleport sesi ke terminal Anda
Tarik sesi web ke terminal lokal Anda dengan claude --teleport. Teleport memverifikasi Anda berada di checkout repositori GHES yang sama sebelum mengambil cabang dan memuat riwayat sesi. Lihat persyaratan teleport untuk detail.
Pasar plugin di GHES
Hosting pasar plugin di instans GHES Anda untuk mendistribusikan alat internal di seluruh organisasi Anda. Struktur pasar identik dengan pasar yang dihosting github.com; satu-satunya perbedaan adalah cara Anda mereferensikannya.
Tambahkan pasar GHES
Shorthand owner/repo selalu diselesaikan ke github.com. Untuk pasar yang dihosting GHES, gunakan URL git lengkap:
/plugin marketplace add git@github.example.com:platform/claude-plugins.git
URL HTTPS juga berfungsi:
/plugin marketplace add https://github.example.com/platform/claude-plugins.git
Lihat Buat dan distribusikan pasar plugin untuk panduan lengkap membangun pasar.
Daftarkan pasar GHES dalam pengaturan terkelola
Jika organisasi Anda menggunakan pengaturan terkelola untuk membatasi pasar mana yang dapat ditambahkan pengembang, gunakan tipe sumber hostPattern untuk memungkinkan semua pasar dari instans GHES Anda tanpa menghitung setiap repositori:
{
"strictKnownMarketplaces": [
{
"source": "hostPattern",
"hostPattern": "^github\\.example\\.com$"
}
]
}
Anda juga dapat mendaftarkan pasar sebelumnya untuk pengembang sehingga mereka muncul tanpa pengaturan manual. Contoh ini membuat pasar alat internal tersedia di seluruh organisasi:
{
"extraKnownMarketplaces": {
"internal-tools": {
"source": {
"source": "git",
"url": "git@github.example.com:platform/claude-plugins.git"
}
}
}
}
Lihat referensi pengaturan strictKnownMarketplaces dan extraKnownMarketplaces untuk skema lengkap.
Keterbatasan
Beberapa fitur berperilaku berbeda di GHES daripada di github.com. Tabel fitur merangkum dukungan; bagian ini mencakup solusi.
- Perintah
/install-github-app: ikuti alur pengaturan admin di claude.ai sebagai gantinya. Jika Anda juga menginginkan alur kerja GitHub Actions di GHES, sesuaikan alur kerja contoh secara manual. - Server GitHub MCP: gunakan CLI
ghyang dikonfigurasi untuk host GHES Anda sebagai gantinya. Jalankangh auth login --hostname github.example.comuntuk autentikasi, kemudian Claude dapat menggunakan perintahghdalam sesi.
Troubleshooting
Sesi web gagal mengkloning repositori
Jika claude --remote gagal dengan kesalahan kloning, verifikasi bahwa admin Anda telah menyelesaikan pengaturan untuk instans GHES Anda dan bahwa GitHub App dipasang di repositori tempat Anda bekerja. Periksa dengan admin Anda bahwa nama host instans yang terdaftar dalam pengaturan Claude cocok dengan nama host di git remote Anda.
Penambahan pasar gagal dengan kesalahan kebijakan
Jika /plugin marketplace add diblokir untuk URL GHES Anda, organisasi Anda telah membatasi sumber pasar. Minta admin Anda untuk menambahkan entri hostPattern untuk nama host GHES Anda dalam pengaturan terkelola.
Instans GHES tidak dapat dijangkau
Jika tinjauan atau sesi web habis waktu, instans GHES Anda mungkin tidak dapat dijangkau dari infrastruktur Anthropic. Konfirmasi firewall Anda memungkinkan koneksi masuk dari alamat IP API Anthropic.
Sumber daya terkait
Halaman-halaman ini mencakup fitur yang direferensikan di seluruh panduan ini secara lebih mendalam:
- Claude Code di web: jalankan sesi Claude Code di infrastruktur cloud
- Code Review: tinjauan PR otomatis
- Pasar plugin: bangun dan distribusikan katalog plugin
- Analytics: lacak penggunaan dan metrik kontribusi
- Pengaturan terkelola: konfigurasi kebijakan di seluruh organisasi
- Konfigurasi jaringan: persyaratan firewall dan daftar izin IP