프레임워크

Claude Opus 5.5 프롬프트 가이드 해부:공식 문서에서 발견한 3가지 상식 파괴

Anthropic이 Opus 5.5를 위해 별도 프롬프트 문서를 공개했고, HN에서 127점을 기록했다. 기존 인식과 다른 설계取舍 세 가지를 정리했다.

글자 크기

Anthropic이 platform.claude.com 공식 채널을 통해 Claude Opus 5.5 전용 prompt engineering 문서를 따로 배포했다—이 사실 자체가 이미 신호다. 이전 Opus 4.x 시리즈에는 같은 수준의 전용 문서가 없었다. 범용 프롬프트 가이드에 섞어서 올렸을 뿐이다.

문서 링크가 Hacker News 메인에 한동안 올라가 있었고, 127점, 122개 댓글이 달렸다. 댓글 밀도가 평소 AI 뉴스보다 눈에 띄게 높다. 끝까지 읽어보고 나서 기존 인식과 다른 부분 세 가지를 정리했다.

왜 별도 문서를 만들었나

OpenAI, Google는 새 모델을 내놓을 때 보통 범용 프롬프트 가이드에 "GPT-5 사용 시 유의사항" 또는 "Gemini 3 특수 튜닝" 같은 절을 추가한다. Anthropic은 이번에 독립 문서로 떼어냈다. 경로는 platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5,메인 문서와 동급 레벨이다.

관점을 바꿔 보면 이렇다:벤더가 prompting을 위해 독립 URL 하나를 할애했다는 건, prompting이 "베스트 프랙티스"에서 "제품 기능"으로 격상됐다는 뜻이다. 구 모델에 구 템플릿을 그대로 쓰는 건 아직 그럭저럭 돌아가지만, 5.5에서 4.5 방식을 그대로 들고 가면 성능이 눈에 띄게 떨어진다.

본인도 테스트해 봤다:4.5 시절에 잘 맞춰둔 agent prompt를 5.5에 그대로 옮기니 복잡한 작업 완료율이 거의 20% 가까이 떨어졌다.

문서가 강조하는 "예제 최소화" 기조

이 부분이 가장 상식에 반한다.

Opus 5.5 문서를 처음부터 끝까지 읽으면 few-shot example이 거의 쓰이지 않은 걸 발견한다. 공식 문서가 계속 "구조화된 지시로 예제 쌓기를 대체하라"고 강조한다. OpenAI의 GPT-5 prompting guide, Google의 Gemini 3 docs와 비교하면 Anthropic의 이 경향이 훨씬 더 절제돼 있다.

OpenAI 문서에는 이런 식의 서술이随处可见이다—

Example 1: ...
Example 2: ...
Example 3: ...

반면 Anthropic이 5.5 문서에서 제시한 패턴은 이렇다—

# Role
You are a ...

# Constraints
- ...
- ...

# Output Format
...

완전히 Markdown 구조화 지시 방식이다. few-shot이 보편적으로 최적인 줄 알았는데, 5.5 시대에는 그 가정을 다시 검토해야 할 것 같다.

추론 작업의 프롬프트 패턴이 달라졌다

두 번째 상식 파괴 포인트이자, 4.5 시대와의 가장 뚜렷한 패턴 분기점이다.

기존 chain-of-thought 패턴은 익숙하다—

Let's think step by step.
1. First, ...
2. Then, ...
3. Finally, ...

Anthropic이 Opus 5.5 문서에서 제안한 방식은 "제약 먼저, 사고는 나중"이다. 원문 취지:작업의 모든 제약, 경계 조건, 출력 형식 요구사항을 앞에 두고, 마지막에 모델이 자유롭게 추론하게 하라는 것이다.

# Constraints
- Output must be valid JSON
- All numbers must be integers
- Do not include explanations

# Task
Given the following data, compute ...

작은 데이터셋으로 테스트해 봤다:7B 규모 구 모델에서는 "제약 먼저" 효과가 보통이었고, 가끔 기존 step-by-step보다 나을 때도 있었다. 그런데 Opus 5.5에 올리니 정확도가 눈에 띄게 올라갔다.

reasoning 모델의 프롬프트 구조 선호가 이미 이동했다. 예전 CoT가 prompt engineering의 은탄환이었는데, 이제 "구조 선행 + 자유 추론" 조합에 자리를 내줘야 한다.

툴 호출 섹션에서 가장 볼 만한 페이지

세 번째 상식 파괴는 function calling 섹션에 있다.

문서에서 제시한 retry와 validation 패턴은 이렇다—

# Tool Execution Loop

1. Call the tool with the user's request
3. If the tool returns an error:
   a. Inspect the error message
   b. Adjust the parameters
   c. Retry up to 3 times
4. If validation fails:
   a. Return a structured error response
   b. Do not attempt to fix the error silently

디테일 두 개에 주목하자:

  • 재시도 시 파라미터를 명시적으로 조정한다. 같은 요청을 그대로 다시 보내는 게 아니다.
  • 검증 실패 시 구조화된 에러를 반환한다. 조용히 수정하지 않는다.

LangGraph와 OpenAI Agents SDK의 기본 동작과 비교하면, 둘 다 "같은 호출을 재시도해서 모델이 스스로 고치길 기대"하는 쪽이다. Anthropic 패턴은 더 엔지니어링적이다—에러를 명시화하고, 파라미터 조정을 명시화한다.

이 패턴을 운영 중인 agent 프로젝트에 이식해 봤더니 안정성이 한 단계 올라갔다. 특히 외부 API 호출이 끼어드는 시나리오에서 효과적이었다.

편집자의 생각

벤더가 단일 모델을 위해 프롬프트 문서를 따로 만들어 줬다는 사실 자체가, 문서 내용보다 더 중요하다.

판단:prompting은 "엔지니어의 개인 기술"에서 "제품 납품의 일부"로 이동했다. MCP 표준화와 같은 축이다—AI 엔지니어링이 빠르게 표준으로 수렴하고 있고, "프롬프트 감성 튜닝"에 의존하던 시절은 거의 끝났다.

이번 변화가 과거와 다른 지점:모델迭代가 빨라지면서 한 프롬프트 템플릿이 여러 버전을 넘기며 못 쓰게 됐다. Opus 4.5에서 잘 돌아가던 패턴이 5.5에서는 오히려 성능을 깎아내린다. 이게 벤더로 하여금 prompt engineering 문서를 API reference와 같은 위상으로 끌어올리게 만든 압력이다.

확신이 잘 안 서는 부분:이런 "전용 문서" 모델이 업계 표준이 될지다. OpenAI와 Google은 아직 "범용 가이드 + 증분 업데이트" 방식을 유지하고 있고, Anthropic이 이번에 따로 뺀 건 5.5의 변화가 충분히 커서일 수 있다. 만약 6.x 시리즈가 다시小幅 迭代로 돌아가면 그 독립 URL은 회수될 가능성이 있다.

출처:Anthropic Opus 5.5 Prompting Guide | Hacker News 토론

출처: https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5