생산성을 잃지 않고 Claude 코드 비용을 60% 절감한 방법

Source: Dev.to

My first full month using Claude Code on a Kotlin Multiplatform project cost me $340. My second month? $127. Same project, same velocity, same output quality. The difference was understanding where tokens actually go — and stopping the bleeding at the source.

This isn’t about using Claude Code less. It’s about using it smarter. Below are the strategies that made the difference, with real numbers from my workflow.

숨겨진 비용: 컨텍스트 윈도우 부피 증가

가장 큰 비용 요인은 보낸 프롬프트 수가 아니라, 각 프롬프트에 담는 컨텍스트 양입니다. Claude Code 세션의 모든 메시지는 전체 대화 기록을 포함합니다. 세션에서 30번째 메시지가 될 때는 이전 30개의 교환과 새로운 프롬프트를 모두 보내게 되며, 토큰 하나하나에 비용을 지불하게 됩니다.

일주일 동안 세션을 추적했습니다. 패턴은 명확했습니다:

컨텍스트가 누적되기 때문에 프롬프트당 비용은 기하급수적으로 증가합니다. 50개의 메시지 세션이 10개의 메시지 세션보다 5배가 아니라 50배 이상의 비용이 듭니다.

전략 1: 15‑메시지 규칙

새 세션을 15개의 메시지마다 시작하세요—예외 없이. 재설정하기 전에 지금까지 달성한 내용과 다음에 할 일을 간단히 요약하고, 집중된 프롬프트로 새로 시작합니다.

Before: One marathon session (47 messages) → $34
After:  Three focused sessions (15+15+12) → $9

/compact 명령도 도움이 됩니다—컨텍스트가 길어질 때 압축해 줍니다. 하지만 새로 시작하는 것이 더 좋습니다. 왜냐하면 필요한 컨텍스트만으로 문제를 다시 정의할 수 있기 때문입니다.

작업 흐름

1. 약 15개의 메시지 동안 작업합니다.
2. /cost를 실행해 비용을 확인합니다.
3. 컨텍스트가 무거워지면 진행 상황을 기록합니다.
4. 필요한 내용만 포함한 집중 프롬프트로 새 세션을 시작합니다.

전략 2: 전체 파일 덤프 중단

내가 가장 나쁜 습관은 전체 파일을 붙여넣는 것이었다. “이 파일을 봐” → 500줄 → Claude가 모든 내용을 읽으며 import, 보일러플레이트, 관련 없는 코드에 토큰을 소모한다.

Before

Read src/shared/data/repository/UserRepository.kt and fix the caching bug

Result: The entire 400‑line file goes into context; ~350 lines are irrelevant.
결과: 전체 400줄 파일이 컨텍스트에 들어가며, 약 350줄은 관련이 없다.

After

In src/shared/data/repository/UserRepository.kt, the getCachedUser()
function (around line 45‑60) returns stale data when the cache TTL expires.
The issue is in the timestamp comparison. Fix the cache invalidation logic.

Result: Claude knows exactly where to look, reads only the relevant section, and produces a faster, cheaper, more accurate response.
결과: Claude는 정확히 어디를 봐야 할지 알고, 관련 섹션만 읽어 더 빠르고, 비용이 적게 들며, 더 정확한 응답을 만든다.

Savings: ~40 % reduction in input tokens per file‑editing task.
절감: 파일 편집 작업당 입력 토큰이 약 40 % 감소한다.

전략 3: 간단한 작업에 One‑Shot 모드 사용

인터랙티브 모드는 탐색 및 다단계 작업에 좋지만, 간단하고 명확히 정의된 작업에는 One‑Shot 모드(claude -p)가 훨씬 저렴합니다.

인터랙티브 모드 (간단한 작업)

claude
> "Add a debug log in processPayment() before the API call"
# Minimum cost: ~$0.15 even for a one‑liner

One‑Shot 모드

claude -p "Add console.log('Processing payment:', amount) before
the fetch call in src/api/payments.ts:42"
# Cost: ~$0.03

이제 One‑Shot 모드를 다음에 사용합니다:

• 로그 문 추가
• 간단한 찾기‑바꾸기 작업
• 보일러플레이트 생성(인터페이스, 데이터 클래스)
• 빠른 설명(예: “이 정규식은 무엇을 하나요?”)

경험 법칙: 작업을 한 문장으로 설명할 수 있고 왕복 대화가 필요 없으면 -p를 사용하세요.

전략 4: 비용 절감 무기로서 CLAUDE.md

잘 작성된 CLAUDE.md 파일은 대부분의 사람들이 깨닫지 못하는 방식으로 비용을 절감합니다. Claude Code가 프로젝트 구조, 규칙, 패턴을 사전에 이해하면, 명확히 하는 질문을 덜 하고 잘못된 추측도 줄어듭니다.

CLAUDE.md 없이

Prompt: "Add a new API endpoint for user preferences"
Claude: *reads 12 files to understand your project structure*
Claude: *asks 3 follow‑up questions about your patterns*
Claude: *generates code using wrong conventions*
You: "No, we use repository pattern, not direct DB calls"
Claude: *regenerates everything*
Total: 8 messages, $4.20

CLAUDE.md와 함께

Prompt: "Add a new API endpoint for user preferences"
Claude: *reads CLAUDE.md, knows your patterns*
Claude: *generates correct code on first try*
Total: 2 messages, $0.45

