← 목록으로

클로드 코드, 고수처럼 쓰는 9가지 원칙

Anthropic 내부 팀이 검증한, 클로드 코드로 잘 일하는 방식

루프 엔지니어링 Routines 예약 실행 고수처럼 쓰기
컨텍스트가 모든 원칙의 뿌리입니다

클로드 코드는 질문에 답하고 기다리는 챗봇이 아닙니다. 파일을 읽고, 자료를 분석하고, 결과물을 직접 만들고, 스스로 문제를 풀어 나가는 에이전트입니다. 그래서 일하는 방식이 달라집니다. 하나하나 직접 하는 대신, 원하는 결과를 설명하면 Claude가 자료를 찾고 계획을 세워 만들어 냅니다.

다만 이 자율성에는 큰 제약이 하나 따릅니다. 바로 컨텍스트 창입니다. Claude가 한 번에 펼쳐 놓고 일하는 책상이라고 보면 됩니다. 주고받은 모든 메시지, Claude가 읽은 모든 파일, 모든 작업 결과가 여기 쌓입니다. 넓지만 무한하지는 않아서, 긴 보고서 하나나 자료 한 더미만 읽어도 금세 채워집니다.

이 책상이 찰수록 Claude의 판단력은 떨어집니다. 가득 차면 앞선 지시를 잊고 실수도 잦아집니다. 그래서 컨텍스트는 가장 먼저 관리해야 할 자원입니다. 아래 9가지 원칙도 대부분 이 하나의 사실에서 출발합니다.

🎯
기본기 · 잘 시키는 법원칙 1~3
1 스스로 검증하게 만드세요 핵심
원칙

다시 계산한 합계, 원본과 맞춰 본 수치, 시안과 비교한 화면. 곁에서 지켜봐야 하는 일과 맡기고 자리를 비울 수 있는 일을 가릅니다.

Claude는 작업이 끝나 보이면 멈춥니다. 스스로 평가할 기준이 없으면 "끝난 것 같다"가 유일한 신호이고, 검증은 사람 몫으로 남습니다. 실수가 있어도 사람이 발견할 때까지 그대로 흘러갑니다.

맞고 틀림을 가려 주는 기준을 주면 이 루프가 알아서 닫힙니다. Claude가 작업하고, 스스로 맞춰 보고, 어긋난 곳을 고치고, 맞을 때까지 반복합니다. 기준은 대화 안에서 결과를 확인할 수 있는 것이면 무엇이든 좋습니다. 원본과 맞춰 본 합계, 빠진 항목을 확인하는 점검 목록, 시안과 비교한 화면, 사실인지 따져 보는 질문.

지시를 이렇게 바꿉니다

전략그냥이렇게
검증 기준 제시"3분기 매출 요약해줘""3분기 매출을 정리해줘. 지역별 합계가 전체 합계와 맞는지 다시 계산해 확인하고, 어긋나면 어디서 틀렸는지 알려줘"
결과를 눈으로 확인"대시보드 보기 좋게 해줘""[시안 이미지] 이 디자인대로 대시보드를 만들고, 결과를 화면으로 찍어 시안과 비교해 차이를 고쳐줘"
증상이 아니라 원인"이 보고서 이상해""이 보고서의 성장률이 이상해. 원본 데이터로 분모가 맞는지 확인하고, 추정 말고 원본 기준으로 다시 계산해줘"

잘됐다고 말로만 하지 말고 근거를 보여 달라고 하세요. 다시 계산한 수치, 대조한 원본, 결과 화면이면 됩니다. 근거를 확인하는 편이 직접 다시 점검하는 것보다 빠르고, 지켜보지 못한 작업에도 그대로 통합니다.

2 탐색하고, 계획하고, 그다음 만드세요
원칙

조사와 계획을 실제 작성과 분리하면, 엉뚱한 결과물을 만드는 일을 막습니다.

곧바로 만들게 하면 엉뚱한 문제를 푼 결과물이 나오기 쉽습니다. Plan 모드로 탐색과 실행을 나누면 이를 막을 수 있습니다. 권장 흐름은 네 단계입니다.

  • 탐색. Plan 모드로 들어갑니다. Claude는 결과물을 만들지 않고 자료를 읽으며 질문에 답합니다. 예: "작년 사업계획서와 이번 분기 실적을 읽고 핵심 메시지가 무엇인지 파악해줘."
  • 계획. 작성 계획을 구체적으로 세우게 합니다. 예: "신사업 제안서를 쓰려고 합니다. 자료가 더 필요한지, 목차는 어떻게 잡을지 계획을 세워줘."
  • 만들기. Plan 모드를 끄고 계획대로 작성하게 합니다. 근거 자료와 대조하면서 진행합니다.
  • 마무리. 최종본으로 정리하고, 공유할 형태로 다듬게 합니다.

