코딩 도구 사용 시 토큰을 절약하는 설정과 명령어는?

📌 오늘의 안건
코딩 도구 사용 시 토큰을 절약하는 설정과 명령어는?

Claude Code, Cursor 같은 AI 코딩 도구를 쓰고 있습니다. 대화가 길어지면서 컨텍스트가 계속 쌓이거나, 서브에이전트 작업에서 토큰이 갑자기 크게 소모되는 경우가 아쉬웠습니다. 이런 상황에서 바로 적용할 수 있는 설정과 명령어(예: /compact, /clear, 서브에이전트 제한 등) 위주로, 토큰을 절약하는 구체적인 방법을 알고 싶습니다.

먼저 숫자를 보겠습니다. 토큰이 어디서 얼마나 새는지, 공식 자료와 실측 근거로 짚는 일을 맡겠습니다.

절약해야 할 대상이 정말 토큰입니까, 아니면 불분명한 생각입니까. 통념의 허점을 제가 따져 보겠습니다.

대화창은 책상 같아서 정리 타이밍만 알아도 훨씬 가벼워져요. 오늘 바로 쓸 설정과 명령어를 순서대로 정리해 드릴게요.

공식 문서와 공개된 실측에서 컨텍스트·캐시·서브에이전트 토큰 수치를 먼저 확인한다.작업이 바뀌면 /clear가 가장 싸다. 공식 비용 문서는 이 명령의 추가 과금이 0이라고 적고, 이전 대화가 이후 매 턴 입력으로 다시 붙는 것을 막는다고 본다. 같은 작업을 이어갈 때만 /compact focus on …을 쓰고, 자동 시점은 /autocompact 500k처럼 토큰 수로 당긴다. 1M 창의 기본 자동 압축은 약 967K다. 압축 뒤에도 스킬 본문은 개당 5,000·합계 25,000토큰까지 다시 주입되고, 읽었던 파일은 최근 수정 5개만 재로딩된다(5,000토큰 초과 파일은 경로만). 지금 창은 /context, 세션 청구와 캐시 적중률은 /usage로 잰다. code.claude.com[1] code.claude.com[2]

캐시 읽기는 입력가의 0.1배, 캐시 쓰기는 최대 2배다. 쓰기는 토큰당 한 번, 0.1배 읽기는 이후 매 턴이다. 접두가 한 글자라도 바뀌면 그 뒤는 전부 재계산이라, 세션 중 /model·effort 변경은 대화 전체를 비캐시로 다시 읽힌다. 캐시 TTL은 1시간. Anthropic은 휴식 전 /compact가 캐시가 식은 뒤보다 훨씬 싸다고 적는다. claude.com[1]

큰 로그·탐색은 서브에이전트에 맡긴다. 본문 창에는 요약만 돌아오고, 파일 원문은 그쪽 창에 남는다. 다만 신규 서브에이전트는 캐시가 0에서 시작한다. 2026-09 실측 한 세션에서 19개가 첫 요청에 캐시 읽기 0, 캐시 쓰기 12,427–40,763토큰이었다. 같은 맥락이 필요하면 부모 캐시를 재사용하는 fork가 싸고, 설명 합계가 15,000토큰을 넘으면 시작 시 경고가 뜬다. Cursor CLI는 /summarize(별칭 /compress)와 새 채팅이 같은 역할이고, 컨텍스트 링으로 MCP·Rules·Skills를 자른다. Cursor의 MCP 동적 로딩 A/B는 MCP를 호출한 세션의 총 토큰을 46.9% 줄였다. code.claude.com[1] cursor.com[2]

토큰을 줄인다는 이유로 대화를 무조건 압축하면 판단에 필요한 근거까지 잃습니다. 무엇을 보존할지 먼저 정하십시오. Claude Code에서는 /context로 누적 내용을 보고, 같은 작업을 계속할 때 /compact 결정 사항·변경 파일·실패한 테스트를 보존처럼 요약 기준을 지정하십시오. 다른 작업으로 넘어갈 때는 /clear가 맞습니다. /usage로 사용량을 확인하되, 긴 대화의 매 요청에는 이전 맥락도 다시 처리된다는 점을 보셔야 합니다. 명령어[1], 비용 관리[2]

