Instalasi Aider dan Konfigurasi OmniProxy

Aider adalah alat yang membantu mengubah kode melalui terminal. Aider membuat peta untuk seluruh basis kode agar model dapat memahami proyek yang lebih besar; Git adalah alat pengelolaan versi yang mencatat perubahan kode sehingga Anda dapat melihat perbedaan dan memulihkan perubahan. Setelah Anda memberikan tugas kepada Aider, alat ini akan menanganinya secara bertahap dan menulis keterangan commit. Jika tidak menyukai perubahan tersebut, Anda dapat membatalkannya dengan /undo.

Persiapan sebelum instalasi

Ada dua metode instalasi yang umum digunakan:

Jika komputer sudah memiliki Python 3.8 hingga 3.13: instal aider-install terlebih dahulu. Python adalah lingkungan program yang diperlukan untuk menjalankan Aider.
Jika tidak memiliki versi Python yang sesuai: gunakan perintah instalasi satu baris, yang juga akan menyiapkan Python 3.12 bila diperlukan.

Mac dan Linux

install.sh

Jalankan dengan sh setelah curl
Python akan diinstal jika diperlukan
Gunakan wget jika curl tidak tersedia

Windows

install.ps1

Jalankan dengan PowerShell
Buka ulang terminal setelah instalasi
Atur variabel lingkungan dengan setx

Sudah memiliki Python

aider-install

Instal paket ini terlebih dahulu dengan pip
Lalu jalankan aider-install
Lingkungannya akan dibuat secara otomatis

Instalasi satu baris akan menyiapkan Python 3.12 bila diperlukan. Menginstal aider-chat secara langsung dengan pip kurang disarankan.

Pastikan OmniProxy sedang berjalan. Setelah instalasi selesai, masuk terlebih dahulu ke direktori proyek yang ingin diubah, lalu jalankan Aider.

Menginstal dan menjalankan untuk pertama kali

Jika Python 3.8 hingga 3.13 sudah tersedia

Jalankan perintah berikut secara berurutan:

python -m pip install aider-install
aider-install

aider-install akan menginstal Aider di lingkungan Python terpisah agar tidak bercampur dengan proyek Python lain di komputer. Bila diperlukan, alat ini juga akan menginstal Python 3.12 khusus untuk Aider.

Instalasi satu baris

Jalankan perintah berikut di Mac dan Linux:

curl -LsSf https://aider.chat/install.sh | sh

Jika komputer tidak memiliki curl, gunakan perintah berikut:

wget -qO- https://aider.chat/install.sh | sh

Jalankan perintah berikut di Windows PowerShell:

powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

Perintah satu baris tersebut menggunakan uv; uv adalah program untuk menginstal dan mengelola alat serta lingkungan Python. Anda juga dapat menggunakan perintah berikut:

uv tool install --force --python python3.12 --with pip aider-chat@latest

Selain itu, Anda dapat menggunakan pipx. Jika menginstal langsung melalui python -m pip install aider-chat, versi Python yang dapat digunakan adalah 3.9 hingga 3.12. Namun, metode ini termasuk metode instalasi alternatif, jadi prioritaskan metode instalasi sebelumnya. Aider dari pengelola paket sistem mungkin mengalami ketidakcocokan dependensi, sehingga jangan memprioritaskan instalasi melalui pengelola paket tersebut.

Pada 2026-10-09, perintah instalasi satu baris menginstal Aider v0.86.2. Jika selama instalasi muncul pemberitahuan bahwa cache dan tujuan tidak berada di disk yang sama sehingga proses beralih ke penyalinan berkas, instalasi tetap akan selesai.

Setelah instalasi selesai, masuk ke direktori proyek. API kompatibel adalah API yang menggunakan format OpenAI untuk berkomunikasi dengan layanan model lain. Format perintah untuk menjalankannya adalah:

aider --model openai/<model-name>

Ganti <model-name> dengan ID model lengkap yang disalin dari OmniProxy pada bagian berikutnya. ID model adalah nama yang digunakan untuk menentukan model secara tepat.

Mendapatkan parameter koneksi dari OmniProxy

Anda perlu menetapkan dua variabel lingkungan berikut. Variabel lingkungan dapat dipahami sebagai sekumpulan pengaturan koneksi yang dibaca oleh program terminal:

export OPENAI_API_BASE=https://your-omniproxy-origin.example/v1
export OPENAI_API_KEY=<YOUR_OMNIPROXY_API_KEY>

OPENAI_API_BASE adalah alamat API dan harus menyertakan /v1. OPENAI_API_KEY adalah kunci yang digunakan untuk mengakses API.

Di Windows, gunakan setx untuk menyimpan variabel. Setelah menjalankannya, Anda harus membuka ulang terminal:

setx OPENAI_API_BASE https://your-omniproxy-origin.example/v1
setx OPENAI_API_KEY <YOUR_OMNIPROXY_API_KEY>

Salin nama model secara lengkap dari daftar OmniProxy saat ini, termasuk garis miring dalam ID model. Saat menjalankan Aider, tambahkan openai/ di depan ID lengkap tersebut.

Pada 2026-10-09, dua ID pembanding dalam dokumentasi penyedia adalah gemini-3.8-flash dan grok-4.7. Jika nama tersebut tidak ada dalam daftar saat ini, jangan menyalinnya secara langsung. Gunakan ID lengkap yang benar-benar tersedia dalam daftar.

Alamat

OPENAI_API_BASE

Arahkan ke OmniProxy
Akhiri dengan /v1
Jangan simpan di repositori

