화제가 된 클로드 코드 꿀팁 3가지, 공식 문서로 확인했습니다
조회수 높은 클로드 코드 팁을 그대로 믿어도 되는지 궁금한 분께 맞습니다. 공식 문서로 확인되는 대화 관리, 서브에이전트, CLAUDE.md 팁 세 가지를 정리했습니다.
화제가 된 팁일수록 공식 문서로 먼저 확인해야 합니다. 이 글에서 고른 세 가지는 /clear와 /compact 구분, 서브에이전트에 무거운 작업 넘기기, CLAUDE.md 짧게 유지하기입니다.
내 클로드 코드 사용 방식을 아래 세 가지로 점검해 줘. 1. /clear와 /compact를 상황에 맞게 구분해서 쓰고 있는지 2. 테스트 실행이나 로그 처리처럼 결과가 방대한 작업을 서브에이전트로 넘길 수 있는지 3. CLAUDE.md가 몇 줄인지 세어 보고, 200줄 미만으로 줄일 수 있는 부분이 있는지 각 항목마다 지금 상태와 고칠 점을 한 줄씩 알려 줘.
조회수가 높은 콘텐츠는 그만큼 많은 사람이 봤다는 뜻이지, 내용이 전부 맞다는 뜻은 아닙니다. 저는 화제가 된 팁을 볼 때마다 공식 문서에 실제로 그런 기능이 있는지부터 확인합니다.
이번에도 같은 방식으로, 많이 회자되는 클로드 코드 팁 중 공식 문서로 확인되고 제가 실제로 쓰는 것 3가지만 골랐습니다.
팁 1. /clear와 /compact를 구분해서 씁니다
많은 초보자가 둘을 같은 걸로 생각합니다. 공식 문서에 따르면 /compact는 대화를 요약해서 남기고, /clear는 완전히 새 세션으로 시작합니다.
하던 일을 이어가면 압축, 완전히 다른 주제로 넘어가면 초기화입니다. 이걸 구분하지 않으면 관련 없는 예전 대화가 계속 자리를 차지해서 답변 품질이 떨어질 수 있습니다.
팁 2. 무거운 작업은 서브에이전트로 넘깁니다
테스트 실행, 문서 수집, 로그 처리처럼 결과가 방대한 작업을 그대로 메인 대화에서 하면 컨텍스트(AI가 지금 기억하는 대화 공간)가 금방 찹니다.
공식 문서는 서브에이전트가 그 작업을 자기 컨텍스트에서 처리하고 요약만 돌려준다고 설명합니다. 장황한 출력은 하위 작업 쪽에 남고, 메인 대화에는 요약만 들어옵니다.
다만 서브에이전트도 공짜는 아니라서, 꼭 필요한 작업에만 씁니다.
팁 3. 규칙 파일(CLAUDE.md)은 짧게 유지합니다
공식 문서는 CLAUDE.md 파일이 세션 시작 시 컨텍스트에 로드되므로, 꼭 필요한 것만 담아 200줄 미만을 목표로 하라고 안내합니다.
규칙 파일이 길어지면 매 세션 시작마다 그만큼의 공간을 미리 차지하고 들어갑니다. 자주 안 쓰는 규칙은 다른 파일로 빼고 필요할 때만 불러오는 방식이 낫습니다.
각 팁을 직접 확인해 보는 법
/clear와/compact는 직접 눌러보면 차이가 바로 느껴집니다./compact뒤에는 요청과 의도, 핵심 개념, 살펴본 파일 같은 요약이 남지만,/clear뒤에는 아무것도 남지 않습니다.- 서브에이전트는 무거운 작업을 시켜본 뒤
/context로 메인 대화의 컨텍스트가 얼마나 덜 찼는지 비교해보면 체감됩니다. - CLAUDE.md는 줄 수를 세어보는 것만으로도 지금 상태를 바로 확인할 수 있습니다.
자주 하는 실수
저는 한동안 조회수가 높은 글을 보면 그대로 믿고 따라 했습니다. 그런데 실제로 공식 문서와 대조해보니 과장되거나 이미 바뀐 내용이 섞여 있는 경우가 있었습니다. 그 뒤로는 화제성과 정확성을 따로 보는 습관이 생겼습니다.
자주 묻는 질문
조회수가 높으면 신뢰해도 되지 않나요?
조회수는 얼마나 많이 봤는지를 뜻할 뿐, 내용의 정확성을 보장하지 않습니다. 특히 기능이나 명령어처럼 버전에 따라 바뀔 수 있는 내용은 공식 문서와 대조하는 게 안전합니다.
꿀팁이 3개뿐인가요?
아닙니다. 공식 문서에는 이 외에도 많은 기능이 있습니다. 여기서는 공식 문서로 확인되고 실제로 자주 쓰는 것만 골라 3가지로 좁혔습니다.
팁을 다 써야 효과가 있나요?
아닙니다. 지금 자신의 작업 방식에서 가장 자주 겪는 문제부터 하나씩 적용하는 게 낫습니다. 세 가지를 한 번에 다 바꾸려 하면 오히려 어떤 게 효과가 있었는지 알기 어렵습니다.
정리
화제가 된 팁일수록 먼저 공식 문서로 확인하는 습관이 필요합니다. 이번에 고른 세 가지는 대화 관리, 작업 위임, 규칙 파일 관리라는 서로 다른 지점을 다룹니다.