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

Mulai di sini

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

Jika README akar adalah cara tercepat memasang AX Code, halaman ini adalah cara tercepat memahaminya.

Edisi dan ketersediaan

Mulai dengan AX Code Standard, edisi sumber terbuka yang gratis untuk pemakaian pribadi dan komersial. Gunakan model lokal atau cloud; AX Engine menyediakan jalur inferensi lokal native pada Mac Apple Silicon yang didukung. Izin yang ada, tinjauan perubahan, dan bukti eksekusi lokal tetap menjadi kapabilitas inti.

Business adalah penawaran proprietari yang direncanakan untuk tata kelola organisasi melalui AX Trust dan alur bisnis melalui AutomatosX. Memakai Standard di tempat kerja sendiri tidak memerlukan lisensi Business. Lihat Standard dan Business untuk rincian.

Pemasang bertanda tangan dan arsip runtime tersedia secara anonim dari download.ax-code.com. Baca panduan pemasangan dan panduan peningkatan dan pemulihan. Dokumentasi teknis publik dihosting di ax-code.app/id/docs/, independen dari akses sumber. Sudah terpasang? Buka terminal di proyek Anda, jalankan ax-code, lalu gunakan /connect di dalam TUI untuk memilih penyedia. Mulai dengan pertanyaan tentang proyek, minta perubahan kecil, dan tinjau diff serta pemeriksaan proyek sebelum mengomit. Gunakan ax-code doctor jika runtime yang terpasang perlu diagnosis.

Apa itu AX Code

AX Code adalah runtime pengodean AI. Ia menggabungkan:

• agen untuk tugas pengodean yang berbeda
• eksekusi alat yang eksplisit
• pemilihan model dan penyedia
• keadaan sesi yang menetap
• isolasi dan izin yang dapat dikonfigurasi
• permukaan integrasi seperti TUI, SDK, mode server, dan MCP

Itu penting karena pengodean AI hanya berguna di repositori sungguhan ketika Anda dapat mengendalikan apa yang boleh dilakukan agen, mempertahankan konteks antar sesi, dan memakai ulang alur kerja yang sama di luar satu jendela obrolan.

Dari mana nilainya berasal

AX Code mengoptimalkan saat setelah agen selesai: memutuskan apakah hasilnya layak dipertahankan.

• Bukti. Setiap sesi dicatat sebagai log peristiwa bertipe plus snapshot berkas, agar ax-code graph, compare, replay, risk, dan audit dapat merekonstruksi apa yang terjadi setelah percakapan berakhir.
• Verifikasi. Di mana gerbang dapat ditegakkan — kandidat arena, penerapan refaktor yang digerbangi — typecheck, lint, dan perintah tes milik repositori Anda yang memutuskan apakah hasil diterima.
• Reversibilitas. Snapshot dapat dipulihkan per langkah, bukan hanya per sesi, dari penyimpanan objek Git yang disimpan di luar repositori Anda.
• Keputusan Anda. AX Code memeringkat, menilai, dan melaporkan. Ia tidak menggabungkan untuk Anda.

Yang mendukung ini: alat eksplisit dengan aturan izin dan mode isolasi, sesi yang tahan lama, AGENTS.md untuk konvensi repositori, portabilitas penyedia, dan satu runtime di belakang TUI, CLI, ekstensi VS Code, SDK, server tanpa antarmuka, dan integrasi MCP. Itu fondasi, bukan alasan memilih AX Code — lihat Mengapa AX Code.

Untuk perintahnya sendiri, lihat Bukti eksekusi.

Model mental

Bayangkan AX Code sebagai lima lapisan:

1. Lapisan penyedia: pilih backend model yang ingin Anda jalankan.
2. Lapisan agen: pilih agen yang tepat untuk tugas, atau biarkan perutean membantu.
3. Lapisan alat: agen bertindak melalui alat eksplisit, bukan kapabilitas tersembunyi.
4. Lapisan sesi: percakapan, keputusan, dan keadaan menetap.
5. Lapisan kendali: isolasi, izin, dan perilaku audit menetapkan batas.

Sisa dokumentasi dipetakan ke lapisan itu.

Pilih jalur berikutnya

Saya ingin mencobanya dengan cepat

