> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ClaudeNode - ComfyUI Built-in Node Documentation

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

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

## 输入

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

### 通用输入

| 参数 | 描述 | 数据类型 | 必填 | 取值范围 |
| - | - | - | - | - |
| `model` | 用于生成回复的 Claude 模型。选择模型后会显示下方的模型专属设置。 | DYNAMIC\_COMBO | 是 | `"Opus 5.5"`<br />`"Opus 5"`<br />`"Opus 4.8"`<br />`"Fable 5.1"`<br />`"Fable 5"`<br />`"Sonnet 5.5"`<br />`"Sonnet 5"`<br />`"Opus 4.7"`<br />`"Opus 4.6"`<br />`"Sonnet 4.6"`<br />`"Sonnet 4.5"`<br />`"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)<br />4096 到 64000 (Opus 5, Fable 5.1, Fable 5) |
| `reasoning_effort` | 扩展思考强度。此模型始终启用推理。（默认值："high"） | COMBO | 是 | `"low"`<br />`"medium"`<br />`"high"`<br />`"xhigh"`<br />`"max"` |

### Opus 4.8、Sonnet 5.5 和 Sonnet 5 输入

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

| 参数 | 描述 | 数据类型 | 必填 | 取值范围 |
| - | - | - | - | - |
| `max_tokens` | 生成的最大 token 数（启用时包含推理 token）。（默认值：32768） | INT | 是 | 1024 到 64000 (Sonnet 5.5)<br />4096 到 64000 (Opus 4.8, Sonnet 5) |
| `reasoning_effort` | 扩展思考强度。`"off"` 表示禁用推理。（默认值："off"） | COMBO | 是 | `"off"`<br />`"low"`<br />`"medium"`<br />`"high"`<br />`"xhigh"`<br />`"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"`<br />`"low"`<br />`"medium"`<br />`"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 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ClaudeNode/zh.md)

***

**Source fingerprint (SHA-256):** `35b737da0f4c3a9da72910bf2053b18ae6a5c60989dc9607b61037623bc94e38`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.