2026년 6월 13일

클로드코드 흔한 실수 5가지 — 같은 도구로 결과가 갈리는 이유

클로드코드 흔한 실수 5가지 — 같은 도구로 결과가 갈리는 이유 같은 클로드코드를 쓰는데 누구는 결과가 쌓이고, 누구는 매번 제자리예요. 차이는 실력이 아니라 세팅 습관이에요. 이미 쓰는 사람도 모르게 하고 있는 실수 5가지를 정리합니다.

클로드코드를 쓰다 보면 이런 날이 있죠. 어떤 날은 한 번에 원하는 결과가 나오고, 어떤 날은 몇 번을 고쳐 말해도 평범한 결과만 나오는 날이요. "내가 프롬프트를 못 써서 그런가" 싶지만, 사실 프롬프트 문제가 아닌 경우가 많아요.

이번 주 내내 CLAUDE.md, 훅(hook), 위임하는 방식 같은 이야기를 다뤘는데요. 오늘은 그 반대편이에요. 이미 클로드코드를 쓰고 있는 사람들이 자기도 모르게 하고 있는 실수들. 하나하나는 사소해 보이는데, 쌓이면 "같은 도구를 쓰는데 결과가 다른" 차이를 만들어요.

다섯 가지 중 몇 개에 해당하는지 세면서 읽어보세요.

실수 1. 아무 폴더에서나 켠다

실수 1 — 아무 폴더에서나 켜기. 작업 폴더는 AI의 책상

클로드코드는 켠 위치(폴더) 안의 자료를 읽을 수 있는 도구예요. 그런데 많은 분이 바탕화면이나 빈 폴더에서 켜요. 그러면 AI는 매번 빈손으로 시작해요. 브랜드 소개도, 지난번에 만든 콘텐츠도, 고객 데이터도 없는 채로요.

비유하면 작업 폴더는 AI의 책상이에요. 책상 위에 브랜드 자료, 이전 산출물, 참고 데이터가 놓여 있으면 AI는 그걸 펼쳐 보면서 일해요. 빈 책상에서는 매번 "우리 브랜드는 이런 곳이고…"를 복붙해서 설명해야 하고요.

고치는 법은 간단해요. 일 전용 폴더를 하나 만들고, 항상 거기서 켜는 거예요.

마케팅-작업/
├── 브랜드-소개.md      ← 우리가 누구인지, 타겟, 톤
├── 콘텐츠/             ← 만든 콘텐츠가 날짜별로 쌓임
└── 자료/               ← 리뷰, 고객 데이터, 참고 자료

이렇게만 해두면 "지난주에 쓴 글이랑 비슷한 톤으로"라는 지시가 통하기 시작해요. 자료가 쌓일수록 AI가 똑똑해지는 구조가 폴더 하나로 만들어져요.

실수 2. CLAUDE.md 없이 맨몸으로 쓴다

실수 2 — CLAUDE.md 없이 쓰기. 매번 같은 설명을 반복하는 중

"타겟은 30대 직장인이고, 톤은 친근하게, 이모지는 빼고…" — 이 설명, 매번 다시 하고 있지 않나요?

클로드코드에는 CLAUDE.md라는 파일이 있어요. 작업 폴더에 이 파일을 만들어두면, 클로드가 켜질 때마다 자동으로 읽고 시작해요. 한 번 적어두면 매번 말 안 해도 지켜지는 규칙이 되는 거죠.

마케터라면 이런 걸 적어두면 돼요.

우리 브랜드: 뭘 파는지, 누구에게 파는지
타겟: 핵심 고객이 누구인지
톤: 어떤 말투로 쓰는지, 금지 표현은 뭔지
작업 규칙: 결과물 형식, 길이, 꼭 들어가야 할 것

