요즘 AI 코딩 도구를 사용하시는 분들이 정말 많아졌습니다. 그중에서도 클로드코드(Claude Code)는 개발자들 사이에서 인기가 높은 AI 코딩 어시스턴트인데요. 그런데 막상 사용해보니 생각보다 비용이 많이 나와서 깜짝 놀라신 분들 계시지 않나요? 저도 처음 사용할 때는 며칠 만에 토큰을 다 써버려서 당황한 적이 있었습니다. 오늘은 클로드코드를 사용하면서 토큰을 효율적으로 사용하고 비용도 아낄 수 있는 프롬프트 작성 방법에 대해 자세히 알려드리겠습니다. 초보자분들도 쉽게 따라하실 수 있도록 차근차근 설명드릴게요.
클로드코드와 토큰의 관계 이해하기
먼저 토큰이 뭔지부터 간단히 짚고 넘어가야겠습니다. 토큰은 AI가 텍스트를 처리하는 최소 단위라고 보시면 됩니다. 한국어 기준으로 보통 1글자가 1~2토큰 정도 차지하고, 영어는 보통 한 단어가 1토큰 정도입니다. 그런데 클로드코드는 여러분이 입력한 프롬프트뿐만 아니라 AI가 생성하는 답변, 그리고 코드 파일을 읽어들이는 것까지 모두 토큰으로 계산됩니다.
여기서 중요한 포인트가 있습니다. 클로드코드는 단순히 우리가 입력한 글자 수만큼만 토큰을 쓰는 게 아닙니다. 프로젝트 폴더 안의 파일들을 읽고, 컨텍스트를 유지하기 위해 이전 대화 내용까지 계속 함께 처리하기 때문에 생각보다 훨씬 많은 토큰이 소모됩니다. 그래서 똑같은 작업을 시켜도 프롬프트를 어떻게 작성하느냐에 따라 토큰 사용량이 몇 배까지 차이가 날 수 있습니다.
토큰이 가장 많이 낭비되는 순간들
제가 직접 사용해보면서 느낀 토큰 낭비의 주범들을 정리해봤습니다. 첫째는 모호한 지시입니다. “코드 좀 고쳐줘” 같은 두루뭉술한 요청은 AI가 추측하면서 여러 번 시도하게 되어 토큰이 폭발합니다. 둘째는 불필요한 파일 탐색입니다. AI에게 어디를 봐야 할지 알려주지 않으면 프로젝트 전체를 뒤지면서 토큰을 어마어마하게 씁니다. 셋째는 긴 대화 누적입니다. 한 세션에서 너무 많은 작업을 하면 이전 대화가 계속 누적되어 매번 같이 처리됩니다.
토큰을 아끼는 프롬프트 작성 핵심 원칙
이제 본격적으로 토큰을 아끼는 프롬프트 작성 방법을 알려드리겠습니다. 어렵지 않으니 천천히 따라오시면 됩니다.
1. 구체적이고 명확하게 지시하기
가장 중요한 원칙입니다. AI가 추측할 일이 없도록 명확하게 지시해야 합니다. 예를 들어보겠습니다.
나쁜 예: “로그인 기능 좀 만들어줘”
좋은 예: “src/auth 폴더에 이메일과 비밀번호로 로그인하는 함수를 만들어줘. JWT 토큰 발급까지 포함해주고, bcrypt로 비밀번호 해싱해줘”
두 번째 프롬프트는 더 길어 보이지만 결과적으로 토큰을 훨씬 적게 씁니다. 왜냐하면 AI가 한 번에 정확한 작업을 수행하기 때문이죠. 모호한 지시는 AI가 여러 번 다시 작업하게 만들고, 그때마다 토큰이 두 배, 세 배로 늘어납니다.
2. 작업할 파일 위치 알려주기
클로드코드는 프로젝트 폴더를 자동으로 탐색하는 능력이 있는데, 이게 양날의 검입니다. 편리하지만 토큰을 많이 잡아먹습니다. 그래서 작업할 파일 경로를 직접 알려주는 습관을 들이시면 좋습니다. “@src/components/Button.tsx 파일을 수정해줘”처럼 @를 붙여 파일을 직접 지정하면 AI가 헤매지 않습니다.
3. 작업 단위를 작게 쪼개기
한 번에 거대한 작업을 시키면 AI가 코드를 길게 생성하면서 토큰을 엄청나게 씁니다. 차라리 “먼저 데이터베이스 스키마부터 만들자”, “이제 API 라우트를 추가하자” 이런 식으로 단계별로 나누는 게 효율적입니다. 또한 작업 도중에 문제가 생기면 처음부터 다시 할 필요 없이 그 단계만 수정하면 되니까 시간도 절약됩니다.
실전에서 바로 쓰는 토큰 절약 프롬프트 패턴
이론은 알겠는데 실제로 어떻게 써야 할지 막막하실 수 있습니다. 그래서 바로 활용 가능한 프롬프트 템플릿을 몇 가지 준비했습니다.
코드 수정 요청 템플릿
코드를 수정할 때는 다음과 같은 형식을 추천드립니다. “@파일경로 파일에서 [어떤 함수/부분]을 [어떻게] 수정해줘. [추가 조건이나 제약사항]. 다른 파일은 건드리지 마” 마지막에 “다른 파일은 건드리지 마”를 추가하는 게 의외로 큰 효과가 있습니다. AI가 괜히 다른 파일까지 들춰보면서 토큰을 쓰는 것을 방지해줍니다.
새 기능 추가 템플릿
새로운 기능을 추가할 때는 “[기능명]을 만들어줘. 위치는 [경로], 사용할 라이브러리는 [라이브러리명], 입력은 [입력값], 출력은 [출력값]. 에러 처리는 [방식]으로 해줘” 이렇게 입출력과 사용 라이브러리를 미리 지정해주면 AI가 추측할 일이 없습니다.
디버깅 요청 템플릿
에러가 났을 때는 에러 메시지 전체를 그대로 붙여넣고 “이 에러는 [어떤 동작]을 할 때 발생했어. @파일경로 의 [몇 번째 줄] 근처를 봐줘”라고 하면 AI가 빠르게 원인을 찾습니다. 막연하게 “에러 났어 고쳐줘”라고 하면 AI가 프로젝트 전체를 분석하느라 토큰을 어마어마하게 씁니다.
비용을 더 아끼는 클로드코드 활용 꿀팁
프롬프트 작성법 외에도 토큰을 아낄 수 있는 방법들이 있습니다. 함께 알아두시면 비용 부담을 크게 줄일 수 있습니다.
CLAUDE.md 파일 활용하기
프로젝트 루트에 CLAUDE.md 파일을 만들어두면 클로드코드가 매번 이 파일을 참고합니다. 여기에 프로젝트 구조, 코딩 컨벤션, 자주 쓰는 명령어 등을 정리해두면 매번 같은 설명을 반복할 필요가 없어집니다. 예를 들어 “이 프로젝트는 Next.js 14 App Router를 사용한다”, “스타일링은 Tailwind CSS를 쓴다” 같은 정보를 넣어두면 AI가 매번 파일을 뒤져 확인하지 않아도 됩니다.
불필요한 폴더는 무시 설정
node_modules, .next, dist 같은 폴더는 AI가 볼 필요가 없습니다. .gitignore에 추가된 폴더들은 클로드코드도 기본적으로 무시하지만, 추가로 무시하고 싶은 폴더가 있다면 별도 설정해두시면 좋습니다. 무거운 빌드 결과물이나 캐시 폴더를 AI가 잘못 읽으면 토큰이 한 번에 수만 개씩 날아갑니다.
세션을 적절히 종료하고 새로 시작하기
한 세션에서 계속 작업하면 이전 대화가 누적되어 매번 함께 처리됩니다. 작업이 한 단락 마무리되면 새 세션을 시작하는 습관을 들이세요. 특히 완전히 다른 주제의 작업을 시작할 때는 무조건 새 세션이 효율적입니다. 저는 보통 기능 하나 완성하면 새 세션으로 넘어갑니다.
한국어보다 영어가 토큰을 적게 쓴다는 사실
한국어는 영어보다 토큰을 더 많이 사용합니다. 같은 의미의 문장이라도 한국어가 영어보다 1.5~2배 정도 토큰을 더 씁니다. 영어가 편하신 분이라면 프롬프트를 영어로 작성하는 것도 토큰 절약에 도움이 됩니다. 다만 영어가 어색하면 오히려 모호한 지시가 될 수 있으니 자신 있는 언어로 명확하게 쓰는 게 더 중요합니다.
토큰 사용량 모니터링하는 습관 들이기
마지막으로 가장 중요한 건 자신이 얼마나 토큰을 쓰고 있는지 계속 확인하는 습관입니다. 클로드코드에서는 /cost 명령어로 현재 세션의 비용을 확인할 수 있습니다. 작업할 때마다 한 번씩 확인하면서 “아, 이런 식으로 했더니 비용이 많이 나오는구나” 하는 감각을 키우시는 게 좋습니다.
처음에는 좀 번거로울 수 있지만 한두 달만 신경 써서 사용하시면 자연스럽게 효율적인 프롬프트 작성 습관이 몸에 배게 됩니다. 그러면 같은 비용으로 훨씬 많은 작업을 할 수 있고, 결과물 품질도 좋아집니다. AI 도구는 잘 쓰면 정말 강력한 무기가 되지만, 잘못 쓰면 비용만 잡아먹는 애물단지가 될 수도 있습니다. 오늘 알려드린 방법들을 차근차근 적용해보시면서 여러분만의 효율적인 작업 방식을 찾아보시길 바랍니다.
