Halaman ini diterjemahkan dari dokumentasi bahasa Inggris. Perintah, pengenal, dan contoh tidak diubah. Runtime 7.24.4 · SDK 2.6.7. Sumber bahasa Inggris

Penyedia dan model yang didukung

Status: Aktif Cakupan: keadaan saat ini Terakhir ditinjau: 2026-09-19 Pemilik: ax-code runtime

Halaman ini mencantumkan preset penyedia yang diekspos AX Code pada alur penyiapan bawaan. Sumber kebenaran adalah daftar izin penyedia runtime di packages/ax-code/src/provider/default-setup-providers.ts, cuplikan model yang dibundel di packages/ax-code/src/provider/models-snapshot.json, preset runtime lokal di packages/ax-code/src/provider/local-runtime.ts, dan definisi AX Engine di packages/ax-code/src/provider/ax-engine/constants.ts.

Gunakan /connect di antarmuka terminal atau ax-code providers login <provider-id> untuk penyiapan interaktif. Lingkungan tanpa antarmuka dan CI juga dapat menyediakan variabel lingkungan yang tercantum.

Mengelola penyedia yang terhubung

Tampilan sesi mempertahankan bilah atas dengan ID sesi (klik untuk menyalin), judul, dan status langsung, diikuti entri Penyedia yang menampilkan jumlah yang terhubung; klik entri itu atau kelola untuk membuka pengelola penyedia, yang juga tersedia sebagai perintah /providers. Dari sana Anda dapat memilih model, menonaktifkan, atau memutus setiap penyedia, atau melompat ke alur /connect yang penuh.

• Ganti kunci: pilih penyedia di /connect dan pilih Ganti kunci, atau jalankan ulang ax-code providers login <provider-id>.
• Nonaktifkan sementara: pilih Nonaktifkan di /providers atau /connect, atau jalankan ax-code providers disable <provider-id>. Ini menambahkan penyedia ke disabled_providers di konfigurasi global dan mempertahankan kredensial tersimpan. Penyedia yang dinonaktifkan tetap terlihat di /providers dan di bawah Dinonaktifkan pada /connect, serta dapat dinyalakan kembali dengan Aktifkan atau ax-code providers enable <provider-id>.
• Putuskan secara permanen: pilih Putuskan di /providers atau /connect, atau jalankan ax-code providers logout <provider-id> — ini menghapus kredensial tersimpan dari auth.json.

Katalog model terhosting dibundel dengan setiap rilis AX Code dan disaring untuk kapabilitas agen pengodean yang dapat dipakai. Jalankan ax-code models <provider-id> untuk ID model yang otoritatif pada rilis yang terpasang; registri mentah dan daftar web yang disalin dapat berisi model yang disembunyikan AX Code karena tidak punya keluaran teks atau pemanggilan alat. Preset penyedia tidak berarti setiap model gratis atau tersedia di setiap akun.

Pilihan runtime

Memilih model tanpa versi

Baik TUI maupun ax-code run menerima nama keluarga --model yang tidak peka huruf ini:

Misalnya, ax-code --model glm membuka TUI dengan GLM Flash, dan ax-code run --model qwen -- "Review this change" meminta Qwen Flash. Letakkan prompt setelah -- (atau teruskan --prompt / --prompt-file); --file melampirkan berkas dan bukan berkas prompt. ax-code models mencantumkan ID provider/model yang dapat dipakai. Nama keluarga diselesaikan melalui penyedia native atau gateway terhubung yang menyajikan model yang sama. Anda juga dapat menamai penyedia: --model my-gateway/glm. Gunakan ID penuh seperti my-gateway/glm-5.3 untuk meminta versi atau tingkat tertentu.

Menghilangkan --model mempertahankan pilihan model yang dikonfigurasi, agen, sesi, dan yang baru-baru ini. Ketika tidak ada pilihan yang dapat dipakai, urutan cadangan bersama mulai dari DeepSeek Flash, GLM Flash, lalu Qwen Flash di seluruh penyedia yang terhubung. Penyiapan penyedia punya bawaannya sendiri: Alibaba Coding Plan memakai qwen3-coder-plus; Alibaba Token Plan memakai qwen3.8-flash.

