快速开始

开始之前，请确认已安装 difyctl。

CLI 依赖部署的 /openapi/v1/* 接口，默认关闭。登录前在 Helm values 中设置 api.openapi.enabled: true；api.enableOauthBearer 需保持为 true（默认值）。

第 1 步：登录

登录到公司的 Dify 主机。使用对应实例的控制台 API URL。
difyctl auth login --host https://dify.example.com
difyctl 会打印一个一次性验证码和一个验证 URL，然后等待：
! Copy this one-time code: WDJP-XKLM Open: https://dify.example.com/device

在浏览器中打开该 URL，输入验证码并登录。回到终端，你会看到：

✓ Logged in to dify.example.com as <your-email> (<your-name>)
  Workspace: <your-workspace>

第 2 步：找到你的应用

列出工作空间中的应用：

difyctl get app

你应该会看到类似下面的输出：

NAME          ID                                    MODE      UPDATED
Customer FAQ  0a1b2c3d-4e5f-6789-abcd-ef0123456789  chat      2026-06-08T03:14:27.521839
Daily Report  7f3e9a2b-1c4d-4e8f-9a0b-2d5c8e1f4a7b  workflow  2026-06-05T22:41:09.812016

复制要运行的应用的 ID。下面的示例使用此表中的两个 ID。

第 3 步：运行你的应用

传入输入的方式取决于应用类型。

聊天助手 / Chatflow / Agent / 文本生成应用
工作流

将消息作为位置参数传入：

difyctl run app 0a1b2c3d-4e5f-6789-abcd-ef0123456789 "What are your business hours?"

回复会打印到 stdout。对于聊天助手、Chatflow 和 Agent 应用，还会向 stderr 打印一条提示，方便你稍后继续同一段对话：

Our business hours are Monday through Friday, 9am to 6pm PT.

hint: continue this conversation with --conversation 4f7d8c2a-9b1e-4c6d-8a3f-5e2b7c9d0a1f

用 --inputs 将输入作为单个 JSON 对象传入：

difyctl run app 7f3e9a2b-1c4d-4e8f-9a0b-2d5c8e1f4a7b --inputs '{"topic":"quarterly report","audience":"executives"}'

工作流的输出会以 JSON 形式打印到 stdout：

{"summary":"Q3 revenue grew 14% YoY...","sections":["revenue","costs","outlook"]}

后续步骤

开箱即用的日常命令：常见任务
token 存储位置与会话机制：认证
difyctl 的其余全部能力：命令索引

入门

账户用户

外部 SSO 用户

集成你的 Agent

命令参考

故障排查

第 1 步：登录

第 2 步：找到你的应用

第 3 步：运行你的应用

后续步骤

​第 1 步：登录

​第 2 步：找到你的应用

​第 3 步：运行你的应用

​后续步骤

第 1 步：登录

第 2 步：找到你的应用

第 3 步：运行你的应用

后续步骤