Tệp cấu hình Aider cho API key của riêng bạn: .aider.conf.yml và Windows setx

Hai biến, OPENAI_API_BASE và OPENAI_API_KEY, cùng một đối số model như openai/<model id> là đủ để trỏ Aider tới CheapTokens. Các bước cơ bản từng bước (cài đặt, yêu cầu đầu tiên, 401/404/400/402) nằm trong Cách kết nối Aider với CheapTokens; trang này bao gồm những gì hướng dẫn đó bỏ sót: Windows setx, tệp cấu hình và thứ tự tải của nó, cùng ước tính chi phí một phiên.

Nguồn: tài liệu của Aider cho các API tương thích OpenAI (trang được kiểm tra ngày 26 tháng 10 năm 2026; tài liệu không hiển thị ngày hay phiên bản, và aider-chat mới nhất trên PyPI ngày hôm đó là 0.86.2).

Windows: setx và một terminal mới#

Trên Mac và Linux bạn export hai biến. Trên Windows (PowerShell hoặc cmd) dùng setx:

setx OPENAI_API_BASE https://api.cheaptokens.dev/v1
setx OPENAI_API_KEY <your CheapTokens key>

Trên Windows có một cái bẫy. setx ghi các biến cho các phiên sau, không phải phiên bạn đang gõ, nên hãy đóng terminal và mở một cái mới trước khi khởi động Aider. Nếu bạn đặt các biến mà Aider vẫn hỏi key, đây là lý do thường gặp.

Model nào cho chỉnh sửa nào#

Đối số model là openai/ cộng với id đầy đủ, nên với CheapTokens nó có hai dấu gạch chéo:

cd your-git-repo
aider --model openai/MiniMaxAI/MiniMax-M2.7

MiniMax-M2.7 có ngữ cảnh 180K và trả lời tối đa 8.192 token, phù hợp cho các chỉnh sửa nhỏ và vừa khi câu trả lời ngắn. Nếu chỉnh sửa của bạn trả về dưới dạng diff dài, model khác đáng thử là DeepSeek-V4-Flash: tối đa 32.768 token mỗi câu trả lời, ngữ cảnh 380K và một mức giá bất kể thời điểm trong ngày.

aider --model openai/deepseek-ai/DeepSeek-V4-Flash-0731

Sao chép id đầy đủ từ tài liệu CheapTokens hoặc danh sách model trên bảng giá.

Chạy chỉnh sửa đầu tiên#

Aider hoạt động bên trong một git repo, nên hãy bắt đầu trong một repo. Thêm một tệp và yêu cầu một việc nhỏ:

> /add app.py
> Add a --verbose flag that prints each file before it is processed

Khi Aider trả lời bằng một chỉnh sửa cho tệp, key, base URL và model id đều đúng.

Ngừng gõ lại: .aider.conf.yml#

Aider đọc .aider.conf.yml từ thư mục home của bạn, rồi gốc git repo, rồi thư mục hiện tại, và các tệp sau thắng. Vậy một tệp toàn cục có thể chứa key và base, còn tệp trong repo có thể chọn model. Nếu bạn muốn một tệp cụ thể và không gì khác, aider --config <file> chỉ tải tệp đó.

Một tệp trong thư mục home (ví dụ, hãy đặt key của riêng bạn vào):

openai-api-base: https://api.cheaptokens.dev/v1
openai-api-key: <your CheapTokens key>
model: openai/MiniMaxAI/MiniMax-M2.7

Giờ chỉ aider là khởi động với endpoint và model đúng. Nếu bạn commit tệp vào một repo, hãy bỏ key ra và giữ nó trong biến môi trường hoặc trong tệp .env; các dòng key là dành cho thư mục home của riêng bạn.

Với một model mà Aider không biết, tài liệu mô tả một model-settings-file (.aider.model.settings.yml) nơi bạn có thể chỉ định các thiết lập của nó.

Một phiên tốn bao nhiêu#

Aider gửi lại các tệp bạn đã thêm và lịch sử trò chuyện với mỗi tin nhắn, nên token đầu vào tăng nhanh hơn đầu ra. Giả sử một phiên làm việc khoảng 20 tin nhắn gửi 400.000 token đầu vào và nhận lại 40.000 token đầu ra (một giả định cho ví dụ; hãy thay bằng số của bạn). Trên MiniMax-M2.7 đó là $0.026, và rẻ hơn OpenRouter tổng cộng, khi tính đầu vào và đầu ra cùng nhau. Bảng dưới đây chạy cùng phiên đó qua các model của chúng tôi:

Cách giữ phía đầu vào nhỏ (tệp chỉ đọc, /drop, kích thước repo map) được đề cập trong Aider tốn bao nhiêu. Giá hiện tại luôn có trên trang bảng giá.

Nếu nó không hoạt động#

• Aider hỏi API key hoặc nói chuyện với dịch vụ sai. Các biến không hiển thị với tiến trình. Trên Windows, khởi động lại terminal sau setx; trên Mac và Linux, chạy echo $OPENAI_API_BASE trong cùng shell.
• Cấu hình của bạn có vẻ bị bỏ qua. Hãy nhớ thứ tự: home, gốc repo, thư mục hiện tại. Một tệp gần bạn hơn sẽ ghi đè tệp toàn cục.
• Không tìm thấy model, 404 hoặc lỗi xác thực. Những điều này được đề cập trong Cách kết nối Aider với CheapTokens.

Cùng địa chỉ tương thích OpenAI hoạt động trong các công cụ khác; nếu bạn cũng dùng một editor agent, xem kết nối OpenCode hoặc tổng quan về nơi cắm API key của riêng bạn.