DeepSeek Reasonix 实战：零成本搭建 AI 编程 Agent（30 分钟教程）

教程目标

在 30 分钟内，完成 DeepSeek Reasonix 的安装、配置与实战。你将学会用这个开源 AI 编程 Agent 自动修 bug、写功能、跑测试——而且因为 DeepSeek 的 prefix-cache 机制，长会话输入 token 成本降到原来的 1/5。

你将搭建什么

• AI 编程 Agent 环境：终端原生 TUI，随时随地 npx reasonix code 启动
• 缓存优先的长会话：94% cache hit，append-only 循环保持成本极低
• Skills 自动化脚本：用 Markdown 编写可复用的 Agent 剧本

准备清单

• DeepSeek API Key（platform.deepseek.com 注册获取，按量计费）
• Node.js ≥ 22（macOS / Linux / Windows 均可）
• 一个已有的代码项目（或新建一个 demo 项目练手）

总体架构

Reasonix 的循环是 append-only：消息和工具结果一律尾部追加，绝不修改历史。这让 DeepSeek 的 prefix-cache 在每次工具调用后都保持命中。

第 1 步：安装 Reasonix 并配置 API Key

Reasonix 不需要全局安装。Node.js ≥ 22 环境下，一行命令即可启动：

# 进入你的项目目录
cd /path/to/your-project

# 直接启动（首次运行会自动引导配置 API Key）
npx reasonix code

首次运行会弹出内置向导，粘贴你的 DeepSeek API Key 即可。这个 Key 会保存在 ~/.reasonix/config.json 中，后续无需重复配置。

提示：DeepSeek API 的计费极低——输入 $0.07/Mtok，命中缓存仅 $0.014/Mtok。Reasonix 的 append-only 循环设计让长会话缓存命中率保持在 90% 以上，实际成本远低于同类工具。

配置完成后，你可以用以下命令检查状态：

# 查看配置
cat ~/.reasonix/config.json

# 查看帮助
npx reasonix --help

Reasonix 也提供桌面端（Tauri 原生客户端），自带 Node runtime、多 tab 会话和实时 cost/cache/token 表盘，适合不想碰命令行的用户。但本教程聚焦终端版——它更轻量、更适合 CI/CD 集成。

第 2 步：首次 AI 编程会话

启动 Reasonix 后，你会进入一个终端 TUI 界面。它不是一个 IDE 插件——diff 留给 git diff，文件树留给 ls，终端本身就是工作面板。

基础交互

进入会话后，直接用自然语言描述你的需求。Reasonix 默认使用 DeepSeek V4-Flash（快速且低成本），复杂任务可以用 /pro 切到 V4-Pro：

# 日常迭代用 Flash（默认）
> 帮我把这个 Python 脚本里的硬编码路径改成配置文件读取

# 复杂重构切 Pro
/pro
> 重构这个模块，把单体函数拆成职责单一的三个类，保持测试通过

Reasonix 会自动读取项目文件、执行 shell 命令、修改代码。所有操作沙箱化到启动目录，不会越权访问。

双档位策略

实战示例：让 Reasonix 修一个 bug

假设你的项目有一个 utils.py 文件，其中 parse_config 函数在文件不存在时直接崩溃：

Reasonix 会：

1. 读取 utils.py，定位 parse_config 函数
2. 分析错误原因
3. 生成修复代码（添加 try/except 或 os.path.exists 检查）
4. 询问你是否确认修改

确认后，Reasonix 应用修改，你可以用 git diff 查看变更。

第 3 步：用 Skills 编排可复用自动化

Skills 是 Reasonix 最强大的功能之一——用 Markdown 编写 Agent 行为剧本，放在 .reasonix/skills/ 目录下即可。

创建一个 Code Review Skill

在项目根目录创建 .reasonix/skills/code-review.md：

---
name: code-review
description: 代码审查：检查安全性、性能和可维护性
runAs: subagent
allowed-tools: [read, grep, glob]
---

