Claude Opus 4.7의 새로운 기능

Claude Opus 4.7은 현재까지 가장 강력한 일반 공개 모델입니다. 높은 자율성을 갖추고 있으며 장기 에이전트 작업, 지식 작업, 비전 작업 및 메모리 작업에서 뛰어난 성능을 발휘합니다. 이 페이지는 출시 시점의 모든 새로운 기능을 요약합니다.

새로운 모델

Claude Opus 4.7은 1M 토큰 컨텍스트 윈도우, 128k 최대 출력 토큰, 적응형 사고 및 Claude Opus 4.6과 동일한 도구 및 플랫폼 기능 세트를 지원합니다.

전체 가격 책정 및 사양은 모델 개요를 참조하세요.

새로운 기능

고해상도 이미지 지원

Claude Opus 4.7은 고해상도 이미지 지원을 갖춘 첫 번째 Claude 모델입니다. 최대 이미지 해상도가 2576px / 3.75MP로 증가했습니다(이전 한계인 1568px / 1.15MP에서 증가). 이 변경은 비전 중심 워크로드의 성능 향상을 가능하게 하며, 컴퓨터 사용 및 스크린샷/아티팩트/문서 이해 워크플로우에 특히 중요합니다.

또한 이미지에 좌표를 매핑하는 것과 같은 작업이 더 간단해졌습니다. 모델의 좌표가 실제 픽셀과 1

고해상도 이미지는 더 많은 토큰을 사용합니다. 추가 이미지 충실도가 불필요한 경우 Claude로 전송하기 전에 이미지를 다운샘플링하여 토큰 사용량 증가를 피하세요.

해상도 외에도 Claude Opus 4.7은 다음 사항에서도 개선되었습니다:

• 저수준 인식 — 포인팅, 측정, 계산 및 유사한 작업.
• 이미지 로컬라이제이션 — 자연 이미지 경계 상자 로컬라이제이션 및 감지가 개선되었습니다.

자세한 내용은 이미지 및 비전을 참조하세요.

새로운 xhigh 노력 수준

노력 매개변수를 사용하면 Claude의 지능과 토큰 지출을 조정하여 기능을 더 빠른 속도와 낮은 비용으로 트레이드오프할 수 있습니다. 코딩 및 에이전트 사용 사례의 경우 새로운 xhigh 노력 수준으로 시작하고, 대부분의 지능 민감 사용 사례의 경우 최소 high 노력을 사용하세요. 수준별 지침은 Claude Opus 4.7을 위한 권장 노력 수준을 참조하세요. (Messages API만 해당; Claude Managed Agents는 노력을 자동으로 처리합니다.)

작업 예산 (베타)

Claude Opus 4.7은 작업 예산을 도입합니다. 작업 예산은 Claude에게 사고, 도구 호출, 도구 결과 및 최종 출력을 포함한 전체 에이전트 루프에 대해 목표로 삼을 토큰 수에 대한 대략적인 추정치를 제공합니다. 모델은 실행 중인 카운트다운을 보고 이를 사용하여 작업의 우선순위를 정하고 예산이 소비될 때 작업을 우아하게 완료합니다. 사용하려면 베타 헤더 task-budgets-2026-03-13을 설정하고 출력 구성에 다음을 추가하세요:

response = client.beta.messages.create(
    model="claude-opus-4-7",
    max_tokens=128000,
    output_config={
        "effort": "high",
        "task_budget": {"type": "tokens", "total": 128000},
    },
    messages=[
        {"role": "user", "content": "Review the codebase and propose a refactor plan."}
    ],
    betas=["task-budgets-2026-03-13"],
)

사용 사례에 따라 다양한 작업 예산을 실험해야 할 수 있습니다. 모델에 주어진 작업에 대해 너무 제한적인 작업 예산이 주어지면 작업을 덜 철저하게 완료하거나 작업을 완전히 거부할 수 있습니다.

품질이 속도보다 중요한 개방형 에이전트 작업의 경우 작업 예산을 설정하지 마세요. 토큰 허용량에 대한 작업 범위를 지정해야 하는 워크로드의 경우 작업 예산을 예약하세요. 작업 예산의 최소값은 20k 토큰입니다.

이것은 하드 캡이 아닙니다. 모델이 인식하는 제안입니다. 이는 생성된 토큰에 대한 하드 요청별 캡인 max_tokens와는 다릅니다(max_tokens는 모델로 전달되지 않으며 모델은 이를 인식하지 못함). task_budget은 전체 에이전트 루프에 걸친 권고 캡입니다. 모델이 자체 조절하기를 원할 때 task_budget을 사용하고, 사용량을 제한하기 위한 하드 요청별 상한으로 max_tokens를 사용하세요.

주요 변경 사항

확장 사고 예산 제거됨

확장 사고 예산은 Claude Opus 4.7에서 제거되었습니다. thinking: {"type": "enabled", "budget_tokens": N}을 설정하면 400 오류가 반환됩니다. 적응형 사고는 유일한 사고 온 모드이며, 내부 평가에서 확장 사고를 안정적으로 능가합니다.

# Before (Opus 4.6)
thinking = {"type": "enabled", "budget_tokens": 32000}

# After (Opus 4.7)
thinking = {"type": "adaptive"}
output_config = {"effort": "high"}

적응형 사고는 Claude Opus 4.7에서 기본적으로 꺼져 있습니다. thinking 필드가 없는 요청은 사고 없이 실행됩니다. 이를 활성화하려면 thinking: {type: "adaptive"}를 명시적으로 설정하세요.

샘플링 매개변수 제거됨