Plan 모드는 유용하지만 품이 듭니다. 오타 수정이나 문구 한 줄 다듬기처럼 작고 분명한 일은 바로 시키세요. 계획이 빛을 보는 때는 접근법이 불확실하거나, 여러 자료를 엮어야 하거나, 다루는 주제가 낯설 때입니다. 한 문장으로 결과를 설명할 수 있다면 계획은 건너뜁니다.

3 프롬프트에 구체적인 맥락을 담으세요 핵심
원칙

지시가 구체적일수록 고치는 횟수가 줄어듭니다.

Claude는 의도를 추론하지만 마음까지 읽지는 못합니다. 어떤 자료를 볼지 알려 주고, 지켜야 할 조건을 말하고, 따라야 할 예시를 보여 주세요.

전략그냥이렇게
범위 좁히기"보고서 검토해줘""이 보고서에서 3분기 매출 부분만 봐줘. 작년 같은 분기와 비교해 빠진 관점이 있는지 찾아줘"
출처 가리키기"이 수치 왜 이래?""이 매출 수치가 원본 시트에서 어떤 계산식으로 집계됐는지 따라가 정리해줘"
기존 예시 참고"제안서 써줘""지난번 통과된 제안서(첨부)를 보고 구조와 톤을 파악해줘. 그 틀을 따라 이번 신사업 제안서를 써줘"
증상 설명"이 분석 틀렸어""이 분석에서 성장률이 이상해. 원본 데이터의 분모가 맞는지 확인하고, 틀렸으면 다시 계산해줘"

풍부한 자료를 건네는 법

  • @로 파일 참조. 자료 위치를 설명하는 대신 @파일명으로 엑셀·문서·PDF를 바로 가리킵니다. Claude가 먼저 읽고 답합니다.
  • 이미지 붙여넣기. 차트나 표, 시안 화면을 복사해 붙이거나 끌어다 놓습니다.
  • URL 전달. 참고할 기사나 자료의 주소를 줍니다.
  • 데이터 붙여넣기. 표나 수치를 그대로 붙여 넣어 바로 분석하게 합니다.

막연한 프롬프트가 쓸모 있을 때도 있습니다. 방향을 틀 여유가 있는 탐색 단계입니다. "이 자료에서 무엇을 개선하면 좋을까?" 같은 질문은 미처 떠올리지 못한 지점을 드러냅니다.

⚙️
환경과 운영원칙 4~6
4 작업 환경을 갖추세요
원칙

몇 가지만 설정해 두면 모든 세션의 효율이 올라갑니다.

프로젝트 지침(CLAUDE.md)을 잘 씁니다

CLAUDE.md는 Claude가 대화를 시작할 때마다 읽는 프로젝트 지침입니다. 자주 쓰는 자료의 위치, 보고서 형식, 말투 규칙을 적어 두면 매번 설명하지 않아도 됩니다. /init으로 초안을 만든 뒤 다듬으세요.

핵심은 짧게 유지하는 것입니다. 한 줄마다 물으세요. "이 줄을 지우면 Claude가 실수할까?" 아니라면 지웁니다. 지침이 길어지면 정작 중요한 규칙이 묻힙니다.

담을 것뺄 것
Claude가 추측 못 하는 회사 용어·약어자료를 보면 알 수 있는 것
기본과 다른 보고서·문서 형식 규칙Claude가 이미 아는 일반 상식
선호하는 말투와 톤자주 바뀌는 정보
자주 쓰는 자료·데이터의 위치한 번 쓰고 마는 일회성 내용
꼭 지켜야 할 표기·금지 규칙"잘 써라" 같은 자명한 말

그 밖의 환경 설정

  • 권한. 자동 승인 모드로 매번 확인하는 수고를 줄이거나, 안전한 작업만 골라 허용합니다.
  • 커넥터·MCP. 노션, 구글 드라이브, 사내 데이터를 연결해 Claude가 직접 가져오게 합니다.
  • 스킬. 뉴스 클리핑이나 보고서 양식처럼 자주 하는 작업을 스킬로 등록하면 한 마디로 불러 씁니다.
  • 서브에이전트. 자료 조사처럼 따로 떼어 맡길 일은 전문 보조에게 넘겨, 본 대화를 깨끗하게 둡니다.
