Pemasangan Aider dan Konfigurasi OmniProxy

Aider ialah alat yang membantu mengubah kod dalam terminal. Ia menyediakan peta bagi seluruh repositori kod untuk membantu model memahami projek yang lebih besar; Git pula ialah alat kawalan versi yang merekodkan perubahan kod dan boleh digunakan untuk melihat perbezaan serta memulihkan perubahan. Selepas anda memberikan tugasan kepada Aider, ia akan mengendalikannya secara berperingkat dan menulis mesej komit. Jika anda tidak menyukai perubahan tersebut, gunakan /undo untuk membatalkannya.

Persediaan sebelum pemasangan

Terdapat dua kaedah pemasangan yang biasa digunakan:

• Jika komputer sudah mempunyai Python 3.8 hingga 3.13: pasang aider-install terlebih dahulu. Python ialah persekitaran program yang diperlukan untuk menjalankan Aider.
• Jika tiada versi Python yang sesuai: gunakan arahan pemasangan satu baris, yang turut menyediakan Python 3.12 apabila diperlukan.

Mac dan Linux

install.sh

• Jalankan dengan sh selepas curl
• Python akan dipasang jika diperlukan
• Gunakan wget jika curl tiada

Windows

install.ps1

• Jalankan dengan PowerShell
• Buka semula terminal selepas pemasangan
• Gunakan setx untuk pemboleh ubah persekitaran

Python sudah tersedia

aider-install

• Pasang pakej ini dahulu dengan pip
• Kemudian jalankan aider-install
• Ia akan mencipta persekitarannya sendiri

Pastikan OmniProxy sedang berjalan. Selepas pemasangan selesai, masuk dahulu ke direktori projek yang ingin anda ubah, kemudian mulakan Aider.

Pasang dan jalankan buat kali pertama

Jika Python 3.8 hingga 3.13 sudah tersedia

Jalankan arahan berikut mengikut urutan:

python -m pip install aider-install
aider-install

aider-install akan memasang Aider dalam persekitaran Python yang berasingan supaya tidak bercampur dengan projek Python lain pada komputer. Apabila diperlukan, ia juga akan memasang Python 3.12 untuk digunakan oleh Aider.

Pemasangan satu baris

Untuk Mac dan Linux, jalankan:

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

Jika komputer tidak mempunyai curl, gunakan arahan berikut:

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

Untuk Windows PowerShell, jalankan:

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

Arahan satu baris ini berasaskan uv; uv ialah program untuk memasang dan mengurus alat serta persekitaran Python. Anda juga boleh menggunakan arahan berikut:

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

Selain itu, pipx juga boleh digunakan. Jika memasang terus melalui python -m pip install aider-chat, versi Python yang boleh digunakan ialah 3.9 hingga 3.12. Namun, kaedah ini dianggap sebagai kaedah pemasangan alternatif, jadi utamakan kaedah pemasangan di atas. Aider daripada pengurus pakej sistem mungkin mengalami ketidakpadanan kebergantungan, maka jangan utamakan kaedah tersebut.

Pada 2026-10-09, arahan pemasangan satu baris telah digunakan untuk memasang Aider v0.86.2. Jika proses pemasangan memaklumkan bahawa cache dan destinasi tidak berada pada cakera yang sama lalu beralih kepada penyalinan fail, pemasangan masih akan selesai.

Selepas pemasangan selesai, masuk ke direktori projek. API serasi bermaksud API yang menggunakan format OpenAI untuk berkomunikasi dengan perkhidmatan model lain. Bentuk arahan untuk memulakannya adalah seperti berikut:

aider --model openai/<model-name>

Gantikan <model-name> dengan ID model penuh yang disalin daripada OmniProxy dalam bahagian seterusnya; ID model ialah nama yang digunakan untuk menentukan model dengan tepat.

Dapatkan parameter sambungan daripada OmniProxy

Dua pemboleh ubah persekitaran berikut perlu ditetapkan. Pemboleh ubah persekitaran boleh difahami sebagai sekumpulan tetapan sambungan 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 ialah alamat API dan mesti disertakan hingga /v1. OPENAI_API_KEY ialah kunci yang digunakan untuk mengakses API.

Pada Windows, gunakan setx untuk menyimpan pemboleh ubah. Selepas menjalankannya, terminal perlu dibuka semula:

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

Salin keseluruhan nama model daripada senarai semasa OmniProxy dan kekalkan garis miring dalam ID model. Apabila memulakan Aider, tambahkan openai/ di hadapan ID penuh tersebut.

Pada 2026-10-09, dua ID rujukan dalam dokumentasi penyedia ialah gemini-3.8-flash dan grok-4.7. Jika nama tersebut tiada dalam senarai semasa, jangan salin secara terus; gunakan ID penuh yang benar-benar tersedia dalam senarai.

Alamat

OPENAI_API_BASE

• Halakan ke OmniProxy
• Akhiri dengan /v1
• Jangan tulis ke dalam repositori

Kunci

OPENAI_API_KEY

• Gunakan yang diberikan oleh get laluan
• Buka semula terminal selepas mengubahnya pada Windows
• Simpan kunci penyedia dalam get laluan

