Claude Opus 4.7 새로운 파라미터 가이드

이 글에서는 Claude Opus 4.7의 추론 제어와 관련된 두 가지 주요 변경 사항을 다루며, AIHubmix 네이티브 API와 Chat 통합 인터페이스 모두에 대한 완전한 사용 방법을 함께 설명합니다. 참고: Anthropic 공식 발표 및 모델 변경 로그.

AIHubMix3분 분량
Claude Opus 4.7 새로운 파라미터 가이드

​1. 새로운 추론 제어 기능

​✦ 새로운 xhigh 추론 노력 수준

새로운 xhigh 수준은 high와 max 사이에 위치하며, 특히 코딩 및 에이전틱 작업을 위해 설계되어 성능과 효율성 간에 더 나은 균형을 제공합니다.

low  ──  medium  ──  high  ──  xhigh ★NEW  ──  max

​✦ 기본적으로 숨겨지는 사고 내용

스트리밍 응답에서 사고 과정은 더 이상 기본적으로 표시되지 않습니다. 추론 요약을 받으려면 요청에 display 필드를 명시적으로 전달하세요:

display 값Opus 4.7Opus 4.6동작
”omitted”기본값기본값 아님사고 블록 내용이 비어 있음
”summarized”수동으로 설정해야 함기본값사고 요약 텍스트를 반환함
"reasoning": {
  "effort": "xhigh",
  "display": "summarized"
}
그림: Opus 4.7 새로운 xhigh 수준 — 에이전틱 코딩 성능 비교 (출처: Anthropic 공식)
Image

​2. Claude 네이티브 API 참조

​Anthropic 네이티브 API의 effort 값은 공식 사양과 일치합니다:

effort 값지원 모델설명권장 사용 사례
low지원되는 모든 모델적당한 성능 트레이드오프로 상당한 토큰 절약간단한 작업, 고동시성 요청, 서브 에이전트
medium지원되는 모든 모델적당한 토큰 절약을 제공하는 균형 모드일반적인 에이전틱 작업
high지원되는 모든 모델기본값; 높은 성능복잡한 추론, 코딩, 에이전틱 작업
xhigh (신규)Opus 4.7 전용high와 max 사이의 확장된 성능; 장기 작업(long-horizon tasks)에 탁월함코딩 및 에이전틱 작업의 권장 시작점
maxOpus 시리즈최대 성능최첨단 연구 문제

​AIHubmix Claude 네이티브 API — Opus 4.7 예시

from anthropic import Anthropic

client = Anthropic(
    api_key="<AIHUBMIX_API_KEY>",
    base_url="https://aihubmix.com"
)

response = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    output_config={"effort": "xhigh"},  # Options: low / medium / high / xhigh / max
    messages=[
        {
            "role": "user",
            "content": "A snail is at the bottom of a 10-meter well. Each day it climbs 3 meters, but each night it slides back 2 meters. How many days does it take to reach the top?"
        }
    ]
)

print(response.content[-1].text)

​3. AIHubmix Chat 통합 인터페이스의 추론 노력 지원

AIHubMix Chat 통합 인터페이스는 OpenAI 사양과 일치하며, reasoning.effort를 통해 추론 강도를 제어합니다. 서로 다른 Claude 모델은 해당 effort 수준으로 자동 매핑됩니다:

​reasoning_effort (Claude 모델의 추론 강도 제어)

effort 값Opus >=4.7 (신규)Opus 4.6 / 4.5Sonnet 4.6
minimallowlowlow
mediummediummediummedium
highhighhighhigh
xhighxhighmaxhigh
maxmaxmaxhigh

참고: xhigh는 Opus 4.7에서만 네이티브로 지원됩니다. 다른 Opus 모델은 자동으로 max로 대체되며, Sonnet 시리즈는 high로 대체됩니다.

​Chat 통합 인터페이스 — Opus 4.7 예시

from openai import OpenAI

client = OpenAI(
    base_url="https://aihubmix.com/v1",
    api_key="<AIHUBMIX_API_KEY>",
)

completion = client.chat.completions.create(
    model="claude-opus-4-7",
    # max_tokens=10000,  # Default is 4096; enable for longer outputs
    messages=[
        {
            "role": "user",
            "content": "A snail is at the bottom of a 10-meter well. Each day it climbs 3 meters, but each night it slides back 2 meters. How many days does it take to reach the top?"
        }
    ],
    extra_body={
        "reasoning": {"effort": "xhigh"}
    }
)

print(completion.choices[0].message.content)

​4. Chat 통합 인터페이스에서 사고 내용 제어

OpenAI 호환 인터페이스에서 reasoning은 사고 요약 반환 여부를 제어하는 display 필드를 지원합니다. Claude Opus 4.7은 기본적으로 사고 내용을 반환하지 않습니다. 이를 활성화하려면 "display": "summarized" 을 설정하세요.

필드값설명
display(생략)사고 내용을 반환하지 않음 (기본값)
display"summarized"사고 요약을 반환함

​Opus 4.7 — 사고 요약 예시

from openai import OpenAI

client = OpenAI(
    base_url="https://aihubmix.com/v1",
    api_key="<AIHUBMIX_API_KEY>",
)

completion = client.chat.completions.create(
    model="claude-opus-4-7",
    messages=[
        {
            "role": "user",
            "content": "A snail is at the bottom of a 10-meter well. Each day it climbs 3 meters, but each night it slides back 2 meters. How many days does it take to reach the top?"
        }
    ],
    extra_body={
        "reasoning": {"effort": "xhigh", "display": "summarized"}
    }
)

print(completion.choices[0].message.content)

​자세한 내용은 AIHubmix 문서 또는 Anthropic 공식 문서를 참고하세요.

최종 업데이트: 2026-06-01