5 효과적으로 소통하세요
원칙

어떻게 묻느냐가 결과의 질을 가릅니다.

자료와 업무에 질문합니다

새 자료나 프로젝트를 받았을 때, 동료에게 묻듯 Claude에게 물으세요. 특별한 요령은 필요 없습니다.

  • 이 보고서는 어떤 논리로 이 결론에 이르렀나요?
  • 이 데이터에서 가장 중요한 추세는 무엇인가요?
  • 이 계약서 3조는 무슨 뜻인가요?
  • 이 수치가 작년 같은 기간보다 낮은 이유는 무엇인가요?

Claude가 먼저 인터뷰하게 합니다

사업계획서나 전략 보고서처럼 규모가 큰 작업은 Claude가 먼저 질문하게 하세요. 짧은 프롬프트로 시작해 AskUserQuestion 도구로 인터뷰를 요청합니다. 그러면 목적, 대상 독자, 놓치기 쉬운 관점까지 미처 생각하지 못한 지점을 물어 옵니다.

> [간단한 설명]을 만들고 싶어. AskUserQuestion 도구로 자세히 인터뷰해줘. > 목적, 대상 독자, 꼭 담을 내용, 빠지기 쉬운 관점, 제약을 물어봐. > 뻔한 질문 말고 놓치기 쉬운 부분을 파고들어줘. > 다 정리되면 기획 메모로 남겨줘.

기획 메모가 완성되면 새 세션을 열어 작성을 맡기세요. 새 세션은 작성에만 집중하는 깨끗한 컨텍스트로 시작하고, 참고할 기획 메모도 손에 있습니다. 기획을 정교하게 다듬는 시간이 작성 과정을 지켜보는 시간보다 더 값집니다.

6 세션을 관리하세요 핵심
원칙

대화는 저장되고 되돌릴 수 있습니다. 이 점을 적극 활용하세요.

일찍, 자주 바로잡습니다

가장 좋은 결과는 촘촘한 피드백에서 나옵니다. 어긋난다 싶으면 곧바로 바로잡으세요.

  • Esc. 작업 도중 멈춥니다. 컨텍스트는 남아 있어 방향을 다시 잡을 수 있습니다.
  • Esc 두 번 또는 /rewind. 이전 대화와 작업 상태로 되돌립니다.
  • "되돌려줘". Claude가 방금 한 변경을 취소하게 합니다.
  • /clear. 무관한 작업 사이에 컨텍스트를 통째로 비웁니다.

같은 문제를 두 번 넘게 바로잡았다면, 컨텍스트가 이미 실패한 시도로 어질러진 상태입니다. /clear로 비우고, 배운 점을 담아 더 구체적인 프롬프트로 다시 시작하세요. 깨끗한 세션에 좋은 프롬프트 하나가 길게 끌며 쌓은 정정보다 거의 늘 낫습니다.

서브에이전트로 조사합니다

컨텍스트가 근본 제약이다 보니, 서브에이전트는 가장 강력한 도구의 하나입니다. Claude가 자료를 폭넓게 조사하면 문서를 많이 읽어 컨텍스트를 잡아먹습니다. 서브에이전트는 별도 컨텍스트에서 조사하고 요약만 돌려줍니다.

> 서브에이전트를 써서 경쟁사 다섯 곳의 최근 분기 실적과 > 공개된 전략 방향을 조사해 핵심만 정리해줘.

결과를 점검할 때도 씁니다. "서브에이전트로 이 보고서에서 빠진 관점을 찾아줘." 체크포인트도 함께 쓰세요. 프롬프트를 보낼 때마다 체크포인트가 생기므로, 과감하게 시켜 보고 아니다 싶으면 되감으면 됩니다. 다만 체크포인트는 Claude의 변경만 따라가므로, 원본을 따로 백업하는 일까지 대신하지는 않습니다.

🚀
숙련 · 멀리, 오래원칙 7~9
7 자동화하고 확장하세요
원칙

익숙해졌다면 한 단계 더 갑니다. 반복 작업은 예약해 두고, 큰 일은 여러 세션에 나눠 맡깁니다.

반복 작업은 예약해 둡니다

