본문 바로가기
AI 실전 활용

Claude Code 창시자가 말하는 프롬프트 레벨업 실전 팁 4가지 - '고쳐줘' 대신 써야 할 진짜 지시문들

by 심독 2026. 6. 28.
반응형

핵심 요약

  • Claude Code 창시자 Boris Cherny는 "이 변경사항을 엄격히 검토하고, 내가 테스트를 통과할 때까지 PR 만들지 마"라는 지시로 Claude를 리뷰어로 활용한다고 공개했다. (출처: Boris Cherny X, 2026.02)
  • "이게 작동한다는 걸 증명해봐"라는 요청으로 main 브랜치와 feature 브랜치 간 동작 차이를 diff하도록 시킨다.
  • 평균적인 수정 결과가 나오면 "지금까지 알게 된 모든 것을 바탕으로 이걸 버리고 우아한 솔루션을 구현해"라고 재요청한다.
  • Claude가 더 많은 연산을 투입하길 원할 때는 요청에 "use subagents"라는 문구를 추가하면 메인 에이전트의 컨텍스트가 깔끔하게 유지된다.

목차

  1. 문제 제기 — "고쳐줘"로만 지시하고 있다면
  2. 팁 1: Claude를 엄격한 리뷰어로 만들기
  3. 팁 2: "증명해봐"로 동작을 검증시키기
  4. 팁 3: 평범한 결과를 버리고 다시 시키기
  5. 팁 4: 서브에이전트로 컨텍스트 분리하기
  6. 마치며

1. 문제 제기 — "고쳐줘"로만 지시하고 있다면

Claude Code를 쓰는 많은 사람이 비슷한 패턴으로 지시를 내린다.
"이 버그 고쳐줘", "이 함수 개선해줘" 같은 짧은 요청이다.
이런 지시는 작동하지만, 결과물의 품질이 평균적인 수준에 머무르는 경우가 많다.

 

2026년 2월 Claude Code 창시자 Boris Cherny가 X에 공개한 실전 사용 팁 중에는
"프롬프트 수준 끌어올리기"라는 항목이 있다.


여기에는 짧은 지시문 4가지가 담겨 있는데,
이 문구들을 그대로 쓰는 것만으로 결과물의 품질이 달라진다.

 

'엄격한 검토, 동작 증명, 재구현 요청, 서브에이전트 활용'


2. 팁 1: Claude를 엄격한 리뷰어로 만들기

첫 번째 팁은 Claude에게 작업을 맡긴 뒤, 그 결과를 다시 Claude에게 검토시키는 방식이다.

 

공개된 지시문은 다음과 같다.

"이 변경사항을 엄격히 검토하고, 내가 테스트를 통과할 때까지 PR 만들지 마."

 

이 지시문의 핵심은 두 가지다.

[일반적인 지시]
"코드 짜고 PR 만들어"
→ Claude가 코드를 작성하고 바로 PR 생성

[레벨업된 지시]
"엄격히 검토하고, 테스트 통과할 때까지 PR 만들지 마"
→ Claude가 자체 검증 단계를 거친 후에만 PR 생성

 

"PR 만들지 마"라는 명시적 제약이
Claude로 하여금 충분히 검증되지 않은 결과물을 섣불리 제출하지 않도록 막는다.


단순히 "검토해줘"보다 "테스트를 통과할 때까지"라는
구체적인 통과 기준을 제시하는 것이 효과의 핵심이다.


3. 팁 2: "증명해봐"로 동작을 검증시키기

두 번째 팁은 결과물이 정말 작동하는지를 의심하고 확인을 요구하는 방식이다.

"이게 작동한다는 걸 증명해봐"라고 하며 main 브랜치와 feature 브랜치 간 동작 차이를 diff하도록 요청한다.

 

이 방식의 작동 원리는 다음과 같다.

1. "이게 작동한다는 걸 증명해봐" 지시
2. Claude가 main 브랜치에서의 동작을 기록
3. Claude가 feature 브랜치에서의 동작을 기록
4. 두 결과를 diff로 비교
5. 의도한 변경이 실제로 반영됐는지 시각적으로 확인

 

이 방식이 효과적인 이유는,
Claude가 "작동합니다"라고 말로만 보고하는 것과
실제로 동작 차이를 증거로 제시하는 것 사이의 간극을 메워주기 때문이다.


코드가 실제로 의도한 대로 바뀌었는지를 Claude 스스로 입증하게 만드는 검증 장치다.


4. 팁 3: 평범한 결과를 버리고 다시 시키기

세 번째 팁은 처음 받은 결과물이 기대에 못 미칠 때 쓰는 재요청 방식이다.

평균적인 수정 결과가 나오면
"지금까지 알게 된 모든 것을 바탕으로 이걸 버리고 우아한 솔루션을 구현해"라고 지시한다.

 

