성능 향상을 위한 Claude Code 팁 12가지

같은 클로드코드인데 쓰는 사람마다 결과가 완전히 다릅니다.

누구는 5시간 리밋이 금방 바닥나고 누구는 넉넉하다고 합니다.

--> 차이는 설정과 습관입니다.

⭐️ 클로드코드 꿀팁 12개를 제대로 알려드립니다. ⭐️

명령어와 프롬프트는 전부 복붙할 수 있게 넣었습니다.

--> 한 번에 다 읽기엔 긴데.. 북마크 먼저 해두시는거 어떠실까요???

⚠️ 시작 전에.. 버전부터 확인하세요 ⚠️

이 글에 나오는 기능은 대부분 최근 몇 달 사이에 나왔습니다. 버전이 낮으면 명령어를 쳐도 안 됩니다.

터미널에서 claude --version으로 확인하고 낮으면 claude update 한 줄이면 됩니다.

이 글의 명령어는 10월 18일 v2.1.302 기준입니다.

1. 서브에이전트마다 Effort를 다르게 설정하기

Effort는 클로드가 답하기 전에 얼마나 깊게 생각할지 정하는 값입니다. low, medium, high, xhigh, max가 있고 모델마다 고를 수 있는 단계가 조금씩 다릅니다.

많은 분들이 무조건 Max나 XHigh로 두고 쓰십니다. 높을수록 좋을 것 같으니까요.

그런데 꼭 그렇지 않습니다.

같은 앱을 만들어 비교했을 때 Max는 79분이 걸렸고 다른 effort는 16분이 걸렸습니다.

결과물은 거의 비슷했습니다. 시간과 토큰만 더 쓴 겁니다.

제가 써보면서 정리한 건 이렇습니다.

--> (핵심) 🔥 프롬프트를 상세하게 적을 수 있으면 low를 쓰나 max를 쓰나 최종 결과가 비슷한 경우가 많습니다. 🔥

--> 브레인스토밍은 오히려 low나 medium이 좋았습니다.

대신 어려운 설계나 까다로운 버그, 중요한 리뷰에는 높은 effort가 필요할 때가 있습니다.

핵심은 "무조건 low"가 아닙니다.

10월 7일부터.. 서브에이전트를 부를 때마다 effort 지정 가능!

10월 7일 업데이트(v2.1.292)부터 메인 클로드코드가 서브에이전트를 부를 때 effort까지 정해서 부를 수 있습니다.

이제 이렇게 시키면 됩니다.

지금 할 일을 세 단계로 나눠서 서브에이전트로 진행해줘.

1. 파일 위치 찾기와 자료 정리는 low effort로

2. 수정 방향의 장단점 검토는 medium effort로

3. 최종 코드에서 버그 찾는 리뷰는 high effort로

각 서브에이전트에 실제로 어떤 effort를 줬는지 표시하고

메인에는 결론과 근거 파일 경로만 가져와줘.

매번 말하기 귀찮으면 에이전트를 파일로 만들어두면 됩니다.

--> 예를 들어 프로젝트의 .claude/agents/ 폴더에 light-research.md로 저장합니다.

name: light-research

description: 관련 파일과 근거 위치만 찾는 가벼운 조사 전용

model: haiku

effort: low

부를 때마다 정하는 방법(위 프롬프트)과 파일로 고정하는 방법 둘 다 됩니다!

2. 컨텍스트 관리와 토큰 낭비 방지

🤪 클로드코드가 갑자기 멍청해지는 이유는 대부분 컨텍스트입니다.

컨텍스트는 클로드가 한 번에 기억하는 작업대입니다. 대화와 읽은 파일, 명령 결과가 전부 여기에 쌓입니다.

--> 요즘 클로드코드는 1M(100만 토큰) 컨텍스트가 '기본값'입니다.

문제는 이 1M을 끝까지 채워 쓰는 것입니다.

클로드만 그런 게 아니라 코덱스 등 모든 LLM의 공통 한계입니다.

⭐️ 꿀팁: autocompact를 500~700k로 ⭐️

그래서 저는 자동 압축 기준을 일찍 당겨둡니다.

/autocompact 600k

자동 압축이 기준으로 삼는 창 크기를 60만 토큰으로 줄이는 겁니다.

1M을 다 채우기 전에 클로드가 알아서 대화를 요약하고 공간을 비웁니다.

(기본값으로 돌리려면 /autocompact auto를 치면 됩니다.)

