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 模型供应商:填上中转站的 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
- 登录 SupaStore,进入【令牌管理】→【添加令牌】;
- 名称填
dify,勾选准备在 Dify 中使用的模型; - 设置额度上限:工作流和 Agent 可能被很多用户同时调用,额度上限能防止意外账单;
- 复制
sk-开头的密钥。Key 的安全使用方法见《Claude API Key 怎么获取?》。
第二步:安装 OpenAI-API-compatible 插件
- 登录 Dify,点击右上角头像,进入 设置 → 模型供应商;
- 在供应商列表中找到 OpenAI-API-compatible;新版 Dify 的模型供应商以插件形式提供,如果列表里没有,先到 插件 市场搜索并安装它;
- 安装完成后,它会出现在模型供应商列表中。
第三步:在 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 如何控制成本
- 按节点选模型:工作流里大部分节点是分类、提取、改写,交给便宜的模型;只把关键的推理节点交给 Claude;
- 控制知识库召回数量:知识库每次召回的分段都会作为输入 Token 发给模型,Top K 设得越大,每次请求越贵;
- 限制对话记忆:聊天助手携带的历史轮数越多,输入 Token 越多,按需调小;
- 给 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,填写嵌入模型的名称即可,可用的嵌入模型以模型广场为准。