Claude Opus 5.5 프롬프트 가이드: effort와 에이전트 템플릿

Claude Opus 5.5에서 프롬프트를 잘 쓰려면 Claude Opus 5에서 쓰던 프롬프트를 그대로 두고, 문구를 고치기 전에 effort 레벨부터 정한 다음, 바꾸고 싶은 동작마다 시스템 프롬프트에 목적이 분명한 문장을 하나씩 추가하세요. Anthropic 가이드는 기존 Claude Opus 5 프롬프트가 "수정 없이도 잘 작동할 것"이라고 하며, effort가 "지능, 지연 시간, 비용 사이의 균형을 맞출 때 가장 먼저 조정할 설정"이라고 설명합니다. 새로운 조언은 대부분 에이전트에 관한 것입니다. 무인 실행이 끊기지 않게 하기, 긴 턴에서 진행 상황 업데이트를 받기, 여러 에이전트로 이루어진 팀의 속도 조절입니다. 아래 내용은 모두 Anthropic의 "Prompting Claude Opus 5.5" 가이드와 이 모델의 API 레퍼런스에서 가져왔으며, 2026년 10월 3일에 확인했습니다.

Claude Fable 5.1과 공통인 요청 규칙, 예를 들어 어시스턴트 미리 채우기(prefill)와 temperature 직접 지정이 안 된다는 점은 Claude Fable 5.1 프롬프트 가이드에서 다뤘습니다. 이 글은 Claude Opus 5.5에만 해당하는 내용을 다룹니다.

Claude Opus 5 프롬프트를 Claude Opus 5.5에서도 쓸 수 있나요?

네. Anthropic은 "수정 없이도 잘 작동할 것"이라고 하며, Claude Opus 5의 프롬프트 작성 방식이 "여전히 합리적인 출발점"이라고 말합니다. 달라진 것은 모델이 노력을 쓰는 방식입니다. Claude Opus 5.5는 Claude Opus 5보다 출력 토큰을 30% 이상 빠르게 생성하고, 같은 작업을 더 적은 토큰으로 끝내는 경향이 있습니다.

Anthropic은 모델이 나아진 네 가지 영역을 꼽았고, 이 가이드에서 어떤 부분이 여러분에게 중요한지는 이것으로 정해집니다.

에이전트 코딩과 코드 리뷰. 실제 저장소에서의 여러 단계 작업, 하위 에이전트를 활용한 장시간 자율 실행, 더 많은 버그를 잡고 오탐은 줄인 코드 리뷰.
지식 작업. 틀린 수치를 말하거나 출처를 잘못 인용할 가능성이 크게 줄었고, 요일이 맞지 않는 날짜처럼 방대한 입력 속 작은 불일치도 찾아냅니다.
커뮤니케이션. 진행 상황 업데이트와 최종 보고서에서 무엇을 했는지, 무엇을 찾았는지, 여러분에게 무엇이 필요한지를 분명하게 말합니다.
차트, 다이어그램, 스크린샷, 컴퓨터 사용. 가장 낮은 effort에서도 Claude Opus 5보다 시각 자료를 더 정확하게 읽습니다.

프롬프트가 주로 채팅용이라면 effort와 채팅 섹션만 읽어도 됩니다. 에이전트를 운영한다면 새로운 조언은 에이전트 섹션에 있습니다.

Claude Opus 5.5에서는 어떤 effort를 써야 하나요?

medium으로 시작하세요. Claude Opus 5.5의 기본값입니다(Claude Opus 5의 기본값은 high). 명시적으로 설정하고, Claude Opus 5에서 쓰던 값을 그대로 가져오지 말고 자신의 작업으로 여러 레벨을 시험해 보세요. effort 이름은 모델마다 같은 양의 사고를 뜻하지 않습니다. Anthropic 테스트에서 medium의 Claude Opus 5.5는 "코딩과 지식 작업 평가에서 high의 Claude Opus 5와 같거나 더 나은" 결과를 냈고, 몇몇 코딩 평가에서는 low도 그에 근접하면서 비용은 훨씬 낮았습니다.

effort	주요 용도(Anthropic effort 문서 기준)
`low`	가장 빠른 속도와 가장 낮은 비용이 필요한 단순 작업, 예를 들어 하위 에이전트. Claude Opus 5에서 사고를 끄고 쓰던 통합도 여기서 시작합니다.
`medium`	Claude Opus 5.5의 기본값. 속도, 비용, 성능의 균형이 필요한 에이전트 작업.
`high`	복잡한 추론, 어려운 코딩 문제, 에이전트 작업.
`xhigh`	30분 넘게 걸리는 장시간 에이전트 및 코딩 작업. 품질 향상을 측정한 경우에만 쓰세요.
`max`	토큰 사용에 제한을 두지 않는 가장 깊은 추론. 품질 향상을 측정한 경우에만 쓰세요.

medium을 명시적으로 설정하는 것은 effort를 생략하는 것과 완전히 같은 동작입니다.

같은 레벨에서도 Claude Opus 5.5는 턴마다 Claude Opus 5보다 더 많이 생각하는 경향이 있으며, xhigh와 max에서 특히 그렇습니다. 세 가지를 기억하세요.

max_tokens에 여유를 두세요. 사고 내용이 보이지 않아도 사고는 max_tokens에 포함되므로, Claude Opus 5에서 사고를 끄고 쓰던 한도로는 답변이 잘릴 수 있습니다. 긴 에이전트 코딩 턴에서는 모델 최대치인 128,000으로 max_tokens를 설정했을 때 잘 작동했다고 Anthropic은 밝혔습니다.
"덜 생각해"라고 쓰기 전에 effort를 낮추세요. effort를 낮추는 것이 프롬프트 지시보다 사고, 비용, 지연 시간을 더 확실하게 줄입니다.
프롬프트 캐시에 의존한다면 effort를 고정하세요. 요청마다 최상위 effort 값을 바꾸면 프롬프트 캐시가 무효화됩니다.

effort는 output_config에서 설정합니다.

{
  "model": "claude-opus-5-5",
  "max_tokens": 128000,
  "output_config": {"effort": "medium"},
  "messages": [{"role": "user", "content": "Review this pull request for bugs and explain each one."}]
}

Claude Opus 5.5에서 사고를 끌 수 있나요?

아니요. Claude Opus 5는 high 이하의 effort에서 "thinking": {"type": "disabled"}를 받아들였지만, Claude Opus 5.5는 받아들이지 않으며 이런 요청은 400 오류를 반환합니다. 사고는 적응형이고 항상 켜져 있습니다. 사고를 끄고 쓰던 통합이라면 Anthropic은 네 가지 변경을 권합니다.

low effort로 시작해 측정하세요. low에서는 모델의 사고가 짧습니다. 그래도 첫 토큰까지의 시간이 중요하다면 시스템 프롬프트에 "Answer directly without deliberating." 같은 문장을 넣어 사고를 더 줄일 수 있지만, 추가한 뒤에는 품질을 확인하세요.
사고를 대신하던 지시를 지우세요. 프롬프트가 답변에 추론 과정을 적으라고 요구했다면 그 문장을 지우고, 추론은 요약된 사고에서 읽으세요. 이제 답변에서 추론을 재현하도록 몰아가는 프롬프트는 거부될 수 있습니다(아래 거부 섹션 참고).
예전 우회 방법을 다시 테스트하세요. 사고 없이 실행할 때 생기던 문제를 피하려고 넣은 규칙은 이제 필요 없을 수 있습니다. 모델에게 생각하지 말라고 하는 규칙은 모두 지우세요.
블록 유형별로 응답을 읽으세요. 응답은 thinking 블록으로 시작할 수도, 아닐 수도 있으므로 첫 블록이 텍스트라고 가정하지 말고 블록마다 유형을 확인하세요.