CLAUDE.md에 포함해야 할 핵심 내용

• 프로젝트 구조 및 아키텍처 패턴
• 명명 규칙
• 파일 조직 규칙
• 일반적인 패턴(오류 처리, 로깅, 테스트)
• 의존성 및 사용 패턴

CLAUDE.md를 작성하는 데 드는 30분은 첫 주에 스스로 비용을 회수합니다.

전략 5: 관련 변경 사항 일괄 처리

프롬프트당 하나씩 변경하는 대신, 관련된 변경을 한 번에 묶어 처리하세요. 각 프롬프트에는 기본 비용(컨텍스트 윈도우)이 발생하므로, 프롬프트 수가 적을수록 총 비용이 낮아집니다.

비싼 방법 (프롬프트 5개 별도)

1. "Add email field to User model"
2. "Update UserRepository to handle email"
3. "Add validation for email in the UI"
4. "Write unit tests for email handling"
5. "Update API docs for the new field"

비용: 5 × base + context ≈ $2.50

일괄 처리 방법 (프롬프트 1개)

"Add an email field to the User model, update UserRepository,
add UI validation, write unit tests, and update API docs."

비용: 1 × base + slightly larger context ≈ $0.80

일괄 처리는 컨텍스트 재로드 횟수를 줄여 전체 지출을 크게 낮춥니다.

핵심 요약

• 컨텍스트 최소화: 약 15개의 메시지마다 리셋하고, /compact를 사용하며, 전체 파일 덤프를 피합니다.
• 적절한 모드 선택: 간단한 작업은 원샷, 복잡하고 다단계 작업은 인터랙티브 모드 사용.
• 프로젝트 메타데이터에 투자: 간결한 CLAUDE.md가 곧 비용 절감으로 이어집니다.
• 관련 편집을 일괄 처리: 프롬프트 수가 적을수록 기본 비용이 낮아집니다.

이러한 습관을 적용하면 Claude Code 청구서가 수백 달러에서 일부에 불과하게 줄어들면서도 속도와 품질을 유지할 수 있습니다. 즐거운 코딩 되세요!

사용자 시스템에 이메일 필드 추가

아래는 사용자 시스템에 이메일 필드를 추가하기 위한 간결한 계획과 두 가지 프롬프트 접근 방식의 비용 절감 비교입니다.

프롬프트 개요 (5‑단계 계획)

1. 데이터 모델에 이메일 추가 – User 데이터 클래스에 email: String을 선언합니다.
2. 이메일 영속화 – UserRepository.createUser()를 업데이트하여 새 필드를 저장합니다.
3. 이메일 검증 – CreateUserUseCase에 이메일 검증(표준 정규식)을 추가합니다.
4. API 업데이트 – POST /users 엔드포인트를 수정하여 이메일을 수신하고 반환하도록 합니다.
5. 이메일 노출 – UserResponse DTO에 email을 포함시킵니다.

참고: CLAUDE.md에 설명된 기존 패턴을 따르세요.

비용 비교

절감액: 동일한 작업에 대해 약 75 % 비용 절감.

지속적인 비용 관리 전략

전략 6 – 비용 대시보드 습관

• /cost를 5 메시지마다 실행합니다.
• 간단한 스프레드시트에 일일 지출을 추적합니다.
• 데이터를 활용해 비용이 많이 드는 습관을 파악합니다(예: 긴 세션, 불필요한 파일 읽기).

월별 비용 분석 (전 vs. 후)

가장 큰 성과는 마라톤 세션을 완전히 없앤 것이며, 두 번째는 간단한 작업에 원샷 모드를 사용한 것입니다.

What NOT to Optimize

• Claude Code를 피하지 마세요. 시간이 절약된다면 $2짜리 프롬프트가 30분 디버깅을 방지하는 것이 좋은 거래입니다.
• 토큰을 절약하려고 불명확한 프롬프트를 작성하지 마세요; 이는 종종 여러 차례의 후속 작업을 필요로 하여 전체 비용을 증가시킵니다.
• 상황에 따라 컨텍스트가 필요할 때 파일 읽기를 건너뛰지 마세요. 파일을 읽는 토큰 비용은 잘못된 코드를 생성하는 비용에 비하면 매우 작습니다.

목표는 낭비를 없애는 것이지, 사용을 없애는 것이 아닙니다.

주요 요점

• 약 15개의 메시지마다 새 세션을 시작하세요 – 컨텍스트 누적이 가장 큰 비용 요인입니다.
• 전체 파일이 아니라 특정 라인을 지정하세요 – 입력 토큰을 약 40 % 줄입니다.
• 간단한 작업에는 claude -p를 사용하세요 – 대화형 모드보다 최대 5× 저렴합니다.
• CLAUDE.md에 투자하세요 – 일주일 안에 비용을 회수합니다.
• 관련 변경을 한 번에 묶으세요 – 하나의 포괄적인 프롬프트가 여러 작은 프롬프트보다 효율적입니다.
• 5개의 메시지마다 /cost를 확인하세요 – 인식이 행동을 바꿉니다.

이 수치는 Kotlin Multiplatform 프로젝트에서 개인적으로 사용한 결과입니다. 비용은 플랜, 프로젝트 규모, 사용 패턴에 따라 달라지지만, 비율과 전략은 보편적으로 적용됩니다.