reasonix的安装与使用

摘要

• 官网
• Github

安装与升级

• any OS，目前只能安装 0.x 版本，而我只在macos上通过brew进行安装 1.x 版本，故以下内容都是基于 1.x 版本

npmi-greasonix# any OS; pulls the prebuilt native binary

• macos

# 安装brewinstallesengine/reasonix/reasonix# 升级brew upgrade esengine/reasonix/reasonix# 或brew upgrade reasonix# 卸载brew uninstall esengine/reasonix/reasonix

使用

• 配置环境变量

# deepseek 的 aip_keyexportDEEPSEEK_API_KEY=sk-...# 或写入 .env（见 .env.example）# 新版本也支持 小米的 mimo 模型，如果希望启用，需要配置 MIMO_API_KEY

• 启动

cdyour-project# 交互式会话reasonix# 这里 reasonis == reasonis chat# 执行单次任务后退出reasonix run<prompt>

• 快速命令

配置文件

• 优先级：flag>./reasonix.toml>~/.config/reasonix/config.toml>内置默认值。

• 在这里的 flag 指的是 命令行参数，比如reasonix --model mimo-pro，也就是说，当你启动 Reasonix 时，如果通过命令行传入了配置相关的参数，这些参数 优先级最高，会覆盖配置文件里的同名设置。

• ⚠️ 重点：这里的 “flag” 并不是环境变量，也不是配置文件，而是 运行时命令行指定的参数。

• 内置默认值：是指写死在代码中的配置

• ⚠️ 重点：macos 下的配置文件在~/Library/Application Support/reasonix/config.toml而不是~/.config/reasonix/config.toml

• 可以通过如下命令创建配置文件

# 创建 `~/.config/reasonix/config.toml`，注意 macos 的不同reasonix setup# 指定配置文件路径reasonix setup ./reasonix.toml

▌ Language · 语言 (↑/↓ · Enter · q to cancel) English ❯ 中文 (简体) ╭─────────────────────────────────╮ │ ◆ 欢迎使用 reasonix │ │ │ │ 还没有配置 — 现在来设置一下吧。 │ ╰─────────────────────────────────╯ ▌ 选择要启用的 provider (↑/↓ · Space · Enter · q) ❯ [x] DeepSeek fast & cheap, plus a stronger Pro SKU [ ] MiMo (Xiaomi) long-horizon agentic [ ] 自定义模型 添加第三方 OpenAI 兼容模型 [ ] 自定义模型2 添加第三方 Anthropic 兼容模型 发现 2 个 DeepSeek 模型 ▌ 选择要启用的 DeepSeek 模型 (↑/↓ · Space · Enter · q) [x] deepseek-v4-flash ❯ [x] deepseek-v4-pro 输入 API key（回车跳过、稍后再设）： ✓ 复用已设置的 DEEPSEEK_API_KEY ✓ 已写入 ./reasonix.toml ✓ 已写入 ~/Library/Application Support/reasonix/credentials ◆ 设置完成。 试试: reasonix chat

• 配置文件示例说明

default_model = "deepseek-flash" # 执行器；设 [agent].planner_model 可加规划器 # language = "zh" # 界面语言；为空则按 $LANG / $REASONIX_LANG 自动检测 [agent] # planner_model = "mimo-pro" # 可选的低频规划器 # subagent_model = "deepseek-pro" # runAs=subagent skill 的默认模型 # subagent_models = { review = "deepseek-pro", security_review = "deepseek-pro" } auto_plan = "ask" # off|ask|on；复杂聊天任务自动进入计划模式 # auto_plan_classifier = "deepseek-flash" # 可选；只在边界任务上调用 [[providers]] name = "deepseek-flash" kind = "openai" # 接口类型，支持 openai 和 anthropic base_url = "https://api.deepseek.com" # anthropic 时要配置为 https://api.deepseek.com/anthropic model = "deepseek-v4-flash" api_key_env = "DEEPSEEK_API_KEY" # 还有预设：deepseek-pro、mimo-pro（mimo-v2.5-pro）、mimo-flash（mimo-v2-flash） @ api.xiaomimimo.com/v1 [tools] enabled = [] # 省略/为空 = 全部内置工具 [skills] # paths = ["~/my-skills", "../shared/skills"] # 额外的自定义技能目录 # disabled_skills = ["review"] # 隐藏技能，直到 /skill enable <name> [permissions] mode = "ask" # 无规则命中时 writer 的兜底：ask|allow|deny deny = ["bash(rm -rf*)", "bash(git push*)"] # 任何模式下都硬阻断 allow = ["bash(go test*)"] # 从不询问 [sandbox] # workspace_root = "" # 文件写工具被限制在此目录；留空 = 当前目录 # allow_write = ["/tmp"] # write_file/edit_file/multi_edit 额外可写的目录 [[plugins]] name = "example" command = "reasonix-plugin-example"

这里可以配置多个[[providers]]，也可以配置为第三方模型

Commands

• 内置命令

Skills

• 内置 skills

• reasonix 会自动加载claude code全局配置下安装的 skill(/.claude/skills)

MCP

• 管理mcp

# 查看已经安装的mcp列表reasonix mcp list# 添加mcpreasonix mcpadd<name><command>[args...]# stdio serverreasonix mcpadd<name>--http<url>[--headerK=V]# remote (Streamable HTTP)reasonix mcpadd<name>--sse<url># remote (legacy SSE)# 删除mcpreasonix mcp remove<name>

• 示例：添加高德mcp

mcpaddamap--httphttps://mcp.amap.com/mcp?key=${AMAP_KEY}

支持环境变量

${VAR}- 扩展为环境变量 VAR 的值${VAR:-default}- 如果设置了 VAR，则扩展为 VAR，否则使用 default

内置Tool

• 交互类

• 文件读写类

• 代码搜索与分析类

• 记忆管理类

• 技能管理类

• 网络访问类

• MCP 集成类

如果mcp的Connect mode设置为connect when this mcp is used，这也是默认值。

如果mcp的Connect mode设置为Connect in background after session starts或Connect before chat starts时，会显示对应mcp的tool，比如：