Dify を CodeNodex に接続する：OpenAI 互換モデルの設定

Dify はワークスペースの Model Provider でモデルの認証情報を管理します。CodeNodex CLI に dify クライアントモードはないため、このページでは存在しないワンクリック設定を案内せず、Dify の管理画面で手動設定します。

OpenAI グループの API キー、API Endpoint https://token.codenodex.com/v1、実際のモデル ID を準備します。セルフホスト版 Dify では、コンテナネットワークからこの HTTPS アドレスへ接続できることも確認します。

Workspace Settings の Model Providers を開き、OpenAI API-compatible provider をインストールまたは選択します。Dify やプラグインのバージョンによってメニュー名は変わる場合がありますが、重要な項目は endpoint、API key、model です。

Endpoint には個別 API の URL ではなく、プロトコルのルートパスを入力します。モデルタイプは LLM または Chat Model を選択し、モデル一覧の返却値を Model Name に設定します。

温度、最大出力、コンテキスト長は、実際のモデル機能に合わせます。不明な場合は Dify の既定値から始め、誤った手動上限でレスポンスを切り詰めないようにします。

関数呼び出し、構造化出力、マルチモーダル対応は、OpenAI Compatible という表示だけでは判断できません。対象モデルと現在のゲートウェイプロトコルで個別に検証してから、ワークフローノードで使用してください。

ユーザー入力と LLM ノードだけを含むテストアプリを作成し、追加したモデルを選択して短い質問を 1 回実行します。最初からナレッジベース、Agent ツール、複雑な変数を追加しないでください。

Dify の実行ログでモデル名、所要時間、エラーコードを確認し、CodeNodex の使用量記録と照合します。その後、ストリーミング、ナレッジベース、ツール呼び出しを 1 つずつ追加します。

401 では API キー、404 では Endpoint に /v1 が重複していないか、Model Name が存在するかを確認します。429 では残高と同時実行数、接続タイムアウトでは Dify コンテナ内部から DNS、TLS、外部ネットワークを確認します。

認証情報の検証は成功するのにアプリが失敗する場合は、該当ノードのログを確認します。ワークフロー変数、出力パーサー、ツール呼び出しのエラーを provider の Base URL 変更で解決しないでください。