> ## 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 모델에서 텍스트 응답을 생성합니다. 텍스트 프롬프트와 선택적으로 멀티모달 컨텍스트를 위한 하나 이상의 이미지를 제공하면, 노드가 모델이 생성한 텍스트 응답을 반환합니다.

## 입력

입력은 공통 설정, 모델을 선택할 때 나타나는 모델별 설정, 선택적 참조 이미지로 그룹화됩니다.

### 공통 입력

| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 |
| - | - | - | - | - |
| `모델` | 응답 생성에 사용되는 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"` |
| `프롬프트` | 모델에 대한 텍스트 입력입니다. (기본값: 빈 문자열) | STRING | 예 | N/A |
| `시드` | `seed`는 노드를 다시 실행할지 여부를 제어합니다. 시드와 관계없이 결과는 비결정적입니다. (기본값: 0) | INT | 예 | 0  \~  2147483647 |
| `시스템 프롬프트` | 모델의 동작을 규정하는 기본 지침입니다. (기본값: 빈 문자열) | STRING | 아니요 | N/A |

### Opus 5.5, Opus 5, Fable 5.1 및 Fable 5 입력

이 네 모델은 동일한 설정을 공유합니다. 이 모델들은 `temperature` 설정을 노출하지 않으며, 추론(reasoning)이 항상 활성화됩니다.

| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 |
| - | - | - | - | - |
| `max_tokens` | 생성할 최대 토큰 수입니다(활성화된 경우 추론 토큰 포함). (기본값: 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` | 생성할 최대 토큰 수입니다(활성화된 경우 추론 토큰 포함). (기본값: 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` | 생성할 최대 토큰 수입니다(활성화된 경우 추론 토큰 포함). (기본값: 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` | 생성할 최대 토큰 수입니다(활성화된 경우 추론 토큰 포함). (기본값: 32768) | INT | 예 | 4096  \~  64000 |
| `temperature` | 무작위성을 제어합니다. 0.0은 결정적이며, 1.0은 가장 무작위합니다. Opus 4.7 및 `reasoning_effort`가 설정된 모든 모델에서는 무시됩니다. (기본값: 1.0) | FLOAT | 예 | 0.0  \~  1.0 (단계: 0.01) |

### 참조 입력

| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 |
| - | - | - | - | - |
| `이미지` | 모델에 대한 컨텍스트로 사용할 선택적 이미지입니다. 최대 20개 이미지입니다. 확장 가능한 슬롯: 1\~20개 항목(`image_1` ... `image_20`)을 연결합니다. | IMAGE | 아니요 | 0  \~  20개 이미지 |

### 매개변수 제약

* **이미지 제한:** 요청당 최대 20개의 이미지를 제공할 수 있습니다. 20개를 초과하는 이미지를 연결하면 오류가 발생합니다.
* **프롬프트 필수:** 프롬프트에는 공백이 아닌 문자가 하나 이상 포함되어야 합니다. 빈 프롬프트는 유효성 검사 오류를 발생시킵니다.
* **`temperature` 처리:** 사고(thinking)가 활성화되면 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` 설정은 사고(thinking) 활성화 여부를 제어합니다. Opus 5.5, Opus 5, Fable 5.1 및 Fable 5는 추론이 항상 활성화됩니다. Haiku 4.5는 추론을 지원하지 않습니다. 사고가 활성화되면 노드는 선택한 모델에 적합한 사고 모드(적응형 또는 예산 기반)를 사용합니다. 예산 모드에서는 실제 응답을 위해 최소 1024개의 토큰을 남기도록 추론 토큰 예산이 제한됩니다. Sonnet 5.5에서 `reasoning_effort`가 `"off"`이면 요청은 비활성화된 사고 대신 `between_tools` 사고를 사용하므로, 응답에는 여전히 추론이 포함되지 않습니다.
* **`max_tokens` 최솟값:** `max_tokens`는 Opus 5.5 및 Sonnet 5.5에서 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/ko.md)

***

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


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