クイックスタート

このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版を参照してください。

Dify Cloud をご利用の場合は、代わりに Cloud 版 CLI ドキュメントの手順に従ってください。
サーバーが Dify 1.18.0 に移行する前から difyctl を使っていた場合は、コマンドとサインイン方法が変わっています。Dify 1.18.0 へのアップグレードから始めてください。

このセットアップをコーディングエージェントに任せるには、このページをエージェントに渡してください。その場合も、サインインはブラウザから自分で承認します。

前提条件

Dify サーバーのバージョンが 1.18.0 以降であること。1.17.x 以前の場合は、その Dify バージョンのドキュメントを参照してください。
サーバーで OPENAPI_ENABLED と ENABLE_OAUTH_BEARER が true に設定されていること。

インストール

brew install dify でインストールされるのは、difyctl ではなく Dify のプラグイン開発用 CLI です。

インストーラーの実行

macOS / Linux
Windows
手動ダウンロード

x64 と arm64 をサポートしています。

curl -fsSL https://raw.githubusercontent.com/langgenius/dify/main/cli/scripts/install-cli.sh | sh

このコマンドは、Dify の最新リリースのビルドをインストールします。サーバーが以前のリリースで稼働している場合は、DIFY_VERSION にそのバージョンを指定します：

curl -fsSL https://raw.githubusercontent.com/langgenius/dify/main/cli/scripts/install-cli.sh | DIFY_VERSION=1.18.0 sh

スクリプトはダウンロードしたファイルのチェックサムを検証し、~/.local/bin/difyctl にインストールします。

対応プラットフォーム：x64。

irm https://raw.githubusercontent.com/langgenius/dify/main/cli/scripts/install.ps1 | iex

このコマンドは、Dify の最新リリースのビルドをインストールします。サーバーが以前のリリースで稼働している場合は、先に DIFY_VERSION にそのバージョンを設定します：

# この PowerShell セッションの間は有効
$env:DIFY_VERSION = "1.18.0"
irm https://raw.githubusercontent.com/langgenius/dify/main/cli/scripts/install.ps1 | iex

スクリプトはダウンロードしたファイルのチェックサムを検証し、%LOCALAPPDATA%\difyctl\bin\difyctl.exe にインストールします。

Dify の GitHub Releases から、サーバーの Dify バージョンに合うリリースを選び、2 つのアセットをダウンロードします：
- お使いのプラットフォーム向けのバイナリ（difyctl-v<version>-<os>-<arch>）
- チェックサムマニフェスト（difyctl-v<version>-checksums.txt）
バイナリの SHA-256 ハッシュを計算し、チェックサムファイル内の対応するエントリと比較します。値が一致しない場合、ダウンロードしたファイルは破損しているか改ざんされています。削除して再度ダウンロードしてください。
shasum -a 256 difyctl-v<version>-darwin-<arch>
sha256sum difyctl-v<version>-linux-<arch>
Get-FileHash difyctl-v<version>-windows-x64.exe

バイナリを PATH の通ったディレクトリに配置します：

chmod +x difyctl-v<version>-<os>-<arch>
mkdir -p ~/.local/bin
mv difyctl-v<version>-<os>-<arch> ~/.local/bin/difyctl

New-Item -ItemType Directory -Force "$env:LOCALAPPDATA\difyctl\bin" | Out-Null
Move-Item difyctl-v<version>-windows-x64.exe "$env:LOCALAPPDATA\difyctl\bin\difyctl.exe"

別のフォルダにインストールする場合や、その他のインストール設定を変更する場合は、設定を参照してください。

インストールの確認

difyctl version

command not found が表示される場合は、インストールディレクトリが PATH に含まれていません。次のように追加します：

# ~/.zshrc または ~/.bashrc に追加する。その場で実行しただけでは、セッションが終わるまでしか有効にならない
export PATH="$HOME/.local/bin:$PATH"

[Environment]::SetEnvironmentVariable('PATH', "$env:LOCALAPPDATA\difyctl\bin;" + [Environment]::GetEnvironmentVariable('PATH', 'User'), 'User')
# その後、新しいターミナルを開く

サインイン

difyctl はブラウザ経由でサインインします。サインインの有効期間は既定で 14 日間です（OAUTH_TTL_DAYS で変更できます）。

サインインの開始

ブラウザで Dify を開く際のアドレスを指定します：

difyctl login --server https://dify.example.com

