실제로 쓰기

“이 표 정리해 줘” 같은 요청이 그렇습니다. 어떤 기준으로 정렬할지, 어떤 열을 남길지, 결과를 어디에 쓸지는 요청한 사람만 압니다. 이유와 제약을 함께 주면 그 여지가 줄어듭니다.

흔한 안티패턴은 “카피 다듬어 줘”처럼 기준 없이 던지는 요청입니다. 무엇을 기준으로 다듬을지 정하지 않으면 Claude는 임의의 기준으로 결과를 채웁니다. “이 카피를 존댓말로 통일하고, 이모지는 빼고, 60자 안쪽 문장으로 다듬어 줘”처럼 기준을 문장 안에 넣으면 뒤이은 재작업이 줄어듭니다.

직군마다 붙일 맥락은 다릅니다. 기획자는 회의록에서 결정 사항만 정리해 달라고 할 때 “결정된 것만, 담당자 이름과 함께”를 덧붙이면 됩니다. 마케터는 캠페인 결과 보고서를 요청할 때 “임원 보고용, 숫자 위주로”라는 용도를 붙이고, 디자이너는 시안 설명 문구를 요청할 때 “클라이언트 메일에 넣을 용도”라는 맥락을 더합니다. 규칙이 반복되면 매번 적을 필요는 없습니다. 자주 쓰는 제약은 CLAUDE.md에 한 번 적어 두면 다음 요청부터 생략해도 적용됩니다.

아래 연습을 그대로 붙여넣어 요청 하나를 직접 다듬어 보세요.

폴더가 정리되어 있지 않으면 매번 위치를 새로 지정해야 합니다. “발행물은 여기, 임시 산출물은 저기, 원본은 건드리지 않는다”는 규칙이 없으면 결과물이 아무 데나 놓이고, 나중에 어디 있는지 찾는 것도 일이 됩니다.

SSoT(Single Source of Truth, 단일 진실 출처)를 정해 두는 이유도 같습니다. 같은 정보가 여러 파일에 흩어져 있으면 어느 쪽이 최신인지 매번 확인해야 합니다. 정본 파일 하나를 정하고 나머지는 그 파일을 가리키게 합니다.

마케터가 캠페인 자료를 만들 때 발행본과 초안이 같은 폴더에 섞여 있으면, 어느 파일이 최종본인지 매번 물어봐야 합니다. 흔한 안티패턴은 “최종”, “진짜최종”, “최종_수정2”처럼 파일명으로 버전을 구분하는 방식입니다. 발행 폴더와 초안 폴더를 나누고 발행 폴더에 있는 것만 정본으로 취급하면, 파일명에 기대지 않아도 됩니다. 공개 범위도 구조에 포함됩니다. 외부에 나가도 되는 폴더와 내부용 폴더를 나눠 두면, 발행 작업을 맡길 때 비공개 자료가 실수로 섞여 나가는 일을 줄일 수 있습니다.

아래 연습을 그대로 붙여넣어 지금 폴더의 구조부터 짚어 보세요.

파일이 직접 바뀌는 만큼, 무엇이 어떻게 달라졌는지 확인할 방법이 없으면 결과가 마음에 안 들어도 되돌리기 어렵습니다.

branch(작업 갈래)를 나눠 두면 실험적인 요청과 완성된 작업을 분리할 수 있습니다. 새 작업을 시작할 때 branch를 하나 만들고, 그 안에서 Claude에게 작업을 맡깁니다. 결과를 그대로 받아들이기 전에 diff(변경 내역)를 봅니다. 어떤 줄이 지워지고 어떤 줄이 추가됐는지 보면, 의도와 다르게 바뀐 부분을 커밋 전에 잡을 수 있습니다.

기획서 여러 장을 한 번에 고쳐 달라고 맡긴 뒤 diff를 보지 않고 그대로 commit하는 것이 흔한 안티패턴입니다. 의도와 다르게 지워진 문단이 나중에야 발견됩니다. 뉴스레터 문구를 수정할 때도 마찬가지로, commit 전에 “무엇이 바뀌었는지 보여줘”라고 요청해 diff를 확인하면 실수를 그 자리에서 잡을 수 있습니다. 커밋은 확인이 끝난 상태를 기록하는 지점입니다. 문제가 있으면 커밋 이전으로 되돌릴 수 있으므로, 큰 작업을 맡기기 전에 커밋해 두면 안전망이 생깁니다.

