# MiMo Code

Nguồn: https://docs.aicentos.com/vi/clients/mimo-code

Language: vi

> Dùng aicentos trong MiMo Code —— kết nối endpoint OpenAI tương thích qua lớp tương thích

MiMo Code hỗ trợ chỉ định `base_url` OpenAI tương thích trong cấu hình. Trỏ nó về aicentos và điền API Key, là có thể cho MiMo Code đi qua các mô hình của aicentos.

## Chuẩn bị

Trước tiên, tạo một Key chuyên dụng cho MiMo Code tại trang "API Key" trong Console (khuyến nghị đặt tên `mimo-code` để dễ theo dõi mức sử dụng).

* Console: [https://aicentos.com](https://aicentos.com)
* Tạo Key: [https://aicentos.com/keys](https://aicentos.com/keys)
* Nạp tiền Ví: [https://aicentos.com/wallet](https://aicentos.com/wallet)
* Trang tài liệu: [https://docs.aicentos.com](https://docs.aicentos.com)

MiMo Code là công cụ CLI, cách cài phổ biến là cài toàn cục bằng npm; nếu gói phát hành bạn nhận được là tarball, giải nén xong đưa file thực thi vào `PATH` là được.

```bash
npm install -g mimo-code
mimo --version
```

## Cấu hình cần điền

| Trường    | Giá trị                                      |
| --------- | -------------------------------------------- |
| API Key   | Key tạo trong Console                        |
| base\_url | `https://aicentos.com/v1`                    |
| model     | tên mô hình trong "Model Square" của Console |

## Các bước thiết lập

Khuyến nghị dùng biến môi trường, độ tương thích tốt nhất:

```bash
export MIMO_BASE_URL="https://aicentos.com/v1"
export MIMO_API_KEY="sk-key-của-bạn"
export AICENTOS_API_KEY="$MIMO_API_KEY"
export MIMO_MODEL="gpt-4o"
```

Muốn hiệu lực vĩnh viễn, ghi vào `~/.zshrc` hoặc `~/.bashrc` rồi thực hiện `source ~/.zshrc`.

Nếu thích file cấu hình, sửa `~/.mimo/config.json`:

```json
{
  "baseUrl": "https://aicentos.com/v1",
  "apiKey": "sk-key-của-bạn",
  "model": "gpt-4o"
}
```

Lưu ý các phiên bản khác nhau có thể khác nhau về cách đặt tên mục cấu hình (`base_url` / `baseUrl`) và tiền tố biến môi trường (`MIMO_` / `MIMOCODE_`). Nếu tên biến ở trên không có hiệu lực, dùng `mimo --help` hoặc tài liệu chính thức xác nhận tên thực tế phiên bản hiện tại đọc vào, đừng thử đi thử lại.

## Kiểm tra

Sau khi cấu hình, chạy trực tiếp `mimo`, gửi một câu prompt đơn giản. Nếu báo lỗi xác thực, ưu tiên kiểm tra tên biến môi trường có được phiên bản hiện tại nhận diện không, `base_url` có chỉ viết đến `/v1` không, Key có khoảng trắng thừa không.

## Lưu ý

* Một số phiên bản khi khởi động sẽ kiểm tra `base_url` với endpoint chính thức tích hợp sẵn, nếu phát hiện cấu hình bị bỏ qua, chuyển sang cách biến môi trường thường có thể qua được.
* Base URL chỉ điền đến `/v1`.
* Khuyến nghị trước tiên dùng `curl https://aicentos.com/v1/models -H "Authorization: Bearer $AICENTOS_API_KEY"` xác nhận mô hình nhìn thấy được, rồi mới điền tên mô hình.
* Khi biến môi trường và file cấu hình cùng tồn tại, độ ưu tiên giữa các phiên bản không nhất quán, khuyến nghị chỉ giữ một cách cấu hình.