SSH 経由での実行時などブラウザが開かない場合は、difyctl が表示した URL を任意のデバイスで開いてください。ローカルサーバーが http:// や自己署名証明書を使っている場合は、--insecure を追加します。この設定は、--insecure なしでサインインし直すまで、以降のすべてのコマンドに適用されます。ローカル開発以外では使わないでください。

ブラウザでの承認

difyctl を認証 ページでコードを入力し、続ける をクリックします。コードの有効期限は 15 分です。ページにアカウントが表示されたら、そのアカウントが正しいことを確認してから 認証する をクリックします。difyctl とコーディングエージェントは、このアカウントとして動作します。このアカウントでできることは、すべて実行できます。意図しないアカウントの場合は、キャンセル をクリックし、正しいアカウントで Dify にサインインしてから、もう一度サインインを開始します。

後でサインインし直す場合やサインアウトする場合は、サインインの管理を参照してください。サインインに失敗した場合は、トラブルシューティングを参照してください。

アプリの一覧表示

ワークスペース内のアプリを一覧表示して、difyctl が動作することを確認します：

difyctl get console_app

一覧に表示されるのは、サービス API アクセスがオンになっているアプリだけです。

コーディングエージェントのセットアップ

difyctl スキルは、コーディングエージェントに difyctl の使い方を教えます。使用するコーディングエージェントごとに、そのエージェントのスキルフォルダにスキルをインストールします：

# Claude Code
difyctl install skills ~/.claude/skills

# Codex、Cursor、Gemini CLI、GitHub Copilot、OpenCode など、ほとんどのエージェント
difyctl install skills ~/.agents/skills

その他のエージェントの場合は、スキルフォルダの場所をそのエージェントのドキュメントで確認してください。エージェントがスキルを認識しない場合は、再起動してください。

コマンドと API キーの管理

シェルコマンドの実行前に承認を求めるエージェント側の設定は、オンのままにしておいてください。difyctl 自体は、コマンドを実行する前に確認を求めません。スキルは、削除、統合のインストール、アプリの公開を行う前にあなたに確認するよう、エージェントに指示しています。ただし、実際に確認するかどうかは、エージェントが使う AI モデル次第です。

エージェントが確認なしで情報を調べられるようにするには、difyctl get と difyctl describe を許可します。どちらもサーバーからの読み取りしか行いません。

モデルプロバイダーの API キーなど、チャットに入力した内容はすべてエージェントのモデルを経由します。キーをモデルに渡したくない場合は、事前に自分で Dify にキーを追加しておくか、求められた時点で自分で追加するとエージェントに伝えてください。

自分でコマンドを探す方法

作業内容を短い言葉で help に伝えると、一致するコマンドが一覧表示されます。たとえば、アプリを公開するコマンドを探すには、次のように実行します：

difyctl help publish app

一覧から探す場合は、difyctl help を実行します。コマンドへの値の渡し方や、結果に含まれるヒントに従う方法については、コマンドの検索と実行を参照してください。

次のステップ

次の作業は、エージェントに依頼することも、自分で行うこともできます：

トラブルシューティング

メッセージ	対処方法
`only https:// hosts are accepted`	`https://` のアドレスを使う。ローカルの `http://` サーバーでは、`--insecure` を追加する。
`network error calling POST <server>/openapi/v1/oauth/device/code`	サーバーのアドレスとネットワークを確認する。サーバーの証明書を `difyctl` が検証できない場合も、同じエラーで失敗する。自己署名証明書を使うローカルサーバーでは、`--insecure` を追加する。
`this Dify host does not implement the OAuth device flow`	サーバーのアドレスを確認する。アドレスが正しい場合は、サーバーで `OPENAPI_ENABLED` と `ENABLE_OAUTH_BEARER` を `true` に設定する。
ブラウザ：`こちら側で問題が発生しました。しばらくしてからもう一度お試しください。`	サーバーで `ENABLE_OAUTH_BEARER` を `true` に設定する。
`authorization denied`	ブラウザでキャンセルがクリックされた。もう一度 `login` を実行する。
`code expired before authorization`	15 分以内にコードが承認されなかった。もう一度 `login` を実行する。
`OS keychain is unreachable`	`--no-keyring` を付けてサインインし直し、トークンをファイルに保存する。

​前提条件

​インストール

​サインイン

​アプリの一覧表示

​コーディングエージェントのセットアップ

​コマンドと API キーの管理

​自分でコマンドを探す方法

​次のステップ

​トラブルシューティング

前提条件

インストール

サインイン

アプリの一覧表示

コーディングエージェントのセットアップ

コマンドと API キーの管理

自分でコマンドを探す方法

次のステップ

トラブルシューティング