LLM Wiki

Anthropic이 공개한 Claude Opus 5 프롬프트 작성법 및 Opus 4.8 마이그레이션 가이드

Properties2
descriptionPyTorchKR 9bow 게시글의 핵심 내용과 실무적 의미를 원문에 근거해 정리한다.
tagsai-models, open-source, research

6 min read

출처

개요

Anthropic은 Claude Opus 5의 동작 특성에 맞춘 공식 프롬프트 가이드와 Claude Opus 4.8에서의 마이그레이션 가이드를 공개했습니다. 핵심은 이전 모델에서 필요했던 지시를 그대로 유지하기보다, Opus 5가 이미 수행하는 검증·자기 교정·작업 조율 지시를 제거하는 것입니다. Opus 5는 응답과 파일 산출물이 더 길어질 수 있으므로, 출력 분량은 effort가 아니라 프롬프트로 직접 제한해야 합니다. 또한 서브에이전트 위임이 늘어날 수 있어 독립적이고 큰 작업에만 사용하도록 상한을 두는 것이 권장됩니다. Opus 4.8에서 마이그레이션할 때는 사고(thinking)의 기본 활성화와 thinking·effort 조합 변경으로 인한 비용 및 출력 잘림 가능성을 점검해야 합니다.

핵심 포인트

  • 응답 분량은 프롬프트로 제어: effort는 사고량을 조절할 뿐 최종 응답 길이를 직접 줄이지 않으므로, 간결성·문서 분량·에이전트 중계 빈도를 프롬프트에 명시해야 합니다.
  • 레거시 검증 지시 제거: Opus 5는 자체적으로 작업을 검증하고 자기 교정을 수행하므로, 반복적인 최종 검증이나 재확인 지시는 품질 향상 없이 토큰과 시간을 늘릴 수 있습니다.
  • 작업 범위를 명확히 제한: 모델이 요청하지 않은 단계까지 작업을 확장하거나 반대로 임의로 축소할 수 있으므로, 요청된 범위 전체를 완료하되 명백히 범위를 벗어난 작업은 하지 않도록 지시해야 합니다.
  • 서브에이전트 사용에 상한 설정: 여러 파일에 걸친 독립적·병렬적인 대규모 작업에는 위임할 수 있지만, 몇 번의 도구 호출로 끝낼 수 있는 작업이나 자기 검증에는 사용하지 않는 것이 권장됩니다. 하니스 수준에서 스폰 수를 제한하는 방법도 제시됩니다.
  • 낮은 effort의 활용: low와 medium은 높은 설정에 비해 토큰과 지연 시간을 줄이면서도 실용적인 품질을 제공할 수 있으므로, 자체 평가셋을 기준으로 다시 조정해야 합니다.
  • 사고(thinking)는 가능하면 활성화: 사고를 끄면 도구 호출이 텍스트로 노출되거나 내부 XML 태그가 응답에 섞이는 문제가 발생할 수 있습니다. 문서는 비슷한 비용이라면 사고를 켜고 낮은 effort를 사용하는 방식을 우선 제안합니다.
  • 마이그레이션 시 API 동작 점검: Opus 5에서는 thinking을 지정하지 않아도 적응형 사고가 기본 활성화됩니다. max_tokens가 사고와 응답을 합친 총 출력 한도이므로 기존 설정에서 응답이 잘릴 수 있으며, 사고를 끄면서 effort를 xhigh 또는 max로 설정하면 400 오류가 발생합니다.

왜 중요한가

모델 교체가 단순히 모델 ID만 바꾸는 작업으로 끝나지 않고, 기존 프롬프트와 에이전트 하니스의 동작 가정까지 재검토해야 한다는 점을 보여 줍니다. 특히 과거 모델의 부족한 자기 검증이나 낮은 위임 성향을 보완하기 위해 추가했던 지시가 Opus 5에서는 과잉 검증과 불필요한 서브에이전트 실행으로 이어질 수 있습니다. 따라서 마이그레이션 전후로 출력 길이, 토큰 비용, max_tokens, 사고 설정, 서브에이전트 스폰 수를 자체 평가셋과 실제 워크로드로 다시 측정하는 것이 필요합니다.

후속 링크 및 키워드

관련 위키

원문 보존 위치

원문 전체는 raw source: 2026-07-28-pytorchkr-topic-11439-anthropic-claude-opus-5-opus-4-8에 source_url 및 HTML 원문과 함께 저장되어 있습니다.