摘要官网Github安装与升级any OS目前只能安装 0.x 版本而我只在macos上通过brew进行安装 1.x 版本故以下内容都是基于 1.x 版本npmi-greasonix# any OS; pulls the prebuilt native binarymacos# 安装brewinstallesengine/reasonix/reasonix# 升级brew upgrade esengine/reasonix/reasonix# 或brew upgrade reasonix# 卸载brew uninstall esengine/reasonix/reasonix使用配置环境变量# deepseek 的 aip_keyexportDEEPSEEK_API_KEYsk-...# 或写入 .env见 .env.example# 新版本也支持 小米的 mimo 模型如果希望启用需要配置 MIMO_API_KEY启动cdyour-project# 交互式会话reasonix# 这里 reasonis reasonis chat# 执行单次任务后退出reasonix runprompt快速命令快捷键描述注释/在开始命令或 skill请参阅内置命令和 skills文件路径提及触发文件路径自动完成exit退出等同于Ctrl D配置文件优先级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 # runAssubagent 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-promimo-v2.5-pro、mimo-flashmimo-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内置命令命令中文说明使用场景/compact压缩当前会话上下文减少上下文长度节省 Token 消耗会话过长、上下文接近限制时/new创建一个全新的会话不继承当前对话上下文开始新的任务或主题/rewind回退到之前的某个对话节点需要撤销后续对话内容时/tree查看当前会话的分支树结构查看历史分支和对话演化过程/branch从当前节点创建一个新的会话分支希望尝试不同方案而不影响主线/switch切换到其他会话分支在多个方案之间切换/todo关闭或隐藏当前任务列表不再需要查看 Todo 时/model切换当前使用的大模型更换 Claude、GPT、Gemini 等模型/mcp管理 MCPModel Context Protocol服务器配置外部工具和服务/skills管理 Skills技能查看、安装或启用技能/hooks管理 Hooks钩子配置命令执行前后自动触发的动作/memory查看 Memory 文件查看 Claude 保存的项目记忆/output-style查看可用输出风格切换回答风格/language切换 CLI 界面语言中英文切换/help显示所有可用命令查询帮助信息Skills内置 skills命令中文说明使用场景/init自动分析项目结构生成或更新AGENTS.md项目记忆文件新接手项目或更新项目信息/explore启动只读子代理对整个代码库进行广泛分析并返回总结结果查找某个功能实现位置、分析代码结构/research启动研究型子代理结合 Web 搜索和代码分析回答问题调研框架特性、最佳实践、兼容性问题/review对当前代码变更进行代码审查提交 PR 前检查代码质量/security-review对当前代码变更进行安全审查检查安全漏洞和风险/test自动运行测试、分析失败原因、尝试修复并重新执行修复测试失败问题reasonix 会自动加载claude code全局配置下安装的 skill(/.claude/skills)MCP管理mcp# 查看已经安装的mcp列表reasonix mcp list# 添加mcpreasonix mcpaddnamecommand[args...]# stdio serverreasonix mcpaddname--httpurl[--headerKV]# remote (Streamable HTTP)reasonix mcpaddname--sseurl# remote (legacy SSE)# 删除mcpreasonix mcp removename示例添加高德mcpmcpaddamap--httphttps://mcp.amap.com/mcp?key${AMAP_KEY}支持环境变量${VAR}- 扩展为环境变量 VAR 的值${VAR:-default}- 如果设置了 VAR则扩展为 VAR否则使用 default内置Tool交互类Tool功能使用时机关键约束ask向用户发起多选问题遇到用户必须决定的分支方案时不要询问有明显默认值的问题bash执行 Shell 命令编译、测试、Git、包管理等查找/编辑文件优先使用专用工具task创建子 Agent 执行任务大型分析、长流程任务子 Agent 不共享上下文wait隐含等待后台任务bash/task 后台运行时配合后台任务使用run_skill执行 Skill复用已有工作流Skill 必须已安装slash_command执行 Slash 命令调用项目预设命令仅执行已注册命令文件读写类Tool功能使用时机关键约束read_file读取文件查看源码、配置文件大文件需分页读取write_file写入整个文件创建或重写文件覆盖原文件edit_file精确替换文本小范围修改文件old_string 必须唯一multi_edit批量编辑同一文件多处修改同一文件所有修改原子提交delete_range删除指定文本范围删除大段内容锚点必须唯一delete_symbol删除 Go 符号删除函数、结构体等仅支持 Go ASTls列目录查看目录结构可递归glob文件匹配查找特定文件支持 ** 递归匹配代码搜索与分析类Tool功能使用时机关键约束grep全局搜索正则查找代码引用基于 ripgrepexplore代码库调查需要跨文件分析子 Agent 执行research代码外部资料研究需要同时查代码和文档子 Agent 执行reviewCode Review提交前检查变更只读security_review安全审查安全相关代码修改只读lsp_definition跳转定义查找符号定义依赖 LSPlsp_references查找引用分析调用链依赖 LSPlsp_hover查看类型与文档理解符号含义依赖 LSPlsp_diagnostics获取诊断信息修改代码后检查错误依赖语言服务器记忆管理类Tool功能使用时机关键约束remember保存长期记忆用户偏好、项目约束不保存临时信息forget删除记忆记忆失效时使用 Memory Slug技能管理类Tool功能使用时机关键约束install_skill创建 Skill希望复用工作流可项目级或全局run_skill运行 Skill执行预定义流程需已安装网络访问类Tool功能使用时机关键约束web_fetch获取网页内容阅读文档、API说明必须是 http/https URLMCP 集成类如果mcp的Connect mode设置为connect when this mcp is used这也是默认值。Tool功能使用时机关键约束mcp__amap__connect连接高德地图 MCP使用地图能力前先建立连接mcp__codegraph__connect连接 CodeGraph MCP使用 CodeGraph 前先建立连接如果mcp的Connect mode设置为Connect in background after session starts或Connect before chat starts时会显示对应mcp的tool比如Tool功能使用时机关键约束mcp__amap__maps_around_search周边 POI 搜索查找某坐标附近的餐厅、酒店、加油站、停车场、景点等必须提供keywords和locationmcp__amap__maps_direction_bicycling骑行路线规划规划骑行通勤、骑游路线必须提供起点和终点经纬度最大支持 500km
reasonix的安装与使用
发布时间：2026/6/13 5:03:05
摘要官网Github安装与升级any OS目前只能安装 0.x 版本而我只在macos上通过brew进行安装 1.x 版本故以下内容都是基于 1.x 版本npmi-greasonix# any OS; pulls the prebuilt native binarymacos# 安装brewinstallesengine/reasonix/reasonix# 升级brew upgrade esengine/reasonix/reasonix# 或brew upgrade reasonix# 卸载brew uninstall esengine/reasonix/reasonix使用配置环境变量# deepseek 的 aip_keyexportDEEPSEEK_API_KEYsk-...# 或写入 .env见 .env.example# 新版本也支持 小米的 mimo 模型如果希望启用需要配置 MIMO_API_KEY启动cdyour-project# 交互式会话reasonix# 这里 reasonis reasonis chat# 执行单次任务后退出reasonix runprompt快速命令快捷键描述注释/在开始命令或 skill请参阅内置命令和 skills文件路径提及触发文件路径自动完成exit退出等同于Ctrl D配置文件优先级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 # runAssubagent 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-promimo-v2.5-pro、mimo-flashmimo-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内置命令命令中文说明使用场景/compact压缩当前会话上下文减少上下文长度节省 Token 消耗会话过长、上下文接近限制时/new创建一个全新的会话不继承当前对话上下文开始新的任务或主题/rewind回退到之前的某个对话节点需要撤销后续对话内容时/tree查看当前会话的分支树结构查看历史分支和对话演化过程/branch从当前节点创建一个新的会话分支希望尝试不同方案而不影响主线/switch切换到其他会话分支在多个方案之间切换/todo关闭或隐藏当前任务列表不再需要查看 Todo 时/model切换当前使用的大模型更换 Claude、GPT、Gemini 等模型/mcp管理 MCPModel Context Protocol服务器配置外部工具和服务/skills管理 Skills技能查看、安装或启用技能/hooks管理 Hooks钩子配置命令执行前后自动触发的动作/memory查看 Memory 文件查看 Claude 保存的项目记忆/output-style查看可用输出风格切换回答风格/language切换 CLI 界面语言中英文切换/help显示所有可用命令查询帮助信息Skills内置 skills命令中文说明使用场景/init自动分析项目结构生成或更新AGENTS.md项目记忆文件新接手项目或更新项目信息/explore启动只读子代理对整个代码库进行广泛分析并返回总结结果查找某个功能实现位置、分析代码结构/research启动研究型子代理结合 Web 搜索和代码分析回答问题调研框架特性、最佳实践、兼容性问题/review对当前代码变更进行代码审查提交 PR 前检查代码质量/security-review对当前代码变更进行安全审查检查安全漏洞和风险/test自动运行测试、分析失败原因、尝试修复并重新执行修复测试失败问题reasonix 会自动加载claude code全局配置下安装的 skill(/.claude/skills)MCP管理mcp# 查看已经安装的mcp列表reasonix mcp list# 添加mcpreasonix mcpaddnamecommand[args...]# stdio serverreasonix mcpaddname--httpurl[--headerKV]# remote (Streamable HTTP)reasonix mcpaddname--sseurl# remote (legacy SSE)# 删除mcpreasonix mcp removename示例添加高德mcpmcpaddamap--httphttps://mcp.amap.com/mcp?key${AMAP_KEY}支持环境变量${VAR}- 扩展为环境变量 VAR 的值${VAR:-default}- 如果设置了 VAR则扩展为 VAR否则使用 default内置Tool交互类Tool功能使用时机关键约束ask向用户发起多选问题遇到用户必须决定的分支方案时不要询问有明显默认值的问题bash执行 Shell 命令编译、测试、Git、包管理等查找/编辑文件优先使用专用工具task创建子 Agent 执行任务大型分析、长流程任务子 Agent 不共享上下文wait隐含等待后台任务bash/task 后台运行时配合后台任务使用run_skill执行 Skill复用已有工作流Skill 必须已安装slash_command执行 Slash 命令调用项目预设命令仅执行已注册命令文件读写类Tool功能使用时机关键约束read_file读取文件查看源码、配置文件大文件需分页读取write_file写入整个文件创建或重写文件覆盖原文件edit_file精确替换文本小范围修改文件old_string 必须唯一multi_edit批量编辑同一文件多处修改同一文件所有修改原子提交delete_range删除指定文本范围删除大段内容锚点必须唯一delete_symbol删除 Go 符号删除函数、结构体等仅支持 Go ASTls列目录查看目录结构可递归glob文件匹配查找特定文件支持 ** 递归匹配代码搜索与分析类Tool功能使用时机关键约束grep全局搜索正则查找代码引用基于 ripgrepexplore代码库调查需要跨文件分析子 Agent 执行research代码外部资料研究需要同时查代码和文档子 Agent 执行reviewCode Review提交前检查变更只读security_review安全审查安全相关代码修改只读lsp_definition跳转定义查找符号定义依赖 LSPlsp_references查找引用分析调用链依赖 LSPlsp_hover查看类型与文档理解符号含义依赖 LSPlsp_diagnostics获取诊断信息修改代码后检查错误依赖语言服务器记忆管理类Tool功能使用时机关键约束remember保存长期记忆用户偏好、项目约束不保存临时信息forget删除记忆记忆失效时使用 Memory Slug技能管理类Tool功能使用时机关键约束install_skill创建 Skill希望复用工作流可项目级或全局run_skill运行 Skill执行预定义流程需已安装网络访问类Tool功能使用时机关键约束web_fetch获取网页内容阅读文档、API说明必须是 http/https URLMCP 集成类如果mcp的Connect mode设置为connect when this mcp is used这也是默认值。Tool功能使用时机关键约束mcp__amap__connect连接高德地图 MCP使用地图能力前先建立连接mcp__codegraph__connect连接 CodeGraph MCP使用 CodeGraph 前先建立连接如果mcp的Connect mode设置为Connect in background after session starts或Connect before chat starts时会显示对应mcp的tool比如Tool功能使用时机关键约束mcp__amap__maps_around_search周边 POI 搜索查找某坐标附近的餐厅、酒店、加油站、停车场、景点等必须提供keywords和locationmcp__amap__maps_direction_bicycling骑行路线规划规划骑行通勤、骑游路线必须提供起点和终点经纬度最大支持 500km
的演进与通信机制)