## 任务

对当前项目的变更文件进行代码审查。

## 检查维度

1. **安全性**：是否有 SQL 注入、XSS、路径遍历风险
2. **性能**：是否有 N+1 查询、不必要的循环、大对象拷贝
3. **可维护性**：函数是否过长（>30 行）、命名是否清晰

## 输出格式

生成一份 markdown 报告，按严重程度排序。

然后在 Reasonix 会话中直接调用：

Reasonix 会以 subagent 模式运行这个 Skill，只使用 read、grep、glob 三个只读工具——不会修改任何代码，确保审查的独立性。

更多 Skill 示例

你可以创建各种 Skill：

• 生成 CHANGELOG：读取 git log，自动生成版本更新日志
• 运行测试 + 修复：先跑测试，对失败的用例自动修代码
• API 文档生成：扫描路由文件，生成 OpenAPI 文档

Skills 是纯文本 Markdown，可以提交到 git 仓库，团队成员共享同一套 Agent 剧本。

第 4 步：接入 MCP 扩展工具链

Reasonix 对 MCP（Model Context Protocol）提供一等公民支持，支持 stdio、SSE、Streamable HTTP 三种传输协议。

挂载一个 MCP Server

# 挂载 GitHub MCP Server
npx reasonix code --mcp "github=npx @anthropic/mcp-server-github"

# 挂载文件系统 MCP Server
npx reasonix code --mcp "fs=npx @anthropic/mcp-server-filesystem /path/to/allowed/dir"

也可以在 ~/.reasonix/config.json 中持久化配置：

{
  "mcp": {
    "github": {
      "command": "npx",
      "args": ["@anthropic/mcp-server-github"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["@anthropic/mcp-server-filesystem", "/home/user/projects"]
    }
  }
}

每个 MCP server 的工具会以前缀合并进 Reasonix 统一的工具 registry，对模型完全透明。挂载 GitHub MCP 后，你可以直接说"帮我创建一个 PR"——Reasonix 会自动调用 GitHub 工具完成操作。

常见问题排查（FAQ）

Q1：npx reasonix code 报错 "Node version too old"？

升级 Node.js 到 ≥ 22。用 node -v 检查版本，推荐用 nvm 管理：

nvm install 22
nvm use 22

Q2：API Key 配置后仍然提示认证失败？

检查 ~/.reasonix/config.json 中 apiKey 字段是否正确。也可以设置环境变量：

export DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxx"

Q3：长会话 token 成本真的能降到 1/5？

是的。Reasonix 的 append-only 循环设计专门适配 DeepSeek 的 prefix-cache 机制：消息历史不重排、不基于 marker 压缩，缓存前缀在每次工具调用后保持稳定。实测长会话（50+ 轮）缓存命中率 90%+，输入 token 成本降为原来的 1/5～1/4。

Q4：Reasonix 和 Claude Code 有什么区别？

Claude Code 是 Anthropic 生态的编程 Agent，依赖 Claude API。Reasonix 是 DeepSeek 原生设计，核心优势在于极低成本（DeepSeek 的缓存定价 + Reasonix 的 Cache-First 循环）和终端优先的轻量设计。两者可以互补使用——简单任务用 Reasonix（省钱），复杂架构讨论用 Claude Code（推理更强）。

工具词条（触发工具悬浮卡）

正文中自然出现的工具名，平台侧会匹配已维护 tools 库生成 hover-card： DeepSeek、Reasonix、Claude Code、Node.js

参考视频/素材

• Reasonix 官方文档
• GitHub: esengine/DeepSeek-Reasonix
• DeepSeek API 开放平台

内链引导

• 有人实践成功：他用 Claude Code + AWS 搭建 AI SaaS，3个月月入 $12,000
• 有人实践成功：Claude Code 48小时创业：一人+29美元月费，3个月做到月入$9,000