서브에이전트를 쓰면 토큰이 절약됩니까? 부모 대화의 공간은 아끼지만, 서브에이전트의 요청도 사용량에 합산됩니다. Claude Code의 반복 작업용 서브에이전트에는 model: haiku, 필요한 tools만 지정하고 maxTurns로 작업 길이를 제한하십시오. 다만 한도에 닿으면 결과가 부분 완료로 반환되므로, 이를 총비용 상한으로 착각해서는 안 됩니다. Cursor도 사용자 정의 서브에이전트의 model을 지정할 수 있습니다. Claude 서브에이전트[1], Cursor 서브에이전트[2]

설정 하나로 해결하려 하지 마십시오. 매번 읽히는 긴 CLAUDE.md와 Cursor의 Always 규칙부터 줄이고, 작업별 지침만 필요할 때 불러오십시오. Cursor는 긴 대화를 자동 요약하므로 Claude Code의 /compact를 그대로 적용하는 설명도 부정확합니다. 새 작업은 새 채팅에서 시작하고, 관련 파일과 필요한 범위만 주십시오. 절약의 기준은 가장 적은 토큰이 아니라 필요한 근거를 유지하며 반복 처리를 줄이는 것입니다. Claude 비용 관리[1], Cursor 규칙[2], Cursor 대화 요약[3]

토큰 절약의 핵심은 작업대를 매번 깨끗하게 비우는 ‘작은 정리 습관’을 규칙으로 만드는 거예요. AI 코딩 도구는 대화할 때마다 이전 기록과 읽어들인 파일을 가방에 담아 통째로 다시 들고 가기 때문에, 오늘 당장 적용할 실행 우선순위를 3단계로 잡아볼게요.

• 1순위: 무시 파일 설정으로 가방 무게 줄이기 (1회 설정, 영구 효과) — 요리하기 전에 쓰지 않을 재료를 조리대에서 치우듯, 프로젝트 루트의 .cursorignore나 .gitignore에 빌드 산출물(dist/, build/), 대용량 로그(*.log), 락 파일(package-lock.json), 테스트 데이터 폴더를 등록해 인덱싱과 탐색에서 아예 배제하세요(Cursor Ignore Files 공식 문서). 또한 항상 자동으로 읽히는 CLAUDE.md나 .cursorrules는 핵심 규칙 50줄 이내로 날씬하게 유지해야 매 턴 나가는 기본 통행료를 아낄 수 있어요. 2순위: /clear와 /compact 타이밍 규칙화 (매 작업 반복)* — 새로운 기능이나 다른 버그로 넘어갈 때는 미련 없이 /clear(또는 새 채팅)를 입력해 작업대를 완전히 비우세요.

반면 하나의 긴 디버깅이나 리팩터링 흐름을 이어가야 할 때는 컨텍스트가 50~60% 차오르거나 중간 단계가 끝날 때마다 /compact [남길 핵심 요약 지시]를 실행해 핵심 결정 사항만 남기고 대화 부피를 압축하는 게 좋아요(Anthropic Claude Code 비용 관리 가이드[1]). 3순위: 서브에이전트 범위 제한과 /model 전환 (고비용 누수 차단)* — 서브에이전트에게 “코드베이스 전체에서 찾아봐”라고 지시하면 백화점 전체를 뒤지느라 토큰이 순식간에 폭발해요. 반드시 탐색할 폴더 경로(src/auth/ 등)와 반환할 요약 형식(“관련 함수명과 줄 번호만 5줄 이내로 요약해 줘”)을 프롬프트에 명시해 탐색 반경을 가두세요.

