> ## Documentation Index
> Fetch the complete documentation index at: https://cli.fuxicode.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Fuxi Code dengan GitHub Enterprise Server
> Hubungkan Fuxi 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 Fuxi 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](#plugin-marketplaces-on-ghes).
Untuk repositori di github.com, lihat [Fuxi Code di web](/id/fuxi-code-on-the-web) dan [Code Review](/id/code-review). Untuk menjalankan Fuxi di infrastruktur CI Anda sendiri, lihat [GitHub Actions](/id/github-actions).
Apa yang berfungsi dengan GitHub Enterprise Server
Tabel di bawah menunjukkan fitur Fuxi Code mana yang mendukung GHES dan perbedaan apa pun dari perilaku github.com.
| Fitur | Dukungan GHES | Catatan |
| :----------------- | :--------------- | :--------------------------------------------------------------------------------------------------------------------------------------------- |
| Fuxi Code di web | ✅ Didukung | Pemilik menghubungkan instans GHES sekali; pengembang menggunakan `fuxi --cloud` atau [fuxi.ai/code](https://fuxi.ai/code) seperti biasa |
| Code Review | ✅ Didukung | Tinjauan PR otomatis yang sama seperti github.com |
| Fuxi Security | ✅ Didukung | Tersedia dalam beta publik untuk paket Enterprise di [fuxi.ai/security](https://fuxi.ai/security) |
| Sesi Teleport | ✅ Didukung | Pindahkan sesi antara web dan terminal dengan `--teleport` |
| Pasar plugin | ✅ Didukung | Persyaratan kredensial berbeda menurut permukaan. Lihat [Pasar plugin di GHES](#plugin-marketplaces-on-ghes) |
| Metrik kontribusi | ✅ Didukung | Dikirimkan melalui webhook ke [dasbor analitik](/id/analytics) |
| 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
Pemilik menghubungkan instans GHES Anda ke Fuxi 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 Fuxi 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](#manual-setup) tersedia.
Buka [fuxi.ai/admin-settings/fuxi-code](https://fuxi.ai/admin-settings/fuxi-code) dan temukan bagian GitHub Enterprise Server.
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.
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 Fuxi dengan kredensial aplikasi disimpan secara otomatis.
Dari halaman GitHub App di instans GHES Anda, pasang aplikasi di repositori atau organisasi yang ingin Anda akses Fuxi. Anda dapat memulai dengan subset dan menambahkan lebih banyak nanti.
Kembali ke [fuxi.ai/admin-settings/fuxi-code](https://fuxi.ai/admin-settings/fuxi-code) dan aktifkan [Code Review](/id/code-review#set-up-code-review), Fuxi Security, dan [metrik kontribusi](/id/analytics#enable-contribution-metrics) untuk repositori GHES Anda menggunakan konfigurasi yang sama seperti github.com.
Izin GitHub App
Manifes mengonfigurasi GitHub App dengan izin dan acara webhook yang Fuxi butuhkan di seluruh sesi web, Code Review, Fuxi 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](#github-app-permissions), 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 Fuxi dapat mengkloning repositori dan memposting komentar tinjauan. Jika instans GHES Anda berada di belakang firewall, daftarkan [alamat IP API Anthropic](https://platform.fuxi.com/docs/en/api/ip-addresses).
Alur kerja pengembang
Setelah admin Anda menghubungkan instans GHES, tidak ada konfigurasi sisi pengembang yang diperlukan. Fuxi Code mendeteksi nama host GHES Anda secara otomatis dari git remote di direktori kerja Anda.
Kloning repositori dari instans GHES Anda seperti biasa:
```bash theme={null}
git clone git@github.example.com:platform/api-service.git
cd api-service
```
Kemudian mulai sesi web. Fuxi mendeteksi host GHES dari git remote Anda dan merutekan sesi melalui instans yang dikonfigurasi organisasi Anda:
```bash theme={null}
fuxi --cloud "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 [fuxi.ai/code](https://fuxi.ai/code). Lihat [Fuxi Code di web](/id/fuxi-code-on-the-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 `fuxi --teleport`. Teleport memverifikasi Anda berada di checkout repositori GHES yang sama sebelum mengambil cabang dan memuat riwayat sesi. Lihat [persyaratan teleport](/id/fuxi-code-on-the-web#teleport-requirements) 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:
| Permukaan | Cara instalasi bekerja | Apa yang setiap pengguna butuhkan |
| :---------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Fuxi Code CLI dan desktop | Fuxi Code mengkloning repositori pasar menggunakan kredensial git yang ada di mesin | Akses Git ke host GHES Anda dari mesin mereka |
| Pengaturan terkelola (`extraKnownMarketplaces`) | Fuxi Code mendaftarkan entri dan mengkloning repositori menggunakan kredensial git yang ada di mesin | Akses Git ke host GHES Anda dari mesin mereka |
| Pengaturan plugin organisasi fuxi.ai | Pemilik memilih instans GHES sebagai sumber; backend Anthropic mengambil dan menyinkronkan repositori menggunakan GitHub App dari [pengaturan admin](#admin-setup) | Tidak ada per pengguna setelah ditambahkan. Pemilik yang menambahkannya memerlukan akun GitHub Enterprise mereka sendiri yang terhubung sebagai pemeriksaan akses, dan GitHub App harus diinstal di repositori pasar |
| Pengaturan pengguna fuxi.ai | Backend Anthropic mengambil repositori menggunakan koneksi GitHub Enterprise pengguna yang mengirimkan | Akun GitHub Enterprise mereka sendiri yang terhubung ke Fuxi |
| Fuxi Code di web | Sesi cloud mengkloning pasar di dalam sandbox sesi. Sandbox hanya dapat menjangkau instans GHES Anda ketika repositori sesi berada di instans yang sama, dan kredensial git-nya dibatasi pada repositori sesi | Tidak dapat diandalkan untuk pasar yang dihosting GHES: host yang berbeda dari repositori sesi tidak dapat dijangkau, dan bahkan instalasi instans yang sama dapat gagal. Gunakan CLI, pengaturan terkelola, atau fuxi.ai sebagai gantinya |
Koneksi GitHub Enterprise di fuxi.ai adalah per pengguna ketika pasar ditambahkan dari pengaturan pengguna. [Pengaturan admin](#admin-setup) 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:
```bash theme={null}
/plugin marketplace add https://github.example.com/platform/fuxi-plugins.git
```
URL SSH berfungsi jika mesin sudah mempercayai host GHES Anda:
```bash theme={null}
/plugin marketplace add git@github.example.com:platform/fuxi-plugins.git
```
Fuxi 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](/id/plugin-marketplaces) 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](/id/settings#extraknownmarketplaces), termasuk `.fuxi/settings.json` repositori; pengaturan terkelola mengirimkannya di seluruh organisasi:
```json theme={null}
{
"extraKnownMarketplaces": {
"internal-tools": {
"source": {
"source": "git",
"url": "https://github.example.com/platform/fuxi-plugins.git"
}
}
}
}
```
Fuxi Code menginstal pasar ini secara lokal: mendaftarkan setiap entri dan mengkloning repositori dengan kredensial git yang ada di mesin. Jalur ini tidak melalui fuxi.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](/id/settings#settings-files) untuk lokasi file.
Daftarkan pasar GHES dalam pengaturan terkelola
Jika organisasi Anda menggunakan [pengaturan terkelola](/id/settings) untuk membatasi pasar mana yang dapat ditambahkan pengembang, gunakan tipe sumber `hostPattern` untuk memungkinkan semua pasar dari instans GHES Anda tanpa menghitung setiap repositori:
```json theme={null}
{
"strictKnownMarketplaces": [
{
"source": "hostPattern",
"hostPattern": "^github\\.example\\.com$"
}
]
}
```
Lihat referensi pengaturan [strictKnownMarketplaces](/id/settings#strictknownmarketplaces) dan [extraKnownMarketplaces](/id/settings#extraknownmarketplaces) untuk skema lengkap.
Keterbatasan
Beberapa fitur berperilaku berbeda di GHES daripada di github.com. [Tabel fitur](#what-works-with-github-enterprise-server) merangkum dukungan; bagian ini mencakup solusi.
* **Perintah `/install-github-app`**: ikuti alur [pengaturan admin](#admin-setup) di fuxi.ai sebagai gantinya. Jika Anda juga menginginkan alur kerja GitHub Actions di GHES, sesuaikan [alur kerja contoh](https://github.com/anthropics/fuxi-code-action/blob/main/examples/fuxi.yml) 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 Fuxi dapat menggunakan perintah `gh` dalam sesi.
Troubleshooting
Sesi web gagal mengkloning repositori
Jika `fuxi --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 Fuxi 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](#allowlist-ghes-marketplaces-in-managed-settings).
Penambahan pasar di fuxi.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 Fuxi, 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 [fuxi.ai/code](https://fuxi.ai/code) menawarkan opsi koneksi untuk setiap instans GHES yang dikonfigurasi, dan Owner juga dapat terhubung dari bagian GitHub Enterprise dari [pengaturan admin Fuxi Code](https://fuxi.ai/admin-settings/fuxi-code). Kemudian tambahkan pasar lagi. Alternatifnya, minta Owner untuk menambahkan pasar dalam pengaturan plugin organisasi, yang menghilangkan persyaratan koneksi per pengguna.
Di permukaan fuxi.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](https://platform.fuxi.com/docs/en/api/ip-addresses).
Halaman-halaman ini mencakup fitur yang direferensikan di seluruh panduan ini secara lebih mendalam:
* [Fuxi Code di web](/id/fuxi-code-on-the-web): jalankan sesi Fuxi Code di infrastruktur cloud
* [Code Review](/id/code-review): tinjauan PR otomatis
* [Pasar plugin](/id/plugin-marketplaces): bangun dan distribusikan katalog plugin
* [Analytics](/id/analytics): lacak penggunaan dan metrik kontribusi
* [Pengaturan terkelola](/id/settings): konfigurasi kebijakan di seluruh organisasi
* [Konfigurasi jaringan](/id/network-config): persyaratan firewall dan daftar izin IP