• Mulai dengan README akar untuk pemasangan dan peluncuran pertama.
• Jalur pemasangan yang didukung memakai runtime yang dikompilasi:
  • Pemasang rilis Bash untuk macOS Apple Silicon dan Linux: curl -fsSL -H "Accept: application/vnd.github.raw+json" "https://api.github.com/repos/defai-digital/ax-code/contents/install?ref=main" | bash
  • Alternatif Homebrew untuk CLI macOS: brew tap defai-digital/tap && brew trust defai-digital/tap && brew install defai-digital/tap/ax-code
  • Pemasang rilis GitHub untuk Windows PowerShell: powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"
• Pemasang Bash bukan jalur penyiapan Windows yang kanonik.
• Paket npm tidak lagi didukung sebagai kanal pemasangan atau peningkatan. Lihat Kanal pemasangan dan runtime untuk kebijakan platform, label runtime, dan matriks peluncur lokal.
• Gunakan /connect atau ax-code providers login untuk mengatur model. Lihat Penyedia dan model yang didukung untuk penyedia API cloud, penyedia CLI, AX Engine, dan ID model. Untuk jalur evaluasi tanpa biaya, gunakan Mulai cepat API tingkat gratis.
• Jalankan ax-code init setelah membuka proyek sungguhan agar AGENTS.md menangkap konvensi lokal.
• Jika Anda menginginkan batas keamanan yang lebih ketat, aktifkan Mode Sandbox sebelum suntingan yang lebih luas.

Saya ingin memakainya dengan aman di repositori tim atau perusahaan

• AX Code mulai dengan mode otonom nyala dan mode sandbox mati: full-access dengan akses sistem berkas dan jaringan tanpa batas.
• Untuk kerja tim, perusahaan, yang tidak dipercaya, atau tanpa pengawasan, aktifkan --sandbox workspace-write (atau read-only) sebelum memulai tugas.
• Baca Mode Sandbox untuk batas eksekusi.
• Baca Mode otonom jika agen akan berjalan tanpa pengawasan.
• Baca Kebijakan keamanan untuk model ancaman dan rincian penyimpanan kredensial.
• Baca Lapisan semantik jika provenans dan pemutaran ulang penting bagi alur Anda.

Saya ingin menyematkan atau mengotomatiskannya

• Gunakan titik masuk tanpa antarmuka atau gRPC @defai-digital/ax-code-sdk untuk integrasi aplikasi TypeScript.
• Gunakan Kompatibilitas HTTP dan OpenAPI untuk batas layanan, klien yang dihasilkan, dan kontrak OpenAPI yang otoritatif.
• Gunakan ax-code mcp add ketika agen memerlukan alat atau layanan eksternal.

Saya ingin memahami repositori atau memberi umpan balik

• Baca Pusat dokumentasi untuk sisa dokumen publik.
• Baca CONTRIBUTING.md untuk kebijakan kontribusi eksternal saat ini.

Kapan AX Code mungkin tidak cocok

AX Code sengaja lebih dari pelengkapan otomatis atau kotak obrolan terhosting. Ia mungkin berlebihan jika:

• Anda hanya memerlukan saran kode sebaris dan tidak ingin agen mengeksekusi alat.
• Anda memerlukan pengalaman hanya-SaaS yang terhosting tanpa runtime lokal.
• Anda tidak memerlukan persistensi sesi, pemutaran ulang, integrasi SDK atau server, atau instruksi tingkat repositori.
• Anda bekerja di lingkungan yang tidak mengizinkan proses CLI lokal.

Dalam kasus itu, asisten editor yang lebih ringan mungkin lebih sederhana. AX Code paling kuat ketika agen perlu beroperasi di dalam alur pengembangan sungguhan dengan batas kendali, kesinambungan, dan integrasi.

Perintah pertama yang umum

ax-code
ax-code providers login
ax-code models
ax-code run --model qwen -- "Review this change"
ax-code init
ax-code index
ax-code mcp add
ax-code doctor

Grok berjalan secara eksklusif melalui Grok Build CLI. Pilih grok-build-cli di /connect; AX Code memanggil perintah lokal grok dan memakai ulang login atau sesi CLI-nya. Penyedia API cloud langsung xai yang dulu tidak lagi didukung.

Peta dokumen