작업 단위만 쪼개도 Claude Code 사용료를 절반으로 줄입니다

토큰 낭비를 막는 세션 관리 규칙

Claude Code 같은 자율 에이전트를 쓸 때 가장 조심해야 할 건 대화가 길어지는 상황입니다. 에이전트는 이전 대화 기록과 참조 파일을 반복해서 읽으며 토큰을 소모합니다. 대화가 길어질수록 비용이 기하급수적으로 늘어나는 구조입니다. 1인 창업가라면 전체 프로젝트를 한 번에 수정해달라는 식의 요청은 피해야 합니다. API 엔드포인트 하나, 혹은 UI 컴포넌트 하나처럼 최소 실행 단위로 세션을 나누면 토큰 소모량을 50% 이상 아낄 수 있습니다.

비용을 아끼려면 터미널 명령어를 습관적으로 사용해야 합니다. 새로운 기능을 만들기 전에는 /clear 명령어로 기존 맥락을 지워야 합니다. 이전 대화가 남아있으면 모델은 굳이 읽지 않아도 될 데이터까지 훑으며 돈을 씁니다. 작업과 관련 있는 폴더만 지정하는 /add-dir 명령어도 유용합니다. 불필요한 파일 스캔을 차단하기 때문입니다. 대화가 길어지면 /compact를 입력하고 "데이터베이스 스키마 정보만 남겨라" 같은 지시를 보태서 핵심만 남기세요. 이 사소한 습관이 월간 API 지출을 40% 이상 깎아줍니다.

고난도 설계는 비싼 모델에 맡기고 단순 코딩은 저렴한 모델로 돌리는 전략이 필요합니다. 설계 단계에서는 추론 능력이 좋은 모델을 쓰고, 실제 구현은 Sonnet이나 Haiku 모델로 전환하는 식입니다. Anthropic의 가이드에 따르면 CLAUDE.md 파일 내 프로젝트 규칙을 200라인 이내로 유지하는 게 좋습니다. 세션마다 로드되는 기본 비용을 줄여주기 때문입니다. 가끔은 ~/.claude/sessions 디렉토리를 열어보세요. 어떤 작업에서 돈이 많이 새나가는지 눈으로 확인해야 대책이 섭니다.

로컬의 통제력과 클라우드의 자동화를 결합하는 방법

로컬 환경의 정밀한 조작과 UltraPlan 클라우드 환경의 자율 실행을 섞으면 개발 속도가 빨라집니다. Superpowers 플러그인을 활용해 TDD(테스트 주도 개발) 방식으로 설계를 먼저 잡아보세요. 로컬에서 만든 상세 설계서는 클라우드 에이전트가 길을 잃지 않게 만드는 이정표가 됩니다. 잘 짜인 설계도 하나가 에이전트의 헛발질을 막고 구현 정확도를 높입니다.

구체적인 흐름은 이렇습니다. 로컬에서 Superpowers의 /brainstorm으로 요구사항을 정리하고 /write-plan으로 plan.md 파일을 만듭니다. 그 다음 Git Worktrees를 써서 독립된 브랜치를 따고 설계 문서를 GitHub에 올립니다. 마지막으로 claude.ai/code 웹 인터페이스에서 .env 환경 변수와 service postgresql start 같은 초기화 스크립트를 세팅하세요. 이렇게 하면 클라우드 컨테이너에서도 로컬과 똑같은 환경이 돌아갑니다. 인프라 설정이 꼬여서 날리는 시간을 버릴 수 있습니다.

주의할 점도 있습니다. UltraPlan은 Anthropic이 관리하는 독립된 가상 머신에서 돌아갑니다. 로컬에 있는 설정 파일이 알아서 따라오지 않습니다. 보안상 CCR(Cloud Container Runtime)에는 전용 비밀 키 저장소가 없어서 환경 설정에 넣은 변수가 노출될 위험도 있습니다. 민감한 정보는 꼭 필요한 것만 넣고, 복잡한 설치 과정은 에이전트가 스스로 해결하도록 스크립트를 짜두는 편이 안전합니다.

예산 폭주를 막는 가드레일 설정

에이전트에게 일을 맡겨놓고 잠들었을 때 가장 무서운 건 예산 소진입니다. 무한 루프에 빠지거나 갑자기 비싼 모델을 마구 호출하면 아침에 영수증 폭탄을 맞습니다. 이를 막으려면 다중 예산 통제 시스템을 깔아야 합니다. MAX_THINKING_TOKENS 설정만 잘해도 성능은 유지하면서 비용이 튀는 현상을 막을 수 있습니다.

시스템 가드레일은 세 가지만 기억하세요. 환경 변수에 MAX_THINKING_TOKENS=8000을 걸어 추론 비용의 상한선을 둡니다. 실행할 때는 --max-budget-usd 옵션을 붙여서 정해진 금액을 넘기면 에이전트가 즉시 멈추게 만드세요. 마지막으로 CLAUDE.md에 테스트 커버리지 85% 이상, 린터 통과 같은 체크리스트를 적어두면 에이전트가 코드를 올리기 전 스스로 검수합니다. 이 정도 장치는 해둬야 마음 편히 잠들 수 있습니다.

에이전트가 짠 코드를 직접 보기 전에 테스트 코드가 통과했는지부터 확인하는 습관을 들여야 합니다. 성공 기준을 명확히 주면 에이전트는 결과 보고서까지 써냅니다. Bifrost 같은 게이트웨이를 쓰면 프로젝트별로 예산을 더 깐깐하게 나눌 수 있습니다. 개발자는 코드를 한 줄씩 읽는 노가다 대신 요약된 차이점과 테스트 결과만 보고 승인 버튼을 누르면 그만입니다.

24시간 돌아가는 배포 파이프라인

개발 자동화의 끝은 내가 손대지 않아도 코드가 배포되는 CI/CD 환경입니다. Claude Code를 GitHub Actions와 연결하면 터미널을 열 필요도 없습니다. 이슈 하나만 잘 만들어도 개발 주기가 돌아갑니다. 수동으로 배포하고 환경 맞추느라 버리는 시간을 매주 5시간은 아낄 수 있습니다.

파이프라인 구축은 간단합니다. GitHub Actions에서 issue_comment 트리거를 켜고 @claude implement라고 댓글을 달면 에이전트가 일하게 만듭니다. 보안을 위해 GitHub Token 권한은 딱 필요한 만큼만 줍니다. 배포는 Vercel이나 AWS 웹훅을 메인 브랜치 병합 이벤트와 연결하세요. 이슈 생성부터 코드 수정, PR 생성, 배포까지 이어지는 흐름이 멈추지 않고 돌아갑니다.

자동화 환경에서 가장 걱정되는 건 보안입니다. 외부인이 깃허브 액션을 악용하지 못하도록 포크 제한 규칙을 꼭 걸어야 합니다. 메인 브랜치에 코드를 합치기 전에는 반드시 사람이 확인하는 승인 단계를 두세요. AI가 혹시라도 이상한 코드를 심지는 않았는지 최종 확인은 사람의 몫입니다. 정교한 파이프라인을 설계해두면 1인 창업가는 코드 한 줄 더 짜는 고민 대신 비즈니스 가치를 높이는 데 집중할 수 있습니다.