앞서 다룬 적 있는데, 오픈AI 창립 멤버였던 안드레 카파시도 AI의 헛짓을 막으려고 이 파일에 규칙 4개를 정리해뒀어요. 고수일수록 프롬프트를 길게 쓰는 게 아니라, 규칙 파일을 한 번 잘 만들어요. 설명은 소모되지만 규칙은 쌓이니까요.

실수 3. 한 세션을 끝없이 이어 쓴다

실수 3 — 한 세션 끝없이 쓰기. 대화가 길어질수록 답이 무뎌진다

아침에 켠 대화창 하나로 블로그도 쓰고, 리뷰 분석도 하고, 카드뉴스도 만들고 — 하루 종일 이어 쓰는 분 많아요. 편하니까요. 그런데 대화가 길어질수록 AI의 답은 무뎌져요.

AI가 한 번에 기억할 수 있는 대화량에는 한계가 있어요. 대화가 쌓이면 오래된 내용부터 흐려지고, 앞에서 정한 조건을 잊거나 이전 작업의 맥락이 다음 작업에 섞여 들어가요. 블로그 쓰다가 리뷰 분석을 시키면, 블로그 톤이 분석 결과에 묻어 나오는 식이죠.

기준은 "한 가지 일, 한 세션"이에요.

블로그 한 편 = 세션 하나
리뷰 분석 = 새 세션
일이 끝나면 /clear로 대화를 비우고 새로 시작

"애써 설명한 맥락이 날아가는 거 아냐?" 싶을 수 있는데, 그래서 실수 1·2가 먼저예요. 맥락은 폴더와 CLAUDE.md에 저장돼 있으니까, 세션은 가볍게 버려도 돼요. 매번 새 세션이어도 AI는 규칙과 자료를 읽고 시작하거든요.

실수 4. 업데이트 후 세팅을 확인하지 않는다

실수 4 — 업데이트 후 세팅 방치. 기본값은 조용히 바뀐다

클로드코드는 업데이트가 잦은 도구예요. 그리고 업데이트는 가끔 기본 세팅을 조용히 바꿔요.

최근 사례가 있었죠. 모델이 Opus 4.8로 올라가면서, AI가 얼마나 깊게 생각할지 정하는 'effort' 기본값이 한 칸 내려갔어요. 전에 깊게(xhigh) 맞춰뒀던 사람도 자동으로 high로 되돌아갔고요. 업데이트하고 "요즘 답이 좀 얕아진 것 같은데?" 했다면 기분 탓이 아니었던 거예요.

도구가 좋아지는 건 반갑지만, 세팅의 주도권은 내가 들고 있어야 해요. 업데이트 후에 1분만 쓰면 돼요.

/effort 입력 → 생각 깊이가 어디에 맞춰져 있는지 확인
깊은 작업(전략·분석·장문)이 많다면 → /effort xhigh
새 기능이 뭐가 들어왔는지 공식 What's new 한 번 훑기

저는 업데이트 알림이 뜨면 이 1분 루틴을 그냥 습관으로 돌려요. 모르고 지나간 세팅 변화 하나가 한 달 치 결과물 수준을 좌우하기도 하거든요.

실수 5. 결과를 검증 없이 받아쓴다

실수 5 — 검증 없이 받아쓰기. 점검 한 줄로 막을 수 있다

마지막이 제일 무서운 실수예요. AI가 만든 결과물을 그대로 복사해서 발행하는 것.

AI는 그럴듯하게 틀려요. 숫자를 미묘하게 바꾸고, 없는 출처를 만들고, 우리 브랜드가 쓰지 않는 표현을 자연스럽게 섞어요. 받아쓰는 사람은 "잘 나왔네" 하고 넘어가기 쉽고요. 발행되고 나서야 고객이 먼저 발견하면, 그게 제일 비싼 수업료예요.

고치는 법은 거창하지 않아요. 시킬 때 점검까지 같이 시키는 거예요. 마지막에 이 한 줄을 붙이세요.

