AI 코딩 에이전트 토큰 절약 설정 — Claude Code·Cursor·Copilot 화면별로 정리

Daily BaapIT/전자기기· 수정

AI 코딩 에이전트를 쓰다 보면 어느 날 갑자기 대화가 느려지거나, 이번 달 사용량이 예상보다 훅 줄어든 걸 느끼게 되는 순간이 있습니다. 어디를 만지면 덜 쓰게 될까요?

결론부터 말하면 세 가지입니다. 대화를 자주 비워서 컨텍스트를 작게 유지하고, 작업 난이도에 맞는 모델을 고르고, 지출 한도를 미리 걸어 둔다. 이 세 가지는 Claude Code, Cursor, GitHub Copilot 모두 화면에서 직접 설정할 수 있는 항목이에요. 아래에서 도구별로 메뉴 이름까지 짚어 보겠습니다.

시작하기 전에 — 어느 요금제에서 되나

  • Claude Code는 Pro·Max·Team·Enterprise 구독이나 Claude Console(API 과금) 계정으로 씁니다. 구독 요금제 사용자는 세션당 비용이 아니라 5시간 롤링 윈도우와 주간 윈도우로 한도가 도는 방식이라, 아래 나오는 /usage의 달러 표시는 참고용이지 실제 청구서가 아니에요.
  • Cursor는 Hobby(무료)·Pro·Pro Plus·Ultra로 나뉘고, 지출 한도나 온디맨드 사용량 조절은 Pro 이상에서 의미가 있습니다.
  • GitHub Copilot는 2026년 6월부터 대부분 사용자에게 AI 크레딧 기반 사용량제 청구로 바뀌었어요(1 크레딧 = 0.01달러). 코드 자동완성과 다음 편집 제안은 어느 요금제에서도 크레딧을 쓰지 않고, 채팅·에이전트·프리미엄 모델을 쓸 때만 크레딧이 줄어듭니다. 개인 요금제 기존 연간 가입자 일부는 여전히 예전 방식(모델별 배수)으로 청구되는 경우가 있어요.

컨텍스트를 작게 유지하기 — 대화가 길어질수록 토큰이 늘어난다

노트북에 거의 빈 텍스트 에디터 창이 떠 있는 모습

토큰 비용은 컨텍스트 크기에 비례합니다. Claude Code 공식 문서에는 “Claude가 처리하는 컨텍스트가 많을수록 더 많은 토큰을 사용합니다”라고 적혀 있어요.

Claude Code에서는 이렇게 관리합니다.

  1. 관련 없는 작업으로 넘어갈 때는 /clear를 씁니다. 이전 세션은 사라지지 않고 /resume으로 다시 불러올 수 있어요.

  2. 같은 작업 안에서 컨텍스트만 줄이고 싶으면 /compact를 씁니다. /compact Focus on code samples and API usage처럼 뒤에 지침을 붙이면 무엇을 남길지 지정할 수 있어요.

  3. 프로젝트 루트의 CLAUDE.md 안에 아래처럼 압축 지침을 미리 적어 둘 수도 있습니다.

    # Compact instructions
    When you are using compact, please focus on test output and code changes
  4. CLAUDE.md는 세션 시작 때마다 통째로 로드되는 파일이라, 특정 워크플로만 쓰는 자세한 지침은 Skills로 옮기고 CLAUDE.md 자체는 200줄 이하로 유지하라고 공식 문서가 권합니다.

  5. /mcp를 실행하면 지금 연결된 MCP 서버 목록이 나옵니다. 안 쓰는 서버는 여기서 끄세요. gh, aws, gcloud 같은 CLI 도구를 직접 쓰게 하는 편이 MCP 서버를 붙이는 것보다 컨텍스트를 덜 먹는다고 안내돼 있습니다.

Cursor에서는 프로젝트 루트에 .cursorignore 파일을 만들어 관리합니다. .gitignore와 같은 문법이라 node_modules/나 빌드 결과물 같은 폴더를 한 줄씩 적으면 됩니다. .cursorignore에 적은 파일은 Agent·Tab·Inline Edit과 @ 멘션에서 아예 접근하지 못하고, 인덱싱만 빼고 싶다면 .cursorindexingignore를 따로 씁니다 — 이 파일에 적은 건 검색 결과에는 안 뜨지만 AI가 직접 열어 볼 수는 있어요. 다만 중첩된 폴더에서는 부모 폴더를 한 번 제외하면 !로 다시 포함시킬 수 없다는 점은 알아 두는 게 좋습니다.

GitHub Copilot은 대화 컨텍스트 자체를 줄이는 전용 메뉴를 공식 문서에서 확인하지 못했습니다. 코드 완성이 크레딧을 쓰지 않는 구조이다 보니, 컨텍스트 절약보다는 아래에 나오는 모델 선택 쪽이 실제 비용에 더 크게 관여하는 것 같아요.

작업 난이도에 맞는 모델 고르기

브러시드 메탈 다이얼 게이지

Claude Code 공식 문서에는 “Sonnet은 대부분의 코딩 작업을 잘 처리하며 Opus보다 비용이 적습니다. 복잡한 아키텍처 결정이나 다단계 추론을 위해 Opus를 예약하십시오”라고 적혀 있습니다.

Claude Code

  • 세션 중간에 모델을 바꾸려면 /model, 기본값을 아예 바꾸려면 /config를 씁니다.

  • 서브에이전트는 .claude/agents/ (프로젝트) 또는 ~/.claude/agents/ (전체) 안의 마크다운 파일에서 YAML 프론트매터로 정의하는데, 여기 model: haiku를 넣으면 그 서브에이전트만 저렴한 모델로 돌릴 수 있습니다.

    ---
    name: code-improver
    description: Scans files and suggests improvements for readability, performance, and best practices.
    tools: Read, Grep, Glob
    model: haiku
    ---
  • 복잡한 계획이 필요 없는 간단한 작업이면 /effort로 사고 노력 수준을 낮추거나, /config에서 확장 사고를 끄거나, 고정 사고 예산을 쓰는 모델에서는 환경 변수 MAX_THINKING_TOKENS(예: MAX_THINKING_TOKENS=8000)로 예산을 줄일 수 있습니다.

Cursor는 채팅 입력창 위쪽 모델 피커 드롭다운에서 모델을 고릅니다(단축키 Cmd/Ctrl + /로도 순환 전환됩니다). “Auto”를 켜면 Cursor Router가 Cost·Balance·Intelligence 세 모드 중 하나로 매 요청마다 모델을 골라 줍니다. 참고로 Max Mode(컨텍스트 윈도우를 확장하는 기능)는 공식 문서에 “레거시 요청 기반 요금제에서만 이용 가능”하다고 적혀 있어서, 새로 가입한 사용량제 요금제에서는 해당 옵션이 안 보일 수 있어요.

GitHub Copilot은 VS Code 채팅 패널 상단 모델 드롭다운에서 고르거나, 명령 팔레트(Cmd/Ctrl + Shift + P)에서 “GitHub Copilot: Change Completions Model”을 검색해 자동완성용 모델을 따로 바꿀 수 있습니다. 공식 요금 문서에는 “캐시된 입력 토큰이 90~95% 저렴하므로 재사용 컨텍스트를 극대화”하라는 안내와, 모델별 백만 토큰당 가격 차이 예시(경량 모델 0점대 달러 vs 고성능 모델 5달러 안팎, 2026년 8월 기준)가 나와 있습니다. 기존 연간 구독으로 남아 있는 일부 계정은 여전히 모델별 배수(경량 모델 0.33배 ~ 고성능 모델 57배)로 청구되는데, 이건 신규 가입자에게는 해당하지 않는 예전 방식이라는 점도 같이 적혀 있어요.

지출에 상한을 걸어 두기

어두운 책상 위 코인 더미 위에 놓인 작은 자물쇠

세 도구 모두 한도를 넘겨도 자동으로 멈추지 않는 게 기본값일 수 있어서, 미리 걸어 두는 편이 안전합니다.

  • Claude Code (Pro·Max): CLI에서 /usage-credits를 실행하면 대화 상자가 열리고, 여기서 월간 지출 한도를 설정·변경·제거할 수 있습니다. 한도 변경에는 계정의 청구 액세스 권한이 필요하다고 공식 문서에 적혀 있어요.
  • Cursor: cursor.com/dashboard 접속 → Spending 탭에서 월간 지출 한도를 설정합니다. 온디맨드 사용 자체를 꺼서 포함 사용량 소진 시 요청이 멈추게 할 수도 있어요. 이 한도를 보고 설정하려면 온디맨드 사용이 켜져 있어야 한다는 점이 문서에 명시돼 있습니다.
  • GitHub Copilot: github.com/settings/billing → Budgets and alerts → New budget을 누르고, 예산 유형에서 “Bundled AI credits budget”을 고르면 Copilot을 포함한 AI 크레딧 전체에 한도를 겁니다. 75%·90%·100% 지점에서 알림을 받을 수 있고, “Stop usage when budget limit is reached” 옵션을 켜면 한도 도달 시 사용을 아예 멈출 수 있습니다.

무료·기본 플랜에서 안 되는 것

  • Claude Code Pro·Max 구독자에게 /usage가 보여주는 세션 비용은 “로컬로 계산된 추정치”일 뿐 실제 청구와 무관합니다. 확장 사고를 끄는 기능은 일부 모델(Fable 5)에서는 아예 지원되지 않는다고 문서에 적혀 있어요.
  • Cursor의 Max Mode는 레거시 요청 기반 요금제 전용이라, 새로 가입해 사용량제로 시작한 계정에는 해당 옵션 자체가 없을 수 있습니다.
  • GitHub Copilot Free 플랜은 코드 완성(월 2,000회)과 제한된 채팅만 제공되고, 크레딧을 쓰는 채팅·에이전트·프리미엄 모델 사용은 크게 제한돼 있습니다. 조직 계정에서는 개인이 아니라 관리자가 예산을 걸어 둔 경우 사용자 쪽에서는 한도 조절 화면 자체가 안 보일 수 있어요.

이럴 땐 신경 쓰지 마라

구독형 요금제(Claude Pro·Max, Cursor Pro, Copilot Pro)로 개인 프로젝트만 가볍게 돌리면서 한 번도 한도에 걸려 본 적이 없다면, 위 설정을 하나하나 다 만지는 것보다 프롬프트를 구체적으로 쓰는 습관 하나가 더 효과적일 수 있습니다. Claude Code 공식 문서도 “이 코드베이스 개선”처럼 모호한 요청이 광범위한 스캔을 유발한다고 지적하고 있어요 — 애매한 지시가 세밀한 설정보다 토큰을 더 많이 잡아먹습니다.

✔ 요약

  • Claude Code: 작업 전환 시 /clear, 같은 작업 안에서는 /compact [지침]
  • Claude Code: CLAUDE.md 200줄 이하 유지, 안 쓰는 MCP 서버는 /mcp에서 끄기
  • Claude Code: 서브에이전트 파일에 model: haiku 지정, 간단한 작업은 /effort로 사고 노력 낮추기
  • Claude Code: 지출 한도는 /usage-credits (Pro·Max, 청구 권한 필요)
  • Cursor: 프로젝트 루트에 .cursorignore / .cursorindexingignore
  • Cursor: 채팅창 상단 모델 피커, Auto의 Cost/Balance/Intelligence 세 모드
  • Cursor: 지출 한도는 대시보드 → Spending 탭 (온디맨드 켜져 있어야 함)
  • GitHub Copilot: 코드 완성은 크레딧 안 씀, 채팅·에이전트만 크레딧 소비
  • GitHub Copilot: 지출 한도는 github.com/settings/billing → Budgets and alerts → New budget

2026년 8월 기준으로 확인했습니다. 요금제 가격과 포함 한도는 자주 바뀌니, 실제 설정 전에 아래 공식 문서에서 다시 확인해 보시는 걸 권합니다.

← 목록으로