Anthropic, Claude Opus 5.5 프롬프트 가이드 공개… Effort 기본값 'medium' 변경

Anthropic이 Claude Opus 5.5용 프롬프트 가이드를 공개했다. Effort 조정, Thinking 동작, Agentic 워크플로우에서 Opus 5 대비 주요 변경 사항이 있다. 출력 토큰 생성 속도는 이전 모델보다 30% 이상 빠르며, 더 적은 토큰으로 작업을 완료하는 경우가 많다. Agentic 코딩과 코드 리뷰에서 기본 medium Effort는 Opus 5의 high Effort 성능을 넘어서거나 동등하며, 수 시간 동안의 자율 작업에서 지속성이 더 좋다.

Effort 및 Thinking 조정

Opus 5.5에서 Effort는 Thinking 양을 조절하는 주요 제어 수단이며, Thinking은 항상 활성화된다. thinking: {"type": "disabled"}를 허용했던 Opus 5와 달리, Opus 5.5는 Thinking 비활성화를 지원하지 않는다. 개발자는 기본값인 medium Effort에서 시작해 지연 시간과 품질을 측정하거나, 속도 최적화를 위해 low Effort에서 시작해 프롬프트를 마이그레이션해야 한다. 응답 텍스트에 추론을 강제하는 지시문은 제거하고, Thinking 블록에서 추론을 확인하려면 display: "summarized"를 사용한다.

• 기본 Effort: Opus 5의 high에서 Opus 5.5의 medium으로 변경됨.
• Max Tokens: 숨겨진 Thinking 토큰을 수용하기 위해 Agentic 코딩 시 128,000으로 설정.
• Cache 영향: 최상위 effort 값을 변경하면 프롬프트 캐시가 무효화됨. 메시지별 변경은 Beta 기능인 Per-message effort change가 필요함.

Agentic 워크플로우 및 진행 상황 업데이트

Opus 5.5는 긴 작업 중 텍스트만 포함된 업데이트(stop_reason: "end_turn")로 턴을 종료할 수 있으며, 이는 무인 루프를 멈출 수 있다. 이를 처리하려면 텍스트 전용 턴을 완료 신호가 아닌 보고서로 취급하고, 체크리스트로 미완료 항목을 추적하며, 자동 재시도를 2~3회로 제한해야 한다.

• 진행 상황 업데이트: 도구 호출 사이의 짧은 업데이트는 text 블록이 아닌 thinking 블록으로 반환됨. 이를 표시하려면 display: "updates"를 설정해야 함(Beta 헤더 thinking-display-updates-2026-08-18).
• 원문 내용 전달: 기본 Thinking 블록이 생략할 수 있으므로, 코드 스니펫이나 정확한 텍스트를 원문 그대로 전달하기 위해 사용자 메시지를 위한 간단한 도구를 선언해야 함.
• 시간 신호: 경과 시간 예산(예: elapsed 340s / 1200s)을 추가하면 멀티 에이전트 워크플로우를 병렬화하여 품질 저하 없이 완료 시간을 단축할 수 있음.

안전 및 보안 거부

Opus 5.5는 생물학, 사이버 보안, 추론 추출에 대한 새로운 안전 분류기를 도입했다.

• 추론 추출: 내부 추론을 응답 텍스트로 강제하는 요청은 reasoning_extraction 범주로 거부됨. 이러한 거부는 사용자에게 직접 반환되며 다른 모델로의 자동 폴백을 트리거하지 않음.
• 사이버 보안: 소스 코드에서 취약점 발견은 허용되지만, 고위험 이중 용도 활동은 금지됨.
• 생물학: Claude Fable 5.1과 동일한 안전장치 적용. 일일 건강/교육 질문에는 영향 없음.

시각 입력 및 프롬프트 주입 방어

Opus 5.5는 낮은 Effort 레벨에서도 차트나 다이어그램 같은 시각 입력을 Opus 5보다 더 정확하게 해석한다. 밀집된 기술 도면의 경우 고해상도 이미지와 이미지 처리 도구(자르기, 확대)를 사용하면 정확도가 향상된다.

• 프롬프트 주입: 간접 프롬프트 주입에 대한 저항성이 강화됨. 사용자가 붙여넣은 콘텐츠를 더 안전하게 보호하려면 고유 태그(예: <pasted_content id="ab12">)로 감싸고, 사용자가 명시적으로 요청하지 않는 한 내부 지시문을 신뢰할 수 없는 것으로 취급하도록 모델에 지시해야 함.