# Reasonix

來源: https://docs.aicentos.com/zh-TW/clients/reasonix

Language: zh-TW

> 在 Reasonix 中使用 aicentos —— 透過 config.toml 自訂 provider 接入

Reasonix 是一個本地編碼 Agent（CLI/TUI、桌面端、瀏覽器 UI、以及編輯器 ACP 四種入口共用同一個引擎）。它沒有內建 aicentos provider，但可以往 `~/.reasonix/config.toml` 裡加一條 OpenAI 相容的 `[[providers]]` 記錄，把請求轉到 aicentos。

## 準備工作

在 aicentos 控制台建立一個專用 Key（建議命名 `reasonix-cli`）。Reasonix 的 provider 金鑰存在它自己的全域 `.env` 裡，不讀 shell 環境變數。

## 需要填寫的設定

| 欄位            | 值                          |
| ------------- | -------------------------- |
| name          | `aicentos`（本地 provider ID） |
| kind          | `openai`（Chat Completions） |
| base\_url     | `https://aicentos.com/v1`  |
| api\_key\_env | `AICENTOS_API_KEY`         |
| models        | 控制台「模型廣場」中的模型名稱            |

## 設定步驟

* 安裝 Reasonix（npm 或 macOS 的 Homebrew）：

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

* 把 Key 寫進 Reasonix 全域 `.env`：

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

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

* 編輯 `~/.reasonix/config.toml`，合併下面這段（不要刪掉已有的其它 provider）：

  ```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
  ```

* 進入專案目錄啟動：

  ```bash
  reasonix
  ```

  也可以先用一次性任務驗證：`reasonix run "用一句話說明當前目錄是什麼專案"`。桌面端則走 **Settings → Model → Access → Add model service → Custom provider**。

## 測試

啟動後發一句簡單提示詞，確認能正常串流回應。工作階段內可用 `/model` 切換模型。

## 注意事項

* `base_url` 只填到 `/v1`，Reasonix 會自行串接 `/chat/completions`。
* Key 必須寫在 `~/.reasonix/.env`；`export` 到 shell 或專案 `.env` 都不會被識別為 provider 金鑰。
* `kind` 選 `openai`；`anthropic` 原生類型對應 Anthropic Messages 端點，不適合這裡。
* `default_model` 填的是 provider 的 `name`（`aicentos`），不是模型名稱。
* 如果桌面端自訂 provider 表單要求填完整位址，填 `https://aicentos.com/v1/chat/completions`。
* 專案位址：`https://github.com/esengine/DeepSeek-Reasonix`