配置模型（API Key）

API Key 是什么、去哪申请、怎么填进 DSH，以及接入 OpenAI / Anthropic 等其他模型的方法和常见报错速查。

约 5 分钟读完

读完这篇你会

  • 搞懂 API Key 是什么、为什么需要它
  • 拿到自己的 DeepSeek API Key 并填进 DSH
  • 学会给 DSH 接入其他模型（OpenAI、Anthropic 等）
  • 排查最常见的几类报错

API Key 是什么

DeepSeek Harness 是"身体"，模型才是"大脑"。API Key 就是连接这两者的通行证——一串以 sk- 开头的字符，相当于你的模型账号凭证：

  • DSH 本身免费开源，但让 AI"思考"需要调用 DeepSeek 的模型服务；
  • 这项服务按用量计费：按输入/输出的字数（token）收费，价格非常低。通常充 10 元人民币，够普通用户玩几周；
  • Key 是认账号不认人的，谁拿到 Key 谁就能花你账户里的余额——就像支付密码，不要发给任何人、不要提交到代码仓库。

第一步：申请 DeepSeek API Key

  1. 打开 platform.deepseek.com，注册并登录（就是普通的手机号/邮箱注册）；
  2. 左侧菜单找到 API Keys（API 密钥）页面，点击创建；
  3. 给 Key 起个名字（如 "dsh-home"），创建后立刻复制保存——页面关闭后就再也看不到完整 Key 了，丢了只能重建一个。

顺手充点钱

DeepSeek API 不是免费额度制，需要账户里有余额才能调用。在平台的充值页面充个 10 元即可起步（支持支付宝/微信）。用不完一直在，不扣年费。

第二步：填进 DeepSeek Harness

  1. 启动 dsh（npx @deepseek-ai/dsh web 或 dsh web），浏览器打开界面；
  2. 打开设置 → 模型；
  3. 在 DeepSeek 卡片的 API 密钥输入框里粘贴 Key，点保存；
  4. 在模型选择器里挑一个模型（日常对话选 deepseek-chat 即可）。

完成。不需要重启，模型配置下一次请求就会生效。

几个让你安心的事实：

  • Key 保存后界面只显示脱敏的尾巴几位，不会回显明文；
  • 它存储在你本机的 ~/.dsh/.credentials.yaml，不会上传到任何第三方；
  • 换 Key、删 Key 随时在同一个界面操作。

常见报错对照表

报错/现象原因解决
MISSING_CREDENTIAL没填 Key 或 Key 为空回到 设置 → 模型 填入并保存
调用报 401 / 余额不足Key 无效，或账户没钱了检查 Key 是否复制完整；去平台充值
UNKNOWN_MODEL当前选中的模型不存在在模型选择器里重新选一个已配置的模型
请求一直转圈网络不通检查本机网络；公司内网可能需要配置代理

想接入其他模型？也行

DSH 是"模型无关"的——不绑定 DeepSeek，只要有对应 API Key 就能换大脑：

  • 接入 Anthropic / OpenAI 等厂商：设置 → 模型 → 添加提供方，选厂商、填 Key 即可，模型列表会自动带出来；
  • 接入自建或中转服务：选添加自定义提供方，填三样东西——接口地址（如 https://your-gateway.com/v1）、协议（一般选 OpenAI 兼容）、API Key，再手动加一个模型 ID。

配好之后，所有提供方会一起出现在顶部的模型选择器里，随时切换。不同会话可以用不同模型，互不影响。

提示：某些第三方 OpenAI 兼容服务的视觉模型，需要在配置里手动声明支持图片输入，详情见官方文档。

Key 的安全习惯

三句话记住：

  1. 不进仓库：别把 Key 写进代码、.env 以外的任何会被提交的文件；
  2. 一人一 Key：不同设备/项目用不同的 Key，泄露了单独作废，不影响其他；
  3. 怀疑泄露立刻删：在平台 API Keys 页面点删除，30 秒止损。

下一步

大脑装好了，接下来给这位"员工"配装备——装第一个插件：

安装第一个插件 →

全部教程