Langsung ke konten utama
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 Owner menghubungkan instans GHES Anda, pengembang dapat menjalankan sesi web dan mendapatkan tinjauan kode otomatis tanpa konfigurasi per-repositori apa pun. Pasar plugin yang dihosting di instans Anda juga didukung; persyaratan kredensial bervariasi menurut permukaan, seperti yang dijelaskan dalam Plugin marketplaces on GHES. 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.

Pengaturan admin

Pemilik 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 peran Pemilik atau Pemilik Utama di 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.
1

Buka pengaturan admin Claude Code

Buka claude.ai/admin-settings/claude-code dan temukan bagian GitHub Enterprise Server.
2

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.
3

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.
4

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.
5

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: 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:
Kemudian mulai sesi web. Claude mendeteksi host GHES dari git remote Anda dan merutekan sesi melalui instans yang dikonfigurasi organisasi Anda:
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

Host pasar plugin di instans GHES Anda untuk mendistribusikan alat internal di seluruh organisasi Anda. Struktur pasar identik dengan pasar yang dihosting github.com, tetapi instalasi bekerja berbeda tergantung di mana Anda menambahkan pasar, dan kredensial berbeda di seluruh permukaan:
Koneksi GitHub Enterprise di claude.ai adalah per pengguna ketika pasar ditambahkan dari pengaturan pengguna. Pengaturan admin menghubungkan instans GHES Anda ke organisasi Anda, tetapi tidak menghubungkan akun pengguna individual: setiap pengguna yang menambahkan pasar GHES dari pengaturan mereka sendiri harus terlebih dahulu menghubungkan akun GitHub Enterprise mereka sendiri, dan koneksi satu pengguna, termasuk Pemilik, tidak mencakup siapa pun yang lain. Pasar yang ditambahkan oleh Pemilik dalam pengaturan plugin organisasi tidak memberlakukan persyaratan ini pada pengguna, karena pengambilan berkelanjutan menggunakan GitHub App organisasi. Pemilik yang menambahkan pasar masih memerlukan akun GitHub Enterprise mereka sendiri yang terhubung pada waktu penambahan.

Tambahkan pasar GHES

Shorthand owner/repo selalu diselesaikan ke github.com. Untuk pasar yang dihosting GHES, gunakan URL git lengkap. URL HTTPS direkomendasikan:
URL SSH berfungsi jika mesin sudah mempercayai host GHES Anda:
Claude Code menjalankan git secara non-interaktif dan menolak koneksi SSH ke host yang tidak ada dalam file known_hosts mesin. URL HTTPS dengan pembantu kredensial git menghindari persyaratan known_hosts. Lihat Buat dan distribusikan pasar plugin untuk panduan lengkap membangun pasar.

Daftarkan pasar GHES sebelumnya dengan pengaturan terkelola

Pengaturan extraKnownMarketplaces mendaftarkan pasar sebelumnya sehingga pengembang mendapatkannya tanpa pengaturan manual. Ini bekerja dari file pengaturan apa pun, termasuk .claude/settings.json repositori; pengaturan terkelola mengirimkannya di seluruh organisasi:
Claude Code menginstal pasar ini secara lokal: mendaftarkan setiap entri dan mengkloning repositori dengan kredensial git yang ada di mesin. Jalur ini tidak melalui claude.ai, jadi koneksi GitHub Enterprise per pengguna tidak diperlukan. Untuk peluncuran yang berhasil:
  • Gunakan URL git lengkap. Shorthand owner/repo selalu diselesaikan ke github.com dan tidak dapat mereferensikan host GHES.
  • Lebih suka URL HTTPS. Kloning SSH gagal pada mesin yang tidak sudah mempercayai kunci host GHES Anda. URL HTTPS dengan pembantu kredensial git standar organisasi Anda bekerja pada mesin apa pun dengan kredensial yang dikonfigurasi.
  • Konfirmasi setiap mesin dapat mengkloning dari host GHES Anda. Jika mesin tidak memiliki kredensial, pasar didaftarkan tetapi tidak pernah diinstal, dan plugin-nya melaporkan sebagai tidak ditemukan alih-alih meminta kredensial.
  • Konfirmasi pengaturan mencapai setiap mesin. File pengaturan terkelola hanya berlaku pada mesin yang diterapkan, misalnya melalui sistem manajemen perangkat Anda. Lihat pengaturan terkelola untuk lokasi file.

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:
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 gh yang dikonfigurasi untuk host GHES Anda sebagai gantinya. Jalankan gh auth login --hostname github.example.com untuk autentikasi, kemudian Claude dapat menggunakan perintah gh dalam sesi.

Troubleshooting

Sesi web gagal mengkloning repositori

Jika claude --cloud gagal dengan kesalahan kloning, verifikasi bahwa seorang Owner telah menyelesaikan pengaturan untuk instans GHES Anda dan bahwa GitHub App dipasang di repositori tempat Anda bekerja. Tanyakan kepada Owner yang menghubungkan instans untuk mengonfirmasi bahwa nama host 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.

Penambahan pasar di claude.ai gagal dengan kesalahan akses GitHub

Jika menambahkan pasar GHES dari pengaturan pengguna Anda gagal dengan kesalahan generik seperti “Marketplace couldn’t be added”, periksa koneksi GitHub Enterprise Anda terlebih dahulu. Ini adalah apa yang muncul ketika akun GitHub Enterprise Anda sendiri tidak terhubung ke Claude, bahkan jika instans GHES organisasi Anda dikonfigurasi dan pengguna lain terhubung. Dialog tidak menunjuk ke alur koneksi GitHub Enterprise, dan opsi “Connect to GitHub” di tab Browse masuk ke github.com, yang tidak memberikan akses ke repositori GHES. Untuk menghubungkan akun GitHub Enterprise Anda: pemilih repositori di claude.ai/code menawarkan opsi koneksi untuk setiap instans GHES yang dikonfigurasi, dan Owner juga dapat terhubung dari bagian GitHub Enterprise dari pengaturan admin Claude Code. Kemudian tambahkan pasar lagi. Alternatifnya, minta Owner untuk menambahkan pasar dalam pengaturan plugin organisasi, yang menghilangkan persyaratan koneksi per pengguna. Di permukaan claude.ai lainnya, kesalahan “Repository not found. If it’s private, GitHub access is required” di pasar GHES biasanya menunjukkan koneksi yang hilang yang sama. Hubungkan akun GitHub Enterprise Anda melalui salah satu jalur di atas, kemudian coba lagi.

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. Halaman-halaman ini mencakup fitur yang direferensikan di seluruh panduan ini secara lebih mendalam: