Metadata
# 클로드 오퍼스 5.5 프롬프트 작성법
클로드 오퍼스 5와 달라진 동작 방식과 이에 대응하는 프롬프트·에이전트 실행 환경 구성 방식을 설명한다. 다루는 주제는 작업 강도 조정, API 연동 및 채팅에서의 사고 동작, 진행 상황 알림, 무인 작업과 다중 에이전트 작업, 안전장치에 따른 거절, 프런트엔드 디자인, 복잡한 시각 자료, 여러 앱에 걸친 워크플로, 사용자 메시지에 붙여 넣은 텍스트다.
이 가이드는 클로드 오퍼스 5.5에 특화된 프롬프트 작성 방식을 다룬다. 모델의 기능과 API 변경 사항은 [클로드 오퍼스 5.5의 새로운 기능](https://platform.claude.com/docs/en/models/opus-5-5/whats-new-opus-5-5)을 참고하라. 현재 모든 클로드 모델에 적용되는 기법은 [프롬프트 작성 모범 사례](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices)를 참고하라.
클로드 오퍼스 5.5는 클로드 오퍼스 5보다 출력 토큰을 30% 이상 빠르게 생성하며, 같은 작업을 더 적은 토큰으로 마치는 경향이 있다. 기존 클로드 오퍼스 5 프롬프트도 수정 없이 잘 작동할 것이며, [클로드 오퍼스 5 프롬프트 작성법](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5)에 소개된 방식도 여전히 좋은 출발점이다. 현재 겪는 상황에 해당하는 항목부터 읽어보라.
* 어떤 작업 강도를 선택할지 모르겠거나, 클로드 오퍼스 5를 쓸 때보다 한 턴이 오래 걸리고 비용도 늘었다면: [작업 강도 조정](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#calibrate-effort)
* 기존 클로드 오퍼스 5 연동에서 사고 기능을 꺼두었다면: [사고 기능을 끈 상태에 맞춰 작성한 프롬프트](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#prompts-written-for-thinking-disabled)
* 무인 에이전트가 긴 작업의 진행 상황을 보고한 뒤 중간에 멈춘다면: [무인 에이전트 실행](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#unattended-agentic-runs)
* 요청 결과로 `stop_reason: "refusal"`이 반환된다면: [안전장치에 따른 거절](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#safeguard-refusals)
* 긴 에이전트 작업 중 아무 반응이 없는 것처럼 보이거나 일정한 시점에 진행 상황을 알리고 싶다면: [사용자에게 진행 상황 알리기](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#user-facing-progress-updates)
* 여러 앱을 연결해 사용하는 에이전트가 작업 요청에 명시되지 않은 정보를 놓친다면: [여러 앱에 걸친 워크플로에서 맥락 탐색하기](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#explore-context-in-multi-app-workflows)
* 에이전트 팀의 작업을 더 빨리 끝내고 싶다면: [다중 에이전트 실행 환경에 시간 정보 제공하기](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#time-signals-for-multi-agent-harnesses)
* 채팅 앱에서 모델이 먼저 오래 생각하느라 답변이 늦게 시작된다면: [채팅 시스템 프롬프트의 사고 지침](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#thinking-instructions-in-chat-system-prompts)
* 모델이 사용자가 붙여 넣은 텍스트 속 지시를 따른다면: [사용자 메시지에서 붙여 넣은 텍스트 표시하기](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#mark-pasted-text-in-user-messages)
* 정보가 빽빽한 차트·다이어그램·스크린샷에 관한 답변에서 세부 사항을 놓친다면: [복잡한 시각 자료를 위한 도구](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#tools-for-complex-visual-inputs)
* 프런트엔드 결과물이 평범해 보인다면: [프런트엔드 디자인 기본값](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#frontend-design-defaults)
## 프롬프트 작성과 관련된 기능
프롬프트를 작성할 때 특히 중요한 기능은 다음과 같다.
* **에이전트 코딩 및 코드 검토(Agentic coding and code review):** 이 모델은 실제 저장소에서 여러 단계에 걸쳐 진행하는 작업에 강하다. 예를 들어 대규모 코드베이스를 수정하고 테스트가 통과할 때까지 작업을 이어갈 수 있다. 앤트로픽의 테스트에서 기본 작업 강도인 `medium`으로 이러한 작업을 수행했을 때, 클로드 오퍼스 5의 `high` 설정과 같거나 더 나은 성능을 더 적은 단계와 토큰으로 달성했다. 병렬 하위 에이전트를 동원해 감독을 거의 받지 않고 대규모 코드베이스를 몇 시간 동안 감사하거나 마이그레이션하는 등, 장시간 자율 작업도 클로드 오퍼스 5보다 안정적으로 이어간다. 초기 테스터들은 코드 검토 능력도 향상됐다고 보고했다. 클로드 오퍼스 5보다 버그를 더 많이 찾아내면서도 오탐은 줄었고, 변경 사항을 쉬운 말로 설명한다.
* **지식 업무(Knowledge work):** 잘못된 수치를 제시하거나 엉뚱한 출처를 인용할 가능성이 크게 줄었다. 거래를 위한 재무 모델과 한 페이지 요약 자료를 만들거나 가치평가 워크북의 오류를 찾아 고치는 등 재무 모델링 작업에도 능하다. 긴 계획 논의에서 날짜와 요일이 맞지 않거나 발표 자료의 차트가 원본 수치와 일치하지 않는 등, 방대한 자료에서 놓치기 쉬운 세부 사항도 찾아낸다. 생성한 스프레드시트, 슬라이드, 문서는 다른 사람에게 공유하기 전에 손볼 부분이 적다.
* **의사소통(Communication):** 에이전트 작업 중에 보내는 진행 상황 알림과 작업을 마친 뒤의 요약에서 무엇을 했고 무엇을 발견했으며 사용자에게 무엇이 필요한지 명확히 밝힌다. [사용자에게 진행 상황 알리기](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#user-facing-progress-updates)를 참고하라.
* **차트·다이어그램·스크린샷 및 컴퓨터 조작(Charts, diagrams, screenshots, and computer use):** 별도의 도구 없이도 클로드 오퍼스 5보다 시각 자료를 정확하게 읽는다. 앤트로픽의 테스트에서는 가장 낮은 작업 강도로도 클로드 오퍼스 5가 가장 높은 작업 강도로 읽을 때보다 복잡한 차트의 값을 더 정확하게 읽었고, 출력 토큰도 훨씬 적게 사용했다. 의미가 텍스트보다 위치에 좌우되는 경우에도 뛰어나다. 순서도에서 화살표가 어느 상자를 잇는지, 다이어그램 두 버전 사이에 무엇이 바뀌었는지, 달력 스크린샷에서 회의가 정확히 언제 시작하고 끝나는지 등을 파악한다. 여러 단계에 걸쳐 스크린샷을 보고 앱을 조작하는 작업도 더 안정적이다. 기본 작업 강도에서 클로드 오퍼스 5가 훨씬 높은 작업 강도를 써야 도달했던 성공률을 달성했다. [복잡한 시각 자료를 위한 도구](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#tools-for-complex-visual-inputs)를 참고하라.
## 작업 강도 조정
[작업 강도(Effort)](https://platform.claude.com/docs/en/build-with-claude/effort)는 클로드 오퍼스 5.5의 사고량을 조절하는 주된 설정이다. 사고 기능이 항상 켜져 있으므로 성능, 응답 지연, 비용 사이에서 균형을 잡을 때 가장 먼저 조정해야 한다. 클로드 오퍼스 5.5의 기본값인 `medium`에서 시작하라. 클로드 오퍼스 5의 기본값은 `high`다. 설정을 명시하고, 클로드 오퍼스 5에서 사용하던 값을 그대로 가져오기보다 자체 평가로 여러 수준을 시험하라. 작업 강도의 이름이 같아도 모델마다 사고량이 같지는 않다. 앤트로픽의 테스트에서 클로드 오퍼스 5.5의 `medium`은 코딩 및 지식 업무 평가에서 클로드 오퍼스 5의 `high`와 같거나 더 나은 성능을 보였다. 일부 코딩 평가에서는 `low`도 훨씬 낮은 비용으로 비슷한 수준에 도달했다. [클로드 오퍼스 5.5의 권장 작업 강도](https://platform.claude.com/docs/en/build-with-claude/effort#recommended-effort-levels-for-claude-opus-5-5)를 참고하라.
같은 작업 강도에서도 클로드 오퍼스 5.5는 클로드 오퍼스 5보다 턴마다 더 많이 생각하는 경향이 있으며, 특히 `xhigh`와 `max`에서 그렇다. 클로드 오퍼스 5에 지정했던 `effort` 값을 유지하면 턴이 길어지고 출력 토큰도 늘어날 수 있다. 다음 세 가지를 조정하면 도움이 된다.
* 모델의 사고 토큰과 답변을 모두 담을 수 있도록 `max_tokens`를 충분히 높게 설정하라. 사고 내용이 사용자에게 반환되지 않더라도 사고 토큰은 `max_tokens`에 포함된다. 따라서 사고 기능을 끈 클로드 오퍼스 5에 맞춰 정한 한도를 그대로 쓰면 답변이 중간에 끊길 수 있다. 앤트로픽의 테스트에서는 에이전트 코딩에서 발생할 수 있는 긴 턴에 모델의 최대치인 `max_tokens` 128,000이 효과적이었다.
* `xhigh`와 `max`는 품질 향상을 측정으로 확인한 작업에만 사용하라.
* 사고량을 줄이려면 먼저 작업 강도를 낮춰라. 작업 강도를 낮추는 편이 프롬프트에 지시를 추가하는 것보다 사고량과 그에 따른 비용·지연 시간을 안정적으로 줄인다.
요청 간에 최상위 수준의 `effort` 값을 바꾸면 프롬프트 캐시가 무효화된다. 특정 턴만 다른 수준으로 실행하려면 캐시가 유지되는 [메시지별 작업 강도 변경](https://platform.claude.com/docs/en/build-with-claude/effort#change-effort-mid-conversation-beta)(베타)을 이용하라.
## 사고 기능을 끈 상태에 맞춰 작성한 프롬프트
클로드 오퍼스 5는 작업 강도가 `high` 이하일 때 `thinking: {"type": "disabled"}`를 허용하지만, 클로드 오퍼스 5.5는 허용하지 않는다. 요청 형식을 어떻게 바꿔야 하는지는 [마이그레이션 가이드](https://platform.claude.com/docs/en/models/opus-5-5/migration-guide#migrating-from-claude-opus-5)에 설명돼 있다. 기존 클로드 오퍼스 5 연동에서 사고 기능을 꺼두었다면 다음 네 가지도 함께 바꿔야 한다.
* **`low` 작업 강도에서 시작해 측정하라.** `low`에서는 모델의 사고가 짧아진다. 사고를 아예 생략하는 빈도는 프롬프트에 따라 다르므로 실제 트래픽에서 지연 시간과 품질을 측정하고, 품질이 떨어지면 `medium`으로 올려라. 그래도 첫 토큰이 나올 때까지 걸리는 시간이 중요하다면 시스템 프롬프트에 “숙고하지 말고 바로 답하라.”와 같은 문장을 넣어 사고를 더 줄일 수 있다. 사고가 줄면 품질도 떨어질 수 있으므로 이 문장을 추가했을 때의 품질을 측정하라.
* **사고 기능을 대신하도록 넣었던 지침을 제거하라.** 사고 기능 대신 응답에 추론 과정을 풀어 쓰라고 지시했다면 그 지침을 삭제하라. 대신 `display: "summarized"`를 설정하고 [요약된 사고](https://platform.claude.com/docs/en/build-with-claude/thinking#summarized-thinking) 블록에서 추론 내용을 읽으면 된다. 모델이 응답 본문에 추론 과정을 재현하도록 요구하는 프롬프트는 `reasoning_extraction` [거절 범주](https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback#refusal-response)로 거절될 수 있다.
* **사고 기능을 껐을 때 적용했던 대응책을 다시 시험하라.** [사고 기능을 끈 상태로 실행하기](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5#running-with-thinking-disabled)에서는 도구 호출 전 발언 허용, 적절한 도구가 없을 때의 처리 방식, 내부 태그 금지를 한데 묶은 지침을 권장한다. 모델에 생각하지 말라고 지시하는 규칙은 제거하라고도 권장한다. 이 두 대응책은 사고 기능을 껐을 때만 클로드 오퍼스 5에 나타나는 현상을 다룬다. 사고 기능이 항상 켜진 환경에서도 해당 지침이 필요한지 확인하고, 생각하지 말라는 규칙은 필요 여부와 관계없이 삭제하라.
* **블록 유형을 확인하며 응답을 읽어라.** 첫 번째 콘텐츠 블록이 텍스트라고 가정하지 말고 각 블록의 유형을 확인하라. 응답은 `thinking` 블록으로 시작할 수도, 그렇지 않을 수도 있다. 기본값인 `display: "omitted"`에서는 해당 블록의 `thinking` 필드가 비어 있다.
## 무인 에이전트 실행
여러 부분으로 이루어진 긴 작업에서 클로드 오퍼스 5.5는 진행 상황을 사용자에게 알린다. 이때 일부 알림은 도구 호출이 아닌 텍스트로 턴을 끝낸다([`stop_reason: "end_turn"`](https://platform.claude.com/docs/en/build-with-claude/handling-stop-reasons#end-turn)). 이런 턴을 작업 완료로 간주하는 무인 에이전트 루프는 그 지점에서 실행을 멈춘다. 실행 환경과 프롬프트를 조금 바꾸면 작업을 계속하도록 할 수 있다.
텍스트만 남기고 끝난 턴은 작업 완료의 증거가 아니라 진행 보고로 취급하라. 할 일 도구나 파일 등에 작업 항목을 체크리스트로 기록하고 모델이 이를 갱신하도록 하라. 턴이 끝났을 때 미완료 항목이 남아 있고 모델이 장애 요인을 밝히지 않았다면, 아래 예시처럼 해당 항목을 짚는 짧은 사용자 메시지를 보내라. 처음부터 완료 조건을 명시하고, 별도의 작은 모델이 매 턴 종료 시 대화 내용을 조건과 대조하도록 할 수도 있다. 조건을 충족하지 못했다면 검사 이유를 다음 사용자 메시지로 전달하면 된다. 어느 방식을 쓰든 동일 작업에서 자동으로 이어가는 횟수는 두세 번으로 제한하라. 무한히 반복하지 않아야 실제로 막힌 실행을 종료하고 검토할 수 있다.
백그라운드 명령이나 하위 에이전트처럼 모델이 시작한 작업이 아직 실행 중이라면 전체 작업이 끝난 것으로 판단하지 마라. 해당 작업이 완료될 때까지 기다린 다음, 출력을 다음 사용자 메시지로 모델에 전달하라.
시스템 프롬프트에 지침을 추가하면 이런 조기 종료도 줄일 수 있다. 클로드 오퍼스 5.5는 피해야 할 조기 종료의 유형을 구체적으로 명시한 지침에 잘 반응한다. 예를 들어 다음 단계를 실행하지 않고 그 계획만 요약한 채 턴을 끝내지 말라고 지시할 수 있다. 반대로 사용자의 입력 없이는 더 진행할 수 없는 경우처럼 멈춰야 할 상황도 명시하면 도움이 된다.
다음 문단은 사용자에게 보고하려고 멈추지 않고 계속 작업해야 하는 완전 무인 에이전트를 위해 작성한 추가 지침의 한 예다. 출발점으로 삼되 애플리케이션에 맞게 조정해야 할 수 있다. 세션의 첫 요청부터 시스템 프롬프트 끝에 추가하라. 도중에 추가하면 `system` 프롬프트가 바뀌어 이전 대화의 사고 블록이 무효화된다([보존되는 사고](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking#new-instructions) 참고). 이 지침은 다음 도구 호출과 같은 메시지에 상태 메모를 넣도록 모델에 지시한다. 따라서 메모가 도구 호출 사이에 진행 상황 알림으로 도착하지만, 기본 `thinking.display` 설정에서는 텍스트가 비어 있다. 각 알림의 요약을 받으려면 `display: "updates"`를 설정하라([사용자에게 진행 상황 알리기](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#user-facing-progress-updates) 참고). 이 지침을 추가하면 모델은 원래 중간 보고를 위해 멈췄을 지점에서도 계속 진행한다. 따라서 위험하거나 되돌릴 수 없는 작업에는 별도의 확인 단계를 유지하라. 사람이 중간에 관여하며 답변할 수 있는 애플리케이션에는 이 지침을 넣지 마라. 작업당 도구 호출과 출력 토큰은 다소 늘어날 수 있다.
## 안전장치에 따른 거절
클로드 오퍼스 5.5는 생물학, 사이버보안, 추론 과정 추출 등을 판별하는 안전 분류기를 사용한다.
* **생물학(Biology):** 생물학 안전장치는 클로드 페이블 5.1과 동일하며, 클로드 오퍼스 5에서 넘어왔다면 새로 적용되는 기능이다. 일상적인 건강 질문과 교육 목적의 질문에는 영향을 주지 않는다. 생물학 분류기가 조직의 생명과학 업무에 걸림돌이 된다면 [생명과학 인증 프로그램](https://www.anthropic.com/news/life-sciences-verification-program)에 신청하라.
* **사이버보안(Cybersecurity):** 소스 코드에서 취약점을 찾는 것은 허용된다. 위험도가 높은 이중용도 사이버보안 활동은 허용되지 않는다.
* **추론 과정 추출(Reasoning extraction):** 모델이 내부 추론 과정을 응답 본문에 재현하도록 요구하면 `reasoning_extraction` 범주로 거절될 수 있다. 클로드 오퍼스 5에서 넘어왔다면 새로 적용되는 범주다. 프롬프트에서 모델에 추론 과정을 써달라고 요청하고 있다면 해당 지침을 삭제하라. 대신 `display: "summarized"`를 설정하고 사고 블록에서 요약된 추론 내용을 읽어라. [사고 기능을 끈 상태에 맞춰 작성한 프롬프트](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#prompts-written-for-thinking-disabled)를 참고하라.
분류기에 따른 거절은 `stop_reason: "refusal"`과 범주를 명시하는 `stop_details` 객체가 포함된 일반 응답으로 도착한다. 요청을 대체 모델에서 자동으로 재시도하도록 설정할 수 있다. 다만 `reasoning_extraction` 거절은 예외다. 이 경우 서버 측 대체 모델 기능이 재시도하지 않고 거절 응답을 그대로 반환한다. [거절과 대체 모델](https://platform.claude.com/docs/en/models/opus-5-5/whats-new-opus-5-5#refusals-and-fallback)을 참고하라.
## 사용자에게 진행 상황 알리기
클로드 오퍼스 5.5는 도구 호출 사이에 방금 발견한 내용과 다음에 할 일을 짧게 알려준다. 사용자가 무엇을 보게 될지는 다음 네 가지 방법으로 조절할 수 있다.
첫째, 클라이언트가 알림을 수신하는지 확인하라. 클로드 오퍼스 5.5에서는 이 메모가 `text` 블록이 아니라 [진행 상황 알림용 `thinking` 블록](https://platform.claude.com/docs/en/build-with-claude/thinking#progress-updates)으로 반환된다. 기본 `thinking.display` 설정에서는 텍스트가 비어 있으므로 `text` 블록만 표시하는 클라이언트는 긴 에이전트 작업 중 아무 반응이 없는 것처럼 보일 수 있다. 각 메모의 짧은 요약을 받으려면 `display: "updates"`를 설정하라(베타, `thinking-display-updates-2026-08-18` 헤더). 표시 방법은 [마이그레이션 가이드](https://platform.claude.com/docs/en/models/opus-5-5/migration-guide#text-between-tool-calls)를 참고하라.
둘째, 긴 턴의 중간에 코드 조각처럼 사용자에게 원문 그대로 전달해야 할 내용이 있다면 메시지 전송용 간단한 도구를 제공하라. 해당 도구는 그런 내용을 보낼 때만 쓰라고 지시하라. 세션의 첫 요청부터 도구를 `tools`에 선언해야 한다. 나중에 `tools`에 추가하면 대화의 앞부분이 변경돼 이전 사고 블록이 무효화된다([보존되는 사고](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking#tool-changes) 참고).
셋째, 첫 도구 호출 전에 의도를 한 줄로 밝히고 마지막에 짧게 요약하는 등 알림을 더 자주 또는 일정한 시점에 받고 싶다면 시스템 프롬프트에 명시하라. 모델은 이런 지침에 잘 반응한다. 사람이 중간에 관여하는 작업에서 특히 유용하다.
넷째, 도구 호출이 이어지는 긴 턴에서 원하는 것보다 오랫동안 아무 소식이 없다면 실행 환경이 알림을 요청하도록 하라. 먼저 `display: "updates"`를 설정한 뒤, 사용자가 읽을 내용이 전혀 없는 연속 도구 호출 단계를 세어라. 여기서 읽을 내용이 없다는 것은 `text` 블록도, 진행 상황 알림 텍스트도 없다는 뜻이다. 이런 단계가 여러 번 이어지면, 예를 들어 다섯 번 연속 발생하면 최근 도구 결과 뒤에 아래 예시와 같은 알림 요청을 추가하라. 이때 [턴 범위 시스템 메시지](https://platform.claude.com/docs/en/build-with-claude/mid-conversation-system-messages#turn-scoped-system-messages)를 사용한다(`clear_at: "next_user_message"`; 베타, `mid-conversation-system-clear-at-2026-08-21` 헤더). 계속 아무 소식이 없더라도 알림 요청은 두세 번에서 멈춰라. 요청을 한 번만 넣었다가 다음 요청에서 삭제하는 대신 뒤에 덧붙인 상태로 유지하면 프롬프트 캐시가 계속 일치하고, 그 뒤에 오는 [사고 블록](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking#per-turn-reminders)도 유효하게 유지된다. 앤트로픽의 에이전트 코딩 작업 테스트에서는 비용에 측정 가능한 변화 없이, 장시간 아무 소식이 없는 작업의 비율이 대략 절반으로 줄었다.
## 여러 앱에 걸친 워크플로에서 맥락 탐색하기
이메일, 문서, 스프레드시트, CRM 기록 등 연결된 여러 앱에서 워크플로를 자동화할 때는 작업에 필요한 정보가 요청에 명시되지 않은 곳에 있는 경우가 많다. 오래된 이메일 대화에 정책이 있거나, 다른 스프레드시트 탭에 규칙이 있거나, 고객 기록에 메모가 남아 있을 수 있다. 클로드 오퍼스 5.5는 작업에 빠르게 착수하는 경향이 있다. 따라서 요청이 포괄적이라면 행동에 나서기 전에 관련 자료를 살펴보라고 지시하는 것이 좋다. 에이전트가 여러 앱에 걸쳐 이런 작업을 수행한다면 시스템 프롬프트에 한 문장만 추가해도 변경 작업 전에 주변 맥락을 확인하게 할 수 있다.
앤트로픽의 여러 앱 자동화 작업 테스트에서 이 지침을 받은 클로드 오퍼스 5.5는 `medium`과 `max` 작업 강도 모두에서 더 많은 작업을 정확히 완료했다. 대신 도구 호출과 토큰 사용량이 조금 늘었다. 모델이 발견한 내용을 바탕으로 행동하도록 지시하는 것이므로, 검색 대상 기록에는 신뢰할 수 없는 콘텐츠가 들어가지 않게 하라.
## 다중 에이전트 실행 환경에 시간 정보 제공하기
클로드 오퍼스 5.5는 경과 시간 정보를 주의 깊게 살핀다. 따라서 주 에이전트가 하위 에이전트에 작업을 위임하는 등의 다중 에이전트 환경에서는 시간 정보를 제공해 병렬 처리를 개선하고 작업을 앞당길 수 있다. 예상 작업 시간을 추정할 수 있다면 모델에 시간 예산을 알려줘라. 실행 환경이 모델에 돌려보내는 각 메시지 끝에 예산 대비 경과 시간을 초 단위로 짧게 추가하면 된다. 예를 들면 `elapsed 340s / 1200s`와 같다. 모델은 예산 안에 끝내도록 작업 속도를 조절하며, 대개 마감보다 훨씬 일찍 마친다. 따라서 실제로 원하는 소요 시간보다 예산을 조금 넉넉히 잡고, 자체 작업 표본으로 조정하라. 적절한 예산을 예측할 수 없다면 경과 시간만 표시하고 시스템 프롬프트에 한 문장을 추가하라.
앤트로픽이 소규모 에이전트 팀의 연구 작업을 평가했을 때, 두 방식 모두 시간 정보를 받지 않은 단일 에이전트보다 팀의 작업 완료 시간을 앞당겼다. 시간 예산을 받은 팀은 단일 에이전트와 비슷한 답변 품질을 유지하면서 훨씬 빨리 끝냈다. 시간 예산을 줄이는 것과 작업 강도를 낮추는 것은 효과가 다르다. 작업 강도를 낮추면 수행하는 작업 자체가 줄어들지만, 시간 예산은 주로 더 많은 에이전트가 병렬로 일하도록 한다. 예산은 권고 사항일 뿐 한도에 도달해도 모델이 자동으로 멈추지 않는다. 반드시 멈춰야 한다면 별도의 시간 제한을 설정하라. 시간 압박을 받으면 모델이 검색과 검증을 다소 줄일 수 있으므로 자체 작업에서 답변 품질도 확인하라.
## 채팅 시스템 프롬프트의 사고 지침
채팅 앱의 시스템 프롬프트에 답변하기 전에 신중히 생각하라는 지침이 있다면, 클로드 오퍼스 5.5에서는 삭제를 고려하라. 모델이 사고량을 스스로 결정하며, 이를 제어하는 주된 설정은 [작업 강도](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#calibrate-effort)다. 앤트로픽의 채팅 제품 테스트에서는 그런 문장을 삭제하자 답변이 더 빨리 시작됐고, 답변 품질이 뚜렷하게 떨어지지는 않았다.
여러 턴에 걸친 채팅에서는 클로드 오퍼스 5.5가 짧은 후속 메시지에도 이전 답변을 다시 검토하는 경우가 있다. 이로 인해 후속 턴의 사고량과 지연 시간이 늘어난다. 모델이 이전 답변을 이미 확정된 것으로 다루게 하고 싶다면 시스템 프롬프트 끝에 두 문장을 추가하라.
앤트로픽의 테스트에서 이 지침은 품질에 영향을 주지 않으면서 후속 턴의 사고량을 줄이고 답변이 더 빨리 시작되게 했다. 긴 분석처럼 이전 작업을 계속 재검토해야 하거나, 나중 단계에서 앞선 단계의 실수가 드러날 수 있는 에이전트 작업에는 넣지 마라. 이 지침으로 인해 모델이 이전 답변의 실수를 스스로 지적할 가능성도 줄어들 수 있다. 애플리케이션에서 이 기능이 중요하다면 지침을 도입하기 전에 시험하라.
## 사용자 메시지에서 붙여 넣은 텍스트 표시하기
클로드 오퍼스 5.5는 도구 결과, 웹페이지, 화면이나 브라우저의 콘텐츠를 통해 들어오는 지시, 즉 간접 프롬프트 인젝션에 이전 오퍼스 모델보다 잘 저항한다. 맥락을 적절히 제공하면 사용자가 이메일이나 웹페이지 등 다른 곳에서 복사해 메시지에 붙여 넣은 내용 속 지시에도 흔들리지 않는다. 이렇게 동작하도록 하려면 사용자가 직접 쓴 텍스트와 다른 곳에서 붙여 넣은 텍스트를 구분해 표시하라. 붙여 넣은 각 블록을 여는 태그와 닫는 태그로 감싸고, 애플리케이션에서 생성한 동일한 짧은 무작위 ID를 두 태그에 넣어라. 각 태그는 별도의 줄에 배치한다.
그런 다음 시스템 프롬프트에 다음 안내를 추가하라.
이 방식은 때때로 모델을 조금 더 신중하게 만들 수 있으므로 자체 작업에 미치는 영향을 측정하라. 태그는 일반 텍스트라 모방할 수 있다. 따라서 이것만 믿지 말고 다른 [프롬프트 인젝션 방어 수단](https://platform.claude.com/docs/en/test-and-evaluate/strengthen-guardrails/mitigate-jailbreaks#indirect-prompt-injection)과 함께 사용하라.
## 복잡한 시각 자료를 위한 도구
클로드 오퍼스 5.5는 도구 없이도 클로드 오퍼스 5보다 차트, 다이어그램, 스크린샷을 훨씬 정확하게 읽는다([프롬프트 작성과 관련된 기능](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#capability-improvements) 참고). 따라서 이전 모델의 시각 자료 처리를 위해 마련한 보조 구성이 여전히 필요한지 다시 시험하라. 정보가 가장 빽빽한 자료에는 여전히 두 가지가 정확도를 높인다. 하나는 고해상도 이미지로, 특히 기술 도면에 효과적이다. 다른 하나는 이미지 처리 도구다. 원본 이미지를 보관하고 PIL, OpenCV 같은 라이브러리가 설치된 컨테이너에 에이전트가 접근할 수 있게 하라. 그러면 이미지를 잘라내고 확대하거나 측정하고, 자신의 분석 결과를 검증할 수 있다. 컨테이너를 마련하기 부담스럽다면 이미지 자르기 도구만 있어도 도움이 된다. 실행 가능한 도구 정의는 [이미지 자르기 도구 예제](https://platform.claude.com/cookbook/multimodal-crop-tool)를 참고하라. 모델은 작업 강도가 높을수록 이런 도구를 효과적으로 사용한다. 도구가 없을 때 작업 강도를 높이면 기술 도면을 읽는 능력은 좋아지지만, 차트를 읽는 능력에는 큰 도움이 되지 않는다.
## 프런트엔드 디자인 기본값
디자인 방향을 제시하지 않고 프런트엔드 작업을 요청하면 클로드 오퍼스 5.5는 몇 가지 기본 스타일을 택한다. “전형적인 AI 디자인처럼 보이지 않게 하라” 같은 포괄적인 지침은 대체로 다른 기본 스타일로 바꾸는 데 그친다. 아래 예시처럼 피해야 할 구체적인 패턴을 짚어주면 잘 반응한다. 반복해서 개선하라. 첫 결과에 대신 어떤 스타일이 쓰였는지 확인하고, 필요하면 피해야 할 패턴 목록을 늘려라.