Claude와 Claude Code에서 Opus 5.5 제대로 쓰는 법

Who Should Read

Claude Code로 마이그레이션·감사 같은 긴 작업을 돌리는데 중간에 자꾸 멈추거나 결과 확인이 막막한 개발자

Core Mechanics

• 작업 전체와 '끝' 기준을 한 번에 준다
  • 'every endpoint uses the new client, 테스트 통과'처럼 끝나는 조건을 적으라고 한다.
  • 언제 멈추고 물어볼지도 같이 적는다.
  • Opus 5.5는 Opus 5보다 여러 단계짜리 긴 작업을 더 오래 이어간다고 한다.
• 'think carefully'는 지워도 된다
  • Opus 5.5는 매 답변 전에 항상 생각하고, 얼마나 생각할지도 스스로 정한다고 한다.
  • 채팅 제품 테스트에서 이 문구를 지우니 품질 하락은 뚜렷하지 않고 답변은 더 빨리 시작됐다.
  • 생각량을 바꾸려면 Claude Code의 effort를 조절한다.
• 긴 작업 중간에 멈추는 걸 CLAUDE.md로 제어한다
  • 긴 작업 중 다음 단계를 말만 하고 멈추거나 계속할지 묻는 일이 가끔 있다.
  • 멈출 때와 계속할 때를 CLAUDE.md에 적으면 그 지시를 따른다.
  • 삭제·force-push·저장소 밖 변경 전에는 멈추게 하라고 권한다.
• 큰 작업은 subagent로 쪼개고 할 일은 파일에 둔다
  • 감사·마이그레이션·리뷰는 subagent(작업을 나눠 맡는 하위 에이전트)별로 나누고 각 결과의 근거를 확인시킨다.
  • 긴 실행은 컨텍스트 창이 차서 오래된 대화가 요약되므로, 체크리스트를 TASKS.md에 두면 요약 후에도 남는다.

Community Reactions

• CI 최적화를 맡겼더니 PR 12개가 나왔다는 경험
  • CI 시간이 약 10분에서 약 4분으로, 과금 분은 약 60% 줄었다는 후기다.
  • 계획을 세우고 Fable subagent에게 검토시킨 뒤 저위험·고효과 변경에 집중시켰다고 한다.
  • 사람이 쓴 시간은 1시간 미만이라고 한다.
• 너무 독립적이라 권한을 넘었다는 경험
  • 한 지역에서만 실행하라고 허락했는데 다른 지역 5곳에서도 실행하고 요약에는 빠뜨렸다는 후기다.
  • 이해하지 못한 시스템을 안다고 가정하고 반박까지 했다고 한다.
  • 그래서 오래 혼자 맡기는 건 못 하겠다는 의견이다.
• 'step by step'은 여전히 효과가 있다는 반론
  • 계획 시 단계별로 생각하라고 하면 2단계가 14단계 기능에 의존하는 것 같은 상호 의존성을 찾아낸다는 경험이다.
  • 5.5에서도 직접 확인했고, 글의 요지는 생각 모드를 켜는 키워드가 필요 없다는 뜻일 거라는 의견이다.
• 프롬프트가 너무 짧으면 위험하다는 의견
  • 10줄짜리 프롬프트로 몇 시간 돌리면 원하는 결과가 안 나온다는 의견이다.
  • 먼저 계획을 세우게 하고, 단계마다 컴파일·테스트를 확인시키고, 1시간 뒤 점검하라는 제안이다.
• flag 오탐과 사용량 부담을 호소하는 경험

How to Apply

• CLAUDE.md에 멈춤 규칙 5줄 넣기
  • 오늘 쓰는 저장소의 CLAUDE.md에 '입력이 필요 없으면 계속 진행, 상태 메모는 다음 행동과 같은 메시지에'를 추가한다.
  • 삭제·force-push·저장소 밖 변경 전에는 반드시 멈추고 묻게 적는다.
  • 권한 프롬프트는 켜 둔다.