아울러 설계와 복잡한 추론만 상위 모델에게 맡기고, 단순 코드 수정이나 포맷팅은 /model 명령어로 가벼운 모델(Sonnet·Haiku 등)로 즉시 내려서 실행하면 불필요한 비용을 확실히 잠글 수 있어요.

오늘 첫 코딩 세션을 열기 전에 .cursorignore에 무거운 폴더 세 개만 먼저 적고, “기능 하나 끝나면 무조건 /clear 치기”부터 손에 익혀보세요. 이 두 가지 작은 규칙만 자리 잡아도 매번 새어나가던 컨텍스트 낭비가 절반 이하로 줄어들 거예요.

/clear가 “가장 싸다”는 말은 무엇을 계산한 것입니까? 한서윤의 캐시 지적은 받아들이겠습니다. 제 초안의 “이전 맥락을 매번 다시 처리한다”는 표현은 캐시가 적용되는 입력까지 같은 비용으로 청구된다는 인상을 줍니다. 다만 작업이 이어지는데 /clear를 치면 필요한 파일과 결정을 다시 읽히게 됩니다. 기준은 명령 자체의 비용이 아니라 다음 작업에 필요한 맥락을 되살리는 비용까지 포함한 총량이어야 합니다.

윤태오의 “탐색 경로와 반환 분량을 제한하라”는 제안도 채택할 만합니다. 그런데 락 파일과 테스트 데이터를 일괄 무시하라니요? 바로 그 파일을 조사하는 작업이라면 근거를 스스로 지우는 셈입니다. .cursorignore는 작업과 무관한 산출물부터 적용하고, 서브에이전트에는 조사 범위·완료 조건·반환 형식을 함께 지정하는 편이 엄밀합니다.

따라서 실행 규칙은 간단합니다. 작업이 바뀌면 /clear 또는 새 채팅, 같은 작업이면 보존할 결정과 미해결 문제를 적어 /compact, 위임할 때는 범위와 종료 조건을 명시하십시오. 자동 압축 임계치나 모델 전환을 만능 절약책으로 제시할 근거는 여기 없습니다. 토큰을 덜 쓰려다 재탐색과 재작업을 늘리면, 무엇을 절약한 것입니까?

중간 세션의 /model 전환은 절약이 아니다. 접두가 바뀌면 그 뒤 대화가 통째로 비캐시 재처리되고, 캐시 쓰기는 입력가의 최대 2배다. 윤태오 초안의 “낭비가 절반 이하”와 CLAUDE.md 50줄, 50–60%에서 /compact는 출처가 없다. 그 숫자는 버린다. .cursorignore로 dist/, 로그, 락파일을 인덱스에서 빼는 방향은 맞다. 절감률은 /usage로 재기 전에는 말하지 않는다.

데이크스트라 쪽이 이긴 지점이 둘이다. 같은 작업을 이을 때 요약 기준을 비우면 실패한 테스트와 변경 파일이 사라지고, maxTurns는 비용 상한이 아니다. 한도에 닿으면 부분 결과만 돌아오고 그때까지 쓴 토큰은 청구된다. 가벼운 모델은 부모 창에서 바꾸지 말고 서브에이전트 정의의 model: haiku와 필요한 tools로 고정한다. 신규 서브에이전트는 캐시 읽기 0에서 시작하고, 2026-09 실측 19건의 첫 요청 캐시 쓰기가 12,427–40,763토큰이었다. 부모의 따뜻한 캐시를 깨는 비용보다 그 쓰기 한 번이 싸다. 같은 접두가 필요하면 fork가 부모 캐시를 재사용한다.

Cursor에 Claude의 967K·/autocompact 500k를 그대로 씌우면 틀린다. Cursor는 긴 대화를 자동 요약하고, 수동 명령은 /summarize(/compress)와 새 채팅이다. 항상 주입되는 CLAUDE.md와 Always 규칙은 매 턴 통행료이며, 세션 중에 고치면 접두가 깨져 캐시 쓰기가 다시 붙는다. 줄 수 상한은 문서에 없다. 작업이 바뀌면 /clear, 같은 작업이면 보존 대상을 명시한 /compact, 모델은 서브에이전트에 고정, 무거운 산출물은 ignore. 효과는 구호가 아니라 /usage의 캐시 적중률로 판정한다.

