Dify 接入

Dify 是目前非常流行的开源 LLM 应用开发平台，支持 Chatbot、Agent、Workflow、知识库 RAG 等多种应用形态。很多开发者都会问：

能不能在 Dify 里使用 Claude 模型？

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

code0.ai 提供 OpenAI API 兼容格式，而 Dify 内置了 OpenAI-API-compatible 插件，两者可以直接配合使用。借助 code0.ai 的 OpenAI 兼容接口，我们可以把 Claude 模型快速接入 Dify，无需额外开发适配层。

准备工作

开始前，请先确认你已经准备好以下内容：

项目	说明
Dify 账号	Cloud 版或自部署版本均可
code0.ai API Key	在 code0.ai 控制台获取
API Base URL	`https://hk.code0.ai/v1`
模型 ID	如 `claude-sonnet-4-6`、`claude-opus-4-7`

第一步：选择 Dify 使用方式

方式一：Dify Cloud

如果你是新手，推荐直接使用 Dify Cloud。

访问：

https://dify.ai

注册并登录后即可使用，无需准备服务器，也不需要配置 Docker。

方式二：Docker 自部署

如果你有自己的服务器，也可以选择 Docker 自部署。这样可以完整控制数据、插件和运行环境。

Dify 官方部署文档：

Docker Compose 部署指南

常用部署命令如下：

启动完成后访问：

http://你的服务器IP/install

如果是本地部署，则访问：

http://localhost/install

完成初始化即可。

推荐最低配置：CPU ≥ 2 核，内存 ≥ 4 GiB。

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

右上角头像 → Settings → Model Providers

在插件列表中找到：

OpenAI-API-compatible

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

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

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

这个插件是接入 code0.ai 的关键。它可以让 Dify 调用任何 OpenAI API 格式兼容的接口。

第三步：添加 code0.ai 模型

安装完成后，进入 OpenAI-API-compatible 插件，点击：

然后按照下表填写：

配置项	填写内容
Model Type	`LLM`
Model Name	`claude-sonnet-4-6`
API Key	你的 code0.ai API Key
API Endpoint URL	`https://hk.code0.ai/v1`
Completion mode	Chat
Stream	建议开启

其中最重要的是 Model Name 和 API Endpoint URL。

模型 ID 必须精确填写，不能写中文名、简称或展示名。

正确示例：

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

错误示例：

Claude Sonnet
Claude 4.6
sonnet-4

保存后，可以输入一个简单测试问题：

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

如果模型能够正常回复，说明 code0.ai 已经成功接入 Dify。

第四步：在 Dify 应用中使用 Claude

回到 Dify 首页，创建一个新应用：

Create App → Chatbot / Agent / Workflow

进入应用编排页面后，在模型选择位置，选择刚刚添加的：

claude-sonnet-4-6

之后就可以开始构建聊天机器人、Agent、Workflow 或知识库 RAG 应用了。

场景	Temperature	Max Tokens
普通聊天机器人	0.7	4096
知识库 RAG 问答	0.2 – 0.5	4096
代码生成	0.2 – 0.4	8192
长文档分析	0.2 – 0.4	8192

常见报错速查

1. 401 Unauthorized

说明 API Key 有问题。

请检查：

API Key 是否复制完整

前后是否有空格

Key 是否仍然有效

是否使用了正确的 code0.ai 账号

2. model not found

说明模型 ID 写错了。

请确认模型名称是否和 code0.ai 控制台中的模型 ID 完全一致。

例如：

claude-sonnet-4-6

不要写成：

Claude Sonnet
sonnet-4
Claude 4.6

3. 接口无响应或请求超时

优先检查 API Endpoint URL 是否填写完整。

错误写法：

https://hk.code0.ai

正确写法：

https://hk.code0.ai/v1

一定不要漏掉 /v1。

4. 自部署插件安装失败

如果是 Docker 自部署 Dify，插件安装失败通常和服务器网络有关。

请检查服务器是否能访问：

marketplace.dify.ai
github.com

同时确认：

Dify 版本不要过旧

服务器 DNS 正常

Docker 容器网络正常

如服务器在特殊网络环境下，需要配置代理

5. 流式输出异常

如果开启 Stream 后输出异常，可以先关闭 Stream 测试。

如果普通响应正常，说明基础配置没有问题，再重新开启 Stream 排查流式响应设置。

自部署网络连通性验证

如果你使用 Docker 自部署 Dify，配置完成后仍然调用失败，可以先在服务器上测试 code0.ai 接口是否可达。

执行：

如果能返回模型列表，说明服务器到 code0.ai 的网络是通的，问题大概率出在 Dify 配置层。

如果无响应或超时，则需要检查：

服务器防火墙

DNS 解析

Docker 容器网络

代理配置

服务器出口网络限制

配置速查表

项目	内容
Provider	OpenAI-API-compatible
API Endpoint URL	`https://hk.code0.ai/v1`
API Key	code0.ai 控制台获取
推荐模型	`claude-sonnet-4-6` / `claude-opus-4-7`
Completion mode	Chat
Stream	建议开启
Dify Cloud	dify.ai
Dify GitHub	github.com/langgenius/dify
Dify 插件市场	marketplace.dify.ai
code0.ai	code0.ai

总结

通过 Dify 的 OpenAI-API-compatible 插件，code0.ai 可以非常方便地接入 Dify。

整个流程可以概括为四步：

准备 code0.ai API Key
安装 OpenAI-API-compatible 插件
填写 API Endpoint URL 和模型 ID
在 Dify 应用中选择 Claude 模型

配置完成后，你就可以在 Dify 中使用 Claude 模型构建 Chatbot、Agent、Workflow 和知识库 RAG 应用了。

对于开发者来说，code0.ai 的优势在于：

OpenAI API 兼容格式

接入方式简单

可直接用于 Dify

支持 Claude 多个模型

适合 Chatbot、Agent、RAG、Workflow 等场景

如果你正在使用 Dify 搭建 AI 应用，想接入 Claude 模型，可以直接按照本文配置。

准备工作#

第一步：选择 Dify 使用方式#

方式一：Dify Cloud#

方式二：Docker 自部署#

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

第三步：添加 code0.ai 模型#

第四步：在 Dify 应用中使用 Claude#

推荐参数设置#

常见报错速查#

1. 401 Unauthorized#

2. model not found#

3. 接口无响应或请求超时#

4. 自部署插件安装失败#

5. 流式输出异常#

自部署网络连通性验证#

配置速查表#

总结#