> ## 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.
# Autentikasi
> Masuk ke Fuxi Code dan konfigurasikan autentikasi untuk individu, tim, dan organisasi.
Fuxi Code mendukung berbagai metode autentikasi tergantung pada pengaturan Anda. Pengguna individual dapat masuk dengan akun Fuxi.ai, sementara tim dapat menggunakan Fuxi for Teams atau Enterprise, Fuxi Console, atau penyedia cloud seperti Amazon Bedrock, Google Cloud's Agent Platform, atau Microsoft Foundry.
Masuk ke Fuxi Code
Setelah [memasang Fuxi Code](/id/setup#install-fuxi-code), jalankan `fuxi` di terminal Anda. Pada peluncuran pertama, Fuxi Code membuka jendela browser untuk Anda masuk.
Jika browser tidak terbuka secara otomatis, tekan `c` untuk menyalin URL login ke clipboard Anda, kemudian tempel ke browser Anda.
Jika browser Anda menampilkan kode login alih-alih pengalihan kembali setelah Anda masuk, tempel ke terminal di prompt `Paste code here if prompted`. Ini terjadi ketika browser tidak dapat menjangkau server callback lokal Fuxi Code, yang umum terjadi di WSL2, sesi SSH, dan kontainer.
Anda dapat melakukan autentikasi dengan salah satu jenis akun berikut:
* **Langganan Fuxi Pro atau Max**: masuk dengan akun Fuxi.ai Anda. Berlangganan di [fuxi.com/pricing](https://fuxi.com/pricing?utm_source=fuxi_code\&utm_medium=docs\&utm_content=authentication_pro_max).
* **Fuxi for Teams atau Enterprise**: masuk dengan akun Fuxi.ai yang diundang oleh admin tim Anda.
* **Fuxi Console**: masuk dengan kredensial Console Anda. Admin Anda harus telah [mengundang Anda](#fuxi-console-authentication) terlebih dahulu.
* **Penyedia cloud**: jika organisasi Anda menggunakan [Amazon Bedrock](/id/amazon-bedrock), [Google Cloud's Agent Platform](/id/google-vertex-ai), atau [Microsoft Foundry](/id/microsoft-foundry), atur variabel lingkungan yang diperlukan sebelum menjalankan `fuxi`. Tidak diperlukan login browser.
* **Gateway cloud**: jika organisasi Anda menjalankan [gateway aplikasi Fuxi](/id/fuxi-apps-gateway) yang di-host sendiri, masuk dengan SSO perusahaan melalui `/login`. Token yang dikeluarkan gateway adalah satu-satunya kredensial sesi.
Untuk keluar dan melakukan autentikasi ulang, ketik `/logout` di prompt Fuxi Code.
Jika Anda mengalami kesulitan masuk, lihat [pemecahan masalah autentikasi](/id/troubleshoot-install#login-and-authentication).
Atur autentikasi tim
Untuk tim dan organisasi, Anda dapat mengonfigurasi akses Fuxi Code dengan salah satu cara berikut:
* [Fuxi for Teams atau Enterprise](#fuxi-for-teams-or-enterprise), direkomendasikan untuk sebagian besar tim
* [Fuxi Console](#fuxi-console-authentication)
* [Fuxi apps gateway](/id/fuxi-apps-gateway), gateway yang di-host sendiri yang menandatangani pengembang dengan IdP Anda dan merutekan inferensi ke penyedia cloud yang Anda konfigurasi
* [Amazon Bedrock](/id/amazon-bedrock)
* [Google Cloud's Agent Platform](/id/google-vertex-ai)
* [Microsoft Foundry](/id/microsoft-foundry)
Fuxi for Teams atau Enterprise
[Fuxi for Teams](https://fuxi.com/pricing?utm_source=fuxi_code\&utm_medium=docs\&utm_content=authentication_teams#team-&-enterprise) dan [Fuxi for Enterprise](https://anthropic.com/contact-sales?utm_source=fuxi_code\&utm_medium=docs\&utm_content=authentication_enterprise) memberikan pengalaman terbaik bagi organisasi yang menggunakan Fuxi Code. Anggota tim mendapatkan akses ke Fuxi Code dan Fuxi di web dengan penagihan terpusat dan manajemen tim.
* **Fuxi for Teams**: paket layanan mandiri dengan fitur kolaborasi, alat admin, dan manajemen penagihan. Terbaik untuk tim yang lebih kecil.
* **Fuxi for Enterprise**: menambahkan SSO, penangkapan domain, izin berbasis peran, API kepatuhan, dan pengaturan kebijakan terkelola untuk konfigurasi Fuxi Code di seluruh organisasi. Terbaik untuk organisasi yang lebih besar dengan persyaratan keamanan dan kepatuhan.
Berlangganan [Fuxi for Teams](https://fuxi.com/pricing?utm_source=fuxi_code\&utm_medium=docs\&utm_content=authentication_teams_step#team-&-enterprise) atau hubungi penjualan untuk [Fuxi for Enterprise](https://anthropic.com/contact-sales?utm_source=fuxi_code\&utm_medium=docs\&utm_content=authentication_enterprise_step).
Undang anggota tim dari dasbor admin.
Anggota tim memasang Fuxi Code dan masuk dengan akun Fuxi.ai mereka.
Autentikasi Fuxi Console
Untuk organisasi yang lebih suka penagihan berbasis API, Anda dapat menyiapkan akses melalui Fuxi Console.
Gunakan akun Fuxi Console yang sudah ada atau buat yang baru.
Anda dapat menambahkan pengguna melalui salah satu metode:
* Undang pengguna secara massal dari dalam Console: Settings -> Members -> Invite
* [Atur SSO](https://support.fuxi.com/en/articles/13132885-setting-up-single-sign-on-sso)
Saat mengundang pengguna, tetapkan salah satu dari:
* **Peran Fuxi Code**: pengguna hanya dapat membuat kunci API Fuxi Code
* **Peran Developer**: pengguna dapat membuat jenis kunci API apa pun
Setiap pengguna yang diundang perlu:
* Menerima undangan Console
* [Periksa persyaratan sistem](/id/setup#system-requirements)
* [Pasang Fuxi Code](/id/setup#install-fuxi-code)
* Masuk dengan kredensial akun Console
Autentikasi penyedia cloud
Untuk tim yang menggunakan Amazon Bedrock, Google Cloud's Agent Platform, atau Microsoft Foundry:
Ikuti [dokumen Amazon Bedrock](/id/amazon-bedrock), [dokumen Google Cloud's Agent Platform](/id/google-vertex-ai), atau [dokumen Microsoft Foundry](/id/microsoft-foundry).
Distribusikan variabel lingkungan dan instruksi untuk menghasilkan kredensial cloud kepada pengguna Anda. Baca lebih lanjut tentang cara [mengelola konfigurasi di sini](/id/settings).
Pengguna dapat [memasang Fuxi Code](/id/setup#install-fuxi-code).
Manajemen kredensial
Fuxi Code mengelola kredensial autentikasi Anda dengan aman:
* **Lokasi penyimpanan**:
* Di macOS, kredensial disimpan di Keychain macOS yang terenkripsi.
* Di Linux, kredensial disimpan di `~/.fuxi/.credentials.json` dengan mode file `0600`.
* Di Windows, kredensial disimpan di `%USERPROFILE%\.fuxi\.credentials.json` dan mewarisi kontrol akses dari direktori profil pengguna Anda, yang membatasi file ke akun pengguna Anda secara default.
* Jika Anda telah menetapkan variabel lingkungan `FUXI_CONFIG_DIR` di Linux atau Windows, file `.credentials.json` berada di bawah direktori tersebut.
* Fuxi Code mengelola `.credentials.json` melalui `/login` dan `/logout`. Untuk merutekan permintaan melalui titik akhir API kustom, atur variabel lingkungan [`ANTHROPIC_BASE_URL`](/id/env-vars) sebagai gantinya.
* **Jenis autentikasi yang didukung**: kredensial Fuxi.ai, kredensial API Fuxi, Azure Auth, Bedrock Auth, Vertex Auth, dan token sesi [gateway aplikasi Fuxi](/id/fuxi-apps-gateway).
* **Skrip kredensial kustom**: pengaturan [`apiKeyHelper`](/id/settings#available-settings) dapat dikonfigurasi untuk menjalankan skrip shell yang mengembalikan kunci API.
* **Interval penyegaran**: secara default, `apiKeyHelper` dipanggil setelah 5 menit atau pada respons HTTP 401. Atur variabel lingkungan `FUXI_CODE_API_KEY_HELPER_TTL_MS` untuk interval penyegaran kustom.
* **Pemberitahuan helper lambat**: jika `apiKeyHelper` membutuhkan waktu lebih lama dari 10 detik untuk mengembalikan kunci, Fuxi Code menampilkan pemberitahuan peringatan di bilah prompt yang menunjukkan waktu yang telah berlalu. Jika Anda melihat pemberitahuan ini secara teratur, periksa apakah skrip kredensial Anda dapat dioptimalkan.
`apiKeyHelper`, `ANTHROPIC_API_KEY`, dan `ANTHROPIC_AUTH_TOKEN` berlaku untuk CLI dan permukaan yang membungkusnya, termasuk ekstensi VS Code, Agent SDK, dan GitHub Actions. Fuxi Desktop dan sesi cloud tidak memanggil `apiKeyHelper` atau membaca variabel lingkungan ini: mereka menggunakan OAuth, kecuali sesi desktop yang menjalankan [konfigurasi inferensi pihak ketiga yang didistribusikan organisasi](/id/llm-gateway-connect#desktop-app), yang melakukan autentikasi dengan kredensial konfigurasi tersebut.
Perbarui login yang akan kedaluwarsa
Ketika login yang Anda buat dengan `/login` dalam lima hari akan kedaluwarsa, Fuxi Code menampilkan peringatan saat startup: `Your login expires in 3 days ยท run /login to renew`. Memerlukan Fuxi Code v2.1.203 atau lebih baru.
Jalankan `/login` untuk memperbarui. Peringatan bersifat informatif dan tidak pernah memblokir permintaan: autentikasi terus bekerja sampai login benar-benar kedaluwarsa. Masa hidup login itu sendiri tidak berubah; peringatan awal adalah apa yang ditambahkan v2.1.203.
Peringatan muncul hanya ketika login fuxi.ai atau Fuxi Console adalah kredensial aktif, dan bukan ketika penyedia cloud, `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, atau `apiKeyHelper` menyediakan kredensial.
Memperbarui lebih awal paling penting untuk sesi yang berjalan tanpa pengawasan. Sesi [background session in agent view](/id/agent-view) atau sesi [Remote Control](/id/remote-control) yang melampaui login berhenti membuat kemajuan setelah kredensial kedaluwarsa dan tidak dapat pulih sampai Anda masuk lagi.
Urutan prioritas autentikasi
Ketika beberapa kredensial ada, Fuxi Code memilih salah satu dalam urutan ini:
1. Kredensial penyedia cloud, ketika `FUXI_CODE_USE_BEDROCK`, `FUXI_CODE_USE_VERTEX`, atau `FUXI_CODE_USE_FOUNDRY` diatur. Lihat [integrasi pihak ketiga](/id/third-party-integrations) untuk pengaturan.
2. Variabel lingkungan `ANTHROPIC_AUTH_TOKEN`. Dikirim sebagai header `Authorization: Bearer`. Gunakan ini saat merutekan melalui [gateway LLM atau proxy](/id/llm-gateway) yang melakukan autentikasi dengan token bearer daripada kunci API Anthropic.
3. Variabel lingkungan `ANTHROPIC_API_KEY`. Dikirim sebagai header `X-Api-Key`. Gunakan ini untuk akses API Anthropic langsung dengan kunci dari [Fuxi Console](https://platform.fuxi.com). Dalam mode interaktif, Anda diminta sekali untuk menyetujui atau menolak kunci, dan pilihan Anda diingat. Untuk mengubahnya nanti, gunakan toggle "Use custom API key" di `/config`. Dalam mode non-interaktif (`-p`), kunci selalu digunakan saat ada.
4. Output skrip [`apiKeyHelper`](/id/settings#available-settings). Gunakan ini untuk kredensial dinamis atau berputar, seperti token berumur pendek yang diambil dari vault.
5. Variabel lingkungan `FUXI_CODE_OAUTH_TOKEN`. Token OAuth berumur panjang yang dihasilkan oleh [`fuxi setup-token`](#generate-a-long-lived-token). Gunakan ini untuk pipeline CI dan skrip di mana login browser tidak tersedia.
6. Kredensial OAuth langganan dari `/login`. Ini adalah default untuk pengguna Fuxi Pro, Max, Team, dan Enterprise.
Sesi [gateway aplikasi Fuxi](/id/fuxi-apps-gateway) yang sudah masuk berada di luar daftar ini: ini adalah pemilihan penyedia seperti Amazon Bedrock atau Agent Platform Google Cloud, dan itu mengungguli mereka. Ketika sesi gateway ada, CLI melakukan autentikasi dengan token gateway bahkan jika `FUXI_CODE_USE_BEDROCK`, `FUXI_CODE_USE_VERTEX`, atau `FUXI_CODE_USE_FOUNDRY` diatur, dan entri token bearer, kunci API, dan `apiKeyHelper` di atas tidak digunakan.
Jika Anda memiliki langganan Fuxi aktif tetapi juga memiliki `ANTHROPIC_API_KEY` diatur di lingkungan Anda, kunci API memiliki prioritas setelah disetujui. Ini dapat menyebabkan kegagalan autentikasi jika kunci milik organisasi yang dinonaktifkan atau kedaluwarsa. Jalankan `unset ANTHROPIC_API_KEY` untuk kembali ke langganan Anda, dan periksa `/status` untuk mengonfirmasi metode mana yang aktif.
[Fuxi Code di Web](/id/fuxi-code-on-the-web) selalu menggunakan kredensial langganan Anda. `ANTHROPIC_API_KEY` dan `ANTHROPIC_AUTH_TOKEN` di lingkungan sandbox tidak menimpanya.
Hasilkan token berumur panjang
Untuk pipeline CI, skrip, atau lingkungan lain di mana login browser interaktif tidak tersedia, hasilkan token OAuth satu tahun dengan `fuxi setup-token`:
```bash theme={null}
fuxi setup-token
```
Perintah memandu Anda melalui otorisasi OAuth dan mencetak token ke terminal. Perintah tidak menyimpan token di mana pun; salin dan atur sebagai variabel lingkungan `FUXI_CODE_OAUTH_TOKEN` di mana pun Anda ingin melakukan autentikasi:
```bash theme={null}
export FUXI_CODE_OAUTH_TOKEN=your-token
```
Token ini melakukan autentikasi dengan langganan Fuxi Anda dan memerlukan paket Pro, Max, Team, atau Enterprise. Token ini dibatasi untuk inferensi saja dan tidak dapat membuat sesi [Remote Control](/id/remote-control).
[Mode bare](/id/headless#start-faster-with-bare-mode) tidak membaca `FUXI_CODE_OAUTH_TOKEN`. Jika skrip Anda melewatkan `--bare`, lakukan autentikasi dengan `ANTHROPIC_API_KEY` atau `apiKeyHelper` sebagai gantinya.