reasonix setup
一分钟 上手
安装 → 配置 → 第一个任务,三步走完。所有命令都可直接复制。
1
安装 npm i -g reasonix
需要 Node.js 环境。安装后验证版本。
$ npm i -g reasonix
$ reasonix version
reasonix v1.19.5
2
配置 reasonix setup
交互式向导会生成 reasonix.toml 与 .env 模板。选择你的 provider,把 API 密钥放进环境变量(脚本里 api_key_env 指向它,密钥不落盘)。
$ reasonix setup
✓ 已生成 reasonix.toml
✓ 已生成 .env 模板
# 然后把密钥写进 .env 或 shell 环境
$ export DEEPSEEK_API_KEY=sk-...
想改哪些项?
reasonix config 子命令可单独调整:reasonix config telemetry off 关闭遥测,reasonix config reasoning-language zh 固定思考语言。3
跑第一个任务 reasonix run
在任意项目目录里跑一个真实任务。也可以直接进交互式会话。
$ reasonix run "给 README.md 补一段快速开始"
$ reasonix # 或者直接进入交互式会话
4
审查你的改动 reasonix review
改完代码,让 agent 基于本地 diff 做一轮审查。
$ reasonix review
$ reasonix review --base main
5
进阶:服务、子智能体、bot serve / subagent / bot
把能力暴露成服务、定义专精子智能体、或接入 IM 渠道,都是同一条命令的事。
$ reasonix serve --addr 0.0.0.0:8080 --auth token --token <token>
$ reasonix subagent create security-review # 建一个安全审查专精 agent
$ reasonix bot start # 启动 IM bot 网关
tip
记住这三条就够了
优先级配置:flag >
./reasonix.toml > 全局 config.toml > 内置默认。
权限agent 只做
permissions.allow 白名单里的事——不信任?就收紧它,再 --permission-mode 兜底。
恢复会话断了用
reasonix --continue;出了怪问题先 reasonix doctor --json。