아래 연습을 그대로 붙여넣어 방금 바뀐 내용을 diff로 확인해 보세요.

Claude Code는 로컬 파일만 다루지 않습니다. Notion, Slack, 데이터베이스처럼 파일 시스템 밖에 있는 데이터를 매번 복사해 옮기면 서식이 깨지거나 최신 값을 놓치기 쉽습니다.

MCP는 Claude Code가 외부 서비스와 대화하는 표준 통로입니다. 설정 파일을 직접 만질 필요는 없습니다. “Notion 연결해 줘” 같은 요청으로 설치와 인증 과정을 Claude Code에게 맡길 수 있습니다. 연결이 끝나면 Notion 페이지 검색·조회·작성 같은 요청을 문장으로 할 수 있습니다.

기본 연결은 프로젝트 단위로 저장됩니다. 같은 도구를 다른 프로젝트에서도 쓰려면 그 프로젝트에서 다시 연결해야 합니다. 모든 프로젝트에서 공용으로 쓰고 싶으면 사용자 범위로 연결해 달라고 요청하면 되고, 이 경우 새 프로젝트를 열 때마다 다시 연결하지 않아도 됩니다. 마케터가 캠페인 성과를 Notion 대시보드에 매주 옮겨 적는다면, 연결 하나로 “이번 주 광고 성과를 Notion 리포트 페이지에 정리해 줘”라고 바로 요청할 수 있습니다. 흔한 안티패턴은 연결 없이 데이터를 손으로 복사해 붙여넣는 것입니다.

아래 연습을 그대로 붙여넣어 지금 연결된 외부 도구부터 확인해 보세요.

긴 조사나 반복 작업을 본 대화에서 직접 하면 맥락이 금방 무거워집니다. 조사 과정에서 나온 중간 결과, 읽었지만 안 쓴 파일 내용이 그대로 쌓이면 이후 요청에서 Claude가 처음 맥락을 놓치기 쉽습니다.

서브에이전트는 별도 맥락(context, 대화가 기억하는 정보 범위)에서 작업하고 결과만 본 대화로 돌려주는 워커입니다. 코드베이스를 뒤지거나, 여러 파일을 비교하거나, 반복적인 조사를 할 때 본 대화 대신 이 워커에게 시킵니다. 이름을 몰라도 됩니다. “서브에이전트로 조사해 줘”처럼 자연어로 요청하면 그것이 기본 경로이고, Claude가 알맞은 워커를 판단해 위임합니다. 읽기 전용으로 코드만 탐색하는 Explore처럼 미리 준비된 워커도 있습니다.

기획자가 경쟁사 공지 열 몇 개를 훑어 요약해야 한다면, 서브에이전트에게 맡기고 본 대화에는 요약만 받는 편이 낫습니다. 흔한 안티패턴은 한두 줄이면 끝나는 질문까지 위임하는 것으로, 위임을 설명하고 기다리는 시간이 직접 답하는 시간보다 길어집니다. 위임한 작업은 완료되거나 막히면 결과를 보고하므로, 잘 진행 중인 위임 작업에 중간에 개입할 필요는 없습니다.

아래 연습을 그대로 붙여넣어 조사 하나를 서브에이전트에 맡겨 보세요.

매번 “이모지 빼고, 존댓말로” 같은 규칙을 다시 적어야 한다면, 그만큼 요청이 길어지고 깜빡 빠뜨린 요청만 규칙에서 벗어난 결과를 받게 됩니다.

CLAUDE.md는 세션이 시작될 때 자동으로 읽히는 규칙 파일입니다. 폴더 구조, 금지 사항, 톤, 자주 쓰는 명령어처럼 매번 설명하던 내용을 여기 적어 두면 이후 요청에서는 생략할 수 있습니다. 빈 프로젝트라면 /init을 실행해 코드와 문서를 분석한 초안을 먼저 받아볼 수 있습니다.