Claude Opus 4.7부터 temperature, top_p 또는 top_k를 기본값이 아닌 값으로 설정하면 400 오류가 반환됩니다. 가장 안전한 마이그레이션 경로는 요청에서 이러한 매개변수를 완전히 생략하고 프롬프팅을 사용하여 모델의 동작을 안내하는 것입니다. 결정론을 위해 temperature = 0을 사용했다면 동일한 출력을 보장한 적이 없다는 점에 유의하세요.

사고 콘텐츠 기본적으로 생략됨

Claude Opus 4.7부터 사고 콘텐츠는 기본적으로 응답에서 생략됩니다. 사고 블록은 여전히 응답 스트림에 나타나지만, 호출자가 명시적으로 옵트인하지 않는 한 해당 thinking 필드는 비어 있습니다. 이는 자동 변경입니다. 오류가 발생하지 않으며 응답 지연 시간이 약간 개선됩니다. 추론 출력이 필요한 경우 display를 "summarized"로 설정하고 한 줄 변경으로 다시 옵트인할 수 있습니다:

thinking = {
    "type": "adaptive",
    "display": "summarized",  # or "omitted" (default)
}

업데이트된 토큰 계산

Claude Opus 4.7은 새로운 토크나이저를 사용하여 광범위한 작업에서 성능 향상에 기여합니다. 이 새로운 토크나이저는 이전 모델과 비교하여 텍스트를 처리할 때 대략 1배에서 1.35배의 토큰을 사용할 수 있습니다(콘텐츠에 따라 최대 약 35% 더 많음). /v1/messages/count_tokens은 Claude Opus 4.7에 대해 Claude Opus 4.6과 다른 토큰 수를 반환합니다. Claude Opus 4.7의 토큰 효율성은 워크로드 형태에 따라 달라질 수 있습니다. 프롬프팅 개입, task_budget 및 effort는 비용을 제어하고 적절한 토큰 사용을 보장하는 데 도움이 될 수 있습니다. 이러한 제어가 모델 지능을 트레이드오프할 수 있다는 점을 명심하세요.

압축 트리거를 포함하여 추가 여유를 제공하도록 max_tokens 매개변수를 업데이트하는 것을 권장합니다. Claude Opus 4.7은 장기 컨텍스트 프리미엄 없이 표준 API 가격으로 1M 컨텍스트 윈도우를 제공합니다.

기능 개선

지식 작업

Claude Opus 4.7은 지식 근로자 작업, 특히 모델이 자신의 출력을 시각적으로 확인해야 하는 경우에 의미 있는 향상을 보여줍니다:

• .docx 교정 및 .pptx 편집 — 추적 변경 및 슬라이드 레이아웃을 생성하고 자체 확인하는 데 개선되었습니다.
• 차트 및 그림 분석 — 차트 및 그림을 분석하기 위해 이미지 처리 라이브러리(예: PIL)를 사용한 프로그래밍 방식의 도구 호출에서 개선되었습니다(픽셀 수준 데이터 전사 포함).

기존 프롬프트가 이러한 영역에 완화 조치를 포함하는 경우(예: "반환하기 전에 슬라이드 레이아웃을 다시 확인하세요"), 해당 스캐폴딩을 제거하고 다시 기준을 설정해 보세요.

메모리

Claude Opus 4.7은 파일 시스템 기반 메모리를 작성하고 사용하는 데 더 능숙합니다. 에이전트가 여러 턴에 걸쳐 스크래치패드, 메모 파일 또는 구조화된 메모리 저장소를 유지하는 경우 해당 에이전트는 자신에게 메모를 적어두고 향후 작업에서 메모를 활용하는 데 개선되어야 합니다. 자신의 메모리를 구축하지 않고 Claude에게 관리되는 스크래치패드를 제공하려면 클라이언트 측 메모리 도구를 사용하세요.

비전

위의 고해상도 이미지 지원을 참조하세요.

동작 변경 사항

이는 API 주요 변경 사항이 아니지만 프롬프트 업데이트가 필요할 수 있습니다. 전체 지침은 Claude Opus 4.7로 마이그레이션을 참조하세요.

• 더 문자 그대로의 명령 따르기, 특히 낮은 노력 수준에서. 모델은 한 항목에서 다른 항목으로 명령을 자동으로 일반화하지 않으며 하지 않은 요청을 추론하지 않습니다.
• 응답 길이가 고정 장황함이 아닌 인식된 작업 복잡도에 맞춰집니다.
• 기본적으로 더 적은 도구 호출, 더 많은 추론을 사용합니다. 노력을 높이면 도구 사용이 증가합니다.
• 더 직접적이고 의견이 있는 톤 Claude Opus 4.6의 더 따뜻한 스타일보다 검증 중심 표현과 이모지가 적습니다.
• 장기 에이전트 추적 전체에 걸쳐 더 정기적인 진행 상황 업데이트. 임시 상태 메시지를 강제하기 위해 스캐폴딩을 추가한 경우 제거해 보세요.
• 기본적으로 더 적은 서브에이전트가 생성됩니다. 프롬프팅을 통해 조종 가능합니다.
• 실시간 사이버보안 보호: 금지되거나 높은 위험의 주제와 관련된 요청은 거부로 이어질 수 있습니다. 합법적인 보안 작업의 경우 사이버 검증 프로그램에 신청하세요.

마이그레이션 가이드

단계별 마이그레이션 지침 및 전체 마이그레이션 체크리스트는 Claude Opus 4.7로 마이그레이션을 참조하세요. Claude Code 또는 Agent SDK를 사용하는 경우 Claude API 스킬이 코드베이스에 이러한 마이그레이션 단계를 자동으로 적용할 수 있습니다.

다음 단계