SupaStore

返回博客列表

Dify 怎么接入 Claude?Dify 配置 OpenAI-API-compatible 模型供应商教程(2026)

Dify 怎么接入 Claude?本文一步步安装 OpenAI-API-compatible 插件,在 Dify 模型供应商中填写 API Key、API endpoint URL 和模型名称,通过中转 API 把 Claude、GPT、DeepSeek 接入 Dify 工作流与 Agent,并附系统模型设置、参数填写建议与常见报错排查。

SupaStore 开发者体验组 ·

Dify 怎么接入 Claude?Dify 配置 OpenAI-API-compatible 模型供应商教程(2026)

Dify 接入 Claude 最通用的做法,是用 Dify 的 OpenAI-API-compatible 模型供应商:填上中转站的 API endpoint URL、API Key 和模型名称,Claude 就会出现在 Dify 的模型列表里,可以直接用在聊天助手、工作流和 Agent 中。

本文用 SupaStore 演示完整的 Dify 配置流程:安装插件、添加模型、设置系统默认模型,以及每个参数该怎么填。同样的方法也适用于 GPT、DeepSeek 等模型,一个 Key 就能在 Dify 里切换多家模型。


Dify 是什么

Dify 是一个开源的大模型应用开发平台,可以用可视化的方式搭建聊天助手、工作流、Agent 和知识库问答应用。既能用 Dify 官方的云服务,也能用 Docker 自己部署。

Dify 不自带模型,所有模型都通过"模型供应商"接入。国内开发者直连 Anthropic 官方接口通常有网络和支付门槛,通过兼容 OpenAI 接口的中转站接入是最省事的方式。


第一步:创建 Dify 专用 API Key

  1. 登录 SupaStore,进入【令牌管理】→【添加令牌】;
  2. 名称填 dify,勾选准备在 Dify 中使用的模型;
  3. 设置额度上限:工作流和 Agent 可能被很多用户同时调用,额度上限能防止意外账单;
  4. 复制 sk- 开头的密钥。Key 的安全使用方法见《Claude API Key 怎么获取?》。

第二步:安装 OpenAI-API-compatible 插件

  1. 登录 Dify,点击右上角头像,进入 设置 → 模型供应商;
  2. 在供应商列表中找到 OpenAI-API-compatible;新版 Dify 的模型供应商以插件形式提供,如果列表里没有,先到 插件 市场搜索并安装它;
  3. 安装完成后,它会出现在模型供应商列表中。

第三步:在 Dify 中添加 Claude 模型

在 OpenAI-API-compatible 供应商上点击 添加模型,按下表填写:

字段 填写内容 说明
模型类型 LLM 对话模型选 LLM
模型名称 claude-sonnet-4-6 必须与模型广场中的模型 ID 完全一致
API Key sk-... 第一步创建的密钥
API endpoint URL https://api.supastore.cc/v1 以 /v1 结尾,末尾不要加 /
模型上下文长度 按模型官方参数填写 决定 Dify 最多给模型发送多少上下文
最大 token 上限 按模型官方参数填写 决定单次回答的最大长度

不同版本的 Dify 还可能有 Function calling、Vision 支持 等选项:Claude 支持工具调用和图片识别,在 Agent 或需要识图的应用里可以打开。Claude 各模型的上下文窗口见《Claude 上下文窗口多大?》。

点击 保存,Dify 会先用这些参数发一次测试请求,通过后模型才会添加成功。GPT、DeepSeek 等模型按同样的方式再添加一次即可,只需要换模型名称。


第四步:设置 Dify 系统默认模型

在模型供应商页面右上角点击 系统模型设置,把 系统推理模型 设为刚添加的模型。Dify 在生成对话标题、推荐问题等内置功能里会用到它。这类任务很简单,选一个便宜的模型(例如 deepseek-v4-flash)就够了。

之后在创建应用时,在应用的模型选择器里就能看到 OpenAI-API-compatible 下的 Claude 模型。


第五步:在应用和工作流中使用 Claude

  • 聊天助手:创建应用后,在右上角的模型选择器中选择 claude-sonnet-4-6,调试面板里发送一句话测试;
  • 工作流:在 LLM 节点 中选择模型,每个节点可以选不同的模型。简单的分类、提取节点用便宜模型,需要深度推理的节点再用 Claude;
  • Agent:选择支持 Function calling 的模型,Agent 才能调用工具。Claude 的工具调用原理见《Claude 工具调用怎么用?》。

在 SupaStore 控制台的使用日志里,可以看到 Dify 每次调用的模型、Token 数和扣费金额。


Dify 接入 Claude 常见报错

现象 常见原因 处理方法
保存模型时报 401 API Key 错误,或复制时多了空格 重新复制密钥,先用 cURL 验证
保存模型时报 404 endpoint URL 缺少 /v1,或末尾多了 / 严格填写 https://api.supastore.cc/v1
模型不存在 模型名称与模型 ID 不一致,或 Key 未勾选该模型 在模型广场核对 ID,检查 Key 的可用模型
自部署的 Dify 连接超时 服务器无法访问外网 确认 Dify 所在服务器能访问 api.supastore.cc
回答被截断 最大 token 上限设置过小 调大模型配置里的最大 token 上限

保存前可以先在服务器上用 cURL 确认 Key 和模型可用:

curl https://api.supastore.cc/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-supastore-api-key" \
  -d '{"model": "claude-sonnet-4-6", "messages": [{"role": "user", "content": "Ping"}]}'

返回包含 choices 的 JSON 就说明接口没问题,再回到 Dify 排查参数。其他错误码见《Claude API 报错怎么办?》。


Dify 用 Claude 如何控制成本

  1. 按节点选模型:工作流里大部分节点是分类、提取、改写,交给便宜的模型;只把关键的推理节点交给 Claude;
  2. 控制知识库召回数量:知识库每次召回的分段都会作为输入 Token 发给模型,Top K 设得越大,每次请求越贵;
  3. 限制对话记忆:聊天助手携带的历史轮数越多,输入 Token 越多,按需调小;
  4. 给 Key 设额度上限:对外开放的应用尤其需要,防止被刷量。

主流模型的价格对比见《2026 主流大模型价格对比与企业 API 成本优化指南》。


常见问题 (FAQ)

Q: Dify 有 Anthropic 官方的模型供应商,为什么用 OpenAI-API-compatible?

答: OpenAI-API-compatible 一个供应商就能接入 Claude、GPT、DeepSeek 等多家模型,填写规则统一,国内网络环境下也最省事。只用 Claude 并且有官方 Key 时,用 Anthropic 供应商也可以。

Q: Dify 云服务和自部署版都能这样接入吗?

答: 都可以。自部署版需要确保 Dify 所在的服务器能访问中转站的地址;云服务版直接填写即可。

Q: 添加模型时上下文长度填多少?

答: 按模型官方公布的上下文窗口填写。填得比实际小,Dify 会截断上下文;填得比实际大,超长请求会被接口拒绝。

Q: Dify 知识库的 Embedding 模型也能用中转站吗?

答: 可以。在 OpenAI-API-compatible 供应商里添加模型时,模型类型选 Text Embedding,填写嵌入模型的名称即可,可用的嵌入模型以模型广场为准。