DeepSeek Harness 是 DeepSeek 推出的编程 Agent。这里通过 Harness 的自定义供应商功能，使用 OpenAI 兼容协议连接 custom。
首次打开 Harness 时，在 DeepSeek API Key 弹窗点击 Configure later，先跳过官方供应商配置。
进入主界面后，点击窗口左下角的设置齿轮。
在 Settings 左侧点击 Models。
点击模型设置页下方的 + Add a custom provider。
Provider ID 填写 custom；Base URL、API protocol 和 API Key 按下方复制区填写，再点击 Fetch available models。
在模型弹窗中勾选页面复制区显示的模型，然后点击 Add selected。
确认模型已经加入列表，再点击 Create provider。
确认 custom 右侧出现绿色状态点，然后点击右上角的 × 关闭设置。
点击输入框底部的当前模型，在 custom 分组中选择页面复制区显示的模型。
点击 Choose workspace 选择要处理的文件夹，在输入框填写一个简单任务，再点击右下角发送按钮。
确认 Harness 正常显示模型回复，且输入框底部仍显示刚选择的 custom 模型。
Provider ID: custom
Display name: custom
Base URL:
API protocol: openai-completions
API Key: sk-your-api-key
Models: gpt-5.6-sol填写 Base URL、协议和 API Key 后，点击 Fetch available models；在弹窗中选择上方模型，再点击 Add selected。
按照 11 张 DeepSeek Harness Preview macOS 真实界面截图，跳过首次官方密钥设置，添加 custom 自定义供应商，选择模型和工作区，再发送任务验证。
截图中的供应商名称是示例，仅用于定位操作入口。实际供应商名称或 ID 统一填写 custom；地址、密钥和模型请使用本页复制区的值。
点击“Configure later”，关闭首次密钥设置弹窗。
首次打开 Harness 时会询问 DeepSeek API Key。点击弹窗底部的“Configure later”（稍后配置），先跳过官方供应商配置；后面再添加 custom。
点击窗口左下角的设置齿轮。
进入 Harness 主界面后，点击窗口左下角的齿轮按钮，打开 Settings（设置）。
点击左侧菜单中的“Models”。
在 Settings 弹窗左侧点击“Models”（模型），进入模型供应商设置页。
点击“+ Add a custom provider”。
在 Models 页面向下找到并点击“+ Add a custom provider”（添加自定义供应商）。供应商是向 Harness 提供模型接口的服务，这里要添加 custom。
Provider ID 填写 custom；Display name 可填写 custom。
Base URL 粘贴页面复制区提供的 /v1 地址。
API protocol 选择 openai-completions。
API Key 粘贴自己的完整密钥。
填写完成后点击“Fetch available models”。
Provider ID 填写 custom。Base URL 是模型服务地址，粘贴页面复制区提供且只含一次 /v1 的地址；API protocol 选择 openai-completions；API Key 是调用服务的访问凭证，粘贴自己的完整密钥。填写后点击“Fetch available models”读取模型列表。截图中的固定地址只用于说明字段位置，实际值必须以页面复制区为准。
勾选页面复制区当前显示的模型。
点击“Add selected”添加已勾选的模型。
在弹窗中找到页面复制区当前显示的模型，点击左侧复选框将其勾选，再点击“Add selected”（添加已选模型）。截图中的模型名称只是界面示例，请勿照抄。
确认模型已加入后，点击“Create provider”保存。
返回供应商表单后，确认刚选择的模型已经出现在 Models 区域，再点击右下角“Create provider”（创建供应商）保存配置。截图中的模型名称只用于说明位置。
确认 custom 右侧显示绿色状态点。
点击右上角的 × 关闭设置弹窗。
在 Models 列表中确认 custom 右侧出现绿色状态点，这表示 Harness 已连接到 custom。然后点击设置弹窗右上角的 × 返回主界面。
在 custom 分组中点击页面复制区显示的模型。
点击输入框底部当前模型的名称，展开模型菜单；在“custom”分组中点击页面复制区当前显示的模型。截图中的模型名称只是示例，请勿照抄；本地项目名已模糊。
点击工作区名称，选择用于测试的文件夹。
在输入框填写一个简单、低风险的测试任务。
确认模型无误后，点击右下角按钮发送任务。
先点击“Choose workspace”（选择工作区），选择一个不含密钥、账号或私人资料的测试文件夹。工作区就是允许 Harness 读取和修改的文件夹。然后在输入框填写一个简单任务，确认底部模型正确，再点击右下角的发送按钮。截图中的本地项目名已模糊，模型名称只用于说明位置。
看到模型开始返回正常内容，即表示 Harness 已连通 custom。
聊天区开始显示模型的正常回复，且输入框底部仍是刚选择的 custom 模型，就表示 Base URL、API Key、协议和模型配置已经生效。
看不清时：点击图片可放大；配置值请复制页面中的文字，不要照着截图手工输入密钥或地址。
选择一个不含敏感文件的测试文件夹，发送“请只列出这个文件夹中的文件”；能够正常返回结果，且底部模型名称正确，即配置成功。
配置示例中如果出现 sk-your-api-key 必须替换为自己的完整密钥；不要把含密钥的配置提交到 Git。
/v1 结尾、API protocol 选择 openai-completions，并重新粘贴完整 API Key。401：API Key 不完整、带有空格、已被禁用或已经过期，请回到令牌管理页检查。404：不要在 Base URL 后追加 /chat/completions，也不要写成重复的 /v1/v1。Fetch available models，并在模型弹窗中勾选页面复制区显示的模型后点击 Add selected。custom 分组重新选择模型。Choose workspace 选择有效文件夹，并检查 Harness 是否有读取该目录的权限。更多通用错误处理见常见问题。