​
Reasonix 接入 NoneLinear

Reasonix 是一款面向代码开发的 AI Agent 工具，提供桌面版和终端版。两种版本都可以通过 OpenAI Chat Completions 兼容接口接入 NoneLinear，核心配置保持一致：
配置项填写内容
API 协议OpenAI-compatible / OpenAI Chat Completions
API 地址 / Base URLhttps://api.nonelinear.com/v1
API Key你的 NoneLinear API Key
模型 ID在 模型列表 中选择，例如 deepseek-v4-pro
不要在截图、工单、公开仓库或聊天群中暴露真实 API Key。如果怀疑 Key 泄露，请立即在 NoneLinear 控制台删除并重新生成。

​
前置要求

​
一、桌面版接入

​
1. 下载并安装桌面版

打开 Reasonix 官网的安装区域：https://reasonix.io/#start，切换到 Desktop / 桌面端，根据系统下载安装包：
系统选择
macOSUniversal DMG，适用于 Apple Silicon 和 Intel
WindowsInstaller，适用于 Windows 10+
Linux.deb 或通用 tar.gz
安装后启动 Reasonix，进入设置页面。

​
2. 进入模型接入设置

在 Reasonix 桌面版中打开 设置 → 模型 → 接入。如果还没有添加过供应商，页面会显示供应商接入区域，点击 + 添加模型服务。 Reasonix 桌面版添加模型服务入口

​
3. 添加 NoneLinear 供应商

添加供应商时，可以使用 自定义供应商，并按下面方式填写：
字段填写内容
自定义供应商名称NoneLinear
接入协议OpenAI-compatible
API 地址https://api.nonelinear.com/v1
完整 URL关闭
密钥你的 NoneLinear API Key
Reasonix 会自动把 /chat/completions 拼接到 Base URL 后面，所以 API 地址只需要填写 https://api.nonelinear.com/v1，不要额外填写完整请求路径。 Reasonix 桌面版配置 NoneLinear 供应商

​
4. 测试并获取模型

填写 API 地址和密钥后，点击 测试并获取模型。如果连接成功，Reasonix 会返回可用模型列表。 你可以直接从发现的模型中勾选要启用的模型，也可以在 模型列表 中手动填写模型 ID。模型 ID 必须与 NoneLinear 模型列表完全一致，包括大小写、连字符和版本号。 Reasonix 桌面版测试并获取模型

​
5. 启用并验证

保存供应商配置后，回到 Reasonix 主界面，在模型选择器中选择刚刚启用的 NoneLinear 模型。发送一条简单测试消息，例如： 
请用一句话说明你当前可以帮助我做什么。
如果 Reasonix 正常返回内容，说明桌面版已经接入成功。

​
二、终端版接入

​
1. 安装 Reasonix CLI

在终端、CMD 或 PowerShell 中执行： 
npm i -g reasonix@next
安装完成后检查版本： 
reasonix --version
如果能看到版本号，说明安装成功。

​
2. 启动配置向导

首次接入时执行： 
reasonix setup
Reasonix 会进入交互式配置向导。后续正常使用时执行 reasonix 即可，只有需要重新配置时才使用 reasonix setup。

​
3. 选择第三方 OpenAI 兼容模型

在 Provider 选择界面，选择 添加第三方OpenAI兼容模型：
  1. 使用上下方向键移动到该选项。
  2. 按空格键选中。
  3. 按回车键确认。
Reasonix 的选择界面需要先按空格选中，再按回车确认。只按回车可能不会选中当前选项。
Reasonix CLI 选择第三方 OpenAI 兼容模型

​
4. 填写 NoneLinear 配置

配置向导会依次提示填写以下信息：
提示项填写内容
Base URLhttps://api.nonelinear.com/v1
API Key 环境变量名可使用默认建议名，也可以填写 NONELINEAR_API_KEY
API Key你的 NoneLinear API Key
模型名称例如 deepseek-v4-pro
其中 Base URL 不要填写到 /chat/completions，Reasonix 会自动拼接请求路径。 Reasonix CLI 填写 NoneLinear 配置信息

​
5. 确认 API Key

填写完成后，Reasonix 可能会提示： 
重新输入 [CUSTOM_API_NONELINEAR_COM_API_KEY]？[y/N]:
如果确认 API Key 已正确输入，直接按回车或输入 N 后回车即可。若需要重新输入，输入 y 后回车。

​
6. 启动使用

配置完成后，在项目目录中执行： 
reasonix
进入 Reasonix 交互界面后，可以发送一条简单测试消息确认模型是否可用。

​
常见问题

​
API 地址应该填什么？

填写 Base URL： 
https://api.nonelinear.com/v1
不要填写： 
https://api.nonelinear.com/v1/chat/completions

​
模型 ID 应该怎么填？

模型 ID 必须与 NoneLinear 模型列表 中展示的 ID 完全一致。示例： 
deepseek-v4-pro
deepseek-v4-flash
gpt-5.5
DeepSeek-V3.2-Think

​
配置后调用失败怎么办？

优先检查以下三项：
  • API Key 是否完整复制，前后不要带空格。
  • API 地址是否为 https://api.nonelinear.com/v1。
  • 模型 ID 是否与 NoneLinear 模型列表完全一致。

​
如何更换模型？

桌面版可以在 设置 → 模型 → 接入 中编辑供应商，重新勾选或填写模型。 终端版可以重新执行： 
reasonix setup
然后按配置向导重新填写模型 ID、API Key 或 Base URL。

​
参考链接