DeepSeek Harness 安装教程:5分钟把＂国产版 Claude Code＂装进自己电脑

大家好，我是孙斌，如果你一直想试 Claude Code 那种"AI 直接在我电脑上干活"的体验，但又被价格和门槛劝退，DeepSeek Harness 是个很值得装来玩的开源替代品——免费模型可用、本地跑、一切皆插件能 DIY。

一行命令就能跑起来：


npx @deepseek-ai/dsh web

2026 年 8 月 13 日，DeepSeek 把自家的 Agent 运行框架 Harness 开源了。 官方给的公式很直白：

Model + Harness = Agent

模型负责思考，Harness 负责"让模型真正干活的工程活"——工具调用、任务规划、上下文管理。它对标的就是 Claude Code、Codex 这类代码智能体，而且因为是开源的（MIT 协议），你可以用 DeepSeek 自己的模型，也可以接别的。

一句话总结它的设计理念：一切皆插件。模型、工具、沙箱策略、多 Agent 协调、会话存储，全都是可插拔的积木，由一套叫 Cordis 的微内核串起来。开源不到 24 小时，GitHub Star 就破了 5 万——热度可见一斑。

命令行里它叫 dsh（DeepSeek Harness 的缩写）。下面我一步步带你把它跑起来。

1、安装前：确认 Node.js 版本

dsh 是用 TypeScript 写的，跑在 Node.js 上。先确认你机器上的版本够新：


node --version

官方要求 Node.js v22.19.0 或更高（或者 Node.js 24+）。

如果你还没有安装Node.js，先去 nodejs.org 下载一个装上（傻瓜式下一步下一步就行）。

装完重开终端再验证一次。

2、npx一键安装

安装好Node.js之后，直接npx 一键启动（最省事，推荐先试）

不需要克隆代码、不需要全局安装，一行命令：


npx @deepseek-ai/dsh web

第一次运行会临时下载相关包，等它跑完。

输入y，表示yes，同意

终端会输出一个本地地址，默认是：


http://127.0.0.1:3080

浏览器打开这个地址，就是它的 Web 界面了。

小提示：如果 3080 端口被占用了，换一个就行：
npx @deepseek-ai/dsh web --port 8080

除了上面这种一键安装，还有另外两种安装方式。

方式一：全局安装（日常用，固定版本）

如果你打算经常用，全局装更顺手：


npm install -g @deepseek-ai/dshdsh web

以后直接敲 dsh 就能启动。

方式二：从源码构建（想读源码 / 二次开发）

想看它内部怎么实现的，或者想自己写插件，就走这条路：


git clone https://github.com/deepseek-ai/deepseek-harness.gitcd deepseek-harnesspnpm installpnpm run buildpnpm dsh web

源码方式依赖 pnpm（用 npm install -g pnpm 先装上）。

3、配置环境变量：API Key

框架跑起来只是第一步，要让它"会思考"，还得接一个模型。

打开 Web 界面后，进入 设置 → 模型，找到 DeepSeek 卡片，可以看到需要通过配置环境变量的方式传入API Key。

去 DeepSeek 开放平台注册账号、创建API Key。

配置环境变量，我的电脑（此电脑），右击鼠标，属性-高级系统设置，点击【环境变量】。

新建一个环境变量，DEEPSEEK_API_KEY，如下图所示。

创建好之后，DeepSeek Harness会自动读取本机环境变量中的API Key。

这种配置API Key的方式能够确保密钥不会以明文留在配置文件里，而是通过环境变量读取，相对安全。

填完 Key、选好模型（比如 deepseek-v4-pro），就能开始跑任务了。

进阶玩法：Harness 是"不锁死模型来源"的设计，除了 DeepSeek，官方还内置了 Anthropic、OpenAI 两个 provider。你甚至可以在 $DSH_HOME/settings.yaml 里写一个 OpenAI 兼容端点，接自己本地部署的模型。

4、初步体验：先选工作区，再派活

启动后第一步，选一个工作区目录——把 dsh 启动时所在的文件夹添加进来并选中。注意：选中工作区之前，输入框是禁用的。这是它的安全设计：让 Agent 明确知道自己能碰哪些文件，不会满世界乱改。

选好后，框架提供几种预设运行模式：

5、几个避坑提醒

有人按装好了吗？第一次跑起来感觉怎么样？欢迎在评论区聊聊你的体验，或者告诉我你最想用它帮你干啥活儿，下篇我带你写一个实用插件。

本文基于 DeepSeek Harness 开发者预览版（v0.1）实测整理，命令以官方最新文档为准。