개요
Xudong Han(@Xudong07452910)이 Anthropic의 공식 문서 Prompting Claude Opus 5.5를 소개한 X 게시물이다. 그의 요약은 이렇다. “깊이 생각해”, “단계별로 분석해” 같은 문장은 이제 지워도 된다. 모델이 생각할 양을 스스로 정하고, 조절할 손잡이는 effort다. 프롬프트 엔지니어링의 무게중심이 “어떤 문장을 써야 말을 듣나”에서 모델이 일할 환경·피드백·제약 설계, 즉 harness 쪽으로 옮겨 가고 있다는 것이다.
아래는 공식 문서 원문을 대조해 정리한 핵심이다. 이전 세대 가이드는 2026-07-03-pytorchkr-topic-11062-anthropic-claude-fable-5-prompting-guide, Opus 5 출시 맥락은 2026-07-25-claude-opus-5-launch-breakdown을 본다.
무엇이 달라졌나
- 속도·효율: Opus 5보다 출력 토큰 생성이 30% 이상 빠르고, 같은 작업을 더 적은 토큰으로 끝낸다. 기존 Opus 5 프롬프트는 대체로 그대로 써도 된다.
- thinking 항상 켜짐: Opus 5에서 쓰던
thinking: {"type": "disabled"}를 받지 않는다. 생각의 양은effort로만 조절한다. - 기본 effort는
medium(Opus 5는high). Anthropic 테스트에서 Opus 5.5medium이 코딩·지식 작업에서 Opus 5high와 같거나 앞섰고, 여러 코딩 평가에서는low도 근접했다. - 시각 입력: 가장 낮은 effort에서도 빽빽한 차트 수치를 Opus 5 최고 effort보다 정확히 읽었다. 컴퓨터 사용 성공률도 기본 effort에서 Opus 5의 높은 effort 수준에 도달했다.
상황별 처방
| 증상 | 문서의 처방 |
|---|---|
| 턴이 길어지고 비용이 늘었다 | Opus 5 때 effort를 그대로 쓰지 말고 medium부터 다시 잰다. max_tokens는 thinking 몫까지 넉넉히(에이전트 코딩은 최대 128,000). xhigh·max는 효과를 측정한 작업에만. effort를 요청 사이에 바꾸면 프롬프트 캐시가 깨지므로 메시지 단위 effort 변경(베타)을 쓴다 |
| Opus 5에서 thinking을 끄고 쓰던 통합 | low에서 시작해 측정한다. 응답 본문에 추론을 쓰라던 지시는 지운다. 그런 요청은 reasoning_extraction 거부로 돌아올 수 있다. 추론은 display: "summarized" thinking 블록에서 읽는다 |
| 무인 에이전트가 진행 보고 후 멈춘다 | 텍스트만 있는 end_turn을 완료로 보지 말고 보고로 본다. 체크리스트를 유지하게 하고, 열린 항목이 있으면 “남은 항목을 계속하라”는 메시지를 보낸다. 자동 재개는 2~3회로 제한한다. 원치 않는 조기 종료 유형 네 가지를 명시한 시스템 프롬프트 예시도 제공한다 |
| 긴 턴 동안 화면이 조용하다 | 진행 업데이트는 text가 아니라 progress-update thinking 블록으로 온다. display: "updates"(베타)를 켜고, 조용한 도구 호출이 5회쯤 이어지면 턴 범위 시스템 메시지로 “짧게 근황을 말하라”고 덧붙인다. 테스트에서 긴 침묵 구간이 있는 작업 비율이 약 절반으로 줄었다 |
| 여러 앱을 넘나드는 자동화에서 맥락을 놓친다 | ”행동 전에 관련될 수 있는 메일·문서·시트 탭·레코드를 폭넓게 탐색하라”는 한 문장을 넣는다. 정답률이 눈에 띄게 올랐다 |
| 멀티 에이전트 팀이 느리다 | 하네스가 메시지 끝에 elapsed 340s / 1200s처럼 경과 시간 대비 예산을 붙인다. 모델이 예산 안에 끝내도록 병렬도를 조절한다. 예산은 권고일 뿐이니 강제 종료는 직접 타임아웃으로 건다 |
| 챗봇 첫 응답이 늦다 | 시스템 프롬프트의 “답하기 전에 신중히 생각하라”를 지운다. 응답 시작이 빨라졌고 품질 저하는 뚜렷하지 않았다 |
| 사용자가 붙여넣은 글 속 지시를 따른다 | 붙여넣은 블록을 같은 무작위 id의 <pasted_content id="…"> 태그로 감싸고, 그 안의 지시는 사용자가 요청할 때만 따르라고 시스템 프롬프트에 적는다 |
| 프론트엔드 결과가 뻔하다 | ”AI 같은 느낌 피해”는 다른 기본값으로 바뀔 뿐이다. 크림색 배경, 01/02/03 번호 라벨, 알약 버튼처럼 피할 패턴을 구체적으로 나열하고 반복해서 목록을 늘린다 |
안전 분류기
생물학(Fable 5.1과 동일 — Opus 5에서 오면 새로 생김), 사이버보안(소스 코드 취약점 탐색은 허용, 고위험 이중용도 행위는 불가), 추론 추출 분류기가 돈다. 분류기 거부는 stop_reason: "refusal"과 카테고리를 담은 stop_details로 온다. reasoning_extraction을 뺀 거부는 서버 측 폴백 모델로 자동 재시도할 수 있다.
읽을 거리
- 가이드 전반이 “프롬프트 문장”보다 하네스 쪽 장치(체크리스트, 완료 조건 검사용 소형 모델, 경과 시간 주입, 턴 범위 리마인더)를 더 많이 다룬다. Xudong이 말한 “Harness가 더 많은 일을 맡는다”는 해석이 문서 구성과 맞는다.
- 오래된 지시를 걷어내는 실무 도구는
/claude-api prompt-audit이다. 2026-09-10-claude-code-rsi-cost 참고.