Claude Code 비용과 컨텍스트를 관리하는 법

컨텍스트는 저장 공간이 아니라 작업 메모리다

긴 대화가 항상 더 똑똑한 결과를 만들지는 않습니다. 디자인, 데이터베이스와 배포처럼 성격이 다른 일을 한 세션에 계속 넣으면 필요한 규칙이 과거 출력에 묻힐 수 있습니다. 한 작업을 마치면 영구 지식을 문서에 남기고 새 세션으로 넘어갑니다.

압축 기능은 이어갈 때 유용하지만 중요한 결정과 현재 상태를 파일로 남기는 일을 대신하지 않습니다. 세션 재개가 필요하면 목표, 완료된 단계, 남은 검증과 변경 파일을 짧은 재개 노트로 만듭니다.

도구 출력부터 줄인다

전체 저장소, 긴 로그와 데이터 덤프를 한 번에 읽지 말고 파일 검색, 패턴 검색과 범위 읽기를 사용합니다. 외부 도구도 필터와 페이지 크기를 지정해 필요한 결과만 반환하게 합니다. 큰 출력은 비용뿐 아니라 중요한 신호를 놓칠 가능성도 높입니다.

스크린샷과 브라우저 결과는 시각 판단이 필요할 때 사용하고, 단순 레이아웃 수치는 DOM과 계산 스타일로 확인할 수 있습니다. 같은 자료를 반복 로드하지 않도록 결과 위치를 기록합니다.

모델과 병렬성은 작업 위험으로 선택한다

제품의 모델명과 제공 범위는 바뀌므로 고정된 추천표를 오래 믿기 어렵습니다. 대신 복잡한 아키텍처·보안·동시성 판단과 패턴이 분명한 반복 수정, 단순 검증을 나눕니다. 실패 영향이 큰 작업에는 더 강한 추론과 독립 리뷰를 배치합니다.

병렬 에이전트는 시간을 줄일 수 있지만 각자 컨텍스트와 도구 호출을 사용합니다. 작업이 독립적이고 통합 비용이 낮을 때만 늘리며, 동일 조사를 여러 에이전트가 반복하지 않게 합니다.

팀 비용은 토큰만 보면 왜곡된다

낮은 사용량으로 잘못된 코드를 배포해 재작업이 늘면 전체 비용은 커집니다. 작업 완료 시간, 첫 검증 통과율, 사람 리뷰 시간, 운영 장애와 함께 봐야 합니다. 조직에서는 예산 한도, 모델 라우팅과 감사 로그를 제공하는 게이트웨이를 고려할 수 있습니다.

비용 도구와 서드파티 대시보드는 편리하지만 로그와 자격증명 접근 범위를 확인합니다. 공식 사용량 자료와 청구 내역을 기준으로 삼고 특정 도구의 추정치를 절대값으로 취급하지 않습니다.

긴 로그를 읽기 전에 검색 계약을 줍니다

예시 세션은 빌드 로그가 큰 모노레포에서 실패 원인을 찾습니다. Claude가 전체 로그와 저장소를 한꺼번에 읽지 않도록 Plan Mode에서 검색 범위와 출력 크기를 먼저 제한합니다.

claude --permission-mode plan

CLAUDE.md와 package.json을 먼저 읽으세요.
/tmp/build.log 전체를 출력하지 말고 ERROR, failed, exit code 위치만 검색하세요.
관련된 파일은 필요한 함수 범위만 읽으세요.
출력은 원인 후보 최대 3개, 근거 줄, 다음 검증 명령으로 제한하세요.
파일 수정, 네트워크, 병렬 에이전트는 아직 사용하지 마세요.

같은 목표를 이어갈 때만 압축합니다

사람이 근거를 확인하고 한 가설을 고른 뒤 “선택한 가설의 실패 명령을 한 번 실행하고 결과가 맞으면 관련 파일만 수정하세요. 테스트 뒤 `git diff --check`와 `git diff -- 해당파일`을 보여주세요”라고 후속 요청합니다. 예상 결과가 가설과 다르면 다른 파일을 무제한으로 읽지 말고 관찰과 다음 선택지를 반환하게 합니다.

