DeepSeek-Reasonix连接VS Code：ACP编辑器集成的完整上手教程-开发者社区

DeepSeek-Reasonix连接VS Code：ACP编辑器集成的完整上手教程

【免费下载链接】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 编码智能体，围绕前缀缓存稳定性设计，专为终端而生。本文带你用最少的步骤完成 ACP 编辑器集成，把它接入 VS Code，让 AI 直接在你的编辑器里读文件、改代码、跑命令，全程可控、可撤销。

什么是 ACP？为什么它适合 VS Code 集成

ACP（Agent Client Protocol，智能体客户端协议）是编辑器与 AI 智能体之间的标准通信协议。简单理解：

Reasonix 侧：执行reasonix acp后，它以"标准输入/输出 + NDJSON JSON-RPC 2.0"的方式运行，成为一个标准 ACP agent；
编辑器侧：VS Code 扩展负责启动这个进程、打开工作区会话，并把流式消息、工具活动、计划、权限请求回显在界面上。

也就是说，你不需要理解协议细节——协议层由扩展和 Reasonix 自动完成握手（initialize能力协商），你只管用。协议实现的核心代码在internal/acp/server.go、internal/acp/dispatch.go与internal/acp/protocol.go，完整的接入说明见 docs/ACP.zh-CN.md（本地文档，供进阶阅读）。

三步完成环境配置

✅第 1 步：安装 Reasonix 本体

Reasonix 是一个零依赖的静态 Go 二进制，一条命令装好：

npm i -g reasonix

✅第 2 步：初始化 Provider

首次使用需要配置模型提供商（例如 DeepSeek 的 API Key）：

reasonix setup

配置会写入reasonix.toml，官方提供了一个可参考的示例配置reasonix.example.toml，涵盖 provider、agent、工具与插件的声明式配置。

✅第 3 步：在 VS Code 中安装扩展

在 VS Code 扩展市场搜索扩展 IDSivanLiu.reasonix-agent并安装（VSCodium / Theia 用户可在 Open VSX 找到同名扩展）。该扩展不内置 CLI，而是直接启动你本机的reasonix acp后端——这也意味着它和终端、桌面端共享同一套本地引擎，行为完全一致。

安装后，在 VS Code 中打开任意项目，打开 Reasonix 聊天面板即可开始对话。

ACP 连接如何工作？

连接建立后，每个 ACP 会话都拥有独立的控制器、工作区根目录、模型、协作模式、审批模式和持久化历史，会话之间互不泄漏状态。你会在日常使用中体验到这些设计：

能力	说明
流式回显	思考过程、消息、工具调用状态实时流式展示
未保存 buffer 感知	编辑器当前未保存的改动也会被 Agent 正确读写，而不是操作磁盘上的旧副本
编辑器终端执行	前台命令可落在你编辑器持有的终端中执行
计划可见	任务执行前生成完整计划，供你确认后开始
会话持久化	`session/load`可回放历史，`session/resume`可静默恢复

工具审批与权限控制：放心让它动手

权限是长时自治运行的底线。工具审批有ask、auto、yolo三档，通过配置项tool_approval切换，无需重启会话：

ask（默认）：受控工具调用会弹出审批条，如上图所示，可"允许一次 / 本会话允许 / 拒绝"，命令内容一目了然；
auto：常规操作自动放行，高风险操作仍询问；
yolo：全自动，适合熟悉的沙箱环境。

配合协作模式（normal/plan/goal），在计划模式下 Agent 会先给出修改方案：

你可以选择"修改计划"、"开始执行"或"退出计划"，审批流程透明、随时可打断。

会话中还能做什么？

切换模型与推理强度

模型（provider/model）与推理强度（effort）同样是独立的配置轴，在会话中通过配置选项即可切换。切换时 Reasonix 会重建会话控制器但保留完整历史——这是前缀缓存友好的关键设计：稳定前缀不被破坏，长会话也不会"失忆"。

回合中引导（Steer）

Reasonix 提供了一个厂商扩展方法_reasonix.io/session/steer，允许你在 Agent 正在执行回合时插入一条新指令（比如"把用户名改成邮箱"），而不是干等当前回合结束。实现位于internal/acp/inbox.go。若当前回合无法立即接受，消息会持久化为后续跟进项，不会丢失。