매일이나 매주 똑같이 하는 일은 Routines로 예약해 두면, 정해진 시각에 클라우드에서 알아서 돕니다. 아침 뉴스 브리핑이나 주간 실적 요약처럼 손이 가던 일을 무인으로 받습니다.

> 매일 아침 7시, 관심 산업의 주요 뉴스 10건을 모아 > 사실과 시사점으로 정리해 메신저로 보내줘. (Routines로 예약)

여러 세션을 동시에 돌립니다

데스크톱 앱이나 웹에서 세션을 나란히 띄웁니다. 일을 나눠 처리하는 것은 물론, 새 컨텍스트는 검토의 질도 높입니다. 방금 쓴 글에 치우치지 않기 때문입니다. 한 세션이 보고서를 쓰고 다른 세션이 처음 보는 눈으로 검토하는 작성자·검토자 방식이 대표적입니다.

여러 건에 같은 양식을 한꺼번에 적용합니다

지점별 보고서나 여러 문서를 같은 기준으로 정리해야 한다면, 먼저 한두 건으로 양식과 지시를 다듬은 뒤 나머지에 똑같이 적용하게 합니다. 한 건이 잘 나오면 나머지는 빠릅니다.

마지막에 점검하는 눈을 더합니다

오래 맡길수록 독립된 점검이 중요합니다. 새 세션이나 서브에이전트는 결과물과 기준만 볼 뿐, 그것을 만든 과정은 보지 않습니다. 그래서 결과를 있는 그대로 평가합니다. "이 보고서를 기준에 비춰 빠진 점만 알려줘"처럼 시키세요. 다만 점검하는 쪽은 시키면 무엇이든 찾아내기 마련입니다. 모든 지적을 좇다 보면 과해집니다. 정확성과 꼭 필요한 요건에 관계된 지적만 다루게 하세요.

8 흔한 실패 패턴을 피하세요
원칙

일찍 알아채면 시간을 아낍니다.

패턴증상해결
잡탕 세션한 가지 일을 하다 엉뚱한 걸 묻고 다시 돌아옵니다. 컨텍스트가 무관한 정보로 찹니다.일이 바뀔 때마다 /clear
정정 반복고쳐도 또 틀립니다. 실패한 시도가 컨텍스트를 어지럽힙니다.두 번 실패하면 /clear 뒤 배운 점을 담아 다시 씁니다
과한 지침프로젝트 지침이 길면 중요한 규칙이 묻혀 절반은 무시됩니다.가차 없이 줄여 핵심만 남깁니다
믿고 안 보기그럴듯해 보여도 숫자나 사실이 틀린 결과가 나옵니다.검증 기준을 함께 줍니다. 확인 못 하면 그대로 쓰지 않습니다
끝없는 탐색범위 없이 "조사해줘"라고 하면 끝없이 자료를 읽어 컨텍스트를 채웁니다.범위를 좁히거나 서브에이전트에 맡깁니다
9 직관을 기르세요
원칙

원칙은 출발점입니다. 정답은 상황마다 다릅니다.

이 원칙들은 고정된 규칙이 아닙니다. 대체로 잘 통하는 출발점일 뿐, 모든 상황의 정답은 아닙니다. 한 문제에 깊이 빠져 흐름 자체가 값질 때는 컨텍스트를 쌓아 두는 편이 낫습니다. 탐색하는 작업이라면 계획을 건너뛰고 Claude가 풀게 두는 편이 낫습니다. 어떻게 해석하는지 먼저 보고 싶을 때는 막연한 프롬프트가 오히려 맞습니다.

무엇이 통하는지 살피세요. 결과가 좋았다면 무엇을 했는지 기억해 두세요. 프롬프트의 짜임, 함께 건넨 자료, 그때의 모드까지. Claude가 헤맸다면 이유를 따져 보세요. 맥락이 너무 어수선했는지, 프롬프트가 막연했는지, 한 번에 하기엔 일이 컸는지. 그렇게 쌓인 감각은 어떤 가이드도 대신 담아 주지 못합니다.

마지막 점검 체크리스트9가지 원칙 한눈에

작업을 시작하기 전이나 끝낸 뒤에 스스로 확인합니다. 체크한 상태는 이 브라우저에 저장됩니다.

진행 0 / 9

이 가이드는 Anthropic 공식 문서 Best practices for Claude Code를 바탕으로 비즈니스 리더 관점에서 재구성했습니다.