⚠️ 두 번째 주의해야할 것: 캐시 만료 ⚠️

하나의 세션에서 오래 쓰시는 분들은 이거 꼭 보세요.

클로드코드는 요청할 때마다 앞의 대화를 통째로 다시 보냅니다. 그래도 빠르고 싼 이유는 캐시 덕분입니다. 이미 처리한 앞부분은 다시 계산하지 않습니다.

그런데 이 캐시는 영원하지 않습니다.

Pro나 Max 구독(플랜에 포함된 사용량 안에서): 메인 대화 캐시 1시간
API 키나 추가 사용량 크레딧: 5분
서브에이전트: 구독이어도 5분

제 화면에 ~852k uncached라고 뜬 적이 있습니다. 이 상태에서 "이어서 해줘" 한 줄만 보내도 약 85만 토큰을 캐시 없이 처음부터 다시 처리해야 합니다. 사용량이 한 번에 크게 빠질 수 있습니다.

캐시가 깨지는 대표적인 경우는 이렇습니다.

오래 쉬었다가 거대한 세션을 다시 이어갈 때
긴 세션 중간에 모델을 바꿀 때 (모델마다 캐시가 따로입니다)
연결된 MCP 도구 구성이 바뀔 때

대처법은 간단합니다.

자리 비우기 전에 정리하세요. 캐시가 살아 있을 때 /compact 하시거나, 아예 그냥 /clear 명령어로 새롭게 채팅을 시작하세요.
최신 버전으로 업데이트하세요. v2.1.299부터는 20만 토큰이 넘는 대화를 54분쯤 그냥 두면 1시간 캐시가 끝나기 전에 클로드코드가 알아서 압축해 둡니다. 끄고 싶으면 (/config의 Idle compaction에서 끌 수 있습니다.)

3. /doctor prompt-audit로 오래된 지침 대청소하기

예전에 좋다고 복붙한 CLAUDE.md. 실수할 때마다 하나씩 추가했던 규칙들.

대부분 옛날 모델 기준으로 쓴 겁니다.

새 모델은 옛날 모델보다 지시를 훨씬 잘 따릅니다.

⚠️ 그래서 옛날엔 "반드시!!" "절대!!" 하고 강조해야 듣던 규칙이 지금은 오히려 과하게 작동하기도 합니다. ⚠️

지금 코드랑 안 맞는 규칙과 서로 부딪히는 규칙도 쌓여 있고요.

이제 명령어 한 줄로 점검할 수 있습니다.

markdown

1/doctor prompt-audit

9월 말 업데이트(v2.1.283)에 들어온 기능입니다.

무엇을 점검하냐면요!

프로젝트와 상위 폴더의 CLAUDE.md와 CLAUDE.local.md, AGENTS.md
~/.claude/CLAUDE.md (모든 프로젝트에 적용되는 내 개인 지침)
.claude/ 안의 규칙(rules)과 스킬, 커스텀 명령어, 서브에이전트 정의, 출력 스타일

설치한 플러그인의 스킬과 에이전트는 보고만 하고 고치자고 하지는 않습니다.

기준은 지금 쓰고 있는 모델입니다. 그 모델 기준으로 오래된 프롬프트 패턴을 찾아 보고서와 수정 제안을 만듭니다.

(settings 파일이나 .mcp.json처럼 키가 들어 있을 수 있는 파일은 읽지 않습니다.)

4. 클로드코드가 같은 실수를 반복할 때... 작업 환경 자체를 고치기

⛏️ AI가 또 삽질하고 있을 때. 한 문제로 몇 시간째 고군분투하고 있을 때. ⛏️

같은 지적을 세 번째 하고 있다면 모델 탓이 아닙니다. 작업 환경 탓입니다.

제가 Claude Sonnet 3.7 때부터 1년 넘게 쓰고 있는 방법이 있습니다.대략적으로 설명드리면..

--> AI가 실수한 세션을 AI한테 다시 분석시키고 그 원인을 프로젝트 지침과 검증 방법에 반영하는 겁니다.

⭐️ 이렇게 하시면 됩니다! 바로 "세션 ID로 실수 분석시키기" ⭐️

1. 실수가 반복된 세션에서 /status를 치면 세션 ID가 나옵니다. 복사합니다.

2. 새 클로드코드 세션(코덱스도 됩니다)을 열고 이렇게 붙여넣습니다.

markdown

