Dùng Aider với API LLM miễn phí
Aider là trợ lý lập trình cặp mã nguồn mở chạy trong terminal. Nó chỉnh sửa tệp trong kho git của bạn và tạo commit. Hướng dẫn này kết nối Aider với model miễn phí qua FreeLLMAPI. Nó cũng cho thấy các cài đặt Aider quan trọng với model miễn phí: định dạng chỉnh sửa, model yếu và kích thước bản đồ kho.
Mã, tên mô hình và nhãn danh mục trực tiếp được hiển thị bằng tiếng Anh.
Bước 1: Cài đặt FreeLLMAPI
FreeLLMAPI là cổng mã nguồn mở. Nó chạy trên máy tính của bạn trong Docker. Nó gom các gói miễn phí của 45 nhà cung cấp sau một khóa tương thích OpenAI.
Cài đặt trên macOS hoặc Linux
curl -fsSL https://freellmapi.co/install.sh | bashMở http://localhost:3001. Thêm ít nhất hai khóa nhà cung cấp miễn phí ở trang Keys. Sao chép khóa thống nhất của bạn từ cùng trang.
Bước 2: Kết nối Aider
Lệnh thiết lập ghi ~/.aider.conf.yml. Trước tiên, nó sao lưu tệp hiện có.
Một lệnh
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>
aiderTệp mà lệnh ghi ra trông như sau:
~/.aider.conf.yml
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"Tiền tố openai/ là bắt buộc. Nó bảo Aider gửi tên model tới một API tương thích OpenAI. Để dùng biến môi trường và không dùng tệp, làm như sau:
Chỉ dùng biến môi trường
export OPENAI_API_BASE=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>
aider --model openai/autoAider tìm .aider.conf.yml trong thư mục home, sau đó ở gốc kho git, rồi ở thư mục hiện tại. Tệp được tải sau cùng có độ ưu tiên cao nhất. Do đó, một tệp của dự án có thể đổi model cho một kho.
Bước 3: Chọn model
Aider gửi tệp của bạn và bản đồ kho trong mỗi yêu cầu. Nó không cần gọi công cụ cho vòng lặp chỉnh sửa chính, vì nó đọc các chỉnh sửa từ văn bản của model. Cửa sổ ngữ cảnh lớn và khả năng làm theo chỉ dẫn tốt quan trọng hơn. Bảng hiển thị các model miễn phí có ít nhất 128K ngữ cảnh hiện nay.
| Mô hình | Miễn phí trên | Ngữ cảnh | Giới hạn miễn phí (ưu đãi tốt nhất) | Công cụ | Thị giác |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 yêu cầu/phút 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | Có | Không |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1 nữa | 1M | 40 yêu cầu/phút 40 RPM | Có | Có |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 yêu cầu/phút 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Có | Có |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | Có | Không |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Có | Có |
| Deepseek V4.1 Flash | APINex | 1M | 5 yêu cầu/phút 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Không | Không |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 yêu cầu/phút 20 yêu cầu/ngày 250,000 token/phút ~3M | Có | Có |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Có | Có |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 yêu cầu/phút 50 yêu cầu/ngày 50 req/day account-wide (1,000 after a $10 purchase) | Có | Có |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 yêu cầu/phút 50 yêu cầu/ngày Shared rate limit | Có | Không |
| DeepSeek V4 Flash 0731 | ElectronHub, Router9 | 1M | 10,000 credits/month (~$1), shared; account-anniversary reset | Không | Không |
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 nữa | 262K | 30 yêu cầu/phút 250 yêu cầu/ngày 70,000 token/phút ~6M | Có | Có |
Đang hiển thị 12 trong số 184 mô hình miễn phí phù hợp. Xem tất cả mô hình.
Dữ liệu trực tiếp từ danh mục FreeLLMAPI (phiên bản 2026.11.19, đã kiểm tra 2026-11-19). Giới hạn miễn phí thay đổi thường xuyên. Danh mục được kiểm tra mỗi ngày.
Dùng openai/auto để bộ định tuyến chọn model. Dùng openai/auto:smart để ưu tiên các model có trí tuệ cao nhất. Để ghim một model, dùng openai/ và một ID trong danh mục từ GET /v1/models.
Bạn cũng có thể đặt model cho một phiên trên dòng lệnh. Ví dụ này dùng các model mạnh nhất để chỉnh sửa. Nó dùng model nhanh cho thông điệp commit và tóm tắt lịch sử trò chuyện:
Model cho một phiên
aider --model openai/auto:smart --weak-model openai/auto:fastVới một hồ sơ đã lên kế hoạch, tạo một chuỗi dự phòng trên bảng điều khiển FreeLLMAPI, ví dụ một chuỗi tên coding. Sau đó dùng --model openai/auto:coding. Tên hồ sơ không tồn tại sẽ trả về lỗi 400, nên yêu cầu không chuyển sang chuỗi khác mà bạn không biết.
Cài đặt Aider cho model miễn phí
Aider biết cài đặt của các model phổ biến. Một model cổng như auto thì không được biết, nên bạn tự đặt các giá trị này.
| Cài đặt | Tác dụng | Giá trị khuyến nghị cho model miễn phí |
|---|---|---|
edit-format | Định dạng model dùng để gửi chỉnh sửa: whole, diff, diff-fenced hoặc udiff | diff cho model mạnh. whole cho model yếu, vì nó đơn giản hơn nhưng gửi nhiều token hơn. |
weak-model | Model dùng cho thông điệp commit và tóm tắt lịch sử trò chuyện | openai/auto:fast, để tác vụ nhỏ không dùng hạn mức của model mạnh |
map-tokens | Số token cho bản đồ kho. 0 tắt nó. | 1024 hoặc thấp hơn trên gói miễn phí nhỏ |
architect | Một model lên kế hoạch thay đổi, và một model biên tập viết các chỉnh sửa | Tùy chọn. Nó làm tăng gấp đôi số yêu cầu. |
~/.aider.conf.yml với cài đặt cho model miễn phí
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: 1024Để cho Aider biết cửa sổ ngữ cảnh của một model cổng, thêm tệp .aider.model.metadata.json. Khóa là tên model đầy đủ. Aider tìm tệp này ở cùng các vị trí với tệp cấu hình.
~/.aider.model.metadata.json
{
"openai/auto": {
"max_input_tokens": 128000,
"max_output_tokens": 8192,
"litellm_provider": "openai",
"mode": "chat"
}
}Giới hạn tốc độ và chuyển dự phòng
Gói miễn phí có giới hạn mỗi phút và mỗi ngày. FreeLLMAPI đếm mức dùng của từng khóa. Khi một nhà cung cấp gửi lỗi 429, bộ định tuyến gửi yêu cầu tới model tiếp theo trong chuỗi của bạn. Aider không thấy lỗi và tiếp tục.
- Thêm khóa từ bốn nhà cung cấp trở lên. Nhiều nhà cung cấp hơn cho nhiều yêu cầu hơn mỗi ngày.
- Chỉ thêm các tệp bạn muốn thay đổi bằng
/add. Mỗi tệp nằm trong mọi yêu cầu. - Dùng
/cleargiữa các tác vụ để gửi lịch sử trò chuyện ngắn hơn. Lịch sử ngắn cũng làm giảm token mỗi phút. - Dùng
/dropđể xóa các tệp bạn không cần nữa.
Khắc phục sự cố
| Vấn đề | Nguyên nhân | Cách khắc phục |
|---|---|---|
| "Model openai/auto: Kích thước cửa sổ ngữ cảnh và chi phí không rõ, dùng giá trị mặc định hợp lý." | Aider không biết model cổng | Cảnh báo này thường vô hại. Để bỏ nó, thêm .aider.model.metadata.json. |
| Chỉnh sửa không được áp dụng | Model không làm theo định dạng chỉnh sửa | Dùng --edit-format whole, hoặc một model mạnh hơn |
401 "Invalid API key" | Aider gửi khóa khác, ví dụ từ một tệp cấu hình khác | Kiểm tra các tệp cấu hình trong thư mục home, gốc git và thư mục hiện tại |
| Aider gọi api.openai.com | Đã dùng tiền tố openai/, nhưng chưa đặt base URL | Đặt openai-api-base hoặc OPENAI_API_BASE |
| "Tất cả model bị giới hạn tốc độ sau N lần thử" | Mọi khóa đều đạt giới hạn | Thêm khóa từ nhiều nhà cung cấp hơn, hoặc giảm map-tokens |
Câu hỏi thường gặp
Tôi có thể dùng Aider miễn phí không?
Có. Aider là mã nguồn mở. Trỏ nó tới FreeLLMAPI bằng openai-api-base và tiền tố model openai/. Cổng dùng các gói miễn phí của nhà cung cấp, nên chi phí suy luận là $0.
Làm sao để dùng Aider với API tương thích OpenAI?
Đặt OPENAI_API_BASE và OPENAI_API_KEY, rồi chạy aider --model openai/
Tôi nên dùng định dạng chỉnh sửa nào với model miễn phí?
Dùng diff cho model mạnh, vì nó gửi ít token hơn. Nếu chỉnh sửa không áp dụng được, dùng whole. Nó đơn giản hơn cho model yếu nhưng gửi toàn bộ tệp mỗi lần.
'Unknown context window size and costs, using sane defaults' nghĩa là gì?
Aider không biết tên model, nên nó dùng giá trị mặc định. Cảnh báo này thường vô hại. Thêm .aider.model.metadata.json với cửa sổ ngữ cảnh để bỏ nó.
Model miễn phí nào tốt nhất cho Aider?
Dùng model có cửa sổ ngữ cảnh lớn và khả năng làm theo chỉ dẫn tốt. Bảng trong trang này cho thấy các model miễn phí mạnh nhất có từ 128K ngữ cảnh trở lên hiện nay.
Hướng dẫn liên quan
- Dùng OpenCode với API LLM miễn phí
- Dùng Codex CLI với mô hình miễn phí
- API model lập trình miễn phí tốt nhất
- Base URL API tương thích OpenAI miễn phí
- API LLM miễn phí với ngữ cảnh 1 triệu token
Nguồn
- Aider docs: OpenAI-compatible APIs (đã kiểm tra 20 November 2026)
- Aider docs: YAML config file (đã kiểm tra 20 November 2026)
- Aider docs: options reference (đã kiểm tra 20 November 2026)
- Aider docs: edit formats (đã kiểm tra 20 November 2026)
- Aider docs: model warnings (đã kiểm tra 20 November 2026)
- Aider docs: advanced model settings (đã kiểm tra 20 November 2026)
- FreeLLMAPI CLI generators (đã kiểm tra 20 November 2026)