다 만들었으면 발행 전 점검을 해줘.
1) 숫자·고유명사·출처가 본문 근거와 일치하는지
2) 우리 금지 표현이 들어갔는지
3) 빠진 조건이 없는지
점검 결과를 표로 보여줘.

AI가 스스로 점검하게 만들고, 그 점검표를 보고 최종 판단만 내가 하는 구조예요. 어제 다룬 이야기와 똑같아요. 양은 AI에게, 판단은 나에게.

다섯 개 중 몇 개였나요

클로드코드 실수 5가지 자가 점검 체크리스트

정리하면 이래요.

#	실수	고치는 법
1	아무 폴더에서나 켠다	일 전용 폴더 만들고 거기서만 켜기
2	CLAUDE.md 없이 쓴다	브랜드·타겟·톤·규칙을 파일 한 장에
3	한 세션을 끝없이 쓴다	한 가지 일, 한 세션 — `/clear`
4	업데이트 후 세팅 방치	`/effort` 확인 1분 루틴
5	검증 없이 받아쓴다	"점검해서 표로 보여줘" 한 줄 추가

오늘 1단계 — 지금 켜서 하나만 고치기

다섯 개 중 가장 뜨끔했던 실수 하나를 고르세요.
폴더가 없다면 폴더부터,
CLAUDE.md가 없다면 파일부터,
세팅을 안 봤다면 /effort부터.

오늘은 하나면 충분해요.

다섯 개를 한꺼번에 고치려고 하면 부담스러워서 안 해요. 하나씩 고칠 때마다 결과물이 눈에 띄게 달라지는 걸 느낄 거예요.

자주 묻는 질문 (FAQ)

Q1. 다섯 가지 중 뭐부터 고쳐야 하나요? 순서대로면 1번(폴더) → 2번(CLAUDE.md)이에요. 이 둘이 기반이라, 갖춰지면 3번(세션 분리)이 부담 없어지고 5번(검증)도 규칙 파일에 적어 자동화할 수 있어요. 4번(세팅 확인)은 업데이트 때마다 하는 1분 루틴이고요.

Q2. CLAUDE.md에 뭘 얼마나 적어야 하나요? 처음부터 완벽할 필요 없어요. 브랜드 한 줄, 타겟 한 줄, 톤 규칙 서너 줄이면 시작으로 충분해요. 쓰다가 "이건 매번 말하게 되네" 싶은 게 생길 때마다 한 줄씩 추가하면, 몇 주 뒤엔 꽤 단단한 규칙 파일이 돼 있어요.

Q3. 세션을 새로 열면 이전 작업 내용을 다 잊어버리지 않나요? 대화 내용은 잊지만, 폴더 안 파일은 남아요. 산출물을 파일로 저장해두는 습관이 있으면 새 세션에서 "어제 만든 글 읽고 이어서"라고 하면 돼요. 그래서 세션은 가볍게 비우고, 기록은 폴더에 쌓는 게 기본 구조예요.

Q4. 코딩을 모르는데 이 세팅들을 할 수 있나요? 네. 폴더 만들기, 텍스트 파일(CLAUDE.md) 작성, /clear·/effort 입력 — 전부 코딩이 아니에요. 클로드코드가 개발자 도구처럼 보여서 그렇지, 여기 나온 다섯 가지는 메모장 쓸 줄 알면 다 할 수 있는 일이에요.

마무리 — 도구 차이가 아니라 습관 차이

같은 클로드코드를 쓰는데 결과가 갈리는 이유, 정리하면 결국 하나예요. 잘 쓰는 사람은 도구를 세팅해두고, 그냥 쓰는 사람은 매번 맨손으로 시작해요.

폴더, 규칙 파일, 세션 습관, 세팅 확인, 검증 한 줄. 다 합쳐도 처음 세팅에 한두 시간이면 끝나는 일이에요. 그런데 이 한두 시간이, 이후 모든 작업의 기본 수준을 바꿔요.

오늘 하나만 고쳐보세요. 가장 뜨끔했던 그것부터요.