Claude 매개변수 및 프로토콜 차이

호환 프로토콜에서 Claude 모델의 매개변수 차이와 사용 방법을 알아봅니다.

Claude 원본은 Messages입니다. Chat Completions는 아래 Anthropic 공식 호환 제한을 참고하며 플랫폼 변환은 선택한 모델 입구에 따릅니다.

대상 모델

모델	추론 기본값과 스위치
claude-haiku-5-5	기본 켬, 강도 `medium`. `low/medium/high`에서만 `disabled`로 해제 가능
claude-sonnet-5-5	기본 켬, 강도 `high`. `disabled` 거부, `low/medium/high`에서 `between_tools`으로 답변 전 추론 해제
claude-opus-5-5	기본 켬, 강도 `medium`, 해제 불가
claude-fable-5-1	기본 켬, 강도 `high`, 해제 불가
claude-opus-5	기본 켬, 강도 `high`. `low/medium/high`에서만 `disabled`로 해제 가능
claude-sonnet-5	기본 켬, 강도 `high`, `disabled`로 해제
claude-fable-5	기본 켬, 강도 `high`, 해제 불가
claude-opus-4-8	기본 꺼짐, 강도 `high`, `adaptive`로 켬

Messages 차이

필드	차이 설명
`thinking.type`	여덟 모두 `adaptive` 지원, 이전 `enabled`, `budget_tokens` 거부. 해제는 위 표, `disabled`을 모두에 적용하지 않음
`between_tools`	Sonnet 5.5만. 답변 전 추론 해제, 도구 간 진행은 `thinking` 블록. 객체는 `type`만 가능, `display`, `budget_tokens` 금지
`output_config.effort`	여덟 모두 `low/medium/high/xhigh/max`, 기본값 위 표. `adaptive`은 유형이지 강도 아님. `max_tokens`는 추론과 답변 총합
`thinking.display`	추론 시 여덟 모두 기본 `omitted`, 빈 추론과 `signature` 반환. 읽는 요약은 `summarized`, 빈 텍스트가 무추론 의미 아님
`tool_choice`	Opus 5.5, Sonnet 5.5, Fable 5.1은 `any`과 `tool` 지정 거부, `auto/none` 사용. 나머지 다섯은 강제 가능하지만 해당 추론 생략. Fable 5는 Fable 5.1 제한 아님
추론 이력과 서명	도구 후 빈 텍스트 포함 이전 `thinking/redacted_thinking` 및 도구 블록 모두 재전송, 서명 편집/재정렬/재생성 금지. Haiku 5.5, Sonnet 5.5, Opus 5.5, Fable 5.1은 원래 system/도구/이력도 검증하므로 수정 후 기존 추론을 바로 재사용하지 않음
assistant 사전 채우기	여덟 모두 마지막 미완성 assistant는 `400`. 출력 제약은 지시 또는 `output_config.format`
`temperature/top_p/top_k`	예제에서 생략. `2023-06-01`도 새 모델 제한 적용. `2026-10-21`에서는 어느 모델이든 하나만 보내도 `400`, 버전 변경이 사용자 샘플링 복원은 아님
Computer 도구 버전	Claude API에서 Haiku 5.5, Sonnet 5.5, Opus 5.5는 `computer_toolset_20260801`, 기존 유형은 불가. 다른 클라우드는 공식 규칙 참고

공식 Chat 호환 차이

Anthropic OpenAI SDK 호환층 규칙이며 원본 Messages와 구분됩니다. 모든 플랫폼 채널의 변환이 같다는 뜻은 아닙니다.

필드	차이 설명
`n`	`1`만 허용
`reasoning_effort`	무시, 강도/추론 읽기는 Messages `output_config.effort`
`response_format`, `tools[].function.strict`	무시, 원본 구조화 출력/엄격 도구 검증 활성화 안 함
`presence_penalty/frequency_penalty/logit_bias/seed`	무시, 해당 샘플링 제어 없음
`logprobs/top_logprobs`	무시, 토큰 확률 반환 안 함
`system/developer`	시작 system에 줄바꿈으로 병합, 대화 중 원래 위치 유지 안 함
`tool_choice`	`required` 및 함수 지정도 위 세 모델의 강제 제한 적용
캐시 및 기타 설정	원본 캐시 설정 없음. `store/service_tier/metadata/prediction/user/audio/modalities` 등 무시, 같은 이름의 기능 활성화 안 함

캐시 차이

필드	차이 설명
`cache_control`	Messages `type: ephemeral`, 최상위 자동 또는 블록 명시, 최대 네 중단점
`ttl`	기본 `5m`, 선택 `1h`, Chat의 `prompt_cache_options` 아님
캐시 접두사 최소	Haiku 5.5, Sonnet 5.5, Opus 5.5, Fable 5.1, Opus 5, Fable 5는 입력 `512` 토큰. Sonnet 5, Opus 4.8은 `1024`. 동일 접두사 필요, 기준 미만 기록 안 함
추론 블록	`thinking` 직접 표시 불가, 재전송한 추론은 이전 assistant 일부로 캐시 가능
캐시 사용량	`usage.cache_creation_input_tokens`, `usage.cache_read_input_tokens`로 쓰기/읽기 확인, 설정만으로 적중 아님

미디어 입력 차이

입력	프로토콜 블록	차이 설명
이미지	Messages `image`	`source`에서 URL / Base64, Chat `image_url` 아님
문서	Messages `document`	원본 문서 구조를 user에, assistant는 금지
이미지	Chat `image_url`	공식 호환층은 `image_url.url` 읽고 `detail` 무시
파일	Chat `file`	공식층은 입력 무시, 원본 문서 기능과 다름
음성	Chat `input_audio`	공식층은 입력 무시, 원본 음성 기능 없음

호출 예제

MODEL_ID을 전체 ID로 바꾸세요. Messages는 적응형 추론과 요약 명시, Chat은 기본 텍스트입니다.

curl 'https://api.agtcloud.ai/v1/messages' \
  -H 'x-api-key: your-api-key' \
  -H 'anthropic-version: 2023-06-01' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "API 시간 초과 진단 방법을 세 가지로 설명하세요"}],
    "max_tokens": 4096,
    "thinking": {"type": "adaptive", "display": "summarized"},
    "output_config": {"effort": "medium"}
  }'