추론을 보고 싶다면 요약된 사고를 요청하세요.

{
  "model": "claude-opus-5-5",
  "max_tokens": 16000,
  "thinking": {"type": "adaptive", "display": "summarized"},
  "output_config": {"effort": "low"},
  "messages": [{"role": "user", "content": "Which of these three invoices has a total that does not match its line items?"}]
}

무인 Claude Opus 5.5 에이전트가 중간에 멈추지 않게 하려면?

긴 작업에서 Claude Opus 5.5는 일하면서 사용자에게 상황을 알리고, 그중 일부는 도구 호출 대신 텍스트로 턴을 끝냅니다(stop_reason: "end_turn"). 이런 턴을 모두 "작업 완료"로 처리하는 에이전트 루프는 중간에 멈춥니다. Anthropic의 해법은 하네스 쪽과 프롬프트 쪽 두 가지입니다.

하네스에서는 텍스트로만 끝난 턴을 작업 완료의 증거가 아니라 보고로 취급하세요. 작업의 각 부분을 할 일 도구나 파일처럼 모델이 갱신하는 체크리스트로 관리합니다. 남은 항목이 있는데 막힌 이유도 없이 턴이 끝나면, 그 항목들을 나열한 짧은 사용자 메시지를 보내세요.

Your task list still has open items: migrate the remaining two endpoints and update their tests. Continue with them. If one is blocked, say what is blocking it.

같은 작업에서 자동 이어가기를 두세 번 한 뒤에는 멈춰, 정말로 막힌 실행은 끝나고 검토할 수 있게 하세요. 백그라운드 명령이나 하위 에이전트가 아직 실행 중이라면 끝날 때까지 기다렸다가 그 출력을 다음 사용자 메시지로 돌려주세요.

시스템 프롬프트에서는 원하지 않는 조기 중단의 유형을 구체적으로 적으세요. Anthropic의 예시는 완전히 무인으로 돌아가는 에이전트용이며, 세션의 첫 요청부터 시스템 프롬프트 끝에 둡니다. 중간에 추가하면 시스템 프롬프트가 바뀌어 대화의 이전 사고 블록이 무효화됩니다.

A standing instruction from the user, the person you are working for. It is about how your turns end. A message with no tool call in it ends your turn, and the work stops there until you are asked to continue. The user has seen you end turns in four ways while work they asked for was still owed, and does not want any of them. One: a long summary of what was done that closes by announcing the next step and has no tool call, so the next thing never starts. Two: an offer to carry on with something unless the user would prefer otherwise, which stops to wait for an answer the user was not going to give. Three: a list of decisions for the user when, by your own account, none of them blocks the rest of the work. Four: deciding that this is a good place to report, because the turn has been long or a milestone is done. Status notes are welcome, and so are your recommendations on open decisions, but put them in the same message as your next tool call and carry on with whatever does not depend on the user's answer. If you notice yourself inviting the user to redirect you or offering to wait, delete it and do the next thing. The stops the user does want are the ones where nothing can move without them, or where the thing blocking you is deliberately protected from you. This does not override the need for confirmation on risky or destructive actions.

사람이 답할 수 있는 human-in-the-loop 애플리케이션에는 이 문단을 넣지 말고, 위험하거나 되돌릴 수 없는 작업에는 자체 확인 단계를 유지하세요. 작업당 도구 호출과 출력 토큰은 다소 늘어납니다.

오래 실행되는 Claude Opus 5.5 에이전트에서 진행 상황 업데이트를 받으려면?

도구 호출 사이에 Claude Opus 5.5는 방금 무엇을 찾았고 다음에 무엇을 할지 짧은 진행 메모를 씁니다. 이 모델에서는 이 메모가 text 블록이 아니라 thinking 블록으로 돌아오고 기본적으로 내용이 비어 있어서, text 블록만 보여 주는 클라이언트는 긴 턴 동안 아무 일도 없는 것처럼 보일 수 있습니다. Anthropic은 메모마다 요약을 돌려주는 베타 표시 모드를 문서화했습니다. 엔드포인트 문서에 나온 thinking.display 값은 Claude Opus 5.5 API 레퍼런스에 있습니다.

특별한 설정 없이 쓸 수 있는 프롬프트와 하네스 수단이 세 가지 있습니다.

원문 그대로 전달할 도구를 주세요. 턴 도중에 코드 조각처럼 정확한 내용을 사용자에게 넘겨야 할 수 있다면, 간단한 "사용자에게 메시지 보내기" 도구를 주고 그런 용도로만 쓰라고 하세요. 도구는 첫 요청부터 선언하세요. 나중에 추가하면 이전 사고 블록이 무효화됩니다.
정해진 시점에 업데이트를 요청하세요. 예를 들어 첫 도구 호출 전에 의도를 한 문장으로 말하고, 끝에 짧게 정리하게 합니다. 모델은 이런 지시를 잘 따르며, 사람이 지켜보는 작업에서 특히 유용합니다.
조용한 턴은 하네스에서 재촉하세요. 사용자가 읽을 내용을 아무것도 주지 않은 도구 호출 단계가 몇 번 연속됐는지 셉니다. 여러 번, 예를 들어 다섯 번이 되면 최신 도구 결과 뒤에 알림을 덧붙이고, 두세 번 보낸 뒤에는 멈추세요. Anthropic의 문구는 다음과 같습니다.

The user hasn't heard from you in a while — say in a few words what you're doing, then continue.

에이전트 코딩 작업에 대한 Anthropic의 테스트에서 이 알림은 긴 침묵이 생기는 작업의 비율을 약 절반으로 줄였고, 비용에는 측정 가능한 변화가 없었습니다.

Claude Opus 5.5 에이전트가 행동하기 전에 맥락을 확인하게 하려면?

Claude Opus 5.5는 금방 작업에 착수하는 편입니다. 이메일, 문서, 스프레드시트, CRM 레코드를 넘나드는 자동화에서는 작업에 필요한 정보가 요청에 언급되지 않은 곳에 있는 경우가 많습니다. 예전 이메일 스레드 속 정책이나 다른 스프레드시트 탭의 규칙 같은 것입니다. 시스템 프롬프트에 한 문장만 넣으면 모델이 먼저 주변을 살핍니다.

Before taking any action, explore broadly with tool calls: list and open the emails, documents, spreadsheet tabs and records across the available apps that could be relevant to this task, including ones the task does not explicitly mention, and use what you find.

여러 앱에 걸친 작업에 대한 Anthropic의 테스트에서 이 문장을 넣자 모델이 올바르게 끝낸 작업이 눈에 띄게 늘었고, medium과 max effort 모두에서 그랬습니다. 대신 도구 호출이 약간 늘어납니다. 이 문장은 찾은 내용을 바탕으로 행동하라고 지시하므로, 신뢰할 수 없는 내용은 모델이 검색하는 레코드에 두지 마세요.

여러 Claude Opus 5.5 에이전트로 이루어진 팀을 더 빨리 끝내려면?

Claude Opus 5.5는 경과 시간에 민감합니다. 리드 에이전트가 하위 에이전트에게 일을 넘기는 구성에서는 시간 예산을 주세요. 하네스가 모델에 돌려보내는 메시지마다 끝에 elapsed 340s / 1200s 같은 짧은 줄을 붙이는 방식입니다. 모델은 예산 안에 끝내도록 속도를 조절하고 보통 예산보다 훨씬 일찍 끝내므로, 실제로 쓰고 싶은 시간보다 조금 넉넉하게 잡으세요. 예산을 추정할 수 없다면 경과 시간만 보여 주고 시스템 프롬프트에 이 문장을 넣으세요.

Time matters here: do not spend time that can be avoided, and the earlier a correct result is obtained, the better.

