Anthropic Claude - 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