# Reasonix

Nguồn: https://docs.aicentos.com/vi/clients/reasonix

Language: vi

> Dùng aicentos trong Reasonix —— kết nối qua provider tùy chỉnh trong config.toml

Reasonix là một coding Agent cục bộ (CLI/TUI, bản desktop, UI trình duyệt, cùng bản ACP cho trình soạn thảo — bốn lối vào dùng chung một engine). Nó không tích hợp sẵn provider aicentos, nhưng có thể thêm một bản ghi `[[providers]]` OpenAI tương thích vào `~/.reasonix/config.toml`, để chuyển yêu cầu sang aicentos.

## Chuẩn bị

Tạo một Key chuyên dụng trong Console của aicentos (khuyến nghị đặt tên `reasonix-cli`). Key của provider Reasonix được lưu trong `.env` toàn cục của chính nó, không đọc biến môi trường shell.

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

| Trường        | Giá trị                                      |
| ------------- | -------------------------------------------- |
| name          | `aicentos` (ID provider cục bộ)              |
| kind          | `openai` (Chat Completions)                  |
| base\_url     | `https://aicentos.com/v1`                    |
| api\_key\_env | `AICENTOS_API_KEY`                           |
| models        | tên mô hình trong "Model Square" của Console |

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

* Cài Reasonix (npm hoặc Homebrew trên macOS):

  ```bash
  npm i -g reasonix
  ```

* Ghi Key vào `.env` toàn cục của Reasonix:

  ```bash
  # macOS / Linux
  echo 'AICENTOS_API_KEY=your_api_key_here' >> ~/.reasonix/.env

  # Windows：%APPDATA%\reasonix\.env
  ```

* Sửa `~/.reasonix/config.toml`, hợp nhất đoạn dưới đây (đừng xóa các provider khác đã có):

  ```toml
  default_model = "aicentos"

  [[providers]]
  name          = "aicentos"
  kind          = "openai"
  base_url      = "https://aicentos.com/v1"
  models        = ["claude-sonnet-5", "deepseek-v4-pro", "qwen3-coder-plus"]
  default       = "claude-sonnet-5"
  api_key_env   = "AICENTOS_API_KEY"
  context_window = 200000
  ```

* Vào thư mục dự án khởi động:

  ```bash
  reasonix
  ```

  Cũng có thể dùng tác vụ một lần để xác minh: `reasonix run "giải thích trong một câu thư mục hiện tại là dự án gì"`. Bản desktop thì đi qua **Settings → Model → Access → Add model service → Custom provider**.

## Kiểm tra

Sau khi khởi động gửi một câu prompt đơn giản, xác nhận có thể trả về dạng stream bình thường. Trong phiên hội thoại có thể dùng `/model` để chuyển mô hình.

## Lưu ý

* `base_url` chỉ điền đến `/v1`, Reasonix sẽ tự nối `/chat/completions`.
* Key bắt buộc phải ghi trong `~/.reasonix/.env`; `export` ra shell hay `.env` của dự án đều không được nhận diện là key provider.
* `kind` chọn `openai`; loại gốc `anthropic` tương ứng endpoint Anthropic Messages, không phù hợp ở đây.
* `default_model` điền là `name` của provider (`aicentos`), không phải tên mô hình.
* Nếu biểu mẫu provider tùy chỉnh của bản desktop yêu cầu điền địa chỉ đầy đủ, điền `https://aicentos.com/v1/chat/completions`.
* Địa chỉ dự án: `https://github.com/esengine/DeepSeek-Reasonix`