Claude Code dengan GitHub Enterprise Server

Hubungkan Claude Code ke instans GitHub Enterprise Server yang di-host sendiri untuk sesi cloud, tinjauan kode, dan pasar plugin.

[!NOTE]

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

Penyiapan admin

Seorang Owner menghubungkan instance GHES Anda ke Claude Code satu kali. Anda memerlukan peran Owner atau Primary Owner di organisasi Claude Anda serta izin untuk membuat GitHub App di instance GHES Anda.

Penyiapan terpandu menghasilkan manifest GitHub App dan mengarahkan Anda ke instance GHES Anda untuk membuat app dengan satu klik. Jika lingkungan Anda memblokir alur pengalihan tersebut, tersedia penyiapan manual alternatif.

1. Buka pengaturan Git providers

Buka Organization settings > Git providers dan temukan bagian GitHub Enterprise.

2. Mulai penyiapan terpandu

Klik Connect, atau Add instance jika sebuah instance sudah terhubung, lalu pilih Set up automatically. Masukkan nama tampilan hingga 20 karakter untuk koneksi tersebut dan hostname GHES Anda, misalnya github.example.com. Jika instance GHES Anda menggunakan sertifikat self-signed atau otoritas sertifikat privat, tempelkan sertifikat CA di kolom opsional.

3. Buat GitHub App

Klik Continue to GitHub Enterprise. Browser Anda akan dialihkan ke instance GHES Anda dengan manifest app yang sudah terisi. Tinjau konfigurasinya dan klik Create GitHub App. GHES akan mengarahkan Anda kembali ke Claude dengan kredensial app yang disimpan secara otomatis.

4. Instal app di repositori Anda

Dari halaman GitHub App di instance GHES Anda, instal app tersebut di repositori atau organisasi yang ingin Anda izinkan untuk diakses Claude. Anda dapat memulai dengan sebagian dan menambahkan lebih banyak nanti.

5. Aktifkan Code Review

Buka claude.ai/admin-settings/claude-code dan aktifkan Code Review untuk repositori GHES Anda menggunakan konfigurasi yang sama seperti github.com.

Izin GitHub App

Manifest mengonfigurasi GitHub App dengan izin dan event webhook di bawah ini, yang secara keseluruhan mencakup sesi cloud, Code Review, Claude Security, dan plugin marketplace:

App ini berlangganan event pull_request, issue_comment, pull_request_review_comment, pull_request_review, check_run, dan status.

GitHub hanya menerapkan manifest saat app dibuat, sehingga app yang dibuat dari versi manifest sebelumnya tetap memiliki izin dan event yang ada saat app tersebut dibuat. Jika app Anda tidak memiliki salah satu izin atau event di atas, tambahkan di pengaturan app pada instance GHES Anda. GitHub kemudian akan meminta owner dari setiap instalasi untuk menyetujui izin baru tersebut, dan instalasi tetap menggunakan izin lamanya hingga mereka menyetujuinya.

Penyiapan manual

Jika alur pengalihan terpandu diblokir oleh konfigurasi jaringan Anda, klik Connect atau Add instance, lalu pilih Add manually alih-alih Set up automatically. Buat GitHub App di instance GHES Anda dengan izin dan event di atas, lalu masukkan detail koneksi di formulir: nama tampilan, hostname GHES Anda dan port opsional, serta ID app, client ID, client secret, webhook secret, dan private key. Formulir ini juga menerima sertifikat CA kustom opsional dan hostname read replica.

Claude menghasilkan URL webhook app saat Anda menyimpan koneksi. Setelah Anda mengklik Add configuration, buka menu More options pada koneksi tersebut, pilih Copy webhook URL, dan tempelkan URL tersebut ke pengaturan webhook app di instance GHES Anda. Gunakan webhook secret yang sama dengan yang Anda masukkan di formulir.

Persyaratan jaringan

Untuk sesi yang di-host oleh Anthropic, instance GHES Anda harus dapat dijangkau dari infrastruktur Anthropic agar Claude dapat meng-clone repositori dan memposting komentar review. Jika instance GHES Anda berada di balik firewall, masukkan alamat IP keluar Anthropic ke dalam allowlist. Sesi di lingkungan self-hosted melakukan clone dari dalam jaringan Anda, kecuali jika runner memilih menggunakan Anthropic git proxy, yang melakukan fetch dari sisi Anthropic dan memerlukan keterjangkauan yang sama.

