Claude Code를 며칠 써보면 기본 동작은 파악이 됩니다. 그런데 매일 실무에 쓰다 보면 “이렇게 하니까 확실히 다르다” 싶은 패턴이 생겨요. 단순히 기능 목록이 아니라, 써보면서 진짜 차이 났던 것들만 10가지로 정리했습니다.
공통 주제는 하나예요. 토큰은 돈이고, 컨텍스트는 유한하다. 이 두 가지를 의식하면서 쓰면 결과가 달라집니다.
기본 세팅 편 — 팁 1~5
팁 1. CLAUDE.md를 프로젝트 루트에 꼭 만들어두세요
CLAUDE.md는 Claude Code가 프로젝트를 열 때 자동으로 읽는 파일입니다. “이 프로젝트에서 지켜야 할 규칙, 폴더 구조, 출력 형식”을 여기에 써두면 매번 대화 처음에 길게 설명할 필요가 없어요.
예를 들어 “보고서는 HTML로 저장해줘”, “파일명은 kebab-case로”, “한국어로 답해줘” 같은 규칙을 CLAUDE.md 하나에 정리해두면 됩니다. AI가 세션이 바뀌어도 같은 맥락으로 일하게 된다는 게 진짜 강점이에요.
처음에는 간단하게 시작해도 충분합니다. 써나가면서 “이것도 반복해서 말하게 된다” 싶으면 추가하는 방식으로요. 파일이 길어질수록 AI가 읽는 토큰도 늘어나니, 핵심만 남기는 것도 중요합니다.
팁 2. /compact — 대화가 길어지면 한 번씩 눌러주세요
Claude Code는 대화 맥락을 통째로 들고 다닙니다. 1시간 넘게 작업하다 보면 초반에 나눈 내용, 중간에 수정한 파일 내용, 오간 설명들이 전부 컨텍스트에 쌓여요.
이 상태가 계속되면 두 가지 문제가 생깁니다. 토큰 소비가 늘어나고, 컨텍스트 한도에 가까워질수록 AI 응답 품질이 미묘하게 떨어질 수 있어요.
/compact 명령을 실행하면 지금까지의 대화를 요점 중심으로 압축해줍니다. 대화 흐름을 유지하면서도 불필요한 세부 내용은 걷어내는 방식이에요. 1시간 넘은 세션이거나 대화가 많이 길어졌다 싶을 때 한 번씩 쓰면 체감 차이가 납니다.
팁 3. 큰 작업은 서브에이전트로 분산해보세요
Claude Code는 복잡한 작업을 할 때 서브에이전트를 띄울 수 있습니다. “이 부분은 따로 조사해줘”, “이 폴더는 별도로 분석해줘”처럼 독립적인 하위 작업이 있을 때 유용해요.
서브에이전트가 장점인 이유는 메인 컨텍스트를 아낄 수 있어서입니다. 방대한 파일을 통째로 읽거나, 길게 검색하는 작업을 서브에이전트에게 맡기면, 메인 대화는 가볍게 유지되죠.
자동으로 뜨는 경우도 있고, “서브에이전트로 처리해줘”라고 명시적으로 요청할 수도 있어요. 병렬 처리가 가능한 작업이라면 특히 시간이 줄어드는 게 느껴집니다.
팁 4. 반복 작업은 Skills(슬래시 명령)로 등록해두세요
매번 같은 지시를 타이핑하는 게 번거롭다면 슬래시 명령을 쓰면 됩니다. /commit, /review 같은 명령이 대표적인 예고, 프로젝트에 맞는 명령을 직접 만들 수도 있어요.
.claude/commands/ 폴더에 마크다운 파일로 만들어두면 됩니다. 예를 들어 매일 일일보고서를 쓴다면 /daily-report 명령 하나로 전체 절차를 자동 실행하게 설정할 수 있어요.
처음에는 없어도 잘 쓰다가, “이 순서 매번 반복되는데”라는 순간에 등록하면 됩니다. 복잡한 프롬프트를 매번 입력하는 대신 명령 하나로 줄이는 거라서, 습관이 되면 작업 속도가 체감상 다르게 느껴져요.
팁 5. Hooks로 반복 체크를 자동화하세요
Hooks는 특정 이벤트가 발생했을 때 자동으로 무언가를 실행하는 기능입니다. 파일이 수정됐을 때 자동으로 린트(코드 검사)를 돌린다거나, 작업이 끝났을 때 자동으로 업로드를 트리거하는 식으로 쓸 수 있어요.
매번 “이 작업 끝나면 저것도 해줘”라고 말해야 했던 반복이 사라집니다. settings.json의 hooks 항목에 등록해두면 Claude Code가 자동으로 처리해요.
예를 들어 HTML 파일이 저장될 때마다 FTP 업로드를 자동으로 트리거하거나, 세션이 끝날 때 요약 로그를 남기도록 설정할 수 있습니다. 초반에 세팅에 시간이 걸리지만, 반복 업무가 많은 분들에게는 가장 생산성 차이가 큰 기능 중 하나예요.
실전 활용 편 — 팁 6~10
팁 6. 수정 전에 반드시 Read 먼저 시키세요
Claude Code에게 파일을 수정해달라고 할 때, “그냥 수정해줘”보다 “이 파일 먼저 읽고 나서 수정해줘”가 결과가 훨씬 낫습니다.
왜냐면 AI가 파일 전체 맥락을 파악하고 편집하는 것과, 이전 대화 맥락에서 추론해서 편집하는 건 다르거든요. 특히 파일이 길거나 코드 구조가 복잡할수록 차이가 납니다.
“이 파일 읽어봐” → “이 부분 고쳐줘” 두 단계가 번거롭다고 건너뛰면, 엉뚱한 부분이 바뀌거나 누락이 생기는 경우가 종종 있어요. Read 먼저, Edit 나중에. 이게 기본 순서입니다.
큰 파일이라면 전체를 읽기보다 관련 부분만 line range를 지정해서 읽게 하는 것도 토큰을 아끼는 방법이에요. “100번째 줄부터 200번째 줄까지만 읽어봐”처럼요.
팁 7. Claude가 쓴 글은 다른 모델로 한 번 더 검토하세요
Claude Code가 긴 보고서나 분석 글을 작성해줬을 때, 같은 Claude에게 “이거 맞아?”라고 물어보면 자기 자신을 검증하는 한계가 있습니다. 관점이 같으니까요.
Gemini나 다른 모델에게 같은 내용을 검토시키면 놓친 오류나 다른 관점이 나올 때가 많습니다. “수치 오류, 과장 표현, 내부 모순을 찾아줘”라는 프롬프트로 교차 검토하는 방식이에요.
특히 중요한 자료를 만들 때는 이 단계가 품질 차이를 확실히 만들어줍니다. 시간이 좀 걸리더라도, 한 모델이 단독으로 쓰고 검토까지 다 하는 것보다 훨씬 신뢰도가 높아요.
팁 8. 프롬프트에 제약 조건을 달아보세요
Claude Code는 요청이 막연할수록 길고 장황한 답을 냅니다. 반대로 구체적인 제약을 달면 결과가 훨씬 실용적으로 나와요.
몇 가지 예를 들면 이렇습니다.
- “3가지만 꼽아줘” → 핵심이 명확해짐
- “100자 이내로 요약해줘” → 쓸데없는 부연 없이 압축됨
- “표로 정리해줘” → 비교가 한눈에 보임
- “글머리 기호 없이 문단으로 써줘” → 원하는 형식이 나옴
제약 없이 “분석해줘”라고 하면 AI 입장에서는 최대한 많이, 상세하게 쓰는 게 기본 동작이거든요. 형식과 분량을 미리 지정하는 습관이 생기면 추가 편집 시간이 줄어들고 토큰도 아낄 수 있습니다.
팁 9. –resume으로 이전 세션을 이어가세요
새로운 Claude Code 세션을 열 때마다 이전 맥락을 처음부터 다시 설명하는 건 번거롭고 토큰 낭비입니다. –resume 옵션을 쓰면 이전 대화를 이어갈 수 있어요.
claude --resume마지막으로 작업하던 세션을 이어서 시작하거나, 특정 세션 ID를 지정해서 그 시점으로 돌아갈 수 있습니다. “어제 하던 작업 계속해줘”가 말 그대로 되는 거예요.
CLAUDE.md가 프로젝트 수준의 맥락을 유지해준다면, –resume은 대화 수준의 연속성을 챙겨줍니다. 둘을 같이 쓰면 새 세션을 시작할 때 설명 시간이 확 줄어드는 게 느껴져요.
팁 10. 토큰을 의식하면서 요청하세요
Claude Code를 쓸 때 가장 쉽게 간과하는 게 토큰 소비입니다. 크게 의식하지 않으면 큰 파일 전체를 불필요하게 읽게 하거나, 긴 설명을 여러 번 반복하는 일이 생겨요.
실용적으로 바꿀 수 있는 습관 몇 가지를 정리하면 이렇습니다.
- 큰 파일은 전체 대신 관련 부분만 line range로 읽기
- 필요 없는 파일 출력을 줄이기 — “내용 출력하지 말고 파일에 바로 저장해줘”
- 긴 결과물은 화면에 표시 대신 파일로 받기
- /compact로 주기적으로 컨텍스트 정리하기 (팁 2와 연결)
- 반복 지시는 CLAUDE.md에 써두고, 매번 타이핑하지 않기 (팁 1과 연결)
토큰을 아끼는 게 단순히 비용 문제만이 아니에요. 컨텍스트가 가벼울수록 AI 응답이 명확해지는 경향이 있습니다. 쌓인 내용이 많을수록 AI도 핵심을 찾기 어려워지거든요.
정리하면
10가지 팁이 많아 보여도, 핵심은 두 가지입니다.
첫째, 세팅에 시간을 투자하면 실행에서 시간이 돌아옵니다. CLAUDE.md, Skills, Hooks — 처음 한 번 설정해두면 이후 매 세션에서 회수됩니다. 귀찮아서 미루는 분들이 많은데, 자주 쓸수록 선투자 가치가 올라가요.
둘째, 컨텍스트 관리가 곧 품질 관리입니다. /compact, 서브에이전트, 토큰 절약 습관은 모두 같은 방향을 가리킵니다. 가볍고 명확한 컨텍스트에서 AI가 더 잘 동작합니다.
한꺼번에 다 바꾸려 하면 부담스럽습니다. 오늘 당장 쓸 수 있는 것 하나만 골라서 써보세요. CLAUDE.md 파일 만들기가 가장 진입장벽이 낮고 효과가 빠릅니다.
※ 이 글은 2026년 6월 기준으로 작성됐습니다. Claude Code 기능은 업데이트가 자주 되므로, 최신 정보는 공식 문서에서 확인하세요.
관련 글 추천