部分模型可免费调用查看免费模型
返回文档中心
文档中心 / DeepSeek Harness

DeepSeek Harness 完整接入文档

从安装桌面端到配置模型供应商，让 DeepSeek Harness 连接 LanoX。

已有 API Key，直接配置
00

LanoX 官方平台地址

进入 LanoX 控制台，完成账户注册、余额充值与 API Key 准备。

LanoX 控制台lanox.ai
01

生成 API Key

后续配置使用 LanoX API Key，无需填写模型厂商官网的密钥。

  1. 01

    注册并登录账户

    填写邮箱和密码，完成邮箱验证。已有账户可直接登录。

    前往注册
  2. 02

    准备账户余额

    在控制台充值，或使用兑换码完成入账。

    打开控制台
  3. 03

    创建并复制 API Key

    进入“API Key”页面，新建密钥，创建后复制并妥善保存。

    创建 API Key

API Key 是你的访问凭证，请勿公开分享、提交到代码仓库或放进截图。

02

安装 DeepSeek Harness

下载 macOS 或 Windows 桌面端；通过 CC Switch 接入时，请同时安装下方 CC Switch。

DeepSeek Harness for macOS

Apple 芯片安装包（官网目前提供 arm64），适用于 macOS 13+。

下载桌面端
  1. 下载并打开桌面端安装包，按提示完成安装。
  2. 打开 DeepSeek Harness 桌面端。
  3. 进入设置，在“模型”中添加自定义模型以对接 LanoX。
官方安装说明

桌面端安装与 LanoX API 鉴权是两个独立步骤。第三方模型调用费用由 LanoX 账户承担。DeepSeek Harness 仍处于开发者预览阶段。

CC Switch for macOS

下载 macOS 通用 DMG 安装包，适用于 Apple 芯片与 Intel Mac。

下载 CC Switch
通过 CC Switch 接入时安装GitHub Releases
通过 Homebrew 安装
Homebrew
brew install --cask cc-switch

安装包含 DeepSeek Harness 入口的版本。安装后在 CC Switch 左侧选择 DeepSeek Harness，再添加供应商。

03

DeepSeek Harness 接入配置

选择 DeepSeek Harness 自带配置，或通过 CC Switch 管理供应商，两种方式任选其一。

接入参数

已安装客户端已准备 API Key账户余额充足
Provider ID
lanox1
显示名称
lanox
Base URL
https://api.lanox.ai/v1
API protocol
OpenAI Chat Completions
API Key
粘贴你的 LanoX API Key
模型 ID
YOUR_MODEL_ID

仅用于更新下方命令示例，不会发送请求。模型 ID 以 LanoX 实际列表为准，不是显示名称。

每个供应商只选择一种 API 协议。切换协议时，请同时核对 Base URL 和模型权限；Provider ID 创建后不可改名。

分步配置

OpenAI Chat Completions
步骤 1 / 4

打开模型设置

打开 DeepSeek Harness 桌面端，进入“设置 → 模型”，点击“添加模型提供商”。

配置截图
在模型设置底部点击“添加模型提供商”。不要将 LanoX 密钥填入内置 DeepSeek 卡片。

用户提供的实际配置截图，保留原有步骤标注与密钥遮挡。

04

验证接入

先验证简单问答，再验证工具调用，最后核对调用记录。

  1. 新建会话，发送一条简短消息，确认收到真实回复。
  2. 在可信测试文件夹中验证工具调用，检查客户端授权。
  3. 在 LanoX 控制台核对模型、用量和调用记录。
可选：直接测试 API

先在本地环境变量中设置 LANOX_API_KEY。以下命令仅供复制，页面不会发送请求；手动运行可能产生模型调用费用。

Terminal
curl --fail-with-body 'https://api.lanox.ai/v1/chat/completions' \
  -H "Authorization: Bearer $LANOX_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "YOUR_MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "Reply with OK."
    }
  ],
  "stream": false
}'
05

常见问题与支持

先检查以下常见问题；仍未解决时，可提交工单获得技术支持。

保存成功，但模型没有回复？

核对 API Key、余额、模型 ID 与接口协议。401/403 通常与鉴权或权限有关，404 需检查接口路径与模型名称，429 需检查限流或额度；以接口返回的具体错误为准。

工作区或模型选择后仍不能输入？

确认已添加并选择工作区，且供应商至少配置了一个可用模型。已有会话会保留其模型记录，请用新会话验证新配置。

获取模型列表失败怎么办？

模型发现是辅助功能，不是接入的前提。可在 Models 中手动添加从 LanoX 控制台复制的准确模型 ID，然后保存供应商。

能对话，但无法操作文件？

确认模型支持工具调用、协议与网关兼容，并检查客户端的工作区授权和工具设置。能回答文本不代表具备完整 Agent 能力。

需要重启或安装 CC Switch 吗？

自带接入无需 CC Switch，保存后在新会话验证即可。通过 CC Switch 配置完成后，必须完全退出并重启 DeepSeek Harness，再选择模型验证；不要仅关闭窗口。

用户交流群

LanoX 用户交流群

微信扫码入群，交流接入与使用问题。

查看最新二维码

工单支持

账户、模型调用或接入遇到问题？提交工单，支持团队将持续跟进。

提交工单

附上操作系统、客户端版本、协议及错误截图，并隐藏 API Key。

参考文档官方模型配置官方下载与项目

接入截图更新：2026-11-09。两种接入方式使用用户提供的截图；可用模型与接口权限以 LanoX 控制台为准。