Reasonix 配置教程

Reasonix 是终端 AI 编码助手（Agent），支持 OpenAI 兼容端点，配置由 TOML 文件驱动。本页介绍如何接入云枢科技AI 的模型（当前为 deepseek-v4-flash），推荐使用一键配置，2 分钟即可完成。

⚠️ 数据迁移提醒：如果你之前在使用其他平台或其他中转站，切换前请先让原平台的 AI 把项目文件完整打包、整理清楚，确保新的 AI 拿到项目后能直接读懂、马上上手，再开始配置。

一、创建 API Key

登录云枢科技AI 后台，点击「API 密钥」→「创建 API 密钥」；
填写名称、分组、过期时间，并勾选 deepseek-v4-flash 模型权限；
点击「保存更改」，复制以 sk- 开头的 API Key。

API Key 只在创建时显示一次，请立即保存。配置脚本只把 Key 写入本机，不会上传到任何服务器。

二、安装 Reasonix

前往 Reasonix 官网下载桌面版并安装：

Reasonix 官网下载

安装完成后打开应用，首次启动会弹出配置 Key 的引导界面，点击【稍后设置】即可进入主界面（如下）：

Reasonix 桌面版界面

提示：安装完成后，如果输入 reasonix 提示「无法识别」，说明没有安装成功或未加入 PATH，请确认安装成功，并新开一个终端再试。

三、一键配置（推荐）

重要：运行一键脚本前，请先完全退出 Reasonix。Windows 版脚本检测到 Reasonix 正在运行时会直接中止，提示你先关闭。

（一）Windows PowerShell

powershell

curl.exe -s https://www.yunshukjai.com/codex-reasonix-setup.ps1 -o "$env:TEMP\codex-reasonix-setup.ps1"
powershell -ExecutionPolicy Bypass -File "$env:TEMP\codex-reasonix-setup.ps1"

（二）macOS / Linux

bash

bash <(curl -fsSL https://www.yunshukjai.com/codex-reasonix-setup.sh)

脚本会提示输入 API Key（如果系统已设置过 YUNSHUKJAI_API_KEY 环境变量，则直接使用），并先验证 Key 是否有效，验证失败会提示重新输入（最多 3 次）。验证通过后自动写入以下配置（已有配置自动备份）：

内容	Windows	macOS / Linux
API Key（.env）	`%APPDATA%\reasonix\.env`	`~/.reasonix/.env`
模型配置（config.toml）	`%APPDATA%\reasonix\config.toml`	`~/.reasonix/config.toml`

看到 Done. 即配置成功。

注意：请使用「下载运行」方式，不要用 irm | iex；API Key 必须放在 .env 文件里，不要写进 config.toml。

四、可用模型

点击 Reasonix 底部状态栏中的模型选择器（当前选择 deepseek-v4-flash 模型），即可看到全部可用模型，按需切换：

deepseek-v4-flash、deepseek-v4-pro
glm-5.2
kimi-k3
MiniMax-M3
qwen3.7-flash、qwen3.7-max、qwen3.7-plus、qwen3.8-max

Reasonix 可用模型

五、常见问题

现象	解决办法
提示 `reasonix` 无法识别 / CommandNotFoundException	Reasonix 未安装成功或未加入 PATH → 重新安装（或前往官网下载），并新开一个终端再试
提示认证失败 / 401	API Key 复制错或已删除 → 后台重新创建，重跑一键脚本
提示无模型权限 / 403	令牌未勾选 `deepseek-v4-flash` → 后台勾选或新建令牌
提示模型不存在 / 404	模型 ID 被手动改过 → 保持 `deepseek-v4-flash` 不要改动
脚本提示 Reasonix 正在运行	完全退出 Reasonix（含托盘/任务管理器进程）后重跑
配置不生效	完全退出 Reasonix 后重新打开；环境变量配置需新开终端
提示 `bash not found on PATH`	Windows 上 Reasonix 的 shell 工具默认使用 bash，安装 Git for Windows 即可消除此警告（不影响正常使用）
提示「正在重新连接 /5」或 `stream closed before response.completed`	流式输出中途被中断 → 稍后重试；换一个模型（如 deepseek-v4-flash）测试是否为渠道问题；确认网络稳定；持续出现联系客服并提供中转站日志

六、安全提醒

API Key 属于机密信息，请妥善保管；泄露后请到后台删除重建，并重跑一键脚本；
不要把 Key 写进项目里的 reasonix.toml 或 config.toml，只放在全局 .env 中。

Reasonix 配置教程 ​

一、创建 API Key ​

二、安装 Reasonix ​

三、一键配置（推荐） ​

（一）Windows PowerShell ​

（二）macOS / Linux ​

四、可用模型 ​

五、常见问题 ​

六、安全提醒 ​

相关文档 ​