Menghubungkan runtime

Pilihan di /connect diurutkan Penyedia cloud API, Penyedia CLI, Runtime AX-Engine, Runtime LLM lokal, Cloud GPU privat, dan AX Trust. Runtime AX-Engine membuka pemilihan model lokal dan pengelolaan runtime secara langsung. Runtime LLM lokal mencantumkan pilihan ini berurutan:

Preset MTPLX dan oMLX tersedia di checkout sumber; biner terpaket v7.19.3 tidak menyertakannya. Lihat Penyiapan MTPLX dan oMLX untuk konfigurasi kapabilitas alat, autentikasi opsional, dan catatan port bawaan yang dipakai bersama.

Jalankan server lokal Anda, pilih entri menunya, lalu konfirmasi atau sunting titik akhir. AX Code menambahkan /v1 jika dihilangkan. Lainnya menyimpan satu titik akhir yang dapat dikonfigurasi di bawah local-llm; pilih lagi untuk mengubah titik akhir. LMStudio dan Lainnya memakai alur penyiapan lokal yang ada tanpa prompt token API. LM Studio mendokumentasikan titik akhir daftar model.

Pilihan penyiapan menghormati enabled_providers dan disabled_providers. Sekadar membuka pemilih tidak mengaktifkan atau memeriksa server lokal ini. Model lokal eksternal yang ditemukan mempertahankan bawaan kapabilitas yang konservatif; model harus mendukung pemanggilan alat agar dapat dipilih untuk alur kerja agen pengodean.

Penyedia API cloud

Penyedia ini memanggil API terhosting atau titik akhir paket akun yang terhosting.

MiniMax mengganti nama Coding Plan menjadi Token Plan. ID penyedia tetap minimax-coding-plan / minimax-cn-coding-plan agar cocok dengan models.dev dan OpenCode. Gunakan kunci Token Plan (sk-cp-…) dari platform.minimax.io (internasional) atau platform.minimaxi.com (Tiongkok).

