Claude Opus 5.5 프롬프팅 공식 가이드, 이전에 쓰던 습관 6가지부터 지금 지워보세요
퀀텀점프클럽 정상록6 min read2 viewsFree Resource
PDF · Free
이제 AI에게 '생각하라'고 말하지 마세요 — 비개발자를 위한 쉬운 가이드
Get the practical guide first, before diving into the full article.
Claude Opus 5.5 프롬프팅 공식 가이드, 이전에 쓰던 습관 6가지부터 지금 지워보세요
Claude Opus 5.5는 사고 과정이 항상 켜져 있어 "생각해봐" 같은 지시가 쓸모없어졌고 프롬프트 문구 대신 effort 파라미터와 max_tokens 재설정이 새로운 조정 지점이 됐습니다.
Claude Opus 5.5 프롬프팅 방식은 이전 모델과 상당 부분 달라졌어요. "이전에 쓰던 프롬프트를 그대로 옮겨도 되나요?" 당연히 궁금할 질문이죠. 모델이 바뀔 때마다 프롬프트 엔지니어링을 처음부터 다시 배우는 일은 누구에게나 피곤하니까요. 이 글에서는 Anthropic이 2026년 9월 22일 공개한 공식 프롬프팅 가이드를 근거로 무엇이 실제로 달라졌는지 살펴보겠습니다. 한국어로 프롬프트를 쓸 때 어디까지가 공식 권고이고 어디부터가 해석인지도 함께 구분해 드릴게요.
공식 가이드는 실재합니다, 다만 문서가 두 종류입니다
먼저 확인부터 하겠습니다. "Anthropic이 공식 프롬프팅 가이드를 냈다"는 소식, 사실이에요. 문서를 직접 확인했고 본문 26,060자 전체를 검토했습니다.
공식 자료는 성격이 다른 두 문서로 나뉩니다.
platform.claude.com/docs의 개발자 문서: API·하네스를 다루는 사람을 위한 1차 SSOT예요.claude.dev블로그: Claude 앱·Claude Code 일반 사용자를 겨냥한 플레이북 코너로, docs와는 별개 property라 보조 자료로만 참고했습니다.
Reddit에도 같은 문서를 소개하는 글이 올라왔지만 조회수나 투표 순위는 확인하지 못해 "1위 게시물"이라는 표현은 쓰지 않습니다.
"생각해봐"라는 말이 사라진 이유
Claude Opus 5.5 프롬프팅의 핵심 변화: adaptive thinking(사고)이 항상 켜져 있고 끌 수 없다는 것입니다. 모델이 매 응답 전에 스스로 얼마나 생각할지 정하므로, "차근차근 생각해봐" 같은 지시는 응답 시작만 늦출 뿐입니다.
Opus 5는 effort를 낮추면 사고를 끌 수 있었지만 Opus 5.5는 이를 거부해요. Anthropic 테스트에서는 프롬프트에 있던 이 지시문을 없애자 응답 시작이 빨라졌고, 품질 저하는 관찰되지 않았습니다.
effort는 낮아졌는데 결과는 더 좋아진 이유
사고량을 조절하는 장치는 이제 프롬프트 문구가 아니라 effort 파라미터입니다. 기본값이 Opus 5의 high에서 Opus 5.5는 medium으로 내려갔는데 Anthropic 자체 테스트에서는 같은 medium이 이전 high와 같거나 더 나은 결과를 더 적은 토큰으로 냈어요.
주의할 점이 있습니다. 같은 effort 이름이라도 모델마다 사고량이 다릅니다. Opus 5에서 쓰던 값을 그대로 옮기지 말고 실제 작업으로 다시 측정하세요. 특히 xhigh·max 단계는 Opus 5.5가 같은 effort에서도 사고를 더 많이 해, 값을 유지하면 턴과 출력 토큰이 함께 길어집니다.
실무에서 바로 걸리는 문제가 하나 더 있습니다. thinking 토큰은 화면에 보이지 않아도 max_tokens 계산에는 그대로 포함돼요. Opus 5에서 thinking을 끈 상태 기준으로 잡아둔 출력 상한값을 그대로 두면 Opus 5.5에서는 응답이 중간에 잘릴 수 있습니다. 에이전트 코딩처럼 긴 작업에는 모델 최대치인 128,000 토큰으로 올려두는 편이 Anthropic 테스트에서 잘 작동했어요.
지금 프롬프트에서 지워야 할 습관 6가지
공식 가이드가 anti-pattern으로 분류한 항목은 다음과 같습니다.
| 과거에 쓰던 것 | 지금 |
|---|---|
| "차근차근 생각해봐", "단계별로 생각해" | 삭제. 모델이 이미 매번 스스로 사고량을 정합니다 |
| "추론 과정을 답변에 적어라" | 삭제. reasoning extraction 거부 범주에 걸려 요청이 거절될 수 있습니다 |
| thinking 비활성화에 대비한 완화책(내부 태그 금지 규칙 등) | 재검토. 어느 방향이든 제거 대상입니다 |
| "일반적인 AI 티를 피해라" 같은 포괄 지시 | 무효. 하나의 기본 스타일을 다른 기본 스타일로 바꿀 뿐이라, 금지할 패턴을 구체적으로 나열해야 합니다 |
| 시각 입력용 OCR·차트 판독 스캐폴딩 | 재검토. 도구 없이도 Opus 5가 최고 effort에서 낸 정확도를 Opus 5.5는 최저 effort에서 넘겼습니다 |
| 첫 응답 블록이 text라고 가정하는 파싱 | 금지. 블록 타입을 확인해야 합니다. 응답이 thinking 블록으로 시작할 수 있습니다 |
안전 분류기도 생물학·사이버보안·reasoning extraction 3종이 새로 추가됐지만, 일상적인 건강·교육 질문에는 영향이 없습니다.
무인으로 돌리는 에이전트가 중간에 멈춘다면
Claude Code 프롬프트나 API로 장시간 에이전트 작업을 돌리는 팀에게는 이 부분이 실무적이에요. Opus 5.5는 진행 상황을 텍스트로 알리다가 도구 호출 없이 턴을 끝내기도 하는데, 이를 "완료"로 해석하는 루프는 거기서 멈춥니다.
공식 가이드는 CLAUDE.md에 "내 입력이 필요 없는 단계는 계속 진행하고, 정말 막혔거나 파괴적 작업 전에만 멈춰 물어라"는 규칙을 넣으라고 권합니다. 텍스트로 끝난 턴은 완료가 아니라 중간 보고로 보세요. 자동 연속 실행도 2~3회로 제한하고요. 사람이 매번 개입해야 하는 애플리케이션이라면 이 규칙은 넣지 않는 편이 맞습니다.
한국어 실무에 적용할 때, 어디까지가 사실인가
여기서부터는 한국어 프롬프트 작성법에 대해 정직하게 선을 긋겠어요. 공식 문서 어디에도 한국어나 다국어 전용 프롬프팅 지침은 없어요. 아래 내용은 공식 원칙을 한국어 사용 맥락에 적용해 본 해석이지, Anthropic이 직접 밝힌 권고가 아닙니다.
적용해볼 만한 근거는 있습니다. cross-model 공통 문서는 도구·스킬이 과소 호출되는 것을 막으려 쓰던 강한 표현이 이제는 오히려 과잉 호출을 유발할 수 있다고 설명해요. 해법은 공격적인 표현을 평범한 문장으로 낮추는 것입니다.
한국어 사용자의 프롬프트나 룰 파일에는 "반드시", "절대 금지", "(중요)", "무조건" 같은 표현이 유독 자주 등장하죠. 지워볼 만한 문장 몇 가지는 다음과 같아요.
| 지워볼 만한 한국어 표현 | 근거 |
|---|---|
| "차근차근 생각해봐", "단계별로 생각해", "깊이 생각한 뒤 답해" | think step by step 계열과 같은 문제 |
| "신중하게 검토한 후", "충분히 고민해서" | think carefully 계열과 같은 문제 |
| "생각 과정을 먼저 적고 답해" | reasoning extraction 거부 범주에 걸릴 수 있음 |
| "반드시", "절대", "(중요)", "무조건" 남발 | 과잉 호출을 유발할 수 있다는 공통 문서 권고를 한국어에 적용한 해석 |
정말 위험한 항목에만 강조를 남기고 나머지는 평서문으로 낮추는 편이 지금 권고 방향에 맞아요.
현장 반응은 완전히 갈립니다
Hacker News 토론 글은 202포인트, 댓글 221개로 프런트페이지에 올랐어요. 시각 자료 해석과 장시간 무인 실행에는 호평이 쏠렸지만 불만도 만만치 않았습니다. Concise 출력 스타일을 설정해도 응답이 장황해진다는 지적, 간단한 테스트에도 비용이 예상보다 크게 나왔다는 불만이 있었어요. 가격은 백만 토큰당 입력 5달러에서 4달러로, 출력 25달러에서 20달러로 내렸지만 응답이 길어지며 체감 지출은 오히려 늘었다는 목소리도 나왔습니다.
능력 평가는 분명히 올라갔지만 그 능력을 다루는 프롬프트 습관을 다시 배워야 한다는 피로감도 함께 커졌습니다.
마무리
Claude Opus 5.5 프롬프팅에서 바꿀 핵심은 세 가지예요. "생각해봐" 계열 지시는 지우세요. effort 값은 이전 모델 것을 그대로 옮기지 말고 다시 측정하세요. 무인 실행 프롬프트에는 완료 조건과 멈출 지점을 명시하세요. 한국어 프롬프트라면 "반드시·절대" 남발을 줄이는 것도 함께 검토할 만해요.
저장해둔 CLAUDE.md나 자주 쓰는 프롬프트 템플릿을 오늘 한 번 열어보시길 권합니다. 이 글에서 다룬 표현이 몇 개나 남아 있는지 확인하는 게 첫 단계예요.
자주 묻는 질문
프롬프팅 방법이 이렇게 자주 바뀌면, 다음 모델이 나올 때 또 전부 바꿔야 하나요?
이번 변화는 유행이 아니라 모델 구조 자체가 바뀐 결과입니다. adaptive thinking이 상시 켜지면서 사고 관련 지시문의 역할이 근본적으로 달라졌기 때문이에요. 다만 프롬프트 원칙을 주기적으로 점검해야 하는 부담 자체는 실재하는 문제입니다.
effort를 낮추면 프롬프트에 따로 "깊게 생각하지 마"라고 써야 하나요?
아니요. effort는 프롬프트 문구가 아니라 API 파라미터(또는 Claude Code의 /effort 명령)로 조절합니다. 사고량을 줄이고 싶다면 프롬프트를 손대기보다 effort 값을 먼저 내리는 편이 비용과 지연을 더 안정적으로 낮춥니다.
한국어로 프롬프트 쓸 때 참고할 공식 가이드가 따로 있나요?
없습니다. Anthropic 공식 문서에는 한국어나 다국어 전용 프롬프팅 지침이 존재하지 않아요. 이 글의 한국어 적용 부분은 공식 원칙(공격적 표현 완화 권고)을 한국어 습관에 적용해 본 해석이며 공식 권고 자체는 아닙니다.
