DeepSeek-Reasonix配置向导实战：reasonix setup三步完成DeepSeek接入-编程实验室

DeepSeek-Reasonix配置向导实战：reasonix setup三步完成DeepSeek接入

【免费下载链接】DeepSeek-ReasonixDeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.项目地址: https://gitcode.com/GitHub_Trending/de/DeepSeek-Reasonix

DeepSeek-Reasonix 是一款为 DeepSeek 原生打造的终端 AI 编码智能体（coding agent），围绕前缀缓存稳定性设计，适合长时间挂运行的自主编码任务。本文带你实战它的配置向导：从安装 CLI，到用reasonix setup三步完成 DeepSeek 接入，再到跑通第一个编码任务，全程无需手写复杂配置。

为什么选择 DeepSeek-Reasonix？

与普通 AI 聊天工具不同，DeepSeek-Reasonix 是真正"能干活"的编码智能体：它可以直接读写你的项目文件、执行命令、管理 Git 变更，并内置 Plan 模式、权限分级、工作区沙盒和逐轮检查点，让长时间自主运行也变得可审查、可回滚。

它的几个核心设计对新手很友好：

配置驱动：Provider、模型、工具、插件全部声明在reasonix.toml里，无硬编码模型；
DeepSeek 开箱即用：DeepSeek 作为预设内置，任何 OpenAI 兼容端点都是一条配置项，而非新代码；
缓存感知：上下文压缩与工具输出剪枝都围绕前缀缓存稳定性优化，长会话也能保持低成本。

配置完成后，你可以在终端 TUI、桌面应用、浏览器或编辑器（ACP）中任选一种方式使用同一个本地引擎，DeepSeek 模型在界面中会被直接列出。

30秒安装 Reasonix CLI

配置向导的前提是先装好 CLI。两种方式任选其一：

npm i -g reasonix # 任意操作系统，自动拉取预编译原生二进制 brew install esengine/reasonix/reasonix # macOS 用户

安装完成是一个完全自包含的静态二进制（CGO_ENABLED=0），目标机器上无需额外依赖。验证一下：

reasonix --version

如果你更喜欢图形界面，也可以从官方渠道下载桌面应用，桌面端与 CLI 共用同一套本地引擎和配置。

核心实战：reasonix setup 三步接入 DeepSeek

在任意终端中运行：

reasonix setup

reasonix setup是一个暂存式供应商管理器：所有修改先暂存，最后统一预览并确认，误操作不会直接写坏配置。整个接入 DeepSeek 的过程就是三步。

第一步：添加 DeepSeek Provider

进入向导后，选择"添加 provider"，选 OpenAI 兼容类型。DeepSeek 官方 API 就是标准 OpenAI 兼容端点，直接填写：

Endpoint：https://api.deepseek.com
模型列表：如deepseek-v4-flash、deepseek-v4-pro
API Key 变量名：如DEEPSEEK_API_KEY

💡 安全设计：配置文件里只保存api_key_env变量名，Key 的真实值始终存放在 CLI 与桌面端共用的全局.env中，不会写进reasonix.toml，避免误提交泄露。

参考 reasonix.example.toml 可以看到一个完整的 DeepSeek provider 声明，包含base_url、models、default、context_window等字段，以及费用展示币种等可选项。

第二步：填写 API Key 并测试连接

向导会引导你粘贴 DeepSeek 平台获取的 API Key，并支持一键测试连接并刷新模型列表。连接成功后，可用模型会自动拉取，无需手工核对模型名拼写。

第三步：设置默认模型并保存退出

从模型列表中选一个默认模型（例如deepseek-v4-flash适合日常编码，deepseek-v4-pro适合复杂推理），然后选择"保存并退出"。

此时向导会先展示待执行的全部操作供你确认；取消则丢弃本次所有修改。保存时 setup 会重新加载最新配置——如果桌面端或其他 CLI 实例改过别的项，那些修改会被保留；只有真正冲突的同一项才会提示，不会静默覆盖。

另外两个实用细节：

通过 setup 添加或删除 provider 时，会同步维护桌面端的 provider access，同一模型可直接在桌面端使用，无需二次配置；
需要项目级独立配置时，用reasonix setup --local管理./reasonix.toml，优先级高于用户全局配置。

验证接入：跑通第一个编码任务

配置完成后，三种最常用姿势：

reasonix # 进入交互式 TUI 会话 reasonix run "实现 main.go 里的 TODO" # 一次性执行任务 reasonix -p "总结这个仓库" # 只要最终答案，适合脚本

在交互式会话中，敲/init可以让 Reasonix 为当前项目生成规范说明文件。之后你就可以放心把它"挂"在后台跑长任务——上下文压缩、检查点回滚都由引擎自动管理。

常见问题与进阶提示

Q：如何确认配置写到了哪里？按flag > ./reasonix.toml > 用户全局 config.toml > 内置默认值的顺序解析，详细说明见 docs/CONFIG_PATHS.zh-CN.md。

Q：想让两个 DeepSeek 模型协同（执行器 + 规划器）？向导完成基础接入后，在项目reasonix.toml加一行即可：

[agent] planner_model = "deepseek-pro" # 作为低频规划器

Planner 会先做只读调研再产出计划，交给执行器落地，两个模型各自保持独立的缓存稳定会话。

Q：费用展示想切换币种？

reasonix config currency CNY # 或 USD / auto

Q：想调整自动压缩时机？

reasonix config compact-ratio # 查看当前生效值及来源 reasonix config compact-ratio 75 # 设置全局默认值（范围 30–85%）

更多命令细节（会话恢复、权限参数、--model切换等）可查阅 docs/CLI.zh-CN.md 和 docs/GUIDE.zh-CN.md，进阶的插件与 MCP 配置在 docs/EXTENSIONS.zh-CN.md 中有完整说明。

小结

步骤	命令	作用
1	`npm i -g reasonix`	安装 CLI
2	`reasonix setup`	三步向导：加 Provider → 测连接 → 设默认模型
3	`reasonix`/`reasonix run`	开跑编码任务