예산은 참고용일 뿐이고 한도에 도달해도 모델이 멈추지 않으므로, 확실히 멈춰야 한다면 자체 타임아웃을 유지하세요. 예산을 빡빡하게 잡는 것과 effort를 낮추는 것은 다릅니다. effort를 낮추면 작업 자체가 줄고, 예산은 주로 더 많은 에이전트가 병렬로 일하게 만듭니다. 시간에 쫓기면 모델이 검색과 검증을 조금 덜 할 수 있으니, 자신의 작업으로 답변 품질을 확인하세요.

채팅 시스템 프롬프트에서 Claude Opus 5.5에게 "신중히 생각하라"고 해야 하나요?

아니요. Anthropic은 채팅 시스템 프롬프트에서 "think carefully before answering"(답하기 전에 신중히 생각하라) 같은 문장을 지우라고 권합니다. 얼마나 생각할지는 모델이 스스로 정하고, 조절 수단은 effort입니다. 채팅 제품에서의 Anthropic 테스트에서 이런 문장을 지우자 답변이 더 빨리 시작됐고 품질은 뚜렷하게 떨어지지 않았습니다.

채팅용으로 알아 두면 좋은 문장이 두 개 더 있습니다. 하나는 이전 답변을 확정된 것으로 다루게 해서 후속 턴이 더 빨리 시작되게 하고, 다른 하나는 사용자가 붙여 넣은 텍스트를 표시해 이메일이나 웹 페이지에 숨은 지시를 모델이 따르지 않게 합니다. 두 문장의 원문은 모두 Fable 5.1 프롬프트 가이드의 Claude Opus 5.5 섹션에 있습니다. 긴 분석이나 에이전트 작업에서는 뒤 단계에서 앞 단계의 실수가 드러날 수 있으므로 "답변 확정" 문장은 넣지 마세요.

차트, 다이어그램, 스크린샷에 대해 더 좋은 답을 얻으려면?

먼저 다시 테스트하세요. 추가 도구 없이도 Claude Opus 5.5는 빽빽한 차트, 순서도, 캘린더 스크린샷을 Claude Opus 5보다 훨씬 정확하게 읽습니다. Anthropic 테스트에서는 가장 낮은 effort에서도 빽빽한 차트의 값을 가장 높은 effort의 Claude Opus 5보다 더 정확하게 읽었습니다. 예전 모델을 위해 만든 보조 장치는 이제 필요 없을 수 있습니다.

가장 빽빽한 입력에는 두 가지가 여전히 도움이 됩니다.

더 높은 해상도의 이미지. 기술 도면에서 특히 효과가 큽니다.
이미지 도구. 원본 이미지를 담고 PIL이나 OpenCV를 설치한 컨테이너를 주고 모델을 에이전트로 실행하면, 자르고 확대하고 측정할 수 있습니다. 그게 부담스럽다면 자르기 도구 하나만으로도 도움이 됩니다. effort가 높을수록 모델은 이 도구들을 더 잘 씁니다.

도구 없이 effort를 높이면 기술 도면 판독은 나아지지만 차트에는 별 효과가 없습니다. 이미지는 사용자 턴에 URL 소스를 가진 image 블록으로 넣으며, 형식은 API 레퍼런스에 있습니다.

Claude Opus 5.5의 프런트엔드 결과물이 뻔해 보이지 않게 하려면?

원하지 않는 패턴을 구체적으로 적으세요. 디자인 방향이 없으면 Claude Opus 5.5는 몇 가지 기본 스타일로 돌아가고, "AI스러운 뻔한 느낌을 피하라" 같은 일반적인 문장은 대개 한 기본값을 다른 기본값으로 바꿀 뿐입니다. Anthropic의 예시는 피해야 할 것을 구체적으로 나열합니다.

Output a vanilla HTML/CSS personal website with placeholder data. Do not use a cream or off-white background, italic accent words in headlines, numbered "01/02/03" section labels, monospace labels, or pill-shaped buttons.