Permulaan

openai/model

• Gunakan cd untuk masuk ke direktori projek
• Tambahkan openai/ pada nama model
• Gunakan nama daripada senarai get laluan

Isikan konfigurasi alat

Anda tidak perlu mencipta fail konfigurasi tambahan di sini. Masuk dahulu ke direktori projek, kemudian mulakan Aider dan gantikan ID model dengan nama yang benar-benar tersedia dalam senarai semasa OmniProxy:

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

Untuk menggunakan model contoh yang lain, jalankan:

aider --model openai/grok-4.7

Apabila Aider menemui model yang tidak dikenalinya, antara muka akan memaparkan amaran. Amaran ini sahaja tidak bermaksud alamat tersebut salah. Semak rekod panggilan OmniProxy untuk memastikan sama ada permintaan ini telah diterima.

Aider hanya memasukkan fail yang sudah dijejaki oleh Git ke dalam konteks; konteks ialah kod dan maklumat yang boleh dibaca oleh model dalam tugasan semasa. Jika direktori semasa belum menjadi repositori Git, Aider akan mencipta repositori secara automatik, tetapi fail yang tidak dijejaki oleh Git masih tidak boleh dibaca. Gunakan git add untuk menambahkan fail dan buat komit terlebih dahulu, kemudian mulakan Aider.

Aider masih boleh mengubah fail. --no-auto-commits hanya mematikan komit automatik dan tidak menghalang fail daripada diubah. Untuk penggunaan pertama, disyorkan agar anda memilih repositori yang tidak penting dan menjalankan git diff selepas tugasan selesai untuk memeriksa perubahan sebenar.

Jangan masukkan kunci sebenar ke dalam fail projek atau halaman awam. Kunci penyedia hanya perlu disimpan dalam OmniProxy. Jika get laluan tidak mengesahkan kunci, OPENAI_API_KEY boleh diisi dengan rentetan pemegang tempat yang hanya digunakan pada komputer tempatan.

Sahkan dengan tugasan sebenar

Pastikan dahulu fail yang ingin dibaca telah dikomit ke dalam Git, kemudian jalankan arahan berikut dalam direktori projek. Gantikan ID model dengan ID penuh daripada senarai semasa OmniProxy:

aider --model openai/gemini-3.8-flash --message "Apakah baris pertama fail ini? Jangan ubah fail tersebut." --no-auto-commits

--message digunakan untuk memberikan satu tugasan terus kepada Aider, manakala --no-auto-commits bermaksud komit Git tidak akan dicipta secara automatik untuk pelaksanaan ini.

Pada 2026-10-09, Aider v0.86.2 telah digunakan untuk membaca baris pertama fail yang dijejaki. Jika fail belum dijejaki oleh Git, Aider akan menjawab bahawa kandungannya tidak dapat dilihat; ini tidak bermaksud alamat API salah. Selepas pertanyaan selesai, semak sumber permintaan dan ID model dalam rekod panggilan OmniProxy.

Permulaan

aider boleh dibuka

• Perintah dapat ditemukan
• Pemboleh ubah persekitaran telah berkuat kuasa
• Berada dalam direktori projek

Tugas

Ia telah melihat fail

• Tanya tentang fail tertentu
• Lihat penjelasannya
• Model yang tidak dikenali akan mencetuskan amaran

Rekod

Kelihatan dalam get laluan

• Sumbernya ialah Aider
• ID model sepadan
• Kunci tidak dimasukkan ke halaman

Ralat lazim

• aider tidak ditemukan: buka semula terminal terlebih dahulu. Jika anda memasangnya secara terus menggunakan pip, cuba python -m aider.
• Windows masih menyambung ke alamat lama selepas pemboleh ubah diubah: selepas menjalankan setx, anda mesti membuka semula terminal supaya tetingkap baharu membaca pemboleh ubah yang telah dikemas kini.
• Tiada openai/ di hadapan nama model: API serasi memerlukan format openai/<model-name>.
• Amaran model tidak dikenali dipaparkan: ini ialah pemberitahuan biasa dan tidak bermaksud sambungan gagal. Seterusnya, semak sama ada OmniProxy menerima permintaan tersebut.
• ID model tidak sah: salin semula ID penuh daripada senarai semasa OmniProxy serta kekalkan awalan openai/ dan semua garis miring asal dalam ID.
• Aider mengatakan tiada kandungan fail: pastikan fail sudah dijejaki oleh Git. Repositori kosong atau fail yang tidak dijejaki tidak akan dimasukkan ke dalam konteks.

Rujukan rasmi

Lihat Aider installation untuk langkah pemasangan. Lihat OpenAI compatible APIs untuk pemboleh ubah persekitaran dan awalan model. ID model yang digunakan sebagai contoh boleh disemak dalam senarai model Gemini dan halaman model xAI.

Gantikan setiap penanda tempat dengan nilai dari konfigurasi OmniProxy anda sendiri. Jangan pernah terbitkan kunci sebenar.

Hasil tersimpan atau HTTP 200 sahaja tidak membuktikan keserasian Agen penuh. Semak sumber dan model dalam rekod panggilan OmniProxy.

Sumber rasmi · Aider ↗