Tài liệu

Aider

Aider đọc OPENAI_API_BASE và OPENAI_API_KEY. Trỏ hai biến này đến Kunavo, thêm tiền tố openai/ vào mã model, rồi chỉ cần đổi một đối số --model để chuyển giữa Claude và GPT.

Hai biến môi trường và một tiền tố. Đặt OPENAI_API_BASE thành https://api.kunavo.com/v1, OPENAI_API_KEY thành khóa sk-kn-… của bạn, rồi chạy Aider với --model openai/<id>. Không cần thay đổi gì trong kho mã hoặc bản cài đặt Aider.

~/.zshrc

export OPENAI_API_BASE=https://api.kunavo.com/v1
export OPENAI_API_KEY=sk-kn-...

# The openai/ prefix is required — it tells Aider to speak the OpenAI
# protocol to OPENAI_API_BASE instead of resolving the id as a known model.
aider --model openai/claude-sonnet-5

Cần có tiền tố openai/ và URL cơ sở phải có hậu tố /v1. Bỏ tiền tố khiến Aider tra mã trong danh sách nhà cung cấp của chính nó và báo lỗi “model không xác định”; bỏ /v1 khiến yêu cầu không đến đúng tuyến xử lý.

Từng bước

Tạo khóa tại /app/keys rồi sao chép khóa — khóa chỉ hiển thị một lần.
Xuất OPENAI_API_BASE và OPENAI_API_KEY trong shell dùng để khởi chạy Aider, hoặc thêm chúng vào ~/.aider.conf.yml như minh họa bên dưới.
Khởi chạy Aider trong kho mã của bạn bằng aider --model openai/claude-sonnet-5.
Khi khởi động, Aider sẽ in model mà nó đã phân giải. Nếu dòng đó hiển thị mã bạn đã yêu cầu, endpoint đã được cấu hình đúng.

Tài liệu tham khảo riêng của Aider cho việc này là trang API tương thích với OpenAI.

Không lưu trong hồ sơ shell

Có thể lưu hai giá trị tương tự trong tệp cấu hình của Aider; đây là nơi phù hợp hơn khi bạn chuyển đổi endpoint theo từng dự án.

~/.aider.conf.yml

# ~/.aider.conf.yml — same two values, without exporting them each shell.
openai-api-base: https://api.kunavo.com/v1
openai-api-key: sk-kn-...
model: openai/claude-sonnet-5

Xác minh trước khi gỡ lỗi Aider

Chỉ cần một yêu cầu là đủ xác định nguyên nhân nằm ở endpoint, khóa hay bước phân giải model của Aider. Nếu yêu cầu này trả về danh sách mã model dạng JSON, thì cùng URL cơ sở và khóa đó cũng dùng được trong Aider — mọi lỗi còn lại đều do tiền tố openai/.

# Settles whether a failure is the endpoint, the key, or Aider.
# A JSON list of model ids means the same base URL will work in Aider.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Nên chọn model nào

Có thể truy cập mọi model văn bản trên Kunavo bằng openai/<id> — xem toàn bộ danh sách tại trang model; danh sách cũng được cập nhật theo thời gian thực từ GET /v1/models. Giá tính bằng USD cho mỗi 1M token, đầu vào / đầu ra.

ID mô hình	Kunavo vào / ra	Phù hợp ở đâu
`claude-haiku-4-5`	$0.70 / $3.50	Claude rẻ nhất — phù hợp cho các lệnh lập bản đồ kho mã và tạo thông điệp commit của Aider
`claude-sonnet-5`	$1.40 / $7.00	Cân bằng tốt giữa chất lượng và giá cho việc chỉnh sửa
`claude-opus-5`	$3.50 / $17.50	Cấp Claude có chất lượng cao nhất — phù hợp với các thay đổi ở cấp kiến trúc
`gpt-5-6-terra`	$0.70 / $4.20	Cùng một khóa, dòng model khác — hữu ích để xin ý kiến thứ hai về một diff khó

Aider gửi lại bản đồ kho mã và các tệp đã chỉnh sửa trong mỗi lượt trao đổi, nên mức tiêu thụ token tỷ lệ với kích thước ngữ cảnh chứ không phải kích thước phần chỉnh sửa. Vì vậy, bộ nhớ đệm prompt là yếu tố quan trọng nhất ở đây, còn --model cùng --weak-model openai/claude-haiku-4-5 là lựa chọn phân chia tiết kiệm nhất: model mạnh thực hiện chỉnh sửa, model yếu viết thông điệp commit và bản tóm tắt. Tính phí theo token từ số dư trả trước, không có phí hằng tháng — xem chi tiết tại thanh toán.

Câu hỏi thường gặp

Làm cách nào để dùng Aider với API tương thích với OpenAI?

Đặt OPENAI_API_BASE thành URL cơ sở của endpoint và OPENAI_API_KEY thành khóa của bạn, sau đó khởi chạy Aider với mã model có tiền tố openai/ — ví dụ `aider --model openai/claude-sonnet-5`. Với Kunavo, URL cơ sở là https://api.kunavo.com/v1. Tiền tố này là bắt buộc: nếu thiếu, Aider sẽ tra mã model trong danh sách nhà cung cấp của chính nó thay vì gửi mã đó đến endpoint của bạn.

Aider có thể dùng model Claude qua endpoint tương thích với OpenAI không?

Có. Aider giao tiếp với đích OPENAI_API_BASE bằng giao thức OpenAI, vì vậy có thể truy cập model Claude được cung cấp theo định dạng đó mà không cần thông tin xác thực Anthropic — mã model chỉ là một chuỗi khác trong danh sách /v1/models. Trên Kunavo, các mã Claude và GPT đều dùng chung một khóa; để chuyển đổi, bạn chỉ cần thay đối số --model, không cần đổi cấu hình.

Vì sao Aider báo model không xác định?

Gần như luôn là do thiếu tiền tố openai/. Aider xem mã trần là model mà nó phải nhận diện và sẽ báo lỗi nếu không nhận ra; `openai/<id>` yêu cầu Aider chuyển thẳng mã đó đến OPENAI_API_BASE. Nguyên nhân phổ biến thứ hai là URL cơ sở thiếu hậu tố /v1, dẫn đến lỗi kết nối hoặc 404 thay vì lỗi model không xác định.

Aider có hiển thị chi phí của một phiên không?

Aider in số lượng token và chi phí ước tính cho mỗi lượt trao đổi, dựa trên siêu dữ liệu model riêng của nó — với endpoint tùy chỉnh, ước tính đó có thể sai vì Aider không biết mức giá của endpoint. Hãy xem số lượng token là phần đáng tin cậy và kiểm tra khoản phí thực tế từ nhà cung cấp. Trên Kunavo, chi phí mỗi yêu cầu có trong mục sử dụng, được trừ từ số dư trả trước và không có phí hằng tháng.