Skip to Content
aicentos

Reasonix

在 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 環境變數。

需要填寫的設定

欄位值
nameaicentos(本地 provider ID)
kindopenai(Chat Completions)
base_urlhttps://aicentos.com/v1
api_key_envAICENTOS_API_KEY
models控制台「模型廣場」中的模型名稱

設定步驟

  • 安裝 Reasonix(npm 或 macOS 的 Homebrew):

    npm i -g reasonix
  • 把 Key 寫進 Reasonix 全域 .env:

    # macOS / Linux
    echo 'AICENTOS_API_KEY=your_api_key_here' >> ~/.reasonix/.env
    
    # Windows:%APPDATA%\reasonix\.env
  • 編輯 ~/.reasonix/config.toml,合併下面這段(不要刪掉已有的其它 provider):

    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
  • 進入專案目錄啟動:

    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