Guna Aider dengan API LLM percuma
Aider ialah pasangan pengaturcara sumber terbuka untuk terminal. Ia menyunting fail dalam repositori git anda dan membuat commit. Panduan ini menyambungkan Aider kepada model percuma melalui FreeLLMAPI. Ia juga menunjukkan tetapan Aider yang penting untuk model percuma: format sunting, model lemah dan saiz peta repo.
Kod, nama model dan label katalog langsung dipaparkan dalam bahasa Inggeris.
Langkah 1: Pasang FreeLLMAPI
FreeLLMAPI ialah gerbang sumber terbuka. Ia berjalan pada komputer anda dalam Docker. Ia menghimpunkan peringkat percuma 45 pembekal di belakang satu kunci yang serasi dengan OpenAI.
Pasang pada macOS atau Linux
curl -fsSL https://freellmapi.co/install.sh | bashBuka http://localhost:3001. Tambah sekurang-kurangnya dua kunci pembekal percuma pada halaman Keys. Salin kunci bersatu anda daripada halaman yang sama.
Langkah 2: Sambungkan Aider
Arahan persediaan menulis ~/.aider.conf.yml. Ia membuat sandaran fail sedia ada dahulu.
Satu arahan
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key>
aiderFail yang ditulis oleh arahan itu kelihatan seperti ini:
~/.aider.conf.yml
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"Awalan openai/ diperlukan. Ia memberitahu Aider untuk menghantar nama model kepada API yang serasi dengan OpenAI. Untuk guna pembolehubah persekitaran dan tanpa fail, buat begini:
Pembolehubah persekitaran sahaja
export OPENAI_API_BASE=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>
aider --model openai/autoAider mencari .aider.conf.yml dalam direktori rumah anda, kemudian dalam akar repositori git anda, kemudian dalam direktori semasa. Fail yang dimuatkan paling akhir mempunyai keutamaan. Oleh itu, fail projek boleh menukar model untuk satu repositori.
Langkah 3: Pilih model
Aider menghantar fail anda dan peta repo dalam setiap permintaan. Ia tidak memerlukan panggilan alat untuk gelung sunting utamanya, kerana ia membaca sunting daripada teks model. Tetingkap konteks yang besar dan ikutan arahan yang baik lebih penting. Jadual menunjukkan model percuma dengan sekurang-kurangnya konteks 128K hari ini.
| Model | Percuma pada | Konteks | Had percuma (tawaran terbaik) | Alat | Penglihatan |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 permintaan/minit 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | Ya | Tidak |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1 lagi | 1M | 40 permintaan/minit 40 RPM | Ya | Ya |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 permintaan/minit 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Ya | Ya |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | Ya | Tidak |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Ya | Ya |
| Deepseek V4.1 Flash | APINex | 1M | 5 permintaan/minit 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Tidak | Tidak |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Ya | Ya |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 permintaan/minit 50 permintaan/hari 50 req/day account-wide (1,000 after a $10 purchase) | Ya | Ya |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 permintaan/minit 50 permintaan/hari Shared rate limit | Ya | Tidak |
| DeepSeek V4 Flash 0731 | ElectronHub, Router9 | 1M | 10,000 credits/month (~$1), shared; account-anniversary reset | Tidak | Tidak |
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 lagi | 262K | 30 permintaan/minit 250 permintaan/hari 70,000 token/minit ~6M | Ya | Ya |
Memaparkan 12 daripada 184 model percuma yang sepadan. Lihat semua model.
Data langsung daripada katalog FreeLLMAPI (versi 2026.11.19, disemak 2026-11-19). Had percuma kerap berubah. Katalog disemak setiap hari.
Guna openai/auto untuk membenarkan penghala memilih model. Guna openai/auto:smart untuk mengutamakan model dengan kecerdasan tertinggi. Untuk memin satu model, guna openai/ dan ID katalog daripada GET /v1/models.
Anda juga boleh menetapkan model untuk satu sesi pada baris arahan. Contoh ini menggunakan model terkuat untuk sunting. Ia menggunakan model pantas untuk mesej commit dan ringkasan sejarah sembang:
Model untuk satu sesi
aider --model openai/auto:smart --weak-model openai/auto:fastUntuk profil yang dirancang, buat rantai sandaran pada papan pemuka FreeLLMAPI, contohnya rantai bernama coding. Kemudian guna --model openai/auto:coding. Nama profil yang tidak diketahui memulangkan ralat 400, jadi permintaan tidak pergi ke rantai lain tanpa notis.
Tetapan Aider untuk model percuma
Aider mengetahui tetapan untuk model yang terkenal. Model gerbang seperti auto tidak diketahui, jadi tetapkan nilai ini sendiri.
| Tetapan | Fungsinya | Nilai yang disyorkan untuk model percuma |
|---|---|---|
edit-format | Format yang digunakan model untuk menghantar sunting: whole, diff, diff-fenced atau udiff | diff untuk model yang kuat. whole untuk model lemah, kerana ia lebih mudah tetapi menghantar lebih banyak token. |
weak-model | Model untuk mesej commit dan ringkasan sejarah sembang | openai/auto:fast, supaya tugas kecil tidak menggunakan kuota model kuat anda |
map-tokens | Bilangan token untuk peta repo. 0 mematikannya. | 1024 atau kurang pada peringkat percuma yang kecil |
architect | Satu model merancang perubahan dan model editor menulis sunting | Pilihan. Ia menggandakan bilangan permintaan. |
~/.aider.conf.yml dengan tetapan untuk model percuma
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"
weak-model: "openai/auto:fast"
edit-format: diff
map-tokens: 1024Untuk memberi Aider tetingkap konteks model gerbang, tambah fail .aider.model.metadata.json. Kuncinya ialah nama model penuh. Aider mencari fail ini di tempat yang sama dengan fail konfigurasi.
~/.aider.model.metadata.json
{
"openai/auto": {
"max_input_tokens": 128000,
"max_output_tokens": 8192,
"litellm_provider": "openai",
"mode": "chat"
}
}Had kadar dan failover
Peringkat percuma mempunyai had seminit dan sehari. FreeLLMAPI mengira penggunaan setiap kunci. Apabila pembekal menghantar ralat 429, penghala menghantar permintaan itu kepada model seterusnya dalam rantai anda. Aider tidak melihat ralat itu dan terus berjalan.
- Tambah kunci daripada empat pembekal atau lebih. Lebih banyak pembekal memberikan lebih banyak permintaan sehari.
- Tambah hanya fail yang anda mahu ubah dengan
/add. Setiap fail ada dalam setiap permintaan. - Guna
/clearantara tugas untuk menghantar sejarah sembang yang lebih pendek. Sejarah yang pendek juga mengurangkan token seminit. - Guna
/dropuntuk membuang fail yang tidak diperlukan lagi.
Penyelesaian masalah
| Masalah | Punca | Penyelesaian |
|---|---|---|
| "Model openai/auto: Saiz tetingkap konteks dan kos tidak diketahui, menggunakan nilai lalai yang munasabah." | Aider tidak mengetahui model gerbang itu | Amaran ini biasanya tidak membahayakan. Untuk membuangnya, tambah .aider.model.metadata.json. |
| Sunting tidak digunakan | Model tidak mengikut format sunting | Guna --edit-format whole, atau model yang lebih kuat |
401 "Invalid API key" | Aider menghantar kunci lain, contohnya daripada fail konfigurasi lain | Semak fail konfigurasi dalam direktori rumah, akar git dan direktori semasa |
| Aider memanggil api.openai.com | Awalan openai/ digunakan, tetapi base URL tidak ditetapkan | Tetapkan openai-api-base atau OPENAI_API_BASE |
| "Semua model mencapai had kadar selepas N percubaan" | Semua kunci telah mencapai had | Tambah kunci daripada lebih banyak pembekal, atau kurangkan map-tokens |
Soalan lazim
Bolehkah saya guna Aider secara percuma?
Boleh. Aider ialah sumber terbuka. Tunjukkan ia kepada FreeLLMAPI dengan openai-api-base dan awalan model openai/. Gerbang menggunakan peringkat pembekal percuma, jadi kos inferens ialah $0.
Bagaimana saya guna Aider dengan API yang serasi dengan OpenAI?
Tetapkan OPENAI_API_BASE dan OPENAI_API_KEY, kemudian jalankan aider --model openai/
Format sunting manakah patut saya guna dengan model percuma?
Guna diff untuk model yang kuat, kerana ia menghantar lebih sedikit token. Jika sunting gagal digunakan, guna whole. Ia lebih mudah untuk model lemah tetapi menghantar fail penuh setiap kali.
Apakah maksud 'Unknown context window size and costs, using sane defaults'?
Aider tidak mengetahui nama model, jadi ia menggunakan nilai lalai. Amaran ini biasanya tidak membahayakan. Tambah .aider.model.metadata.json dengan tetingkap konteks untuk membuangnya.
Model percuma manakah terbaik untuk Aider?
Guna model dengan tetingkap konteks yang besar dan ikutan arahan yang baik. Jadual pada halaman ini menunjukkan model percuma terkuat dengan konteks 128K atau lebih hari ini.
Panduan berkaitan
- Guna OpenCode dengan API LLM percuma
- Gunakan Codex CLI dengan model percuma
- Model API pengekodan percuma terbaik
- Base URL API percuma yang serasi dengan OpenAI
- Free LLM API dengan konteks 1 juta token
Sumber
- Aider docs: OpenAI-compatible APIs (disemak 20 November 2026)
- Aider docs: YAML config file (disemak 20 November 2026)
- Aider docs: options reference (disemak 20 November 2026)
- Aider docs: edit formats (disemak 20 November 2026)
- Aider docs: model warnings (disemak 20 November 2026)
- Aider docs: advanced model settings (disemak 20 November 2026)
- FreeLLMAPI CLI generators (disemak 20 November 2026)