1"<세션 ID>" → 이 클로드코드 세션에서 두 번 이상 잘못한 점
2
3내가 지적했는데도 계속 실수한 점, 병목 현상을 찾아줘.
4
5각각 왜 생겼는지(잘못된 가정, 빠진 맥락, 코드 구조, 테스트 부재) 구분하고
6
7다시는 안 생기게 하려면 CLAUDE.md, .claude/rules, 스킬,
8
9훅, 테스트 중 어디를 어떻게 고쳐야 하는지 가장 작은 수정안만 제안해줘.

3. 제안을 보고 괜찮은 것만 반영합니다.

4. 효과를 확인합니다. 예전에 틀렸던 요청을 다시 시켜보고 이번엔 안 틀리는지 봅니다.

⚠️ 전부 CLAUDE.md에 쌓으면 안 됩니다. ⚠️

길어질수록 컨텍스트를 먹고 규칙끼리 부딪힙니다!!!

프로젝트 전체 규칙은 CLAUDE.md에
특정 폴더나 파일에만 해당하는 규칙은 .claude/rules/ 또는 그 폴더 안의 CLAUDE.md에
반복되는 작업 절차는 스킬(Skill)로
절대 어기면 안 되는 규칙은 Hooks와 권한 설정으로 (10번)
같은 버그가 또 나는 건 회귀 테스트로

이렇게 쌓인 규칙은 가끔 3번 /doctor prompt-audit로 대청소합니다. 4번이 쌓고 3번이 정리합니다.

5. Claude-Mem으로 세션 간 작업 기억 유지하기

클로드코드는 세션이 끝나면 대화를 잊습니다.

**"저번에 그거 왜 그렇게 했더라?"

"그 오류 어떻게 고쳤었지?"**

새 세션마다 다시 설명해야 합니다.

제가 1년째 유일하게 계속 쓰고 있는 클로드코드 플러그인이 이걸 해결해줍니다.

--> claude-mem입니다.

⭐️ 깃허브 스타가 10만 개를 넘었습니다. ⭐️

기본 메모리랑 뭐가 다른가요?

클로드코드에도 기본 메모리(Auto Memory)가 있습니다. 차이는 이렇습니다.

기본 Auto Memory는 클로드가 중요하다고 판단한 내용과 프로젝트에서 배운 것들을 요약해서 메모로 남깁니다. /memory로 볼 수 있고 설치가 필요 없습니다.

claude-mem은 이전 세션에서 어떤 작업을 했고 어떤 오류를 어떻게 해결했고 왜 그런 결정을 내렸는지까지 자동으로 기록합니다. 다음 세션에서 필요한 기록을 찾아 꺼내 씁니다.

제 화면에서는 토큰 절감률이 87%까지 찍혔습니다.

설치 방법은 터미널에서 한 줄으로 설치 가능합니다.

markdown

1npx claude-mem install

클로드코드 안에서 플러그인으로 설치해도 됩니다.

markdown

1/plugin marketplace add thedotmack/claude-mem
2/plugin install claude-mem

❌ 이런 분께는 추천하지 않습니다 ❌

코덱스 위주로 쓰시는 분
이미 다른 메모리 플러그인이나 직접 만든 기억과 인수인계 체계가 있는 분

겹치는 도구를 하나 더 얹으면 복잡해지고 비용만 늘어납니다.

클로드코드만 쓰는 환경이라면 여전히 강력하게 추천합니다.

6. Statusline으로 모델, Effort, 컨텍스트와 사용량 한눈에 보기

클로드코드 쓰다 보면 계속 궁금합니다.

지금 이 세션 Opus야? Sonnet이야? Haiku야?
effort는 뭐로 되어 있지?
컨텍스트 얼마나 찼지?
5시간 리밋이랑 주간 리밋은 얼마나 남았지?

🔥 이걸 터미널 맨 아래에 항상 보이게 하는 게 statusline입니다. 🔥

만드는 법은 쉽습니다. /statusline 뒤에 원하는 모양을 말로 적으면 클로드가 스크립트를 만들어서 적용까지 해줍니다.

제가 공유했던 디자인 5종

예전에 복붙용 statusline 프롬프트 5종을 공유했었습니다.

1. 미니멀: 모델과 effort, 프로젝트, 컨텍스트를 한 줄에

2. 파스텔 블록: 어두운 터미널에 어울리는 파스텔 하이라이트 블록

3. Nord Powerline: 구간들이 화살표 경계로 매끄럽게 이어지는 띠