작업 도중 수시로 모델을 바꾸던 습관은 오히려 캐시를 깨뜨려 토큰 요금을 키우는 함정이었어요. 제 초안에서는 단순 수정 시 /model로 가벼운 모델로 즉시 전환하라고 권했지만, 한서윤 님이 짚어준 공식 비용 구조(Anthropic 비용 가이드[1])를 보니 생각이 바뀌었어요. 프롬프트 캐시 읽기는 기본가의 0.1배로 아주 저렴한데, 대화 중간에 모델이나 effort 설정을 바꾸면 예열해 둔 캐시가 전부 깨져서 대화 전체를 비캐시(최대 2배의 쓰기 비용 포함)로 처음부터 다시 읽어야 해요. 또한 데이크스트라 님의 지적처럼 Cursor와 Claude Code의 명령어를 뭉뚱그리지 않고 도구별로 명확히 나누어 기존 3단계 실행 규칙을 정교하게 고쳐 잡을게요.

• 모델 변경은 ‘세션 시작 전’이나 /clear 직후에만 고정하기 (입장 수정) — 달리는 기차의 기관차를 중간에 바꾸면 처음부터 다시 출발해야 하듯, 대화 도중에는 /model 변경을 금하고 한 모델을 끝까지 유지해 0.1배 캐시 할인 혜택을 챙기세요. 대신 아예 새 작업을 시작할 때(/clear)만 난이도에 맞춰 모델을 고르고, 긴 탐색이나 단순 반복은 본문 모델을 바꾸는 대신 서브에이전트 설정 파일에 model: haiku, 허용할 tools, 그리고 무한 루프를 막는 maxTurns 상한선을 미리 못 박아 두는(Claude 서브에이전트 문서[1]) 편이 훨씬 경제적이에요.

• 자리 비우기 전 ‘선제적 압축’과 도구별 분리 습관 (두 초안 흡수) — 캐시 수명(TTL)은 1시간뿐이라 점심 식사나 회의 뒤에 돌아와 압축하면 식어버린 대화를 비싼 값에 다시 읽어야 해요(Anthropic 세션 가치 극대화 블로그[1]). 따라서 1시간 이상 자리를 비울 때는 떠나기 직전에 미리 압축해 두는 걸 새 규칙으로 삼으세요. 이때 Claude Code는 /autocompact 500k로 안전망을 걸되 수동 실행 시 /compact 결정 사항·변경 파일·실패 테스트만 보존처럼 남길 뼈대를 콕 집어주고, Cursor CLI는 /summarize( /compress)를 쓰며 Always 규칙을 작업별 동적 규칙으로 쪼개어 기본 통행료를 줄이세요.

다만 수치 확인(/context, /usage)과 보존 기준 설정만 강조한 두 분께는, ‘탐색 반경을 처음부터 물리적으로 잠그는 .cursorignore 설정’이 여전히 0순위 습관이라는 점을 꼭 설득하고 싶어요. 서브에이전트에 maxTurns를 걸고 부모 캐시를 물려받는 fork를 쓰더라도, 쓰레기통(빌드 폴더·대용량 로그)을 열어두면 첫 턴의 캐시 쓰기 비용 자체가 수만 토큰으로 부풀어 오르고 정작 보존해야 할 핵심 코드가 maxTurns 한도에 걸려 잘려 나가기 때문이에요. 결국 “무시 파일로 탐색 울타리 치기 → 휴식 전 기준 정해 압축하기 → 모델 변경은 /clear 직후에만 하기”라는 세 가지 스위치만 손에 익히면, 캐시 효율과 판단 근거를 모두 지키면서 토큰 누수를 가장 확실하게 막을 수 있어요.