Kunci

OPENAI_API_KEY

Gunakan yang diberikan oleh gateway
Buka ulang terminal setelah mengubahnya di Windows
Biarkan kunci penyedia tetap di gateway

Mulai

openai/model

Gunakan cd untuk masuk ke direktori proyek
Tambahkan openai/ di depan nama model
Gunakan nama dari daftar gateway

Dua variabel lingkungan dan nama model dengan prefiks openai/ merupakan format API kompatibel yang digunakan.

Mengisi konfigurasi alat

Anda tidak perlu membuat berkas konfigurasi tambahan. Masuk terlebih dahulu ke direktori proyek, lalu jalankan Aider dan ganti ID model dengan nama yang benar-benar tersedia dalam daftar OmniProxy saat ini:

cd /path/to/your/project
aider --model openai/gemini-3.8-flash

Untuk menggunakan model contoh lainnya, jalankan:

aider --model openai/grok-4.7

Saat Aider menemukan model yang tidak dikenalnya, antarmuka akan menampilkan peringatan. Peringatan tersebut tidak berarti alamatnya salah. Periksa catatan panggilan OmniProxy untuk memastikan apakah permintaan ini diterima.

Aider hanya memasukkan berkas yang sudah dilacak oleh Git ke dalam konteks; konteks adalah kode dan informasi yang dapat dibaca model dalam tugas saat ini. Jika direktori saat ini belum menjadi repositori Git, Aider akan membuat repositori secara otomatis, tetapi berkas yang belum dilacak Git tetap tidak dapat dibaca. Tambahkan dan commit berkas terlebih dahulu dengan git add, lalu jalankan Aider.

Aider tetap dapat mengubah berkas. --no-auto-commits hanya menonaktifkan commit otomatis dan tidak mencegah perubahan berkas. Saat pertama kali menggunakannya, sebaiknya pilih repositori yang tidak penting, lalu jalankan git diff setelah tugas selesai untuk memeriksa perubahan yang sebenarnya.

Jangan menuliskan kunci asli dalam berkas proyek atau halaman publik. Simpan kunci penyedia hanya di OmniProxy. Jika gateway tidak memvalidasi kunci, OPENAI_API_KEY dapat diisi dengan rangkaian karakter pengganti yang hanya digunakan secara lokal.

Memverifikasi dengan tugas nyata

Pastikan terlebih dahulu bahwa berkas yang akan dibaca sudah di-commit ke Git, lalu jalankan perintah berikut di direktori proyek. Ganti ID model dengan ID lengkap dari daftar OmniProxy saat ini:

aider --model openai/gemini-3.8-flash --message "Apa isi baris pertama berkas ini? Jangan ubah berkas." --no-auto-commits

--message digunakan untuk langsung memberikan satu tugas kepada Aider, sedangkan --no-auto-commits berarti proses ini tidak boleh membuat commit Git secara otomatis.

Pada 2026-10-09, Aider v0.86.2 berhasil digunakan untuk membaca baris pertama berkas yang sudah dilacak. Jika berkas belum dilacak Git, Aider akan menjawab bahwa isinya tidak dapat dilihat. Hal ini tidak berarti alamat API salah. Setelah pertanyaan selesai, periksa sumber permintaan dan ID model dalam catatan panggilan OmniProxy.

Mulai

aider dapat dibuka

Perintah dapat ditemukan
Variabel lingkungan sudah berlaku
Berada di direktori proyek

Tugas

File sudah diperiksa

Tanyakan tentang satu file tertentu
Lihat penjelasannya
Model yang tidak dikenal akan memunculkan peringatan

Catatan

Terlihat di gateway

Sumbernya adalah Aider
ID model sesuai
Kunci tidak masuk ke halaman

Pastikan variabel lingkungan sudah aktif dan perintah dapat ditemukan, lalu selesaikan satu pertanyaan nyata.

Kesalahan umum

aider tidak ditemukan: buka ulang terminal terlebih dahulu. Jika menggunakan instalasi langsung melalui pip, coba python -m aider.
Setelah variabel diubah, Windows masih terhubung ke alamat lama: setelah menjalankan setx, Anda harus membuka ulang terminal agar jendela baru membaca variabel yang telah diperbarui.
Tidak ada openai/ di depan nama model: API kompatibel mengharuskan format openai/<model-name>.
Muncul peringatan tentang model yang tidak dikenal: ini adalah pemberitahuan normal dan bukan berarti koneksi gagal. Selanjutnya, periksa apakah OmniProxy menerima permintaan tersebut.
ID model tidak valid: salin ulang ID lengkap dari daftar OmniProxy saat ini. Pertahankan prefiks openai/ dan garis miring yang sudah ada dalam ID.
Aider mengatakan tidak ada isi berkas: pastikan berkas sudah dilacak oleh Git. Repositori kosong atau berkas yang belum dilacak tidak akan dimasukkan ke dalam konteks.

Referensi resmi

Untuk langkah instalasi, lihat Aider installation. Untuk variabel lingkungan dan prefiks model, lihat OpenAI compatible APIs. ID model yang digunakan sebagai contoh dapat dilihat di Daftar model Gemini dan Halaman model xAI.

Ganti setiap placeholder dengan nilai dari konfigurasi OmniProxy Anda sendiri. Jangan pernah menerbitkan kunci asli.

Hasil tersimpan atau HTTP 200 saja tidak membuktikan kompatibilitas Agen penuh. Periksa sumber dan model dalam catatan panggilan OmniProxy.

Sumber resmi · Aider ↗