huggingface adalah router Penyedia Inferensi Serverless yang terhosting (https://router.huggingface.co/v1). Ia tidak terkait dengan cache cuplikan Hugging Face lokal yang dipakai AX Engine untuk menyimpan model lokal yang diunduh — menghubungkan huggingface tidak pernah memulai atau memerlukan mesin lokal.

Untuk eksekusi pertama tanpa biaya, lihat Mulai cepat API tingkat gratis. Halaman itu membedakan penawaran gratis penyedia dari kompatibilitas AX Code dan menjelaskan mengapa katalog API gratis eksternal sendiri bukan matriks dukungan.

Grok hanya didukung melalui penyedia grok-build-cli yang tercantum di bawah. AX Code tidak lagi menyertakan penyedia API cloud xai langsung; kredensial API Grok yang ada tidak membuat koneksi.

github-copilot adalah jembatan akun GitHub Copilot. Ia bukan API github-models terpisah yang dicantumkan beberapa direktori API gratis.

Gateway yang kompatibel dengan OpenAI dan Anthropic juga didukung melalui konfigurasi penyedia khusus. Lihat Penyedia khusus dan gateway.

Cloud GPU privat

Penyedia ini muncul di /connect di bawah Cloud GPU privat, setelah runtime LLM lokal.

Pilih Penyedia khusus untuk menghubungkan titik akhir GPU Anda sendiri yang kompatibel dengan OpenAI. Masukkan URL dan kunci API; AX Code menemukan model dari /v1/models dan menyimpan kunci di penyimpanan autentikasi terenkripsi. Koneksi tersimpan tetap di cloud GPU privat. Pilih lagi untuk memilih model, mengganti titik akhir, atau memutus. Entri ini menyimpan satu titik akhir yang dapat dikonfigurasi di bawah custom-private-gpu.

Katalog (kunci API)

Katalog GPU terhosting bergaya OpenCode. Model berasal dari cuplikan models.dev yang dibundel. Hubungkan dengan kunci API.

Router Hugging Face yang terhosting (huggingface / HF_TOKEN) tetap di Penyedia API cloud. Titik akhir inferensi Hugging Face khusus tercantum di bawah.

Khusus (URL + token)

Titik akhir GPU khusus bergaya PAI. Tempel URL yang kompatibel dengan OpenAI dan token; AX Code memanggil GET …/models dan memakai ID model yang diterapkan. Ini bukan penyedia Alibaba Coding Plan / Token Plan (DashScope).

sagemaker untuk URL yang kompatibel dengan OpenAI di depan SageMaker (vLLM / TGI / API Gateway). Ia tidak menandatangani AWS SigV4.

Koneksi AX Trust

AX Trust adalah kategori terakhir di /connect, setelah cloud GPU privat. Pilih Hubungkan AX Trust, masukkan URL dasar gateway termasuk /v1, dan berikan kunci API klien. AX Code menemukan model gateway dan menyimpan kunci di penyimpanan autentikasi terenkripsi. Koneksi tersimpan menawarkan pemilihan model, pembaruan titik akhir, penyegaran model, dan penghapusan.

Menghubungkan ulang URL yang ada mempertahankan ID penyedia, model, dan kunci tersimpannya ketika token dikosongkan. Penyedia tetap di AX Trust bahkan dengan nama khusus. ID warisan ax-trust dan ax-trust-* juga muncul di kategori ini. AX Trust tetap memiliki kebijakan gateway, persetujuan, dan audit. AX Code mengirim header afinitas sesi pada koneksi ini secara bawaan.

Penyedia CLI

Penyedia CLI memakai ulang CLI vendor lokal dan login atau sesinya, alih-alih menyimpan kunci API terhosting di AX Code.

Jalankan login CLI vendor terlebih dahulu jika diperlukan, lalu jalankan ax-code providers login <provider-id>. AX Code memeriksa perintah CLI dan menyimpan kredensial penanda lokal setelah pemeriksaan berhasil.

Untuk Muse Code, pasang biner lokal muse, jalankan muse login (atau atur META_API_KEY), lalu ax-code providers login muse-cli. AX Code memakai ulang sesi CLI Muse (~/.config/muse) alih-alih menyimpan kunci API Meta yang terhosting. Penyedia API terhosting meta tetap koneksi yang terpisah.

MiniMax Token Plan yang terhosting tetap tersedia sebagai minimax-coding-plan / minimax-cn-coding-plan. Tidak ada penyedia MiniMax Code CLI atau Kimi Code CLI yang dibundel.

Penyedia lokal AX Engine

ax-engine adalah penyedia inferensi lokal bawaan. Ia hanya tersedia pada Mac Apple Silicon yang memenuhi syarat dan hanya menawarkan paket pengembangan AutomatosX Tiel Coder dan Cyber-Tiel Coder 35B A3B MXFP4 MTP. Kapabilitas native diperiksa saat model mulai.

Qwen3.8 27B, Ornith, Qwen3-Coder-Next, dan semua repositori lain dikecualikan dari pemilihan terkelola. Catatan historis tetap dapat dibaca untuk status dan pembersihan.

Model lokal bawaan adalah tiel-coder-35b-axq-mxfp4. Lihat Pemilihan model AX Engine untuk repositori yang dipilih secara persis, memori, dan panduan disk.

Untuk antarmuka lampiran loopback yang dikonfigurasi terpisah dan sudah ada, /v1/models bersifat otoritatif: AX Code menemukan ID model yang hidup, batas konteks/keluaran, modalitas, dan dukungan panggilan alat terstruktur. Model yang tidak mengiklankan pemanggilan alat terstruktur tidak dipakai untuk permintaan agen pengodean.

AX Engine memakai profil alat ringkas core secara bawaan (bash, penemuan/baca/sunting/tulis berkas, dan skills). Atur provider.ax-engine.options.toolProfile ke full hanya untuk penerapan khusus yang punya konteks cukup untuk registri alat lengkap.

Memasang mesin

Inferensi lokal memerlukan AX Engine 7.5.7 atau lebih baru. Pemasang Mac Apple Silicon sudah menyertakan sidecar AX Engine yang mandiri (engine/<version>/ di samping runtime CLI), jadi Mac yang bersih tidak memerlukan Homebrew.

AX Code kemudian menyelesaikan biner dalam urutan ini:

1. provider.ax-engine.options.binaryPath di ax-code.json (memerlukan versi terverifikasi setidaknya 7.5.7)
2. variabel lingkungan AX_ENGINE_BIN (memerlukan versi terverifikasi setidaknya 7.5.7)
3. ax-engine pada PATH Anda (memerlukan versi terverifikasi setidaknya 7.5.7)
4. pemasangan overlay yang dikelola AX Code (ax-code providers ax-engine install; juga memerlukan setidaknya 7.5.7)
5. sidecar yang dibundel di runtime Mac saat ini

Ia pertama memeriksa --version dan kembali ke install.version dari ax-engine doctor --json. Kode keluar Doctor melaporkan kesiapan host (rantai alat Metal, berkas MLX), jadi keluar bukan nol tetap dihitung ketika JSON itu berisi versi. AX Code memiliki pengaktifan server dan biasanya meluncurkan ax-engine serve pada 127.0.0.1:31418. Formula Homebrew opsional tetap alternatif bagi pengguna yang menginginkan mesin milik brew; ia tidak diharuskan.

Peluncuran Tiel terkelola memakai jendela katalog (65,536 token konteks dan 8,192 token keluaran), yang lebih besar daripada bawaan 16,384 token bawaan ax-engine serve agar prompt agen muat. Kecilkan salah satu anggaran dengan provider.ax-engine.options.contextTokens dan provider.ax-engine.options.maxOutputTokens (outputTokens adalah kenop keluaran yang sama). Nama lingkungan adalah AX_ENGINE_CONTEXT_TOKENS dan AX_ENGINE_MAX_OUTPUT_TOKENS (AX_ENGINE_OUTPUT_TOKENS adalah alias). Penimpaan hanya dapat mempersempit langit-langit katalog: nilai yang lebih besar atau tidak valid dilaporkan dan diabaikan, dan jendela Tiel atau Qwen3.8 yang bukan kelipatan 1,024 diturunkan agar blok cache prefiks tetap 1,024 token. Angka yang sama dipakai server yang berjalan dan batas model. Kartu /v1/models yang hidup dapat mengecilkan jendela itu lebih lanjut, dan tidak dapat menaikkannya. Opsi yang dikonfigurasi menang, dan AX Code memperingatkan ketika nilai lingkungan diabaikan. Peringatan yang sama dikeluarkan ketika binaryPath mengabaikan AX_ENGINE_BIN, atau ketika connectionMode / baseURL mengabaikan AX_ENGINE_HOST. Jendela yang lebih kecil dapat terlalu kecil untuk prompt agen penuh; AX Code kemudian menolak model alih-alih mengirim prompt yang tidak dapat ditampung server.

Tiel dan Cyber-Tiel mengiklankan pemanggilan alat terstruktur. Kartu /v1/models yang hidup tetap menimpa iklan itu setelah server berjalan. mtpPolicy: disabled mematikan MTP bahkan ketika versi biner tidak dapat dibaca; auto dan required tetap memerlukan AX Engine 7.4.0 atau lebih baru.

Pemasangan PATH atau overlay yang kehilangan libmlx.dylib / mlx.metallib ditolak. Arsip yang dibundel dan overlay adalah muatan macOS 7.5.7 yang mandiri.

Memasang mesin tidak mengunduh model. Pilih dan unduh model setelahnya dari halaman Model Desktop atau dengan ax-code providers ax-engine prepare. Cuplikan dasar yang kompatibel dan lengkap yang sudah ada di cache Hugging Face diterima untuk decode langsung; prepare --download memakai paket MTP yang diutamakan katalog jika tersedia.

Gunakan /connect -> Runtime AX-Engine -> Pilih model. AX Code mengonfigurasi dan memulai runtime lokal secara otomatis ketika model yang dipilih diperlukan; tidak perlu URL atau kunci API. Lihat status, Hentikan runtime lokal, dan Nonaktifkan mengelola runtime lokal. Memilih model juga mengganti pengaturan lampiran manual warisan dengan penyiapan lokal terkelola.

Mesin dikirim hanya untuk macOS Apple Silicon. Pada host lain, gunakan penyedia terhosting atau gateway penyedia yang kompatibel dengan OpenAI; server AX Code hanya lokal.