이 지시문의 구조를 분석하면 두 가지 요소가 들어 있다.

요소 역할
"지금까지 알게 된 모든 것을 바탕으로" 첫 시도에서 얻은 컨텍스트와 학습을 유지하도록 지시
"이걸 버리고 우아한 솔루션을 구현해" 기존 코드에 얽매이지 않고 처음부터 다시 설계하도록 유도

 

단순히 "다시 해줘"라고 하면 Claude가 기존 코드를 조금씩 수정하는 방향으로 갈 수 있다.
반면 "버리고 다시 구현해"는 완전히 새로운 접근을 시도하게 만들면서도,
첫 시도에서 파악한 문제점과 제약 조건은 그대로 활용하게 한다.

첫 시도가 "탐색"의 역할을 하고, 두 번째 시도가 "완성"의 역할을 하는 구조다.

 

이 모든 레벨업 기법의 전제 조건도 함께 공개됐다.
"작업 전달 전 상세한 스펙 작성과 모호함 제거가 출력 품질 향상의 핵심"이라는 것이다.
즉 지시문 자체가 정교해도, 애초에 요구사항이 모호하면 효과가 떨어진다.


5. 팁 4: 서브에이전트로 컨텍스트 분리하기

네 번째 팁은 더 복잡한 작업에서 Claude가 더 많은 연산 자원을 투입하도록 유도하는 방법이다.

Claude가 더 많은 연산을 투입하길 원하면 요청에 "use subagents"를 추가한다.

 

이 지시가 효과적인 이유는 서브에이전트의 구조적 장점에 있다.
"개별 작업을 서브에이전트에 위임해
메인 에이전트의 컨텍스트 윈도우를 깔끔하고 집중된 상태로 유지한다"는 것이다.

[서브에이전트 없이]
메인 에이전트 컨텍스트
= 작업 A 진행 내용 + 작업 B 진행 내용 + 작업 C 진행 내용
→ 컨텍스트가 뒤섞이고 길어짐

[서브에이전트 활용 시]
메인 에이전트 컨텍스트 = 전체 조율 정보만
서브에이전트 1 = 작업 A 전담
서브에이전트 2 = 작업 B 전담
서브에이전트 3 = 작업 C 전담
→ 각 컨텍스트가 분리되어 깔끔하게 유지

 

"use subagents"라는 짧은 문구 하나만 추가해도
Claude는 작업을 여러 서브에이전트로 나누어 처리하는 방향으로 움직인다.

 

실무 적용 가이드:
4가지 팁 중 가장 먼저 시도해볼 만한 것은
"이게 작동한다는 걸 증명해봐"이다.
별도 설정 없이 바로 입력할 수 있고, 효과를 즉시 체감할 수 있다.
익숙해지면 "엄격히 검토" 지시와 "use subagents"를 함께 조합해 더 복잡한 작업에 적용해보는 것이 좋다.

 


FAQ

Q: Claude를 리뷰어로 활용하는 정확한 지시문은 무엇인가?
A: "이 변경사항을 엄격히 검토하고, 내가 테스트를 통과할 때까지 PR 만들지 마"이다.
명시적인 통과 기준을 제시하는 것이 핵심이다.

Q: "이게 작동한다는 걸 증명해봐"는 어떤 방식으로 작동하는가?
A: Claude가 main 브랜치와 feature 브랜치에서의 동작을 각각 기록하고 diff로 비교해,
의도한 변경이 실제로 반영됐는지 시각적으로 확인하게 만드는 검증 방식이다.

Q: 평범한 결과가 나왔을 때 어떤 식으로 재요청해야 하는가?
A: "지금까지 알게 된 모든 것을 바탕으로 이걸 버리고 우아한 솔루션을 구현해"라고 지시한다.
기존 코드를 그대로 수정하기보다 첫 시도의 학습을 유지하면서 완전히 새로 설계하도록 유도하는 방식이다.

Q: "use subagents"는 언제 추가하는 것이 효과적인가?
A: 작업이 복잡해서 더 많은 연산 투입이 필요하다고 느낄 때 추가한다.
개별 작업을 서브에이전트에 위임해 메인 에이전트의 컨텍스트를 깔끔하게 유지하는 효과가 있다.


마치며

Claude Code에서 받는 결과물의 품질은 지시문의 정교함에 직접적으로 영향을 받는다.

  • "고쳐줘"라는 한 단어 대신, 엄격한 검토를 요구하고,
  • 동작을 증명하게 하고,
  • 평범한 결과를 버리고 재구현시키고,
  • 필요할 때 서브에이전트를 활용하는
    4가지 지시문을 적용하면 같은 Claude Code에서도 전혀 다른 수준의 결과를 받을 수 있다.

이 문구들은 추측이 아니라 Claude Code를 만든 사람이 실제로 매일 쓰는 것들이다.


참고자료

반응형