Alur pra-sesi yang di-host, seperti pemilih repositori, berjalan di sisi Anthropic sebelum sesi dimulai. Alur tersebut memerlukan instance GHES Anda agar dapat dijangkau dari infrastruktur Anthropic bahkan ketika sesi berjalan di lingkungan self-hosted. Konektor SCM tidak tersedia, sehingga alur tersebut tidak dapat menjangkau host GHES yang hanya dapat dirutekan secara internal.

Alur kerja pengembang

Claude Code mendeteksi nama host GHES Anda secara otomatis dari git remote di direktori kerja Anda.

Kloning repositori dari instans GHES Anda seperti biasa, mengganti github.example.com dan jalur repositori dengan nama host GHES dan repositori Anda:

git clone git@github.example.com:platform/api-service.git
cd api-service

Kemudian mulai sesi cloud. Claude mendeteksi host GHES dari git remote Anda dan merutekan sesi melalui instans yang dikonfigurasi organisasi Anda:

claude --cloud "Add retry logic to the payment webhook handler"

Sesi mengkloning repositori Anda dari GHES dan mendorong perubahan kembali ke branch. Pantau kemajuan di claude.ai/code. Lihat Menggunakan Claude Code di cloud untuk alur kerja sesi cloud lengkap termasuk tinjauan diff, perbaikan otomatis, dan tugas terjadwal cloud.

Teleport sesi ke terminal Anda

Tarik sesi cloud 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.

Plugin marketplace di GHES

Host plugin marketplace di instans GHES Anda untuk mendistribusikan tooling internal ke seluruh organisasi Anda. Struktur marketplace identik dengan marketplace yang di-host di github.com, tetapi instalasi bekerja secara berbeda tergantung di mana Anda menambahkan marketplace, dan kredensial berbeda di setiap surface:

[!WARNING]

Koneksi GitHub Enterprise di claude.ai bersifat per pengguna ketika marketplace ditambahkan dari pengaturan pengguna. Penyiapan admin menghubungkan instans GHES Anda ke organisasi Anda, tetapi tidak menghubungkan akun pengguna individual: setiap pengguna yang menambahkan marketplace GHES dari pengaturan mereka sendiri harus terlebih dahulu menghubungkan akun GitHub Enterprise mereka sendiri, dan koneksi satu pengguna, termasuk milik Owner, tidak mencakup orang lain. Marketplace yang ditambahkan oleh Owner di pengaturan plugin organisasi tidak membebankan persyaratan ini kepada pengguna, karena pengambilan berkelanjutan menggunakan GitHub App milik organisasi. Owner yang menambahkan marketplace tetap memerlukan akun GitHub Enterprise miliknya sendiri yang terhubung pada saat penambahan.

Menambahkan marketplace GHES

Singkatan owner/repo selalu di-resolve ke github.com. Untuk marketplace yang di-host di GHES, gunakan URL git lengkap, dengan mengganti github.example.com dan path repositori dengan milik Anda sendiri. URL HTTPS direkomendasikan:

/plugin marketplace add https://github.example.com/platform/claude-plugins.git

URL SSH berfungsi jika mesin sudah memercayai host GHES Anda:

/plugin marketplace add git@github.example.com:platform/claude-plugins.git

Claude Code menjalankan git secara non-interaktif dan menolak koneksi SSH ke host yang tidak ada di file known_hosts mesin. URL HTTPS dengan git credential helper menghindari persyaratan known_hosts.

Lihat Membuat dan mendistribusikan plugin marketplace untuk panduan lengkap membangun marketplace.

Mendaftarkan marketplace GHES terlebih dahulu dengan pengaturan terkelola

Pengaturan extraKnownMarketplaces mendaftarkan marketplace terlebih dahulu sehingga developer mendapatkannya tanpa penyiapan manual. Pengaturan ini berfungsi dari file pengaturan mana pun, termasuk .claude/settings.json milik repositori; pengaturan terkelola mengirimkannya ke seluruh organisasi:

{
  "extraKnownMarketplaces": {
    "internal-tools": {
      "source": {
        "source": "git",
        "url": "https://github.example.com/platform/claude-plugins.git"
      }
    }
  }
}

Claude Code menginstal marketplace ini secara lokal: Claude Code mendaftarkan setiap entri dan meng-clone repositori dengan kredensial git yang sudah ada di mesin. Jalur ini tidak melalui claude.ai, sehingga koneksi GitHub Enterprise per pengguna tidak diperlukan. Untuk peluncuran yang berhasil:

