Reasonix 配置​

Reasonix 是面向项目开发的编码 Agent。它会在首次启动时通过 setup wizard 配置模型服务，并将设置保存到用户目录。完成通用凭证准备后，可以将它连接到 yuyuflow。

先完成通用配置

建议先阅读快速开始和 LLM 配置，确认 API Key、额度和模型 ID 可用。Reasonix 不需要通过环境变量保存 API Key。

前置条件​

  • Node.js 20.10 或更高版本。
  • Windows 用户还需要 Git for Windows。
  • 已在控制台创建专用 API Key。

启动 Reasonix​

在项目目录运行：

bash
npx reasonix code

不需要全局安装。首次启动时，setup wizard 会提示输入 API Key 和连接信息。

在向导中填写平台信息​

根据向导提示填写：

配置项填写内容
API Key控制台创建的专用 API Key
API host / Base URL使用 art-api.yuyuflow.com 或控制台明确提供的 https://art-api.yuyuflow.com
Model默认可先使用快速模型，再按需切换主模型

参考页面说明 Reasonix 直接连接 API host，不经过 translation layer，但没有公开当前版本的完整 URL、端口、endpoint、协议名称或配置 JSON schema。请以 Reasonix 向导显示的字段为准，不要自行补充未知字段。

配置文件通常位于：

text
~/.reasonix/config.json

如果需要备份或迁移配置，请先确认文件中没有把真实 API Key 暴露给其他用户或提交到仓库。

模型切换​

Reasonix 默认使用快速模型。可以在会话中使用以下命令：

text
/pro

让下一回合使用主模型；使用以下命令可切换整个会话：

text
/preset max

查看可用命令：

text
/help

具体模型 ID 请以控制台和客户端当前版本显示为准。

验证连接​

启动后先发送一个简单的代码相关问题，确认模型能够返回结果。再让 Agent 读取一个非敏感源文件，验证项目上下文和权限是否正常。

如果返回鉴权或模型错误，先退出 Reasonix，检查向导中的 API host、模型 ID 和 API Key，再重新启动。

常见问题​

首次启动没有出现 setup wizard

检查是否已有 ~/.reasonix/config.json。可以先备份该文件，再重新启动客户端；不要直接删除包含凭证的配置。

鉴权失败或返回 `401`

确认 API Key 未过期、属于当前平台和工作区，并检查 API host 是否填成了其他服务的地址。Reasonix 不需要通过环境变量注入密钥。

模型不存在或返回 `404`

使用控制台中的完整模型 ID。/pro 和 /preset max 是会话切换命令，不是模型 ID。

不知道 `config.json` 的字段含义

参考页面只确认了文件位置，没有公开当前版本 JSON schema。不要把 WorkBuddy 的 models、availableModels 等字段复制到 Reasonix。

请求协议不兼容

Reasonix 的参考接入信息没有公开完整协议和 endpoint。请使用客户端向导提供的连接方式，不要直接复制 Codex 的 Responses API 或 WorkBuddy 的 Chat Completions 配置。

下一步可阅读 Agent 工具总览、LLM 配置、OpenCode 配置 或 WorkBuddy / CodeBuddy 配置。