# MiniMax Code

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

Language: vi

> Dùng aicentos trong MiniMax Code (mcode) —— dùng provider add để thêm một provider tương thích OpenAI

MiniMax Code là CLI lập trình chính thức của MiniMax (lệnh `mcode`), có sẵn TUI, thực thi headless, ACP và TypeScript SDK. Nó hỗ trợ BYOK: có thể dùng `mcode provider add` để gắn bất kỳ endpoint tương thích OpenAI nào.

## Chuẩn bị

Trước tiên, tạo một Key chuyên dụng cho MiniMax Code trong Console (khuyến nghị đặt tên `minimax-code`), sau đó cài đặt:

```bash
curl -fsSL https://filecdn.minimax.chat/public/install.sh | bash
```

Cũng có thể cài qua npm:

```bash
npm install -g @minimax-ai/code@latest
mcode --version
```

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

| Trường          | Giá trị                                      |
| --------------- | -------------------------------------------- |
| Tên provider    | tự đặt, ví dụ `aicentos`                     |
| `--base-url`    | `https://aicentos.com/v1`                    |
| `--api-format`  | `openai-completions`                         |
| `--model`       | tên mô hình trong "Model Square" của Console |
| `--api-key-env` | `MCODE_PROVIDER_API_KEY`                     |

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

Một lệnh đăng ký và chuyển sang:

```bash
export MCODE_PROVIDER_API_KEY="sk-API-Key-của-bạn"

mcode provider add \
  --name aicentos \
  --base-url https://aicentos.com/v1 \
  --api-format openai-completions \
  --model tên-mô-hình-của-bạn \
  --api-key-env MCODE_PROVIDER_API_KEY \
  --use
```

`--use` nghĩa là đăng ký xong chuyển ngay sang provider này. Nó sẽ ghi cấu hình vào đoạn `custom_provider` trong `config.yaml` của profile hiện tại (thư mục dữ liệu mặc định `~/.minimax`), cách viết tương đương:

```yaml
custom_provider:
  aicentos:
    options:
      apiKey: sk-API-Key-của-bạn
      baseURL: https://aicentos.com/v1
    models:
      tên-mô-hình-của-bạn: {}
```

Lưu ý khóa ở đây là `baseURL` (URL viết hoa), không phải `base-url`.

## Kiểm tra

```bash
mcode exec "Giới thiệu bản thân trong một câu"
```

Headless trả về được nghĩa là cấu hình có hiệu lực. Sau đó vào TUI chạy một vòng tác vụ thực tế, cuối cùng quay lại Console đối chiếu mức sử dụng.

## Lưu ý

* Mô hình tùy chỉnh phải chỉ rõ giới hạn ngữ cảnh và đầu ra (`--context-limit`, `--output-limit`), nếu không nó cắt theo giá trị mặc định, file dài dễ bị cắt cụt.
* Script cài một lệnh không hỗ trợ Alpine / musl, môi trường này đổi sang cài bằng npm.
* Khi muốn dùng giao thức tương thích Anthropic để làm trung chuyển, yêu cầu vẫn kèm `x-api-key`, nếu phía trên chỉ nhận `Authorization` thì cần tự thêm một lớp chuyển đổi.
* Provider được lưu **theo profile**, sau khi đổi profile cần xác nhận lại mục nào đang có hiệu lực.

## Liên kết liên quan

* [Bắt đầu nhanh với MiniMax Code](https://agent.minimax.io/docs/cli/quick-start)
* [Kho minimax-code](https://github.com/MiniMax-AI/minimax-code)