ClaudeNode - ComfyUI Built-in Node Documentation

从 Anthropic 的 Claude 模型生成文本回复。

从 Anthropic 的 Claude 模型生成文本回复。提供文本提示词，并可选地提供一张或多张图像作为多模态上下文，节点将返回模型生成的文本回复。

​

输入

输入分为通用设置、选择模型后出现的模型专属设置，以及可选的参考图像。

​

通用输入

参数	描述	数据类型	必填	取值范围
model	用于生成回复的 Claude 模型。选择模型后会显示下方的模型专属设置。	DYNAMIC_COMBO	是	"Opus 5.5" "Opus 5" "Opus 4.8" "Fable 5.1" "Fable 5" "Sonnet 5.5" "Sonnet 5" "Opus 4.7" "Opus 4.6" "Sonnet 4.6" "Sonnet 4.5" "Haiku 4.5"
prompt	输入给模型的文本。（默认值：空字符串）	STRING	是	N/A
seed	seed 用于控制节点是否重新运行；无论 seed 取何值，结果都是非确定性的。（默认值：0）	INT	是	0 到 2147483647
system_prompt	决定模型行为的基础指令。（默认值：空字符串）	STRING	否	N/A

​

Opus 5.5、Opus 5、Fable 5.1 和 Fable 5 输入

这四种模型共享相同的设置。它们不提供 temperature 设置，并且始终启用推理。

参数	描述	数据类型	必填	取值范围
max_tokens	生成的最大 token 数（启用时包含推理 token）。（默认值：32768）	INT	是	1024 到 64000 (Opus 5.5) 4096 到 64000 (Opus 5, Fable 5.1, Fable 5)
reasoning_effort	扩展思考强度。此模型始终启用推理。（默认值：“high”）	COMBO	是	"low" "medium" "high" "xhigh" "max"

​

Opus 4.8、Sonnet 5.5 和 Sonnet 5 输入

这三种模型共享相同的设置。它们不提供 temperature 设置。

参数	描述	数据类型	必填	取值范围
max_tokens	生成的最大 token 数（启用时包含推理 token）。（默认值：32768）	INT	是	1024 到 64000 (Sonnet 5.5) 4096 到 64000 (Opus 4.8, Sonnet 5)
reasoning_effort	扩展思考强度。"off" 表示禁用推理。（默认值：“off”）	COMBO	是	"off" "low" "medium" "high" "xhigh" "max"

​

Opus 4.7、Opus 4.6、Sonnet 4.6 和 Sonnet 4.5 输入

这四种模型共享相同的设置。

参数	描述	数据类型	必填	取值范围
max_tokens	生成的最大 token 数（启用时包含推理 token）。（默认值：32768）	INT	是	4096 到 64000
temperature	控制随机性。0.0 为确定性输出，1.0 为最随机。对于 Opus 4.7 以及任何设置了 reasoning_effort 的模型，此参数会被忽略。（默认值：1.0）	FLOAT	是	0.0 到 1.0（步长：0.01）
reasoning_effort	扩展思考强度。"off" 表示禁用推理。（默认值：“off”）	COMBO	是	"off" "low" "medium" "high"

这四种模型上的 reasoning_effort 均提供 "off"、"low"、"medium" 和 "high"。Opus 4.7、Opus 4.6 和 Sonnet 4.6 还额外接受 "max"，而 Opus 4.7 还接受 "xhigh"。

​

Haiku 4.5 输入

此模型不提供 reasoning_effort 设置。

参数	描述	数据类型	必填	取值范围
max_tokens	生成的最大 token 数（启用时包含推理 token）。（默认值：32768）	INT	是	4096 到 64000
temperature	控制随机性。0.0 为确定性输出，1.0 为最随机。对于 Opus 4.7 以及任何设置了 reasoning_effort 的模型，此参数会被忽略。（默认值：1.0）	FLOAT	是	0.0 到 1.0（步长：0.01）

​

参考输入

参数	描述	数据类型	必填	取值范围
images	可选的图像，用作模型的上下文。最多 20 张图像。可扩展插槽：连接 1 到 20 个项目（image_1 … image_20）。	IMAGE	否	0 到 20 张图像

​

参数约束

• 图像数量限制： 每次请求最多可提供 20 张图像。连接超过 20 张图像会引发错误。
• 提示词必填： prompt 必须至少包含一个非空白字符。空的提示词会引发验证错误。
• temperature 处理： 当启用思考时，Anthropic API 要求不设置 temperature（其默认值为 1.0）。Opus 5.5、Opus 5、Opus 4.8、Fable 5.1、Fable 5、Sonnet 5.5 和 Sonnet 5 不提供 temperature 设置。Opus 4.7 会忽略 temperature，任何将 reasoning_effort 设置为 "off" 以外值的模型也会忽略它。
• 推理/思考行为： reasoning_effort 设置用于控制是否启用思考。Opus 5.5、Opus 5、Fable 5.1 和 Fable 5 始终启用推理。Haiku 4.5 不支持推理。当启用思考时，节点会为所选模型使用相应的思考模式，即自适应模式或基于预算的模式。在预算模式下，推理 token 预算会被限制，以确保为实际回复至少保留 1024 个 token。当 Sonnet 5.5 上的 reasoning_effort 为 "off" 时，请求会使用 between_tools 思考而非禁用思考，因此回复中仍然不包含推理内容。
• max_tokens 最小值： Opus 5.5 和 Sonnet 5.5 上的 max_tokens 可接受从 1024 开始的值，其他所有模型则从 4096 开始。
• 安全拒绝： 如果 Claude 出于安全原因拒绝回答该请求，节点会引发错误，提示你改写提示词或尝试其他模型。
• 输出文本： 思考和推理块不会包含在输出中；仅返回生成的文本。

​

输出

输出名称	描述	数据类型
output	Claude 模型生成的文本回复。不包含思考/推理块。如果未生成任何文本，则返回 “Empty response from Claude model.”。	STRING

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ 在 GitHub 上编辑

---

Source fingerprint (SHA-256): 35b737da0f4c3a9da72910bf2053b18ae6a5c60989dc9607b61037623bc94e38