약점 공략의 핵심은 이것이다. 다수 의견은 캐시 쓰기를 ‘최대 2배’라는 상한으로 가격을 매기고, 포크가 물려받는 접두의 읽기 총량은 빼지 않는다. 2026-09 실측 19건의 첫 요청 캐시 쓰기는 12,427–40,763토큰이다. 상한 2배를 그대로 곱하면 한 번의 냉시작은 기본가 환산 최대 약 8.2만 토큰이다. 부모가 /autocompact 500k 근처에 있고 캐시 읽기가 0.1배라면, 포크의 자식은 턴마다 기본가 환산 5만 토큰을 접두 재구매로 낸다. 가정은 이 500k가 그 19건의 부모 크기라는 뜻이 아니라는 점이다. 자식이 두 턴만 가도 상속 읽기만으로 냉시작 쓰기의 상한을 넘는다. 19건은 범위만 있고 중앙값도, 부모 크기와의 짝도 없다. 양 끝의 비는 약 3.3배다. 어느 끝을 ‘서브에이전트 기동비’로 써도 근거가 아니다.

500k 자동 압축과 자리 비우기 직전의 선제 압축은 절감 실측이 없다. 압축은 그 긴 기록을 한 번 더 읽고 요약을 쓰며, 짧아진 접두에 캐시 쓰기가 다시 붙는 청구다. 자리 비움이 1시간을 넘기면, TTL이 마지막 사용부터 1시간이라는 전제 아래 그 요약 캐시도 식는다. 압축비는 남고 재사용은 없다. /usage의 적중률은 비율이다. 비대한 접두를 0.1배로 성실히 재구매해도 적중률은 높게 나온다. 총 토큰은 그대로 는다.

model: haiku와 낮은 maxTurns를 절약으로 묶는 근거도 없다. 자료에는 가격비도, 추가 턴 배수도 없다. 상한에서 잘리면 부분 결과는 청구된 채 부모가 다시 띄우고, 냉시작 쓰기 12,427–40,763이 한 번 더 붙는다. .cursorignore를 세션 도중에 넣으면 CLAUDE.md를 고친 것과 같은 종류의 접두 파손이다. 조사 대상까지 빠지면 탐색이 옆길로 새고 그 실패 턴도 청구된다. 판정 수치는 적중률이 아니라, 되살린 맥락과 재시도까지 더한 다음 작업의 총 토큰이다.

토큰 절약의 기준은 명령 한 번의 비용이 아니라 다음 작업을 끝낼 때까지 재탐색과 재시도에 쓴 총량입니다. 캐시 적중률이 높아도 긴 접두를 여러 턴 읽으면 비용은 쌓입니다. 그러니 다음처럼 작업의 연속성부터 판단하십시오.

자동 압축 임계치를 높이거나 자리 비우기 전에 압축하면 반드시 절약됩니까? 제시된 자료에는 그 절감 실측이 없습니다. 서브에이전트 첫 요청의 캐시 쓰기 수치 역시 특정 환경의 관측값이므로 보편적인 기동비로 쓰지 마십시오. Claude Code에서는 /usage를 보되 적중률만 보지 말고, 압축·위임 전후에 맥락 복원과 재시도를 포함한 총 토큰을 비교해 설정을 유지할지 결정하십시오.

토큰 절약의 핵심은 일률적인 수치 암기가 아니라, 작업 전환 시점의 초기화와 서브에이전트 출력 통제를 도구별 규칙으로 고정하고 실제 총소모량으로 검증하는 데 있어요. 앞선 반론처럼 1시간 이상 자리를 비우면 압축 요약본의 캐시(TTL 1시간)도 함께 식어버리므로 휴식 전 무조건 선제 압축하라는 제 기존 제안을 철회하고, 서브에이전트 첫 요청 캐시 쓰기(12,427~40,763토큰)나 모델 전환 비용 역시 특정 환경의 측정치이므로 일반 법칙으로 단정하지 않을게요. 대신 요리할 때 도마를 작업마다 닦고 재료 손질 분량을 미리 정하듯, 아래 표의 도구별 설정과 명령어를 세션 시작 전에 적용해 보세요.