• Gunakan URL git lengkap. Singkatan owner/repo selalu di-resolve ke github.com dan tidak dapat merujuk ke host GHES.
• Utamakan URL HTTPS. Clone SSH gagal pada mesin yang belum memercayai host key GHES Anda. URL HTTPS dengan git credential helper standar organisasi Anda berfungsi di mesin mana pun yang kredensialnya telah dikonfigurasi.
• Pastikan setiap mesin dapat melakukan clone dari host GHES Anda. Jika suatu mesin tidak memiliki kredensial, marketplace terdaftar tetapi tidak pernah terinstal, dan plugin-nya dilaporkan sebagai tidak ditemukan alih-alih meminta kredensial.
• Pastikan pengaturan sampai ke setiap mesin. File pengaturan terkelola hanya berlaku pada mesin tempat file tersebut di-deploy, misalnya melalui sistem manajemen perangkat Anda. Lihat Men-deploy pengaturan terkelola untuk lokasi file.

Allowlist marketplace GHES di pengaturan terkelola

Jika organisasi Anda menggunakan pengaturan terkelola untuk membatasi marketplace mana yang dapat ditambahkan developer, gunakan tipe sumber hostPattern untuk mengizinkan semua marketplace dari instans GHES Anda tanpa mencantumkan setiap repositori satu per satu. Lihat Mekanisme pengiriman untuk lokasi file di setiap platform. Tambahkan JSON ke file managed-settings.json Anda atau kebijakan MDM yang setara:

{
  "strictKnownMarketplaces": [
    {
      "source": "hostPattern",
      "hostPattern": "^github\\.example\\.com$"
    }
  ]
}

Lihat referensi pengaturan strictKnownMarketplaces dan extraKnownMarketplaces untuk skema lengkapnya.

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: dalam sesi di mesin Anda sendiri, 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 di sana.

Troubleshooting

Cloud session fails to clone repository

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.

Jika sesi berhenti dengan "Authentication failed while accessing the repository", Anda mungkin belum menghubungkan akun GitHub Enterprise Anda sendiri. Hubungkan akun tersebut dari pemilih repositori di claude.ai/code, kemudian mulai sesi baru.

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.

Hubungkan akun GitHub Enterprise Anda di salah satu tempat berikut, kemudian tambahkan marketplace lagi:

• Pemilih repositori: di claude.ai/code, pemilih repositori menawarkan opsi koneksi untuk setiap instans GHES yang dikonfigurasi.
• Halaman penyedia Git: jika Anda seorang Owner, buka bagian GitHub di Organization settings > Git providers dan klik Connect, atau Add organization setelah akun terhubung. Pilih nama host GHES di bawah GitHub instance, kemudian klik Connect.

Alternatifnya, minta Owner untuk menambahkan marketplace 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 cloud habis waktu, instans GHES Anda mungkin tidak dapat dijangkau dari infrastruktur Anthropic. Konfirmasi firewall Anda memungkinkan koneksi masuk dari outbound IP addresses Anthropic. Sesi dalam self-hosted environment mencapai GHES dari dalam jaringan Anda, jadi ketika salah satu dari mereka tidak dapat mengkloning, periksa jalur jaringan runner sendiri sebagai gantinya. Untuk pemilih repositori dan alur pra-sesi yang dihosting lainnya, lihat Network requirements.

Tes koneksi berhasil tetapi tes kedua gagal

Tes kedua terhubung ke instans GHES Anda dengan cara yang sama seperti sesi cloud yang dihosting Anthropic. Temukan pesan Anda untuk mengetahui apakah Anda perlu memeriksa firewall atau mencoba lagi:

• Connection test passed, but a second test failed.: jika instans Anda berada di balik firewall, izinkan semua outbound IP addresses Anthropic, karena tes koneksi dapat berhasil meskipun firewall Anda memblokir sebagian di antaranya. Anda juga dapat mencoba lagi dalam beberapa menit.
• Connection test passed, but a second test could not run.: coba lagi dalam beberapa menit.

Untuk melakukan tes lagi, buka menu More options milik koneksi di Organization settings > Git providers dan pilih Test connection.

Awal sesi gagal dengan Unable to get organization UUID

Claude Code tidak dapat membaca organisasi claude.ai dari kredensial Anda. Masuk dengan /login menggunakan akun di organisasi Team atau Enterprise Anda, karena dukungan GitHub Enterprise Server terbatas pada paket tersebut. Lihat Unable to get organization UUID untuk penyebab dan pesan lain yang dihasilkan keadaan ini.

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 Claude Code di seluruh organisasi Anda
• Pengaturan terkelola: konfigurasi kebijakan di seluruh organisasi
• Konfigurasi jaringan: persyaratan firewall dan daftar izin IP