클로드 코드로 레거시를 고칠 때 지갑을 지키는 현실적인 방법

지능은 높이고 비용은 깎는 이중 모델 교차 운용

에이전트 기반 코딩을 시작할 때 가장 겁나는 건 성능이 아니라 다음 달 카드 명세서입니다. 영상에서 본 이중 에이전트는 환상적이지만, 아무 생각 없이 쓰다간 API 비용 폭탄을 맞기 딱 좋습니다. 2026년 현재 클로드 4.6 오퍼스(Opus)의 입력 단가는 100만 토큰당 $5.00로 소네트($3.00)보다 60% 이상 비쌉니다. 출력 비용은 $25.00까지 치솟습니다. 10만 토큰이 넘는 레거시 프로젝트에서 루프가 한 번 돌 때마다 커피 한 잔 값이 날아가는 셈입니다.

비용을 통제하려면 무조건 오퍼스만 고집하지 말고 슬롯 배정 방식을 써야 합니다. 전체 작업의 20%인 설계와 아키텍처 판단에만 오퍼스를 배치하고, 나머지 80%의 단순 구현은 소네트에게 맡깁니다.

• 방법: 앤스로픽 콘솔(Anthropic Console)에서 프로젝트별 예산 한도(Usage Limit)를 먼저 거십시오. 클로드 코드 설정에서 기본 모델은 소네트로 두되, 복잡한 로직이 꼬인 세션에서만 --model opus 플래그로 수동 승격합니다. 매주 월요일 아침에 API 리포트를 열어 실제 지출이 예상 곡선을 타는지 확인하는 습관이 필요합니다.
• 결과: 고난도 추론 품질은 챙기면서 전체 API 비용을 40%에서 최대 70%까지 덜어낼 수 있습니다.

토큰 낭비를 막는 코드베이스 지형도 작성

에이전트가 쓰는 토큰의 70%는 사실 불필요한 파일을 뒤지고 디렉토리를 탐색하는 데 낭비됩니다. LLM은 컨텍스트가 10만 토큰을 넘어가면 집중력이 급격히 떨어지는 성능 절벽 현상을 보입니다. 모든 소스코드를 다 밀어 넣는 건 돈 버리고 성능 망치는 지름길입니다. 앤스로픽의 내부 테스트 결과를 보면, 컨텍스트를 압축해서 전달할 때 추론 품질은 유지되면서 입력 비용은 50% 이상 줄어듭니다.

AI 전용 명세서인 ARCH.md를 만들어 에이전트에게 지도를 쥐여주십시오.

• 방법: 먼저 tree -L 3 -I 'node_modules|dist|.git' > tree.md 명령으로 프로젝트의 뼈대부터 추출합니다. 그다음 레포믹스(Repomix) 같은 도구를 써서 실제 로직은 빼고 함수 시그니처와 인터페이스 정의만 남긴 시그니처 맵을 만듭니다. 마지막으로 .claudeignore 파일에 .svg, .json 같은 에셋을 확실히 적어 에이전트의 시야에서 치워버리십시오.
• 결과: 초기 탐색 단계를 줄여 세션당 입력 토큰 소비를 50% 이상 아끼고 응답 속도는 2배 가까이 끌어올립니다.

배포 후 버그 수정을 줄이는 비판적 검토 자동화

이중 에이전트의 핵심은 설계(Advisor)와 구현(Executor)을 분리해 안전 장치를 만드는 겁니다. 단순히 "코드 리뷰해줘"라고 하면 "깔끔하네요" 같은 영혼 없는 대답만 돌아옵니다. 시니어 엔지니어라면 어드바이저에게 심술궂은 비판자 역할을 강제로 맡겨야 합니다. 이 단계만 제대로 거쳐도 매주 5시간 이상 걸리던 사후 버그 수정 시간을 대폭 줄일 수 있습니다.

실행 모델이 코드를 건드리기 전, 오퍼스에게 비판적 검토를 시키는 장치를 만드십시오.

• 방법: 클로드 코드 커스텀 스킬에 'Critical Review' 프롬프트를 등록합니다. 이때 데이터 정합성(Race Condition), 보안 취약점, 성능 저하(N+1 Query)라는 3가지 항목을 반드시 체크하라고 명시하십시오. 이 검토에서 심각한 결함이 없다는 승인이 떨어질 때만 실행 명령을 내리는 규칙을 세워야 합니다.
• 결과: 논리적 결함이 눈에 띄게 줄어들며, 실제 운영 환경에서의 장애 발생률을 30% 이상 낮추는 효과를 봅니다.

대규모 작업 시 발생하는 병목 해결법

어드바이저와 이그제큐터를 한 줄로 세워두면 검증할 때마다 대기 시간이 생깁니다. 수백 개 파일을 고쳐야 하는 대규모 리팩토링에서는 이 방식이 너무 느립니다. 5만 라인 이상의 라이브러리를 마이그레이션할 때는 작업을 쪼개서 병렬로 돌리는 오케스트레이션이 필요합니다.

작업 속도를 높이는 병렬 공정은 다음과 같이 짭니다.

• 방법: git worktree add 명령으로 기능별 독립 디렉토리를 만듭니다. 각 워크트리에서 별도의 클로드 코드 세션을 띄워 서로 다른 모듈을 동시에 리팩토링합니다. 마지막에 클래시(Clash) 같은 도구로 워크트리 간 충돌을 잡으며 메인 브랜치에 합칩니다.
• 결과: 몇 주 걸릴 리팩토링 작업을 단 20시간 내외의 집중 작업으로 끝내는 생산성 향상을 경험하게 됩니다.

AI 기술 부채를 막는 주간 아키텍처 감사

AI가 짠 코드가 쌓이다 보면 어느 순간 전체 구조가 엉망이 되는 기술 부채가 발생합니다. 에이전트는 파일 하나는 기가 막히게 고치지만, 시스템 전체가 가야 할 방향까지는 책임지지 않습니다. 2026년 시니어 엔지니어의 진짜 업무는 코드를 직접 타이핑하는 게 아니라, 에이전트들이 만든 결과물의 정렬 상태를 관리하는 것입니다.

매주 금요일 퇴근 전, '아키텍처 감사' 루틴을 돌리십시오.

• 방법: 한 주 동안 바뀐 모든 커밋을 오퍼스에게 넣고 기존 컨벤션(예: Early Return 패턴)을 어긴 곳이 있는지 찾게 합니다. 복잡도가 너무 높아진 함수나 테스트가 빠진 모듈을 골라내 '부채 목록'을 만드십시오. 이 목록이 다음 주 에이전트의 첫 번째 할 일이 됩니다.
• 결과: 코드베이스가 썩어가는 것을 막고, AI를 처음 도입했을 때의 깨끗한 상태를 장기적으로 유지할 수 있습니다.