클로드 코드는 질문에 답하고 기다리는 챗봇이 아닙니다. 파일을 읽고, 자료를 분석하고, 결과물을 직접 만들고, 스스로 문제를 풀어 나가는 에이전트입니다. 그래서 일하는 방식이 달라집니다. 하나하나 직접 하는 대신, 원하는 결과를 설명하면 Claude가 자료를 찾고 계획을 세워 만들어 냅니다.
다만 이 자율성에는 큰 제약이 하나 따릅니다. 바로 컨텍스트 창입니다. Claude가 한 번에 펼쳐 놓고 일하는 책상이라고 보면 됩니다. 주고받은 모든 메시지, Claude가 읽은 모든 파일, 모든 작업 결과가 여기 쌓입니다. 넓지만 무한하지는 않아서, 긴 보고서 하나나 자료 한 더미만 읽어도 금세 채워집니다.
이 책상이 찰수록 Claude의 판단력은 떨어집니다. 가득 차면 앞선 지시를 잊고 실수도 잦아집니다. 그래서 컨텍스트는 가장 먼저 관리해야 할 자원입니다. 아래 5가지 원칙도 대부분 이 하나의 사실에서 출발합니다.
바쁘면, 이 3가지부터
5가지를 한 번에 익힐 필요는 없습니다. 효과가 가장 큰 셋만 먼저 손에 붙이세요. 모두 위의 '책상' 이야기에서 곧장 따라 나오는 습관입니다.
무엇을 알고 무엇을 모르는지 먼저 정리하면, 무엇을 프롬프트에 적고 무엇을 Claude와 함께 풀지 분명해집니다.
내가 건네는 지시에는 일의 전부가 담기지 않습니다. 원본 자료의 속사정, 조직의 형편, 그동안 쌓인 판단은 프롬프트 밖에 남습니다. 그렇게 빠진 자리가 내가 모르는 것입니다. Claude는 이 자리를 만나면 멈추지 않고 내가 원할 법한 쪽으로 추측해 결정합니다. 맡기는 일이 클수록 추측도 늘어납니다.
그래서 지시는 너무 좁아도, 너무 넓어도 안 됩니다. 너무 구체적이면 Claude는 방향을 틀어야 할 때도 시킨 대로만 가고, 너무 모호하면 내 상황과 안 맞는 관행을 따릅니다. 모르는 것을 먼저 좁혀 두면 이 양쪽을 모두 피할 수 있습니다.
모르는 것을 네 가지로 나눠 봅니다
이미 프롬프트에 적어 둔 것. "3분기 매출을 지역별로 정리해줘"처럼 분명히 말해 둔 부분입니다.
→ 그대로 적어 두면 됩니다.아직 못 정했지만, 못 정했다는 사실은 아는 것. 어떤 그래프로 보여줄지 아직 안 정한 경우입니다.
→ Claude가 먼저 묻게 해 빈칸을 채웁니다.너무 당연해 쓰지 않지만 보면 바로 알아채는 것. 보고서 말투나 빼야 할 항목입니다.
→ 시안을 여러 개 받아 눈으로 고릅니다.아예 생각조차 못 한 것. 이 분야에서 흔히 빠지는 함정처럼, 무엇을 물어야 할지도 모르는 영역입니다.
→ 놓친 곳을 짚어 달라고 Claude에게 청합니다.1번과 2번, 아는 걸 안다와 모르는 걸 안다는 내가 이미 알아채고 있는 것입니다. 적어 두거나 물어보면 채워집니다. 어려운 쪽은 3번과 4번, 아는데 안 적은 것과 모르는 걸 모른다입니다. 알아채지 못하니 스스로 적을 수가 없습니다.
그래서 이 두 칸은 Claude가 먼저 꺼내 줘야 합니다. 생각의 파트너로 쓰면 모르는 것이 빠르게 줄어듭니다. 시작할 때 내 경험과 익숙한 정도를 함께 알려 주면 Claude가 더 정확히 짚어 줍니다.
일의 단계마다 이렇게 씁니다
- 시작 전. 낯선 주제라면 "이 주제는 처음입니다. 내가 놓치고 있는 부분을 짚어줘"라고 먼저 청합니다. 보면 아는데 말로 설명하기 어려우면 "완전히 다른 4가지 방향으로 시안을 만들어 줘"처럼 눈앞에 꺼내 봅니다. 일이 크면 Claude가 먼저 인터뷰하게 하고, 비슷한 자료가 있으면 그대로 가리킵니다. 말로 푸는 것보다 정확합니다.
- 진행 중. 계획에서 벗어난 결정은 기록하게 합니다. "계획과 다르게 판단한 부분은 이유와 함께 메모로 남겨줘." 다음 시도가 그만큼 좋아집니다.
- 끝난 뒤. 결과물과 근거, 메모를 한 문서로 묶으면 검토자도 같은 지점에서 출발하니 승인이 빨라집니다. "방금 한 작업을 내가 제대로 이해했는지 퀴즈로 확인해 줘"도 유용합니다.
조사와 계획을 작성에서 따로 떼어 두고, 무엇을 볼지 구체적으로 짚으세요. 엉뚱한 결과물도 되돌리는 수고도 줄어듭니다.
새 자료를 받으면 동료에게 묻듯 먼저 물어봅니다. "이 보고서는 어떤 논리로 이 결론에 이르렀나요?" 같은 질문이면 충분합니다. 이 과정 없이 곧바로 만들게 하면 엉뚱한 문제를 푼 결과물이 나오기 쉽습니다. Plan 모드로 탐색과 실행을 나누면 이를 막을 수 있습니다.
- 탐색. Plan 모드에서 Claude는 결과물을 만들지 않고 자료를 읽으며 답합니다. "작년 사업계획서와 이번 분기 실적을 읽고 핵심 메시지를 파악해줘."
- 계획. "신사업 제안서를 쓰려고 합니다. 자료가 더 필요한지, 목차는 어떻게 잡을지 계획을 세워줘."
- 만들기와 마무리. Plan 모드를 끄고 계획대로 쓰게 한 뒤, 공유할 형태로 다듬습니다.
다만 계획에도 품이 듭니다. 오타 수정처럼 한 문장으로 결과를 설명할 수 있는 일은 바로 시키세요. 계획이 제값을 하는 때는 어떻게 풀지 막막하거나, 여러 자료를 엮어야 하거나, 주제가 낯설 때입니다.
그다음, 무엇을 볼지 구체적으로 짚습니다
Claude는 뜻을 헤아리지만 마음까지 읽지는 못합니다. 어떤 자료를 볼지 알려 주고, 조건을 말하고, 따라야 할 예시를 보여 주세요. 지시가 구체적일수록 고치는 횟수가 줄어듭니다.
| 전략 | 그냥 | 이렇게 |
|---|---|---|
| 범위 좁히기 | "보고서 검토해줘" | "이 보고서에서 3분기 매출 부분만 봐줘. 작년 같은 분기와 비교해 빠진 관점이 있는지 찾아줘" |
| 출처 가리키기 | "이 수치 왜 이래?" | "이 매출 수치가 원본 시트에서 어떤 계산식으로 집계됐는지 따라가 정리해줘" |
| 기존 예시 참고 | "제안서 써줘" | "지난번 통과된 제안서(첨부)를 보고 구조와 톤을 파악해줘. 그 틀을 따라 이번 신사업 제안서를 써줘" |
| 증상 설명 | "이 분석 틀렸어" | "이 분석에서 성장률이 이상해. 원본 데이터의 분모가 맞는지 확인하고, 틀렸으면 다시 계산해줘" |
자료는 설명하지 말고 그대로 건네세요. @파일명으로 엑셀·문서·PDF를 가리키고, 차트나 시안은 이미지로 붙여넣고, 참고할 기사는 주소를 줍니다. 표나 수치는 붙여 넣으면 바로 분석합니다.
막연한 프롬프트가 맞을 때도 있습니다. 방향을 틀 여유가 있는 탐색 단계입니다. "이 자료에서 무엇을 개선하면 좋을까?" 같은 질문은 미처 떠올리지 못한 지점을 드러냅니다.
다시 계산한 합계, 원본과 맞춰 본 수치, 시안과 비교한 화면. 이런 기준이 있으면 곁에서 지켜볼 일과 맡기고 자리를 비울 일이 나뉩니다.
Claude는 작업이 끝나 보이면 멈춥니다. 스스로 평가할 기준이 없으면 "끝난 것 같다"가 유일한 신호이고, 검증은 사람 몫으로 남습니다. 실수가 있어도 사람이 발견할 때까지 그대로 흘러갑니다.
맞고 틀림을 가려 주는 기준을 주면 Claude가 알아서 고쳐 나갑니다. 작업하고, 결과를 기준에 맞춰 보고, 어긋난 곳을 고치고, 맞을 때까지 되풀이합니다. 기준은 대화 안에서 결과를 확인할 수 있는 것이면 무엇이든 좋습니다. 원본과 맞춰 본 합계, 빠진 항목을 확인하는 점검 목록, 시안과 비교한 화면, 사실인지 따져 보는 질문이 모두 기준이 됩니다.
지시를 이렇게 바꿉니다
| 전략 | 그냥 | 이렇게 |
|---|---|---|
| 검증 기준 제시 | "3분기 매출 요약해줘" | "3분기 매출을 정리해줘. 지역별 합계가 전체 합계와 맞는지 다시 계산해 확인하고, 어긋나면 어디서 틀렸는지 알려줘" |
| 결과를 눈으로 확인 | "대시보드 보기 좋게 해줘" | "[시안 이미지] 이 디자인대로 대시보드를 만들고, 결과를 화면으로 찍어 시안과 비교해 차이를 고쳐줘" |
| 증상이 아니라 원인 | "이 보고서 이상해" | "이 보고서의 성장률이 이상해. 원본 데이터로 분모가 맞는지 확인하고, 추정 말고 원본 기준으로 다시 계산해줘" |
잘됐다고 말로만 하지 말고 근거를 보여 달라고 하세요. 다시 계산한 수치, 대조한 원본, 결과 화면이면 됩니다. 근거를 확인하는 편이 직접 다시 점검하는 것보다 빠릅니다. 이 방법은 곁에서 지켜보지 못한 작업에도 그대로 통합니다.
한 번 설정해 두면 모든 세션이 편해지고, 맥락을 제때 비우면 긴 대화에서도 품질이 떨어지지 않습니다.
프로젝트 지침(CLAUDE.md)을 잘 씁니다
CLAUDE.md는 Claude가 대화를 시작할 때마다 읽는 프로젝트 지침입니다. 자주 쓰는 자료의 위치, 보고서 형식, 말투 규칙을 적어 두면 매번 설명하지 않아도 됩니다. /init으로 초안을 만든 뒤 다듬으세요.
무엇보다 짧아야 합니다. 한 줄마다 물으세요. "이 줄을 지우면 Claude가 실수할까?" 아니라면 지웁니다. 지침이 길어지면 정작 중요한 규칙이 묻힙니다.
| 담을 것 | 뺄 것 |
|---|---|
| Claude가 추측 못 하는 회사 용어·약어 | 자료를 보면 알 수 있는 것 |
| 기본과 다른 보고서·문서 형식 규칙 | Claude가 이미 아는 일반 상식 |
| 선호하는 말투와 톤 | 자주 바뀌는 정보 |
| 자주 쓰는 자료·데이터의 위치 | 한 번 쓰고 마는 일회성 내용 |
| 꼭 지켜야 할 표기·금지 규칙 | "잘 써라" 같은 자명한 말 |
그 밖에 한 번 해 두면 좋은 설정이 넷 있습니다. 권한은 자동 승인으로 두거나 안전한 작업만 골라 허용하면, 매번 확인하는 수고가 줄어듭니다. 커넥터와 MCP는 노션이나 구글 드라이브를 연결해 Claude가 자료를 직접 가져오게 합니다. 자주 하는 작업은 스킬로 등록해 두면 한 마디로 부를 수 있습니다. 자료 조사처럼 떼어 낼 일은 서브에이전트에 넘겨 본 대화를 깨끗하게 둡니다.
맥락은 제때 비웁니다
환경을 갖췄어도 대화가 길어지면 품질이 떨어집니다. 어긋난다 싶으면 곧바로 바로잡으세요. Esc로 작업을 멈추고, Esc 두 번이나 /rewind로 이전 상태로 되돌리고, 무관한 일로 넘어갈 때는 /clear로 통째로 비웁니다.
같은 문제를 두 번 넘게 바로잡았다면 이미 실패한 시도로 맥락이 어질러진 상태입니다. 비우고, 배운 점을 담아 더 구체적으로 다시 시작하세요. 깨끗한 세션에서 좋은 프롬프트 하나로 다시 시작하는 편이, 길게 끌며 고쳐 쌓는 것보다 거의 늘 낫습니다.
조사처럼 문서를 많이 읽는 일은 서브에이전트에 맡기세요. 별도 공간에서 읽고 요약만 돌려주니 맥락이 덜 찹니다.
> 서브에이전트를 써서 경쟁사 다섯 곳의 최근 분기 실적과
> 공개된 전략 방향을 조사해 핵심만 정리해줘.
이런 실패는 미리 알아 두면 피할 수 있습니다
| 패턴 | 증상 | 해결 |
|---|---|---|
| 잡탕 세션 | 한 가지 일을 하다 엉뚱한 걸 묻고 다시 돌아옵니다. 컨텍스트가 무관한 정보로 찹니다. | 일이 바뀔 때마다 /clear |
| 정정 반복 | 고쳐도 또 틀립니다. 실패한 시도가 컨텍스트를 어지럽힙니다. | 두 번 실패하면 /clear 뒤 배운 점을 담아 다시 씁니다 |
| 과한 지침 | 프로젝트 지침이 길면 중요한 규칙이 묻혀 절반은 무시됩니다. | 가차 없이 줄여 핵심만 남깁니다 |
| 믿고 안 보기 | 그럴듯해 보여도 숫자나 사실이 틀린 결과가 나옵니다. | 늘 검증 기준을 함께 줍니다. 확인 못 하면 그대로 쓰지 않습니다 |
| 끝없는 탐색 | 범위 없이 "조사해줘"라고 하면 끝없이 자료를 읽어 컨텍스트를 채웁니다. | 범위를 좁히거나 서브에이전트에 맡깁니다 |
익숙해졌다면 반복 작업은 예약하고, 큰 일은 나눠 맡기세요. 그리고 무엇이 통했는지 돌아보며 나만의 요령을 만듭니다.
앞의 넷이 손에 붙었다면 같은 일을 매번 반복할 이유가 없습니다. 매일이나 매주 똑같이 하는 일은 Routines로 예약해 두세요. 정해진 시각에 클라우드에서 알아서 돕니다.
> 매일 아침 7시, 관심 산업의 주요 뉴스 10건을 모아
> 사실과 시사점으로 정리해 메신저로 보내줘. (Routines로 예약)
일이 커지면 세션을 나란히 띄워 나눕니다. 한 세션이 보고서를 쓰고 다른 세션이 처음 보는 눈으로 검토하는 방식이 대표적입니다. 새 세션은 방금 쓴 글에 치우치지 않아 더 냉정하게 봅니다. 지점별 보고서처럼 같은 양식을 여러 건에 적용할 때는 한두 건으로 지시를 다듬은 뒤 나머지에 그대로 넘깁니다.
다만 점검하는 쪽은 시키면 무엇이든 찾아냅니다. 모든 지적을 다 좇으면 과해집니다. 사실이 틀렸거나 꼭 필요한 조건을 어긴 것만 고치게 하세요.
원칙은 출발점일 뿐입니다
여기까지는 대체로 잘 통하는 방법이지, 모든 상황의 정답은 아닙니다. 한 문제를 오래 파고드는 중이라면 맥락을 비우지 않고 쌓아 두는 편이 낫고, 이것저것 살펴보는 일이라면 계획을 건너뛰는 편이 낫습니다.
그래서 마지막은 직접 해 보며 익히는 것입니다. 결과가 좋았다면 무엇을 했는지 기억해 두고, 헤맸다면 이유를 따져 보세요. 맥락이 어수선했는지, 지시가 막연했는지, 한 번에 하기엔 일이 컸는지. 그렇게 몸에 익은 것은 어떤 가이드도 대신 알려 주지 못합니다.
작업을 시작하기 전이나 끝낸 뒤에 스스로 확인합니다. 체크한 상태는 이 브라우저에 저장됩니다.
이 가이드는 Anthropic 공식 문서 Best practices for Claude Code를 바탕으로 비즈니스 리더 관점에서 재구성했습니다.