이 규칙들을 적용할 때는 세 가지 근거만 기억해 주세요. 첫째, .cursorignore는 인덱싱은 줄여도 에이전트가 직접 파일을 여는 비용까지 막지는 못하며, 조사 대상까지 빼면 탐색 실패 턴이 늘어나니 꼭 세션 시작 전에 불필요한 폴더만 잠가야 해요. 둘째, 압축 요약이 실패한 테스트 같은 핵심 맥락을 놓치거나 어설픈 maxTurns 제한으로 작업이 잘리면 부모가 맥락을 복구하고 재시도하느라 토큰을 두 번 쓰게 되니, 압축할 땐 보존 대상을 적고 서브에이전트엔 반환 형식과 종료 조건을 명확히 일러두세요. 셋째, 거대한 대화를 0.1배로 반복 구매해도 캐시 적중률 비율만 높게 나오는 착시가 생기므로, 확인되지 않은 절감 효과는 /context와 /usage로 재시도와 맥락 복구까지 합산한 작업당 총 토큰을 직접 측정해 내 워크플로에 맞게 다듬으시길 권해요.

판정 수치는 캐시 적중률이 아니라, 되살린 맥락과 재시도까지 더한 그 작업의 총 토큰입니다. 2026-09 실측 19건의 첫 요청 캐시 쓰기 12,427–40,763은 범위만 있고 중앙값도 부모 크기와의 짝도 없습니다. 상한에 입력가 2배를 곱한 약 8.2만, 또는 /autocompact 500k에 읽기 0.1배를 곱한 턴당 5만은 둘 다 가격표가 아닙니다. 그 비교는 거둡니다. 같은 접두가 필요할 때만 fork하고, 새 서브에이전트는 캐시 읽기 0에서 쓰는 한 번의 크기를 /usage로 읽으십시오.

Claude Code에서 작업이 바뀌면 /clear, 같은 작업이면 실패 테스트와 변경 파일을 보존 목록으로 명시한 /compact입니다. 압축은 긴 기록을 다시 읽고 요약을 쓰며, 짧아진 접두에 캐시 쓰기가 다시 붙습니다. 자리 비움이 마지막 사용 후 1시간을 넘기면 그 캐시도 식고 압축비 청구만 남습니다. 부모 창의 /model 전환은 접두를 통째로 비캐시 재처리하고, 캐시 쓰기는 입력가의 최대 2배입니다. 가벼운 모델은 서브에이전트 정의의 model과 필요한 tools에 고정하고, 범위·종료 조건·반환 형식을 같은 지시에 적으십시오. maxTurns는 비용 상한이 아닙니다. 한도에서 잘린 부분 결과는 청구된 채 부모가 다시 띄우면 냉시작 쓰기가 한 번 더 붙습니다. 세션 중 CLAUDE.md 수정은 접두를 깨므로 다음 세션으로 미루십시오. 줄 수 상한은 문서에 없습니다.

Cursor에 Claude의 창 크기나 /autocompact 500k를 씌우지 마십시오. 긴 대화는 자동 요약되고, 수동 수단은 /summarize(/compress)와 새 채팅입니다. dist/, 로그, 락파일은 .cursorignore로 인덱스에서 빼되, 에이전트가 파일을 직접 여는 읽기까지 막지는 못합니다. 세션 도중에 넣으면 CLAUDE.md를 고친 것과 같은 접두 파손이고, 조사 대상까지 빠지면 옆길의 실패 턴도 청구됩니다. 위 캐시 수치는 그 시점·그 환경의 실측이므로 일반 단가로 쓰지 마십시오. 절감은 다음 작업의 총 토큰이 /usage에서 줄었는지로만 말하십시오. 비대한 접두를 0.1배로 재구매해도 적중률은 높게 나옵니다.