같은 버그를 계속 다룬다면 `/compact`에 보존할 범위와 실패 명령을 적어 이어갈 수 있습니다. UI 개선이나 배포처럼 목표가 달라지면 새 세션을 엽니다. 나중에 재개할 작업은 `/rename`으로 이름을 붙이고 변경 파일, 실행한 검증과 남은 위험을 저장소 문서에 남깁니다. 병렬 조사를 시작하기 전에는 각 에이전트가 같은 큰 로그를 중복해서 읽지 않는지 확인합니다. 비용 한도나 계정 사용량은 변동 정보이므로 공식 비용 화면을 보고, 세션 속 숫자를 청구 원장으로 취급하지 않습니다.

가상의 사용량 급증은 반복 입력에서 찾는다

가상의 팀 기록에서 일부 세션의 입력량이 다른 유사 작업보다 유난히 큽니다. 해당 세션은 같은 긴 로그를 여러 차례 다시 읽었고, 기능 구현 뒤 배포 조사까지 같은 대화에서 이어 갔습니다. 비용을 줄이려고 모델만 바꾸면 이 반복은 그대로 남습니다.

다음 비교 기간에는 로그를 오류 주변으로 제한하고 구현과 배포를 새 세션으로 나눕니다. 중앙 입력량, 첫 검증 통과율, 재작업과 완료 시간이 함께 나아지는지 관찰합니다. 이는 실제 청구 결과가 아니라 비교 방법을 설명하는 가상 시나리오입니다.

절감이 재작업을 늘리면 원래 방식으로 돌아간다

입력을 줄인 뒤 원인 파일을 다시 찾는 시간이 늘거나 첫 검증 통과율이 떨어지면 필수 맥락까지 제거한 것입니다. 세션당 입력량만 목표로 두지 않고 완료 시간, 재탐색 횟수와 리뷰 수정 수를 함께 봅니다.

팀 예산 소진 속도가 계획을 앞서거나, 한 세션의 사용량이 같은 유형 작업의 평소 범위를 크게 넘으면 새 병렬 세션을 열지 않습니다. 공식 사용량 화면에서 워크스페이스와 모델별 원인을 확인한 뒤 작업을 다시 나눕니다.

측정표에는 비용과 품질을 같은 줄에 둔다

가격은 바뀌므로 금액만 고정하지 않고 공식 사용량과 작업 결과를 함께 기록합니다.

기간 | 완료 작업 | 중앙 입력량 | 첫 검증 통과 | 재작업 | 중앙 완료시간
비교 전 | 기록 | 기록 | 기록 | 기록 | 기록
비교 후 | 기록 | 기록 | 기록 | 기록 | 기록

변경: 로그 범위 제한, 목표별 새 세션, 중복 조사 금지
중단: 통과율 하락 또는 재탐색 증가 시 입력 제한 재조정

사용량 화면이 보여 주는 범위를 먼저 확인한다

구독 사용자는 `/usage`에서 현재 사용량을 확인할 수 있지만 로컬 비용 기록은 기기와 세션에 따라 근사치이며 `/clear` 뒤 세션 합계가 초기화됩니다. `/insights`는 로컬 세션 기록 가운데 최대 200개의 아직 분석하지 않은 세션을 바탕으로 HTML 보고서를 만듭니다. 다른 기기나 웹 사용까지 포함한 완전한 청구 명세로 해석하면 안 됩니다.

Claude 구독 사용량, Console API 과금, 클라우드 제공자 청구는 서로 다른 경로입니다. 비용을 줄일 때는 먼저 `/clear`, `/compact`, `/rename`, `/resume`로 세션 경계를 관리하고, 독립 작업만 병렬화합니다. Agent Teams는 활성 팀원 수와 시간에 비례해 사용량이 커질 수 있어 비용 상한과 종료 조건을 먼저 둡니다.