반복해서 다듬으세요. 첫 결과가 대신 어떤 스타일을 썼는지 확인하고 목록에 추가합니다.

Claude Opus 5.5가 stop_reason "refusal"을 반환하는 이유는?

안전 분류기가 요청을 거절했기 때문입니다. Claude Opus 5.5는 생물학, 사이버 보안, 추론 추출에 대한 분류기를 실행하며, 거부는 stop_reason: "refusal"이 담긴 일반 응답으로 돌아오고 stop_details 객체에 범주가 적힙니다.

범주	대상	대응
생물학	Claude Fable 5.1과 같은 안전장치이며, Claude Opus 5에서 넘어온다면 새로 생긴 것입니다. 일상적인 건강·교육 질문은 영향을 받지 않습니다.	생명과학 분야 조직은 Anthropic의 Life Sciences Verification Program에 신청할 수 있습니다.
사이버 보안	고위험 이중 용도 사이버 보안 활동.	소스 코드에서 취약점을 찾는 것은 허용되며 바꿀 필요가 없습니다.
추론 추출	모델의 내부 추론을 답변에서 재현하도록 몰아가는 프롬프트.	그런 지시를 지우고 `"display": "summarized"`를 설정한 뒤 사고 블록에서 읽으세요. 답에 대한 짧은 설명을 요청하는 것은 괜찮습니다.

무해한 요청이 거부되는 일반적인 경우는 Fable 5.1 가이드의 Claude가 무해한 요청을 거부하는 이유를 참고하세요.

자주 묻는 질문

공식 Claude Opus 5.5 프롬프트 가이드가 있나요?

있습니다. Anthropic은 개발자 문서에 "Prompting Claude Opus 5.5"를 공개했고, 현재 모든 Claude 모델에 적용되는 일반 프롬프트 모범 사례 페이지도 있습니다. 이 글은 2026년 10월 3일 기준 Opus 5.5 가이드를 요약했으며, 템플릿은 원문 그대로 인용했습니다.

Claude Opus 5.5의 기본 effort는 무엇인가요?

medium입니다. Claude Opus 5의 기본값은 high입니다. 레벨은 low, medium, high, xhigh, max이며 output_config.effort에서 설정합니다.

Claude Opus 5.5는 최대 몇 토큰까지 출력하나요?

요청당 최대 128,000토큰이며, 이 한도에는 사고가 포함됩니다. 컨텍스트 윈도우는 1M 토큰입니다.

Claude Opus 5.5의 답변을 미리 채우거나 temperature를 설정할 수 있나요?

아니요. 어시스턴트 미리 채우기와 기본값이 아닌 temperature는 모두 400 오류를 반환하고, 특정 도구를 강제하는 것도 지원되지 않습니다. 대신 원하는 형식을 프롬프트로 설명하세요. 각각을 무엇으로 대신할지는 Fable 5.1 프롬프트 가이드에서 설명합니다.

에이전트에는 Claude Opus 5.5와 Claude Fable 5.1 중 무엇이 더 나은가요?

작업과 예산에 따라 다릅니다. 고르는 방법은 Claude 모델 비교에서 다룹니다. 프롬프트 조언의 차이는 주로 기본값입니다. Claude Opus 5.5는 medium, Claude Fable 5.1은 high effort에서 시작합니다.

프롬프트 직접 써 보기

SeedRouter 키 하나로 Anthropic SDK, 또는 OpenAI Chat Completions·Responses 형식을 통해 Claude Opus 5.5에서 이 템플릿들을 실행해 보세요. Claude Opus 5.5 API 레퍼런스에 모든 파라미터가 있고, 모델 페이지에서 현재 토큰당 가격을 확인할 수 있습니다. SeedRouter는 사용한 만큼 결제합니다. 한 번 충전하면 크레딧은 만료되지 않고, 실패한 요청에는 요금이 부과되지 않습니다.

Claude Opus 5.5 프롬프트 가이드: effort, 에이전트, 거부, 템플릿