> ## 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.
# Cara Kerja Fuxi Code
> Pahami loop agentic, tools bawaan, dan bagaimana Fuxi Code berinteraksi dengan proyek Anda.
Fuxi Code adalah asisten agentic yang berjalan di terminal Anda. Meskipun unggul dalam coding, Fuxi Code dapat membantu dengan apa pun yang dapat Anda lakukan dari command line: menulis dokumentasi, menjalankan build, mencari file, meneliti topik, dan banyak lagi.
Panduan ini mencakup arsitektur inti, kemampuan bawaan, dan [tips untuk bekerja secara efektif dengan Fuxi Code](#work-effectively-with-fuxi-code). Untuk panduan langkah demi langkah, lihat [Common workflows](/id/common-workflows). Untuk fitur extensibility seperti skills, MCP, dan hooks, lihat [Extend Fuxi Code](/id/features-overview).
Loop agentic
Ketika Anda memberikan tugas kepada Fuxi, Fuxi bekerja melalui tiga fase: **mengumpulkan konteks**, **mengambil tindakan**, dan **memverifikasi hasil**. Fase-fase ini berpadu bersama. Fuxi menggunakan tools di seluruh proses, baik mencari file untuk memahami kode Anda, mengedit untuk membuat perubahan, atau menjalankan test untuk memeriksa pekerjaannya.
Loop beradaptasi dengan apa yang Anda minta. Pertanyaan tentang codebase Anda mungkin hanya memerlukan pengumpulan konteks. Perbaikan bug melakukan siklus melalui ketiga fase berulang kali. Refactor mungkin melibatkan verifikasi ekstensif. Fuxi memutuskan apa yang setiap langkah perlukan berdasarkan apa yang dipelajarinya dari langkah sebelumnya, menghubungkan puluhan tindakan bersama-sama dan melakukan koreksi jalur di sepanjang jalan.
Anda juga bagian dari loop ini. Anda dapat mengganggu kapan saja untuk mengarahkan Fuxi ke arah yang berbeda, memberikan konteks tambahan, atau memintanya mencoba pendekatan yang berbeda. Fuxi bekerja secara otonom tetapi tetap responsif terhadap input Anda.
Loop agentic didukung oleh dua komponen: [models](#models) yang bernalar dan [tools](#tools) yang bertindak. Fuxi Code berfungsi sebagai **agentic harness** di sekitar Fuxi: Fuxi Code menyediakan tools, manajemen konteks, dan lingkungan eksekusi yang mengubah model bahasa menjadi agen coding yang mampu.
Models
Fuxi Code menggunakan model Fuxi untuk memahami kode Anda dan bernalar tentang tugas. Fuxi dapat membaca kode dalam bahasa apa pun, memahami bagaimana komponen terhubung, dan mengetahui apa yang perlu berubah untuk mencapai tujuan Anda. Untuk tugas kompleks, Fuxi memecah pekerjaan menjadi langkah-langkah, menjalankannya, dan menyesuaikan berdasarkan apa yang dipelajarinya.
[Multiple models](/id/model-config) tersedia dengan trade-off yang berbeda. Sonnet menangani sebagian besar tugas coding dengan baik. Opus memberikan penalaran yang lebih kuat untuk keputusan arsitektur yang kompleks. Beralih dengan `/model` selama sesi atau mulai dengan `fuxi --model `.
Ketika panduan ini mengatakan "Fuxi memilih" atau "Fuxi memutuskan," itu adalah model yang melakukan penalaran.
Tools adalah apa yang membuat Fuxi Code agentic. Tanpa tools, Fuxi hanya dapat merespons dengan teks. Dengan tools, Fuxi dapat bertindak: membaca kode Anda, mengedit file, menjalankan perintah, mencari web, dan berinteraksi dengan layanan eksternal. Setiap penggunaan tool mengembalikan informasi yang umpan balik ke dalam loop, menginformasikan keputusan Fuxi berikutnya.
Tools bawaan umumnya terbagi menjadi lima kategori, masing-masing mewakili jenis agency yang berbeda.
| Kategori | Apa yang dapat dilakukan Fuxi |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **File operations** | Membaca file, mengedit kode, membuat file baru, mengganti nama dan mengorganisir ulang |
| **Search** | Menemukan file berdasarkan pola, mencari konten dengan regex, menjelajahi codebase |
| **Execution** | Menjalankan perintah shell, memulai server, menjalankan test, menggunakan git |
| **Web** | Mencari web, mengambil dokumentasi, mencari pesan error |
| **Code intelligence** | Melihat type error dan warning setelah edit, melompat ke definisi, menemukan referensi (memerlukan [code intelligence plugins](/id/discover-plugins#code-intelligence)) |
Ini adalah kemampuan utama. Fuxi juga memiliki tools untuk spawning subagents, mengajukan pertanyaan kepada Anda, dan tugas orchestration lainnya. Lihat [Tools available to Fuxi](/id/tools-reference) untuk daftar lengkap.
Fuxi memilih tools mana yang akan digunakan berdasarkan prompt Anda dan apa yang dipelajarinya di sepanjang jalan. Ketika Anda mengatakan "perbaiki test yang gagal," Fuxi mungkin:
1. Menjalankan test suite untuk melihat apa yang gagal
2. Membaca output error
3. Mencari file sumber yang relevan
4. Membaca file tersebut untuk memahami kode
5. Mengedit file untuk memperbaiki masalah
6. Menjalankan test lagi untuk memverifikasi
Setiap penggunaan tool memberikan Fuxi informasi baru yang menginformasikan langkah berikutnya. Ini adalah loop agentic dalam aksi.
**Memperluas kemampuan dasar:** Tools bawaan adalah fondasi. Anda dapat memperluas apa yang diketahui Fuxi dengan [skills](/id/skills), terhubung ke layanan eksternal dengan [MCP](/id/mcp), mengotomatisasi workflow dengan [hooks](/id/hooks), dan mendelegasikan tugas ke [subagents](/id/sub-agents). Ekstensi ini membentuk lapisan di atas loop agentic inti. Lihat [Extend Fuxi Code](/id/features-overview) untuk panduan memilih ekstensi yang tepat untuk kebutuhan Anda.
Apa yang dapat diakses Fuxi
Panduan ini berfokus pada terminal. Fuxi Code juga berjalan di [VS Code](/id/vs-code), [JetBrains IDEs](/id/jetbrains), dan lingkungan lainnya.
Ketika Anda menjalankan `fuxi` di direktori, Fuxi Code mendapatkan akses ke:
* **Proyek Anda.** File di direktori dan subdirektori Anda, ditambah file di tempat lain dengan izin Anda.
* **Terminal Anda.** Perintah apa pun yang dapat Anda jalankan: build tools, git, package managers, system utilities, scripts. Jika Anda dapat melakukannya dari command line, Fuxi juga dapat.
* **Status git Anda.** Branch saat ini, perubahan yang belum di-commit, dan riwayat commit terbaru.
* **[FUXI.md](/id/memory) Anda.** File markdown tempat Anda menyimpan instruksi khusus proyek, konvensi, dan konteks yang harus diketahui Fuxi setiap sesi.
* **[Auto memory](/id/memory#auto-memory).** Pembelajaran yang disimpan Fuxi secara otomatis saat Anda bekerja, seperti pola proyek dan preferensi Anda. 200 baris pertama atau 25KB MEMORY.md, mana pun yang lebih dulu, dimuat di awal setiap sesi.
* **Ekstensi yang Anda konfigurasi.** [MCP servers](/id/mcp) untuk layanan eksternal, [skills](/id/skills) untuk workflow, [subagents](/id/sub-agents) untuk pekerjaan yang didelegasikan, dan [Fuxi in Chrome](/id/chrome) untuk interaksi browser.
Karena Fuxi melihat seluruh proyek Anda, Fuxi dapat bekerja di seluruhnya. Ketika Anda meminta Fuxi untuk "perbaiki bug autentikasi," Fuxi mencari file yang relevan, membaca beberapa file untuk memahami konteks, membuat edit terkoordinasi di seluruhnya, menjalankan test untuk memverifikasi perbaikan, dan melakukan commit perubahan jika Anda meminta. Ini berbeda dari asisten kode inline yang hanya melihat file saat ini.
Lingkungan dan interface
Loop agentic, tools, dan kemampuan yang dijelaskan di atas sama di mana pun Anda menggunakan Fuxi Code. Apa yang berubah adalah di mana kode dieksekusi dan bagaimana Anda berinteraksi dengannya.
Lingkungan eksekusi
Fuxi Code berjalan di tiga lingkungan, masing-masing dengan trade-off berbeda untuk di mana kode Anda dieksekusi.
| Lingkungan | Di mana kode berjalan | Use case |
| ------------------ | ---------------------------------- | --------------------------------------------------------------------------- |
| **Local** | Mesin Anda | Default. Akses penuh ke file, tools, dan lingkungan Anda |
| **Cloud** | VM yang dikelola Anthropic | Mendelegasikan tugas, bekerja pada repo yang tidak Anda miliki secara lokal |
| **Remote Control** | Mesin Anda, dikontrol dari browser | Gunakan web UI sambil menjaga semuanya tetap lokal |
Interface
Anda dapat mengakses Fuxi Code melalui terminal, [desktop app](/id/desktop), [IDE extensions](/id/vs-code), [fuxi.ai/code](https://fuxi.ai/code), [Remote Control](/id/remote-control), [Slack](/id/slack), dan [CI/CD pipelines](/id/github-actions). Interface menentukan bagaimana Anda melihat dan berinteraksi dengan Fuxi, tetapi loop agentic yang mendasarinya identik. Lihat [Use Fuxi Code everywhere](/id/overview#use-fuxi-code-everywhere) untuk daftar lengkap.
Bekerja dengan session
Fuxi Code menyimpan percakapan Anda secara lokal saat Anda bekerja. Setiap pesan, penggunaan tool, dan hasil ditulis ke file plaintext JSONL di bawah `~/.fuxi/projects/`, yang memungkinkan [rewinding](#undo-changes-with-checkpoints), [resuming, dan forking](#resume-or-fork-sessions) session. Sebelum Fuxi membuat perubahan kode, Fuxi juga membuat snapshot file yang terpengaruh sehingga Anda dapat mengembalikan jika diperlukan. Untuk path, retention, dan cara menghapus data ini, lihat [application data in `~/.fuxi`](/id/fuxi-directory#application-data).
**Session bersifat independen.** Setiap session baru dimulai dengan context window segar, tanpa riwayat percakapan dari session sebelumnya. Fuxi dapat mempertahankan pembelajaran di seluruh session menggunakan [auto memory](/id/memory#auto-memory), dan Anda dapat menambahkan instruksi persisten Anda sendiri di [FUXI.md](/id/memory).
Bekerja di seluruh branch
Setiap percakapan Fuxi Code adalah session yang terikat pada direktori saat ini Anda. Picker `/resume` menampilkan session dari worktree saat ini secara default, dengan pintasan keyboard untuk memperluas daftar ke worktree atau proyek lain. Lihat [Manage sessions](/id/sessions#use-the-session-picker) untuk daftar lengkap pintasan picker dan bagaimana name resolution bekerja.
Fuxi melihat file branch saat ini Anda. Ketika Anda beralih branch, Fuxi melihat file branch baru, tetapi riwayat percakapan Anda tetap sama. Fuxi mengingat apa yang Anda diskusikan bahkan setelah beralih.
Karena session terikat pada direktori, Anda dapat menjalankan session Fuxi paralel dengan menggunakan [git worktrees](/id/worktrees), yang membuat direktori terpisah untuk branch individual.
Resume atau fork session
Melanjutkan session dengan `fuxi --continue` atau `fuxi --resume` membuka kembali session di bawah session ID yang sama dan menambahkan pesan baru ke percakapan yang ada. Forking dengan `--fork-session` atau `/branch` menyalin riwayat ke session ID baru, meninggalkan yang asli tidak berubah.
Untuk flag resume, picker `/resume`, naming, dan apa yang terjadi ketika session yang sama terbuka di dua terminal, lihat [Manage sessions](/id/sessions).
Context window
Context window Fuxi menampung riwayat percakapan Anda, konten file, output perintah, [FUXI.md](/id/memory), [auto memory](/id/memory#auto-memory), skill yang dimuat, dan instruksi sistem. Saat Anda bekerja, konteks terisi. Fuxi melakukan compacting secara otomatis, tetapi instruksi dari awal percakapan dapat hilang. Letakkan aturan persisten di FUXI.md, dan jalankan `/context` untuk melihat apa yang menggunakan ruang.
Untuk panduan interaktif tentang apa yang dimuat dan kapan, lihat [Explore the context window](/id/context-window).
Ketika context terisi
Fuxi Code mengelola konteks secara otomatis saat Anda mendekati batas. Fuxi menghapus output tool yang lebih lama terlebih dahulu, kemudian merangkum percakapan jika diperlukan. Permintaan Anda dan snippet kode kunci dipertahankan; instruksi terperinci dari awal percakapan mungkin hilang. Letakkan aturan persisten di FUXI.md daripada mengandalkan riwayat percakapan.
Untuk mengontrol apa yang dipertahankan selama compacting, tambahkan bagian "Compact Instructions" ke FUXI.md atau jalankan `/compact` dengan fokus (seperti `/compact focus on the API changes`).
Jika file tunggal atau output tool sangat besar sehingga konteks terisi kembali segera setelah setiap ringkasan, Fuxi Code berhenti auto-compacting setelah beberapa upaya dan menampilkan error sebagai gantinya dari looping. Lihat [Auto-compaction stops with a thrashing error](/id/troubleshooting#auto-compaction-stops-with-a-thrashing-error) untuk langkah pemulihan.
Jalankan `/context` untuk melihat apa yang menggunakan ruang. Definisi tool MCP ditunda secara default dan dimuat sesuai permintaan melalui [tool search](/id/mcp#scale-with-mcp-tool-search), jadi hanya nama tool yang mengonsumsi konteks sampai Fuxi menggunakan tool spesifik. Jalankan `/mcp` untuk memeriksa biaya per-server.
Kelola konteks dengan skills dan subagents
Selain compacting, Anda dapat menggunakan fitur lain untuk mengontrol apa yang dimuat ke dalam konteks.
[Skills](/id/skills) dimuat sesuai permintaan. Fuxi melihat deskripsi skill pada awal session, tetapi konten lengkap hanya dimuat ketika skill digunakan. Untuk skill yang Anda panggil secara manual, atur `disable-model-invocation: true` untuk menjaga deskripsi keluar dari konteks sampai Anda membutuhkannya. Untuk skill yang tidak Anda tulis, gunakan [`skillOverrides`](/id/skills#override-skill-visibility-from-settings) untuk melakukan hal yang sama dari settings.
[Subagents](/id/sub-agents) mendapatkan konteks segar mereka sendiri, sepenuhnya terpisah dari percakapan utama Anda. Pekerjaan mereka tidak membengkak konteks Anda. Ketika selesai, mereka mengembalikan ringkasan. Isolasi ini adalah alasan mengapa subagents membantu dengan session yang panjang.
Lihat [context costs](/id/features-overview#understand-context-costs) untuk apa yang setiap fitur biayai, dan [reduce token usage](/id/costs#reduce-token-usage) untuk tips mengelola konteks.
Tetap aman dengan checkpoint dan permission
Fuxi memiliki dua mekanisme keamanan: checkpoint memungkinkan Anda membatalkan perubahan file, dan permission mengontrol apa yang dapat dilakukan Fuxi tanpa bertanya.
Batalkan perubahan dengan checkpoint
**Setiap edit file dapat dikembalikan.** Sebelum Fuxi mengedit file apa pun, Fuxi membuat snapshot konten saat ini. Jika ada yang salah, tekan `Esc` dua kali untuk kembali ke state sebelumnya, atau minta Fuxi untuk membatalkan.
Checkpoint terpisah dari git dan tetap tersedia ketika Anda melanjutkan percakapan. Mereka hanya mencakup perubahan file. Tindakan yang mempengaruhi sistem remote (database, API, deployment) tidak dapat di-checkpoint, itulah mengapa Fuxi bertanya sebelum menjalankan perintah dengan efek samping eksternal.
Kontrol apa yang dapat dilakukan Fuxi
Tekan `Shift+Tab` untuk melakukan siklus melalui mode permission:
* **Manual**: Fuxi bertanya sebelum edit file dan perintah shell
* **Accept edits**: Fuxi mengedit file dan menjalankan perintah filesystem umum seperti `mkdir` dan `mv` tanpa bertanya, masih bertanya untuk perintah lain
* **Plan**: Fuxi mengeksplorasi dan mengusulkan rencana tanpa mengedit file sumber Anda
* **Auto**: Fuxi mengevaluasi semua tindakan dengan pemeriksaan keamanan latar belakang
Anda juga dapat mengizinkan perintah spesifik di `.fuxi/settings.json` sehingga Fuxi tidak bertanya setiap kali. Ini berguna untuk perintah terpercaya seperti `npm test` atau `git status`. Settings dapat dibatasi dari kebijakan organisasi-luas hingga preferensi pribadi. Lihat [Permissions](/id/permissions) untuk detail.
***
Bekerja secara efektif dengan Fuxi Code
Tips ini membantu Anda mendapatkan hasil yang lebih baik dari Fuxi Code.
Minta bantuan Fuxi Code
Fuxi Code dapat mengajarkan Anda cara menggunakannya. Ajukan pertanyaan seperti "bagaimana cara mengatur hooks?" atau "apa cara terbaik untuk menyusun FUXI.md saya?" dan Fuxi akan menjelaskan.
Perintah bawaan juga memandu Anda melalui setup:
* `/init` memandu Anda membuat FUXI.md untuk proyek Anda
* `/doctor` menjalankan pemeriksaan setup yang mendiagnosis masalah instalasi dan konfigurasi serta dapat memperbaikinya
Ini adalah percakapan
Fuxi Code bersifat conversational. Anda tidak memerlukan prompt yang sempurna. Mulai dengan apa yang Anda inginkan, kemudian perbaiki:
```text theme={null}
Perbaiki bug login
```
\[Fuxi menyelidiki, mencoba sesuatu]
```text theme={null}
Itu tidak cukup benar. Masalahnya ada di session handling.
```
\[Fuxi menyesuaikan pendekatan]
Ketika upaya pertama tidak benar, Anda tidak memulai dari awal. Anda melakukan iterasi.
Ganggu dan arahkan
Anda dapat mengalihkan Fuxi kapan saja tanpa menunggu giliran selesai atau memulai dari awal:
* **Tekan `Esc`** untuk menghentikan Fuxi segera. Panggilan tool yang sedang berjalan dibatalkan dan Fuxi menunggu instruksi Anda berikutnya.
* **Ketik koreksi dan tekan `Enter`** untuk mengirimnya tanpa menghentikan tool yang sedang berjalan. Fuxi membacanya segera setelah tindakan saat ini selesai dan menyesuaikan sebelum memutuskan langkah berikutnya.
Jadilah spesifik di awal
Semakin presisi prompt awal Anda, semakin sedikit koreksi yang Anda perlukan. Referensikan file spesifik, sebutkan batasan, dan tunjukkan pola contoh.
```text theme={null}
Alur checkout rusak untuk pengguna dengan kartu yang kadaluarsa.
Periksa src/payments/ untuk masalahnya, terutama token refresh.
Tulis test yang gagal terlebih dahulu, kemudian perbaiki.
```
Prompt yang samar-samar berfungsi, tetapi Anda akan menghabiskan lebih banyak waktu untuk mengarahkan. Prompt spesifik seperti yang di atas sering berhasil pada upaya pertama.
Berikan Fuxi sesuatu untuk diverifikasi
Fuxi berkinerja lebih baik ketika dapat memeriksa pekerjaannya sendiri. Sertakan test case, tempel screenshot UI yang diharapkan, atau tentukan output yang Anda inginkan.
```text theme={null}
Implementasikan validateEmail. Test case: 'user@example.com' → true,
'invalid' → false, 'user@.com' → false. Jalankan test setelahnya.
```
Untuk pekerjaan visual, tempel screenshot desain dan minta Fuxi membandingkan implementasinya dengannya.
Jelajahi sebelum mengimplementasikan
Untuk masalah kompleks, pisahkan penelitian dari coding. Gunakan plan mode (`Shift+Tab` dua kali) untuk menganalisis codebase terlebih dahulu:
```text theme={null}
Baca src/auth/ dan pahami bagaimana kami menangani session.
Kemudian buat rencana untuk menambahkan dukungan OAuth.
```
Tinjau rencana, perbaiki melalui percakapan, kemudian biarkan Fuxi mengimplementasikan. Pendekatan dua fase ini menghasilkan hasil yang lebih baik daripada langsung melompat ke kode.
Delegasikan, jangan mendikte
Pikirkan mendelegasikan kepada rekan kerja yang mampu. Berikan konteks dan arah, kemudian percayai Fuxi untuk mengetahui detail:
```text theme={null}
Alur checkout rusak untuk pengguna dengan kartu yang kadaluarsa.
Kode yang relevan ada di src/payments/. Bisakah Anda menyelidiki dan memperbaikinya?
```
Anda tidak perlu menentukan file mana yang harus dibaca atau perintah mana yang harus dijalankan. Fuxi mengetahui itu.
Apa selanjutnya
Tambahkan Skills, koneksi MCP, dan perintah kustom
Panduan langkah demi langkah untuk tugas khas