파일은 크게 두 층입니다. 프로젝트 루트의 CLAUDE.md는 그 프로젝트에서 함께 일하는 사람과 공유하는 규칙이고, 사용자 홈 폴더의 ~/.claude/CLAUDE.md는 어떤 프로젝트를 열어도 항상 적용되는 개인 규칙입니다. 같은 내용이 두 파일에 있으면 프로젝트 파일이 우선 적용됩니다. 흔한 안티패턴은 온갖 규칙을 하나의 파일에 계속 이어 붙이는 것으로, 파일이 길어질수록 실제로 지켜지는 비율이 떨어지므로 안 쓰는 규칙은 지우고 자주 어기는 규칙은 눈에 잘 띄는 자리로 옮깁니다.

아래 연습을 그대로 붙여넣어 CLAUDE.md 초안부터 만들어 보세요.

Claude가 기억하는 범위(context window, 맥락 창)는 무한하지 않습니다. 대화가 길어지면 오래된 내용부터 흐려지고, 앞에서 정한 규칙이나 결정이 뒤로 갈수록 반영이 약해집니다.

정리 신호가 오면 /compact로 대화를 압축하거나 /clear로 아예 새로 시작합니다. 이때 중요한 것은 지금까지의 결정과 남은 작업을 파일로 남기는 것입니다. 파일에 남은 내용은 세션이 바뀌어도 그대로 이어받을 수 있습니다.

디자이너가 하루 종일 같은 브랜드 리뉴얼 작업을 이어간다면, 오전에 정한 컬러·톤 결정을 요약 파일에 적어 두고 오후 세션에서 그 파일부터 읽혀 시작하면 됩니다. 흔한 안티패턴은 결정을 어디에도 적지 않고 대화창 하나에서 며칠씩 이어가는 것으로, 뒤로 갈수록 초반에 정한 기준이 흐려지거나 뒤집힙니다. 짧은 작업은 굳이 나눌 필요가 없습니다. 여러 세션에 걸치거나 하루를 넘기는 작업에서만 이 흐름을 씁니다.

아래 연습을 그대로 붙여넣어 지금까지의 결정을 파일로 남겨 보세요.

같은 절차를 매번 처음부터 설명하면 그만큼 시간이 들고, 설명을 빠뜨리면 결과도 매번 달라집니다.

Skill(스킬)은 특정 작업의 절차와 규칙을 SKILL.md 파일에 정리해 둔 패키지입니다. 예전에는 커스텀 커맨드와 스킬이 따로였지만 지금은 하나로 통합되어, 이름을 불러 실행하면 매번 설명했던 순서와 기준을 다시 적지 않아도 됩니다. 이름을 몰라도 됩니다. description에 실제로 쓸 법한 표현을 적어 두면 Claude가 요청 맥락을 보고 스스로 스킬을 불러옵니다. description이 부실하면 이 자동 호출이 안 되고, 사용자가 이름을 직접 불러야만 실행됩니다.

Plugin(플러그인)은 Skill·서브에이전트·Hook을 묶어 다른 프로젝트나 사람에게 그대로 옮기는 배포 단위입니다. 한 프로젝트에서 다듬은 조합을 다른 곳에도 쓰고 싶을 때 이 단위로 옮깁니다. 카피라이터가 매주 같은 형식으로 뉴스레터 초안을 뽑는다면, 그 절차를 스킬로 만들어 두고 다음부터는 이름만 불러 실행하면 됩니다. 흔한 안티패턴은 description에 “뉴스레터용”처럼 짧게만 적어 두는 것으로, 실제 요청 문장과 맞아떨어지지 않아 자동으로 불려 오지 않습니다. 처음부터 완벽하게 만들 필요는 없습니다. 반복하다 보면 빠진 단계나 잘못된 가정이 드러나므로, 실제로 쓰면서 다듬는 편이 낫습니다.

아래 연습을 그대로 붙여넣어 반복 절차 하나를 스킬로 만들어 보세요.