ClaudeNode - ComfyUI Built-in Node Documentation

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

输入

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

参数	描述	数据类型	必填	范围
`model`	用于生成回复的 Claude 模型。选择模型后会在下方显示模型专属设置。	DYNAMIC_COMBO	是	`"Opus 5.5"` `"Opus 5"` `"Opus 4.8"` `"Fable 5.1"` `"Fable 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

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

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

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

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

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

参数	描述	数据类型	必填	范围
`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"。

此模型不提供 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 images

图像限制： 每次请求最多可提供 20 张图像。连接超过 20 张图像会引发错误。
prompt 必填： prompt 必须至少包含一个非空白字符。空提示词会引发验证错误。
温度处理： 启用思考时，Anthropic API 要求不设置 temperature（默认为 1.0）。Opus 5.5、Opus 5、Opus 4.8、Fable 5.1、Fable 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。
安全拒绝： 如果 Claude 出于安全原因拒绝回答请求，节点会引发错误，要求你重新表述提示词或尝试其他模型。
输出文本： 思考与推理块不会包含在输出中；仅返回生成的文本。

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

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

Source fingerprint (SHA-256): f6d9353025598bbed1aca7bdeb56ac59f5e4c26dd5b8e29359e97ef29e35bee7