Dify 接入 ClaudeAPI.com 完整教程

Dify 是目前最流行的开源 LLM 应用开发平台，支持 Chatbot、Agent、Workflow、知识库 RAG 等多种应用形态。很多开发者问：能不能在 Dify 里用 Claude 模型？

答案是可以，而且配置很简单。

ClaudeAPI.com 提供 OpenAI API 兼容格式，Dify 内置了 OpenAI-API-compatible 插件，两者天然匹配。本文以最直接的方式走完整个配置流程。

准备工作

开始前确认你有以下内容：

第一步：选择 Dify 使用方式

方式一：Dify Cloud（推荐新手）

直接访问 https://dify.ai，注册登录即可，无需服务器，无需 Docker。

方式二：Docker 自部署

有服务器的用户可以自部署，完整控制数据。官方文档：Docker Compose 部署指南

git clone https://github.com/langgenius/dify.git
cd dify/docker
cp .env.example .env
docker compose up -d

git clone https://github.com/langgenius/dify.git
cd dify/docker
cp .env.example .env
docker compose up -d

启动后访问 http://你的服务器IP/install 完成初始化。本地部署访问 http://localhost/install。

最低配置要求：CPU ≥ 2 核，内存 ≥ 4 GiB。

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

登录 Dify 后进入：

右上角头像 → Settings → Model Providers

右上角头像 → Settings → Model Providers

在插件列表中找到 OpenAI-API-compatible，点击安装。

插件地址：https://marketplace.dify.ai/plugin/langgenius/openai_api_compatible

这个插件是接入 ClaudeAPI.com 的关键——它让 Dify 能够调用任何 OpenAI 格式兼容的接口。

第三步：添加 ClaudeAPI.com 模型

进入 OpenAI-API-compatible 插件，点击 Add Model，按下表填写：

模型 ID 必须精确，不能写中文名或简称：

✅ claude-sonnet-4-6
✅ claude-opus-4-7
✅ claude-haiku-4-5-20251001

❌ Claude Sonnet
❌ Claude 4.6
❌ sonnet-4

✅ claude-sonnet-4-6
✅ claude-opus-4-7
✅ claude-haiku-4-5-20251001

❌ Claude Sonnet
❌ Claude 4.6
❌ sonnet-4

保存后，输入测试问题确认模型返回正常：

你好，请用一句话介绍一下你自己。

你好，请用一句话介绍一下你自己。

第四步：在应用中使用 Claude

回到 Dify 首页，创建应用：

Create App → Chatbot / Agent / Workflow

Create App → Chatbot / Agent / Workflow

进入编排页面，在模型选择处选择刚添加的 claude-sonnet-4-6，即可开始构建。

推荐参数参考

常见报错速查

401 Unauthorized

API Key 有误。检查是否复制完整、前后有无空格、Key 是否仍然有效。

model not found

模型 ID 写错了。对照上方表格核实模型名称。

接口无响应 / 超时

Base URL 漏了 /v1。

❌ https://gw.claudeapi.com
✅ https://gw.claudeapi.com/v1

❌ https://gw.claudeapi.com
✅ https://gw.claudeapi.com/v1

自部署插件安装失败

服务器需要能访问 marketplace.dify.ai 和 GitHub。检查服务器网络或代理配置，同时确认 Dify 版本不过旧。

流式输出异常

先将 Stream 关闭测试。如果普通响应正常，再重新开启 Stream 排查。

自部署网络连通性验证

Docker 自部署后如果调用失败，先在服务器上验证接口是否可达：

curl https://gw.claudeapi.com/v1/models \
  -H "Authorization: Bearer sk-你的key"

curl https://gw.claudeapi.com/v1/models \
  -H "Authorization: Bearer sk-你的key"

能返回模型列表说明网络通畅，问题出在 Dify 配置层面；无响应则检查服务器防火墙、DNS、Docker 容器网络或代理设置。

配置速查表