4. 한도 도트바: Pro나 Max용. 5시간과 7일 사용량, 초기화까지 남은 시간을 점 막대로

5. 선명한 게이지: 라임색 모델 배지와 사선 게이지. 컨텍스트 토큰 수까지

프롬프트 전문은 원래 게시물에 있습니다. 그대로 복붙하면 클로드가 바로 만들어서 적용해줍니다.

1번 미니멀: https://x.com/lucian__03/status/2103173295118098750

2번 파스텔 블록: https://x.com/lucian__03/status/2103173396075065594

3번 Nord Powerline: https://x.com/lucian__03/status/2103173518573916178

4번 한도 도트바: https://x.com/lucian__03/status/2103173612832444536

5번 선명한 게이지: https://x.com/lucian__03/status/2103173754218258607

7. 클로드코드가 직접 실행하고 결과까지 검증하게 만들기

클로드가 "구현 완료했습니다!" 합니다. 실행해 보면 안 됩니다. 버튼이 안 눌리거나 화면이 깨지거나 아예 안 뜹니다.

테스트는 통과했는데 앱은 안 되는 경우가 생각보다 많습니다.

그래서 클로드에게 직접 앱을 띄우고 눌러보게 시켜야 합니다. 이걸 위한 명령어가 있습니다.

/run: 프로젝트의 앱을 실제로 실행하고 직접 조작해서 변경 사항을 확인합니다.
/verify: 바꾼 기능이 진짜 되는지 앱을 빌드하고 실행해서 확인합니다. 테스트나 타입 체크로 대신하지 않습니다.
/run-skill-generator: 이 프로젝트를 실행하는 방법(명령과 환경 변수, 준비 단계)을 스킬로 저장합니다. 실행 절차가 복잡한 프로젝트라면 이걸 먼저 하세요.
/verify는 한 번 확인한 방법을 프로젝트 스킬(.claude/skills/verify/)로 저장해 두고 다음부터 다시 씁니다.

이렇게 씁니다

1. 기능을 구현하고 테스트와 빌드부터 확인

2. /run으로 앱 실행

3. 웹이면 실제로 클릭하고 입력해 보기. CLI 도구면 샘플 입력으로 실제 출력 보기

4. /verify로 원래 목표가 됐는지 다시 확인

5. 안 되면 고치고 다시 실행. 실제 명령 결과나 화면을 근거로 남기기

8. 코드를 작성한 AI와 검수하는 AI 분리하기

자기가 쓴 글은 자기 눈에 오타가 안 보입니다. AI도 마찬가지입니다.

코드를 짠 세션은 이미 "이게 맞다"는 생각으로 가득 차 있습니다.

⭐️ 그래서 새 컨텍스트의 검수자를 따로 써야합니다. ⭐️

/code-review: 지금 바뀐 코드나 PR, 브랜치, 경로에서 버그와 정확성 문제를 찾습니다.
/code-review high처럼 강도를 정할 수 있습니다(low부터 max까지).

(기본적으로 보고서만 내고 고치는 것까지 원하면 --fix를 붙이면 바로 고쳐줍니다.)

/security-review: 내 브랜치와 원격 기본 브랜치의 차이에서 보안 문제(인증, 입력 검증, 정보 노출 등)를 점검합니다.
/simplify: 중복이나 비효율, 너무 복잡한 구조를 정리하고 고칩니다. 버그 찾는 도구는 아닙니다. 버그는 /code-review 담당입니다.

9. 복잡한 작업은 코딩 전에 설계와 완료 조건부터 확정하기

복잡한 일을 맡길 때 클로드한테 제일 먼저 줘야 하는 건 긴 코딩 지시가 아닙니다. 어디까지 할지와 언제 끝난 건지입니다.

이걸 안 정하면 클로드는 알아서 범위를 넓힙니다.

⚠️ 안 건드려도 될 파일을 고치고 시키지 않은 일까지 합니다. ⚠️

Plan Mode 쓰는 법

입력창에서 Shift+Tab을 눌러 plan mode on이 보이게 하거나 /plan을 칩니다. /plan 로그인 버그 고치기처럼 바로 할 일을 붙여도 됩니다.

(Plan Mode에서 클로드는 파일을 읽고 계획만 세웁니다. 코드는 내가 승인한 다음에 고칩니다.)

흐름은 탐색 → 계획 → 승인 → 구현 → 검증 순서입니다.

다만 오타 수정이나 한 줄 고치기에는 계획이 오히려 낭비입니다. 공식 문서 기준이 깔끔합니다. 바꿀 내용을 한 문장으로 설명할 수 있으면 계획은 건너뛰세요.

