# Aider (/vi/docs/guides/aider)

Chạy trợ lý lập trình Aider trên các mô hình cheapaimodel qua API tương thích OpenAI.



Aider kết nối với các API tương thích OpenAI qua tiền tố mô hình `openai/`: trỏ Base URL và key tới cheapaimodel, rồi thêm `openai/` trước ID mô hình.

|            | Cài đặt Aider                              | Giá trị                                                                                    |
| ---------- | ------------------------------------------ | ------------------------------------------------------------------------------------------ |
| Base URL   | `OPENAI_API_BASE` hoặc `--openai-api-base` | `https://api.cheapaimodel.ai/v1`                                                           |
| API key    | `OPENAI_API_KEY` hoặc `--openai-api-key`   | Key của bạn từ trang [API key](https://console.cheapaimodel.ai/keys) trong bảng điều khiển |
| ID mô hình | `--model`                                  | `openai/glm-5.3`, hoặc `openai/` cộng với bất kỳ ID nào trong [danh mục](/vi/models)       |

## Thiết lập [#set-it-up]

```bash title="Terminal"
python -m pip install aider-install
aider-install
```

Sau đó, trong dự án của bạn:

```bash title="Terminal"
export OPENAI_API_BASE="https://api.cheapaimodel.ai/v1"
export OPENAI_API_KEY="$CHEAPAIMODEL_API_KEY"
aider --model openai/glm-5.3
```

Aider bỏ tiền tố đi và gửi yêu cầu `glm-5.3` tới `/v1/chat/completions`.

Để lưu lại cài đặt mà không phải export các biến `OPENAI_*` cho mọi công cụ, đặt các cài đặt này trong tệp cấu hình của Aider:

```yaml title="~/.aider.conf.yml"
model: openai/glm-5.3
openai-api-base: https://api.cheapaimodel.ai/v1
openai-api-key: sk-...
```

Aider cũng đọc `.aider.conf.yml` ở thư mục gốc của repo git. Đừng commit các tệp chứa key lên repo.

## Cảnh báo về mô hình [#the-model-warning]

Khi khởi động, Aider in ra `Unknown context window size and costs, using sane defaults` với những mô hình mà Aider không có metadata, và có thể gợi ý tên tương tự như `zai/glm-5.3`. Giữ nguyên `openai/glm-5.3`: các tên được gợi ý gọi thẳng nhà cung cấp khác, không qua cheapaimodel. Theo tài liệu của Aider, có thể bỏ qua cảnh báo này vì Aider không áp giới hạn token.

Để tắt cảnh báo, truyền `--no-show-model-warnings`, hoặc mô tả mô hình trong `.aider.model.metadata.json` ở thư mục home của bạn:

```json title="~/.aider.model.metadata.json"
{
  "openai/glm-5.3": {
    "max_input_tokens": CONTEXT_LENGTH,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}
```

Thay `CONTEXT_LENGTH` bằng độ dài ngữ cảnh ghi trên trang của mô hình, ví dụ [glm-5.3](/vi/models/glm-5.3). Aider không biết giá của cheapaimodel; xem chi tiêu của bạn ở trang [Hoạt động](https://console.cheapaimodel.ai/activity) trong bảng điều khiển.

## Lỗi thường gặp [#common-mistakes]

* **`litellm.BadRequestError: LLM Provider NOT provided`.** ID mô hình thiếu tiền tố `openai/`. Dùng `--model openai/glm-5.3`.
* **Aider khởi động với `gpt-4o` và mọi yêu cầu đều báo lỗi.** Nếu không có `--model` (hoặc `model:` trong tệp cấu hình), Aider thấy `OPENAI_API_KEY` và chọn một mô hình OpenAI mặc định, chẳng hạn `gpt-4o` với `gpt-4o-mini` làm weak model. Chúng tôi không cung cấp các ID đó. Luôn chỉ định mô hình.
* **Yêu cầu của `--weak-model` hoặc `--editor-model` báo lỗi.** Hai tùy chọn này theo cùng quy tắc với `--model`: thêm tiền tố `openai/` và dùng ID trong danh mục, ví dụ `--weak-model openai/glm-5.3-flash`. Nếu bạn không đặt cái nào, Aider dùng mô hình chính cho cả hai.
* **"The API provider's servers are down or overloaded", kèm các lần thử lại.** Aider báo mọi lỗi `503` theo cách này. Nếu lỗi ngay từ yêu cầu đầu tiên, kiểm tra ID mô hình: ID mà chúng tôi không cung cấp sẽ trả về `503` kèm `model_not_found`. Các trường hợp khác, xem [Lỗi](/vi/docs/concepts/errors).
* **`fault filter abort` hoặc `Invalid URL (POST /v1/chat/completions/chat/completions)`.** Cả hai đều là `404` do Base URL sai: lỗi thứ nhất nghĩa là thiếu `/v1`, lỗi thứ hai nghĩa là Base URL có kèm đường dẫn endpoint. Đặt chính xác `https://api.cheapaimodel.ai/v1`.