Snapshot dokumentasi · CLI 7.30.1 · SDK 2.6.53. Desktop memakai runtime yang disertakan dalam rilisnya sendiri. Perintah dan contoh tetap sama dengan sumber bahasa Inggris. Sumber bahasa Inggris

Hubungkan penyedia model pertama

Pilih koneksi

Penyedia adalah koneksi ke layanan model; model adalah pilihan tertentu melalui koneksi itu. Menghubungkan penyedia tidak memilih semua model atau memberikan hak akses akun.

Di antarmuka terminal, masukkan /connect, lalu pilih jalur berikut. Desktop memiliki pengaturan penyedia dan runtime bawaan sendiri; perintah garis miring ini berlaku untuk terminal.

API cloud: pilih API Cloud Provider, pilih layanan, lalu ikuti petunjuk kredensial. Langganan chat belum tentu mencakup akses atau kredit API.
CLI pemrograman: pasang dan masuk ke CLI yang didukung terlebih dahulu, lalu pilih CLI Provider. AX Code memakai kembali login lokal itu; kemampuan bergantung pada adaptor.
Model lokal: jalankan Ollama atau LM Studio dan muat model yang mendukung pemanggilan alat, lalu pilih Local LLM runtime dan konfirmasi endpoint. AX-Engine runtime memiliki alur pengaturan dan unduhan model tersendiri pada Mac yang didukung.
Gateway: pilih AX Trust untuk endpoint AX Trust, API Cloud Provider → Custom API provider untuk gateway lain, atau Private GPU cloud untuk deployment kompatibel khusus. Masukkan URL layanan, token, dan ID model persis yang diumumkan layanan.

Periksa koneksi

Jalankan perintah berikut di terminal interaktif. Perintah login meminta penyedia dan kredensial; jangan tempel kunci asli ke perintah bersama atau berkas repositori.

ax-code providers login
ax-code providers list
ax-code models

Penyedia dan ID model yang dapat digunakan seharusnya muncul. Kredensial tersimpan atau daftar model yang berhasil tidak membuktikan izin inferensi. Lanjutkan ke pemilihan model dan kirim permintaan uji kecil.

Kelola kredensial dan konfigurasi

Gunakan /providers untuk mengelola koneksi dan /connect untuk mengganti kunci. Menonaktifkan mempertahankan kredensial tersimpan; memutus koneksi menghapusnya. Variabel lingkungan dan kunci dalam konfigurasi masih dapat menyediakan akses.

Gunakan ax-code.json proyek untuk pengaturan bersama yang bukan rahasia, atau ~/.config/ax-code/ax-code.json global untuk bawaan pribadi. Jangan masukkan rahasia ke kontrol versi; gunakan prompt kredensial atau referensi lingkungan dalam panduan gateway. Mulai ulang setelah mengedit konfigurasi secara manual.

Jika pengaturan gagal

Autentikasi gagal: pastikan kunci sesuai layanan, endpoint, dan paket API yang dipilih. Untuk CLI pemrograman, periksa login CLI itu terlebih dahulu.
Daftar kosong atau koneksi ditolak: pastikan server lokal berjalan, model dimuat, serta URL dan port benar. Ollama biasanya memakai http://localhost:11434/v1; LM Studio memakai http://localhost:1234/v1.
Model ditolak: gunakan ID persis dari endpoint dan periksa izin akun. Nama tampilan gateway dapat berbeda dari ID permintaan ke hulu.
Penyedia tidak muncul: periksa enabled_providers dan disabled_providers. Untuk diagnosis instalasi, jalankan ax-code doctor; ini tidak memvalidasi akun penyedia.

Langkah berikutnya

Katalog penyedia dan metode login · Gateway khusus dan endpoint GPU privat · Pilih model · Buat AX Wiki · Pusat dokumentasi