直接答案
把 CodeNodex 作为 OpenAI 兼容模型供应方加入 Dify，并分别验证 provider 凭据、模型能力和应用运行结果。
这篇内容解决什么问题
解决 Dify 中 OpenAI Compatible provider 的安装和字段填写问题，并明确 Dify 不属于 CodeNodex CLI 的 `--client` 支持范围。
准备 Dify 工作区与模型信息
Dify 通过工作区的 Model Provider 管理模型凭据。CodeNodex CLI 没有 dify 客户端模式，因此本页使用 Dify 后台手动配置，不提供伪造的一键命令。
准备 OpenAI 分组 API Key、API Endpoint https://token.codenodex.com/v1 和真实模型 ID。自托管 Dify 还要确保容器网络可以访问该 HTTPS 地址。
curl --fail-with-body "https://token.codenodex.com/v1/models" -H "Authorization: Bearer YOUR_API_KEY"添加 OpenAI API-compatible Provider
进入 Workspace Settings 的 Model Providers，安装或打开 OpenAI API-compatible provider。Dify 的具体菜单名称可能随版本和插件更新变化，但核心字段仍是 endpoint、API key 和 model。
Endpoint 填协议根路径，不要填写单个接口 URL。模型类型选择 LLM 或 Chat Model，并按模型列表返回值填写 Model Name。
- 01打开 Provider进入工作区 Model Providers，选择 OpenAI API-compatible。
- 02保存凭据Endpoint 填
https://token.codenodex.com/v1，API Key 填 CodeNodex Key。 - 03添加模型Model Name 使用
/models返回的精确 ID，Model Type 选择 LLM。 - 04执行校验使用 Dify 的凭据校验；失败时保留 HTTP 状态码。
设置模型能力与参数边界
温度、最大输出和上下文长度应以实际模型能力为准。无法确认时先使用 Dify 默认值，避免用错误的手工上限截断响应。
函数调用、结构化输出和多模态能力不能仅凭 OpenAI Compatible 标签推断。应在目标模型和当前网关协议上分别验证，再用于工作流节点。
在最小 Dify 应用中验证
新建一个只包含用户输入和 LLM 节点的测试应用，选择刚添加的模型，用短问题运行一次。先不要加入知识库、Agent 工具或复杂变量。
确认 Dify 运行日志中的模型名称、耗时和错误码，再核对 CodeNodex 用量记录。随后再逐项增加流式输出、知识库和工具调用。
- Provider 凭据校验通过。
- 最小 LLM 节点返回完整文本。
- Dify 日志与 CodeNodex 用量记录时间一致。
- 复杂能力按需逐项启用并回归。
排查凭据校验和运行错误
401 检查 API Key；404 检查 Endpoint 是否重复 /v1 或 Model Name 不存在；429 检查余额和并发；连接超时则从 Dify 容器内部测试 DNS、TLS 和出口网络。
凭据校验成功但应用失败时，查看具体节点日志。工作流变量、输出解析器和工具调用错误不应通过修改 provider Base URL 解决。
官方来源与核验范围
本文以公开官方文档为事实依据；命令和配置可能随客户端版本变化，执行前请同时核对对应来源。
查看技术核验方法