10. Hooks로 중요한 규칙을 자동으로 강제하기

CLAUDE.md에 "이 파일은 절대 건드리지 마"라고 적어둬도 클로드는 가끔 건드립니다.

🔥 CLAUDE.md는 참고 지침인데, Hooks는 강제 규칙입니다. 🔥

제일 많이 쓰는 3가지

PreToolUse: 클로드가 파일을 고치거나 명령을 실행하기 직전입니다. 보호 파일 수정을 막거나 위험한 명령을 차단합니다.
PostToolUse: 실행 직후입니다. 고친 파일을 자동으로 포맷하거나 린트를 돌립니다.
Stop: 클로드가 답을 끝내려고 할 때입니다. 테스트가 안 끝났으면 못 끝내게 합니다.

예시: 운영 설정 파일 수정 막기

이런 Hook도 클로드코드에게 만들어 달라고 시켜도 됩니다.

--> "config/production.env 수정을 막는 PreToolUse 훅 만들어줘."

이런 데 쓰면 좋습니다

코드 파일을 고칠 때마다 프로젝트 포맷터 자동 실행 (PostToolUse)
중요한 폴더를 건드리기 전에 한 번 더 승인 받기 (PreToolUse)
테스트를 안 돌렸으면 작업을 못 끝내게 하기 (Stop)
위험한 명령 차단 (PreToolUse + Bash)

11. Git Worktree로 여러 클로드코드 세션을 동시에 돌리기

클로드코드 창 두 개를 띄워서 같은 폴더에서 동시에 일을 시키면 어떻게 될까요?

🚫 서로 같은 파일을 고치다가 꼬입니다. (이거 진짜 매우매우 골치 아픕니다..) 🚫

Worktree는 같은 저장소를 작업별로 별도 폴더와 별도 브랜치로 나눠주는 git 기능입니다.

클로드코드는 이걸 명령어 하나로 해줍니다.

터미널 두 개에서 각각 이렇게 실행합니다.

claude --worktree feature-auth
claude --worktree feature-dashboard

짧게 -w도 됩니다.

그러면 .claude/worktrees/feature-auth/ 폴더가 생기고 worktree-feature-auth라는 새 브랜치에서 작업합니다.

--> ⭐️ 두 세션이 서로의 파일을 건드리지 않습니다. ⭐️

알아두면 좋은 것도 있습니다.

새 worktree는 지금 내가 있는 브랜치가 아니라 원격 기본 브랜치(main)에서 시작합니다.

claude --worktree "#1234"처럼 PR 번호를 주면 그 PR에서 시작합니다.

세션을 끝낼 때 worktree 정리까지 챙겨줍니다. 작업한 게 남아 있으면 지우기 전에 남길지 지울지 물어봅니다.

주의할 것

Worktree는 파일과 브랜치만 나눕니다. 같은 로컬 DB와 포트, 배포 대상, 외부 API 계정은 공유됩니다. 두 세션이 같은 포트로 서버를 띄우면 부딪힙니다.
나중에 합칠 때 같은 파일을 고쳤다면 충돌이 날 수 있습니다.
서로 강하게 엮인 작업은 인터페이스부터 정하거나 순서대로 하세요.
세션마다 사용량이 따로 듭니다. 병렬이 곧 토큰 절약은 아닙니다.

12. /goal로 목표를 달성할 때까지 자동 검증 반복하기

클로드는 한 턴이 끝나면 멈춥니다. 테스트가 아직 3개 실패하는데도 "대부분 고쳤습니다" 하고 멈추기도 합니다.

goal은 완료 조건을 정해두면 그 조건을 채울 때까지 클로드가 멈추지 않고 계속 일하게 만듭니다. (v2.1.139부터 있는 기능입니다.)
/goal만 치면 지금 목표와 진행 상태를 보여줍니다.
/goal clear를 치면 목표를 해제하고 멈춥니다.

어떻게 동작하나...

매 턴이 끝날 때마다 별도의 작고 빠른 모델이 조건과 지금까지의 대화를 읽고 조건을 채웠는지 판단합니다. 아직이면 클로드가 다음 턴을 이어서 시작합니다.

목표에 "테스트 명령과 결과를 대화에 출력할 것" 같은 확인 방법을 꼭 넣어야 합니다. 그래야 판정 모델이 진짜 통과했는지 알 수 있습니다.