Dify 配置 Anthropic 接口：从安装插件到完成调用
简答：Dify 配置 Anthropic 接口，先安装 Marketplace 中的 Anthropic 模型插件，再在“设置 → 模型供应商”中填写 API Key 和 API URL。直连 Anthropic 时建议填 <code>https://api.anthropic.com</code>，不要把完整的 <code>/v1/messages</code> 填进 API URL；模型名称优先使用插件列表或官方模型接口返回的值。代理场景则按代理是否兼容 Anthropic Messages API 判断插件和地址。
定义：Dify 配置 Anthropic 接口，是在 Dify 工作区安装并配置 Anthropic 模型供应商，让应用、Chatflow 或 Workflow 通过 Anthropic Messages API 调用 Claude 模型。
先看速查表：10 秒判断该用哪种接法
先判断你手里的服务地址属于哪种协议，再决定插件。本站是与 Dify、Anthropic 及相关服务无隶属关系的第三方 AI API 接入指南站，本文只依据公开文档和 Marketplace 页面整理配置方法。
| 场景 | 怎么判断 | 建议使用的 Dify 供应商 | API URL 或 Base URL | 容易填错的内容 |
|---|---|---|---|---|
| 直连 Anthropic | 服务文档指向 Anthropic Claude API，接口为 Messages API | Anthropic | https://api.anthropic.com | 不要填完整的 /v1/messages；不要把它改成 OpenAI 的聊天路径 |
| Anthropic Messages API 代理 | 代理文档明确写有 /v1/messages 或声明兼容原生 Anthropic Messages API | Anthropic 或代理专用插件 | 按代理文档填写根地址或 Base URL | 不要把代理地址和直连地址的路径规则混用 |
| OpenAI 兼容接口 | 文档写明使用 OpenAI 格式，常见请求路径为 /v1/chat/completions | OpenAI-API-compatible 类插件 | 填该服务规定的 OpenAI API Base URL | 不要把 https://api.anthropic.com 直接填入兼容插件 |
判断原则：看服务商文档中的请求协议和路径，不要只看服务名称里是否出现“Claude”或“Anthropic”。Dify Marketplace 的 Anthropic 插件要求配置 Anthropic API Key 与 API URL；另一个 Claude Proxy 插件则明确要求上游实现原生 Anthropic Messages API，二者的定位不同。可查看 Dify Anthropic 插件说明 和 Claude Proxy 插件说明。
Dify 配置 Anthropic 的完整步骤
- 准备 API Key。在 Anthropic 的 Claude Console API Keys 页面创建或复制密钥。官方文档说明，API Key 可在 Console 中创建，完整密钥通常只在创建时显示一次；共享的生产任务应使用适合工作负载的密钥类型，并放入凭据管理系统。可查看 官方 API Key 获取说明。
- 安装 Anthropic 模型插件。在 Dify 的插件 Marketplace 搜索 Anthropic 并安装。Dify Marketplace 页面显示该插件用于接入 Claude 系列模型，配置时需要 API Key 和 API URL。自部署环境如果看不到安装入口，应先确认 Marketplace 和插件服务是否可用。
- 进入模型供应商设置。在工作区设置中打开“模型供应商”。Dify 官方文档给出的通用路径是“设置 → 模型供应商”，不同版本可能出现“Model Providers”或相近名称。只有工作区所有者和管理员通常可以配置、修改或删除供应商凭据，成员主要负责使用已配置的模型。具体权限和流程以 Dify 模型供应商文档 为准。
- 选择 Anthropic 并填写密钥。API Key 字段只填密钥值本身，不要粘贴
Authorization: Bearer、x-api-key:或完整 curl 命令。Dify 插件会负责把凭据转换为请求所需的认证信息。 - 直连时填写 API URL。优先填写
https://api.anthropic.com，不要把完整的https://api.anthropic.com/v1/messages当作 API URL。Anthropic 官方 API 概览把服务根地址和 Messages API 路径分开描述：根地址是https://api.anthropic.com，消息接口是POST /v1/messages。因此，将完整接口路径填入 Dify 的 API URL 会让插件有机会重复拼接路径；这是根据字段含义和接口结构得出的配置判断，若你使用的插件界面明确给出其他格式，应以该插件说明为准。参见 Anthropic API 概览。 - 保存并测试供应商。保存后观察是否通过凭据验证，再打开应用或 Chatflow 的 LLM 节点，选择 Anthropic 及可用模型。不要只看供应商保存成功就认为模型调用一定成功，最好用一条短文本完成实际调用。
- 逐步开启高级能力。基础文本调用成功后，再测试长上下文、流式输出、工具调用或提示词缓存。Anthropic 插件页面列出了请求元数据和 Prompt Caching 等可选能力，但这些能力依赖上游接口、插件版本和模型支持，不能作为首次配置的必填项。
API URL、认证方式和模型名称怎么填
API URL 不等于完整 Endpoint
直连 Anthropic 时，最小配置可以写成 https://api.anthropic.com。官方接口的实际消息请求路径是 POST /v1/messages，但 Dify 的供应商字段是 API URL，而不是让用户手动填写完整请求 Endpoint。不要直接填 https://api.anthropic.com/v1/messages，也不要默认所有代理都必须追加 /v1。
认证头由插件处理，用户只粘贴 Key
截至 2026 年 10 月 24 日，Anthropic 当前认证文档把 API Key 说明为通过 Authorization: Bearer <key> 发送，同时说明旧的 x-api-key 方式仍受支持。对 Dify 用户而言，关键不是手动选择请求头，而是把密钥值填入正确的凭据字段，让插件生成请求。可核对 Anthropic Authentication 文档 和 API 请求头说明。
模型名称不要凭记忆长期写死
本文不固定提供某个 Claude 模型 ID 作为可复制配置，因为模型状态和可用名称会变化。优先使用 Dify Anthropic 插件当前展示的模型；如果必须添加自定义模型，再用 Anthropic 官方模型列表或上游代理文档核对完整名称。模型列表、模型状态和可用性应以 Anthropic 模型文档 为准。
代理场景必须先核对协议
如果服务商提供的是原生 Anthropic Messages API 代理，使用 Anthropic 或专用代理插件，并按其文档填写 Base URL、Key 和模型名。如果服务商只提供 OpenAI 兼容接口，则应改用 OpenAI 兼容类插件。Claude Proxy Marketplace 页面明确要求代理实现原生 Anthropic Messages API，并提供 API Base URL、API Key、模型名和最大输出参数等字段；这些字段不能直接套用到官方 Anthropic 插件。
配置成功后的验证顺序
- 验证凭据层。保存供应商后，确认没有出现认证失败、凭据缺失或验证超时。
- 验证模型层。在 LLM 节点或应用模型选择器中，确认供应商和模型属于同一套配置。模型名称显示出来，不代表当前 Key 一定有权限调用。
- 验证请求层。使用短文本进行一次普通调用。若普通调用成功，再分别测试流式输出、较长输入、工具调用和提示词缓存。
- 验证地址层。如果返回 404，检查 Dify 日志中的最终请求地址，重点看是否把完整
/v1/messages填入了 API URL，或把 OpenAI 兼容路径套到了 Anthropic 插件上。 - 验证权限层。如果管理员能保存凭据但成员无法使用，检查工作区模型供应商是否已配置，以及应用或工作流是否实际选择了该模型。
建议按“凭据 → 模型 → 实际请求”的顺序排查。不要一开始同时更换 Key、URL 和模型名，否则即使问题解决，也很难判断真正原因。
Dify 调用 Anthropic 的错误码排查表
| 状态或现象 | 可核对的错误类型 | 优先检查 | 处理步骤 |
|---|---|---|---|
| 400 | invalid_request_error | 请求格式、参数、工作区标识、URL | 先读取错误消息和 request_id；检查 API URL 是否写成完整 Endpoint，以及请求是否缺少必要字段。 |
| 401 | authentication_error | Key 是否完整、过期、撤销或粘贴了错误前缀 | 只在 Dify 字段中填写密钥值；重新确认密钥属于目标账户或工作区。不要把整段请求头粘贴进 Key 输入框。 |
| 403 | permission_error | 组织、工作区或资源权限 | 确认当前 Key 对目标工作区和模型具有使用权限；如果是代理，还要核对代理侧权限。 |
| 404 | not_found_error | 路径、资源 ID、模型或代理端点 | 直连时先恢复为 https://api.anthropic.com；不要把 /v1/messages 当作 API URL。代理场景按代理文档核对最终路径。 |
| 413 | request_too_large | 输入内容、图片、文档或请求体大小 | 减少上下文、附件或单次请求内容，再用短文本验证。官方错误文档将 413 定义为请求超过允许大小。 |
| 429 | rate_limit_error | 请求频率、并发或账户使用限制 | 降低并发，观察响应头和错误消息；如果错误明确指向持续性的使用上限，反复点击重试不能替代账户限制处理。 |
| 500 | api_error | 上游服务内部错误 | 记录 request_id，按退避方式稍后重试；持续发生时提交给上游支持团队。 |
| 504 | timeout_error | 请求耗时、网络、代理转发 | 先缩短输入和输出，再检查 Dify 到上游的出站网络；长请求可测试流式响应。 |
| 529 | overloaded_error | Anthropic 服务暂时过载 | 与 429 区分处理：降低请求压力并稍后重试，同时记录时间和 request_id，不要只修改 API Key。 |
页面显示 unsupported_parameter | 通常不是独立 HTTP 状态 | 插件、代理和模型是否支持该参数 | 检查最近新增的参数、工具、思考或缓存配置；对照上游接口文档，先关闭非必要高级参数。Anthropic 官方错误页未将其列为独立状态码，因此应以实际错误消息判断。 |
Anthropic 官方错误文档列出了 400、401、403、404、413、429、500、504 和 529 的错误类型，并说明错误响应包含顶层错误对象和 request_id。流式请求不要只看初始 HTTP 状态；如果 Dify 或代理在传输过程中中断，应同时检查 SSE 解析、连接超时和上游错误内容。可查看 Anthropic API Errors 文档。
Dify Cloud、自部署和高级选项的差异
Dify Cloud 和自部署 Dify 的界面名称、插件安装入口及权限范围可能不同，但配置逻辑基本一致：安装供应商插件、填写凭据、保存验证、选择模型、进行最小调用。自部署环境还需要额外确认插件服务、Marketplace 访问和服务器到上游 API 的 HTTPS 出站连接。
如果直连配置在 Cloud 成功、自部署失败，优先把问题拆成两部分：一是 Dify 供应商字段是否相同，二是自部署服务器是否能解析域名、建立 TLS 连接并持续读取响应。不要因为页面能打开，就默认后台容器也能访问上游接口。
Prompt Caching、工具调用和请求元数据属于可选能力，不是首次接入的必要条件。建议先完成普通文本调用，再根据插件 Marketplace 页面显示的实际字段逐项开启。页面没有明确写出的字段、版本或模型能力，应按服务商文档确认。
密钥安全清单：
- 不要把 API Key 写入公开仓库、截图、工作流公开变量或日志。
- 开发、测试和生产尽量使用不同密钥，便于撤销和审计。
- 如果密钥泄露，立即在 Console 中禁用或删除，并创建新密钥。
- 不要在命令行参数中直接暴露密钥，优先使用 Dify 凭据字段或密钥管理器。
- 使用未限定工作区的密钥时，按 Anthropic 文档确认是否还需要工作区标识。
密钥创建、过期、禁用和存储方式可参考 Anthropic Authentication 文档；Dify 工作区权限和凭据范围可参考 Dify 模型供应商文档。
结论：先选协议，再填地址，最后验证模型
- 直连 Anthropic：安装 Anthropic 插件，API URL 优先填
https://api.anthropic.com，不要填完整/v1/messages。 - API Key：只填密钥值，当前 Anthropic 文档以
Authorization: Bearer为主，同时仍支持x-api-key；Dify 用户不需要手动拼请求头。 - 模型名称：优先选择插件提供的模型；自定义模型必须按官方模型文档或代理文档核对。
- 代理：先确认是原生 Anthropic Messages API 还是 OpenAI 兼容协议，再选择对应插件。
- 排错：401 先查 Key，403 查权限，404 查路径，429 查速率和使用限制，529 查上游过载，413 查请求体大小。
常见问题
Dify 配置 Anthropic 时，API URL 要不要带 /v1？
直连 Anthropic 时，建议填写 <code>https://api.anthropic.com</code>，不要填写完整的 <code>/v1/messages</code>。官方 API 将服务根地址与 Messages API 的 <code>POST /v1/messages</code> 路径分开定义；Dify 的 API URL 字段应按插件说明填写。代理场景是否包含路径，必须按代理文档确认。
Dify Anthropic 插件里的 API Key 应该填写什么？
只填写 API Key 本身，不要填写 <code>Authorization: Bearer</code>、<code>x-api-key:</code> 或完整请求头。当前 Anthropic 文档以 Authorization Bearer 方式为主，同时仍支持 x-api-key；Dify 插件会处理请求头。
为什么 Dify 保存成功，但模型列表里没有想用的 Claude 模型？
先确认供应商凭据验证通过，再检查该模型是否在插件可选列表中。若需要自定义模型，使用 Anthropic 官方模型文档或代理服务文档中的准确名称，不要凭记忆修改模型 ID。
Dify 调用 Anthropic 返回 404，最先检查什么？
先检查 API URL 是否填成了完整的 <code>/v1/messages</code>，或是否把 OpenAI 兼容路径套到了 Anthropic 插件。直连时先恢复为 <code>https://api.anthropic.com</code>；代理则核对代理要求的最终路径。
Dify 调用 Anthropic 返回 429 或 529，应该怎么区分？
429 对应速率或使用限制，应先降低并发并查看响应头和错误消息；529 表示上游暂时过载，通常应稍后重试并记录 <code>request_id</code>。两者都不适合通过反复更换 API URL 来解决。
Dify Cloud 和自部署 Dify 的配置入口完全一样吗？
不一定。Dify 官方文档给出的通用路径是“设置 → 模型供应商”，不同部署版本的菜单名称和插件入口可能不同。配置逻辑仍是安装插件、填写凭据、保存验证、选择模型并完成最小调用。
相关阅读
参考资料
- Dify Marketplace：Anthropic 插件（marketplace.dify.ai）
- Dify Marketplace：Claude Proxy 插件（marketplace.dify.ai）
- Dify Docs：模型供应商（docs.dify.ai）
- Anthropic：API 概览（platform.claude.com）
- Anthropic：Authentication（platform.claude.com）
- Anthropic：获取 API Key（platform.claude.com）