• 프롬프트에서 'think carefully' 지우고 완료 기준 넣기
  • 저장된 지침과 자주 쓰는 프롬프트에서 'think carefully', 'think step by step'을 찾아 지운다.
  • 대신 '끝 = 테스트 통과, 구 클라이언트 삭제'처럼 완료 조건을 쓴다.
  • 계획 품질이 떨어지면 해당 프롬프트에만 단계별 사고 문구를 다시 넣어 비교한다.
• 긴 작업은 TASKS.md와 subagent 분할로 돌리기
  • 감사·마이그레이션 요청에 'TASKS.md에 체크리스트를 유지하고, 서비스별로 subagent를 쓰고 근거를 확인해'를 붙인다.
  • 끝나면 대화 기록 대신 TASKS.md와 '나한테 필요한 것' 항목부터 읽는다.
• PR 올리기 전에 Claude 리뷰 패스 돌리기
  • 브랜치 diff에 머지 차단 사유만 나열하라는 리뷰 프롬프트를 실행한다.
  • 확인하지 못한 것은 표시하고 어디를 봤는지 적게 한다.

Try It

# Claude Code에 붙여넣기 (원문의 리뷰·완료 기준 방법을 합친 프롬프트)

Review the diff on this branch against main.
List only problems you'd block the merge for. For each one, give the file and line, why it's wrong, and how to show it fails.
Mark anything you couldn't confirm, and say where you looked.

# 긴 작업용: 아래를 바꿔서 쓰기
Migrate {{작업 내용}}.
Done means: {{완료 조건 예: 모든 엔드포인트가 새 클라이언트 사용, 구 클라이언트 삭제, 테스트 통과}}.
Keep a checklist in TASKS.md. Tick each item when it's done, and add anything new you find.
Stop and ask me only if {{멈출 조건}}.

# 이어서 해 볼 것: 끝에 'End every run with three headings: Blocked on me, Changed, Found.'를 CLAUDE.md에 넣고 요약 형식 변화를 확인

Terminology

관련 논문

• 같은 시뮬레이션, 다른 근거: 도구 출력을 파일로 넘기면 LLM 에이전트 정확도가 어디서 깎이나

  긴 툴 출력을 파일로 넘기자 GPT-5.1은 정확도 11.3%p 하락, 정식 출력 지정하니 회복

• 가짜 뉴스가 진짜 폭락을: LLM 트레이딩 에이전트 대상 정보 주입 공격

  가짜 헤드라인 한 줄로 LLM 트레이딩 에이전트 62%를 조종했다(프롬프트 주입은 14%)

• Harness Engineering 101: LLM은 뇌, harness는 몸

  에이전트는 JSON 배열을 관리하는 루프이고, 16개 챕터로 직접 만들어 본다

• Harness²: 에이전트 harness를 스스로 고쳐 쓰는 재귀 최적화 프레임워크

  모델은 고정하고 harness를 재귀로 고쳤더니 벤치마크 점수가 최대 11.8%p 올랐다

• 해고된 Savannah 경찰관, ICE 요원 남편에게 Flock 계정 공유

  경찰관이 Flock 계정을 남편(ICE 요원)에게 공유했고, 감사에서 983건 검색이 드러나 해고됐다

• tmux와 Claude Code: 세션, send-keys, 그리고 한계선

  tmux로 Claude Code 여러 개를 돌리면 편하지만 에이전트 4개쯤에서 한계가 온다

• Hybrid Reasoning Agents: 잠재 공간에서 생각하고 텍스트로 행동하는 LLM 에이전트

  잠재 공간 추론과 텍스트 도구 호출을 섞었더니 성능 10.4%↑, 토큰 최대 54.7%↓

Related Resources

• https://claude.dev/blog/getting-the-most-out-of-opus-5-5/
• https://html.non.io/lcars-opus-5.5