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.

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.

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.

Izin GitHub App

Manifes mengonfigurasi GitHub App dengan izin dan acara webhook di bawah ini, yang bersama-sama mencakup sesi web, Code Review, Claude Security, pasar plugin, dan metrik kontribusi:

Aplikasi berlangganan acara pull_request, issue_comment, pull_request_review_comment, pull_request_review, check_run, dan status.

GitHub menerapkan manifes hanya ketika aplikasi dibuat, jadi aplikasi yang dibuat dari versi manifes sebelumnya mempertahankan izin dan acara yang dibuat dengannya. Jika aplikasi Anda kehilangan salah satu izin atau acara di atas, tambahkan di pengaturan aplikasi di instans GHES Anda. GitHub kemudian meminta pemilik setiap instalasi untuk menyetujui izin baru, dan instalasi mempertahankan izin lamanya sampai mereka melakukannya.

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 detail koneksi dalam formulir: nama tampilan, nama host GHES dan port opsional Anda, dan ID aplikasi, ID klien, rahasia klien, rahasia webhook, dan kunci pribadi aplikasi. Formulir juga menerima sertifikat CA kustom opsional dan nama host replika baca.

Claude menghasilkan URL webhook aplikasi ketika Anda menyimpan koneksi. Setelah Anda klik Add configuration, buka menu More options koneksi, pilih Copy webhook URL, dan tempel URL ke pengaturan webhook aplikasi di instans GHES Anda. Gunakan rahasia webhook yang sama yang Anda masukkan dalam formulir.

Persyaratan jaringan

Untuk sesi yang dihosting Anthropic, 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 keluar Anthropic Anthropic. Sesi di lingkungan yang dihosting sendiri mengkloning dari dalam jaringan Anda, kecuali runner memilih proxy git Anthropic, yang mengambil dari sisi Anthropic dan memerlukan jangkauan yang sama; konektor SCM mencakup alur pra-sesi yang dihosting, seperti pemilih repositori, untuk host GHES yang hanya dapat dirutekan secara internal.

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, 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 cabang. Pantau kemajuan di claude.ai/code. Lihat Claude Code di web untuk alur kerja sesi cloud lengkap termasuk tinjauan diff, perbaikan otomatis, dan rutinitas.

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.

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:

Tambahkan pasar GHES

Shorthand owner/repo selalu diselesaikan ke github.com. Untuk pasar yang dihosting GHES, gunakan URL git lengkap, mengganti github.example.com dan jalur 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 mempercayai 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 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:

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

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 Terapkan 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 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 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

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.

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 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 untuk mereka periksa jalur jaringan runner sendiri dan SCM connector sebagai gantinya.

Awal sesi gagal dengan `Unable to get organization UUID`

Sesi cloud memerlukan organisasi Tim atau Enterprise. Masuk dengan /login menggunakan akun organisasi Anda. Jika Anda mengautentikasi dengan kunci API sebagai gantinya, sesi cloud gagal lebih awal dengan pesan yang meminta Anda menjalankan /login.

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