한국어 토큰 수 실측 — 공식 countTokens API 값과 문서의 4자 어림이 갈리는 자리
한국어 토큰 수 계산을 어림값 대신 공식 countTokens 엔드포인트로 직접 재 봤어요. 문서는 약 4자에 1토큰이라고 적지만 실측한 한국어는 2자 남짓에 1토큰이었고, 글자 수가 두 배 넘는 영어 문장이 오히려 토큰은 적게 나왔어요.
AI 기술을 누구나 쉽게 활용할 수 있도록 실전 가이드를 작성합니다. ChatGPT, Claude, AI 자동화, SEO 분야를 전문으로 다룹니다.
3월에 Cursor 2.x 쓰다가 3.0 업데이트 받고 나서 작업 흐름이 완전히 바뀌었어요. 가장 큰 변화는 Agents Window 추가. 같은 리팩터링 작업을 Claude Opus 4.8과 GPT-5.5에 동시에 던져서, 30분 후 둘 다 결과 보고 더 깔끔한 쪽만 머지하는 식이거든요.
결론부터 말하면 Agents Window의 값어치는 "모델을 여러 개 쓴다"가 아니라 git worktree 자동 분기에 있어요. 두 에이전트가 같은 파일을 수정해도 충돌이 안 나요. 각자 별도 브랜치(checkout)에서 돌거든요. 다만 크레딧은 띄운 에이전트 수만큼 배로 나가니까, 어떤 작업에 병렬을 쓰고 어떤 작업에 안 쓰느냐가 실제 비용을 가릅니다.
이 글은 직접 한 달 써본 뒤 정리한 7가지 실전 워크플로우예요. Pro $20·Pro+·Ultra $200 중 뭐가 본인한테 맞는지도 실제 크레딧 소모량 기준으로 정리했어요.

3.0 출시 노트에서 반드시 알아야 할 변화만 추렸어요.
기존 채팅창 옆에 Agents Window 패널이 새로 생겼어요. 여기서 에이전트 여러 개를 동시에 돌릴 수 있어요. 각 에이전트는 별도 git worktree에서 작동해서 파일 충돌 0%. 작업 끝나면 패널에서 diff 보고 하나만 main에 머지.
저는 보통 동시에 2~3개 돌려요. 에이전트마다 램을 따로 먹어서, 더 늘리면 램이 넉넉하지 않은 노트북에서는 눈에 띄게 버벅댔어요.
채팅 도중 /worktree feature-x 입력하면 나머지 대화가 별도 checkout에서 진행돼요. 메인 작업 하다가 "잠깐, 이건 다른 브랜치에서 실험해보자" 할 때 컨텍스트 안 잃어요. 끝나면 그 worktree만 PR 올리면 돼요.
/best-of-n 3 "이 함수를 더 효율적으로 리팩터링해줘" 입력하면 모델 3종이 같은 작업을 병렬로 처리. 결과 3개 비교 후 최선만 채택.
저는 테스트 코드 작성과 문서 생성에 주로 써요. 모델별 스타일 편차가 크거든요. Claude는 테스트 케이스가 꼼꼼하고, GPT는 문서가 자연스럽고, Gemini 3 Flash는 짧고 단순해요. 작업 성격 따라 채택하면 돼요.
2025년 중반에 요청 쿼터(request quota) 모델에서 크레딧 풀 모델로 전환됐어요. 한 달에 쓸 수 있는 토큰 양이 달러로 환산돼서 풀에 들어 있고, 모델별로 다르게 차감되는 구조.
| 플랜 | 가격 | 크레딧 풀 | 추천 대상 |
|---|---|---|---|
| Hobby | 무료 | 매우 제한 | 가입만, 실사용 X |
| Pro | $20/월 | $20어치 | 주 5~10시간 코딩, 1인 개발자 |
| Pro+ | $60/월 | $60어치 (3배) | 주 20시간+, 병렬 에이전트 자주 |
| Ultra | $200/월 | 거의 무제한 | 풀타임 + 대형 코드베이스 |
| Teams | $40/사용자 | 팀 공유 풀 | 5인 이상 스타트업 |
| Enterprise | 커스텀 | 협상 | 50인+, SSO·감사 로그 |
저는 Pro 일주일 쓰다 풀 다 떨어져서 Pro+로 옮겼어요. 병렬 에이전트가 크레딧 3배 빨리 쓰는 게 결정적이었어요. /best-of-n 5번 정도만 돌려도 Pro 풀 1/3이 사라져요.
복잡한 함수 하나를 리팩터링할 때 무조건 3 모델 병렬로 돌려요. 명령어:
/best-of-n 3 src/utils/parser.ts 의 parseInput 함수를 더 효율적이고 타입 안전하게 리팩터링.
사이드 이펙트 없이, 기존 테스트 모두 통과하도록.
결과가 도착하면 diff 보고 가장 깔끔한 거 선택. 체감: 모델을 하나씩 순서대로 돌려 비교할 때보다 확실히 빨라요. 크레딧: 띄운 에이전트 수만큼 더 나가요. 모델마다 토큰 단가가 달라서 정확히 몇 배인지는 그때그때 달라지고요.
Agents Window에서 에이전트 하나를 background mode로 돌려요. GitHub MCP 서버 연결하고 프롬프트:
오픈된 PR #234 을 검토. 코드 스타일·잠재적 버그·테스트 커버리지 체크 후
인라인 커멘트 작성. 변경 큰 이슈는 별도 issue 생성.
이렇게 하면 PR 코멘트가 자동으로 달려요. 손으로 하나씩 훑을 때보다 리뷰 회전이 확 빨라져요. 백그라운드 에이전트를 더 파고들고 싶으면 Cursor 멀티태스크·백그라운드 에이전트 7가지 활용 패턴에 실행 중 관리법이 더 자세히 있어요.
테스트 케이스는 GPT-5.5 한 모델만 쓰는 게 효율 좋아요. Claude·DeepSeek 결과가 너무 비슷해서 /best-of-n 의미 없음. 대신 단일 모델로 컨텍스트 길게 쓰는 게 더 좋음.
@codebase 의 src/services/auth/ 모듈 전체 분석 후
Vitest 단위 테스트 작성. 커버리지 90% 목표.
모든 edge case 포함, mock는 vi.mock 사용.
API 문서·README·주석 보강은 Claude Opus 4.8 이 잘해요. 한국어 문체가 자연스럽고 기술 용어도 정확하게 잡아요.
저는 OpenAPI 스펙 → 한국어 README 변환에 자주 써요. 1500자 분량을 30초에 뽑아내고, 거의 손 안 대요.
전체 모놀리스 리뷰는 Gemini 3.1 Pro 가 편해요. 컨텍스트 창이 넉넉한 축이라 파일을 한 번에 여러 개 밀어 넣어도 잘 안 잘려요.
@codebase 전체 분석. 다음 관점에서 개선 제안 5개:
1. 성능 병목 의심 지점 2. 타입 안전성 약한 부분
3. 테스트 미커버 비즈니스 로직 4. 보안 위험 5. 데드 코드
크레딧 많이 먹지만(한 번에 ~$2~3), 분기에 1번 돌리면 큰 그림 잡혀요.
한참 작업하다가 "이거 다른 라이브러리로 바꿔보면 어떨까" 싶을 때 /worktree experiment-zod-to-valibot 입력. 그 시점부터 새 worktree에서 대화 진행. 메인 작업 컨텍스트 그대로 유지되고, 실험 끝나면 PR 만들거나 버리거나.
이거 하나만으로 작업 흐름 분리가 매우 깨끗해요.
처음에 욕심내서 MCP 서버 12개 등록했다가 도구 60개 넘어서 끊겼어요. 지금은 코어 5개만:
합계 29 tools, 11 여유. 프로젝트별로 더 필요하면 .cursor/mcp.json 에 추가.

같은 작업을 어느 모델에 던지냐에 따라 크레딧 소모가 크게 차이나요.
| 모델 | 크레딧 소모 | 컨텍스트 | 추천 작업 |
|---|---|---|---|
| Claude Opus 4.8 | 높음 | 넉넉함 | 문서·복잡 리팩터링·아키텍처 |
| Claude Sonnet 4.6 | 보통 | 넉넉함 | 일상 코딩·리뷰 |
| Gemini 3.1 Pro | 보통 | 매우 넉넉함 | 코드베이스 전체 분석 |
| Gemini 3 Flash | 낮음 | 넉넉함 | 단순 변환·반복 작업 |
표의 크레딧 소모는 네 모델을 서로 견준 상대적 위치예요. 세대가 바뀌면서 플래그십 단가가 예전만큼 부담스럽지 않아진 구간도 있으니, "플래그십은 무조건 비싸다"는 인상만으로 피하고 있었다면 각 모델의 공식 가격 페이지에서 다시 계산해보세요. 컨텍스트를 길게 넣는 요청은 구간에 따라 단가가 달라지는 경우도 있어서, 예산을 잡을 때 그 부분까지 함께 확인하면 계산이 정확해져요.
팁: 단순 변수명 변경·import 정리 같은 자잘한 일은 Gemini 3 Flash 로 충분해요. 크레딧이 10분의 1이에요. 모델 단가는 자주 바뀌니 결제 전 각 공식 가격 페이지에서 최신 확인하세요. 다른 IDE 대안이 궁금하면 Cursor Composer 2.5 vs Windsurf SWE-1.5 가격·속도 7가지 테스트를 함께 보면 비교가 빨라요.
.cursor/rules/01-model-selection.md 에 작성:
- 단순 변환/import 정리: gemini-3-flash 사용
- 테스트 코드: gpt-5.5 사용
- 문서·복잡 리팩터링: claude-opus-4-8 사용
- 코드베이스 전체 분석: gemini-3.1-pro 사용
이렇게 두면 Cursor가 작업 성격 보고 자동으로 모델 추천. 풀 자동은 안 되고 모델명 클릭 한 번으로 바뀜.
긴 채팅 30분 넘으면 컨텍스트가 무거워서 토큰 단가 올라요. /summarize 한 번 돌리면 핵심만 요약, 그 시점부터 새 대화 흐름. 인풋 토큰이 눈에 띄게 줄어요.
@codebase 호출하면 전체 인덱스 로드해서 토큰 폭증. 특정 파일만 필요하면 @file:src/utils/parser.ts 명시.
Agents Window 의 background mode 토글 켜면 실시간 응답 안 받고 백그라운드 처리. 즉시 응답을 포기하는 대신 크레딧 부담이 줄어드는 구조예요. 단 결과를 받기까지 한참 기다려야 해요. 할인 여부와 폭은 요금 정책에 따라 달라지니 공식 안내에서 확인하세요.
매번 /best-of-n 3 돌리면 크레딧 3배 빨리 사라져요. 리팩터링·아키텍처 결정 같이 한 번 정하면 영향 큰 작업에만 사용. 자잘한 건 단일 모델.
병렬 에이전트 신기해서 매일 /best-of-n 5번씩 돌렸더니 5일째 풀 0. 처음 한 달은 Pro+ $60 으로 시작 권장.
도구 갯수 안 세고 다 켜놨더니 "Tools exceed 40 limit" 에러. 코어 5개로 줄임.
실험적인 변경을 메인 채팅에서 하다가 컨텍스트 더러워짐. /worktree 로 분리했어야.
Gemini 3 Flash 는 단가가 압도적으로 싸지만, 복잡한 리팩터링은 Opus 4.8·GPT-5.5 가 훨씬 나아요. 작업 성격 안 보고 모든 모델에 다 던지는 건 낭비예요.
긴 작업(전체 코드베이스 분석 등)은 background mode 로 돌려야 크레딧이 덜 나가요. 실시간 응답이 그렇게 중요하지 않으면 무조건 background.
이 글을 처음 쓴 건 5월 초인데, 그 뒤 Cursor 3.5 가 나오면서 병렬 흐름이 한 번 더 바뀌었어요. 핵심은 Cloud Agents 예요.
3.0 의 병렬 에이전트는 내 노트북 자원을 나눠 썼어요. 그래서 위에서 "2~3개까지"라고 적은 거예요. 에이전트마다 램을 따로 잡아먹으니까요. 3.5 의 Cloud Agents 는 격리된 클라우드 VM 에서 돌아요. 터미널·브라우저까지 붙은 완전한 환경이라, 내 RAM 과 무관하게 여러 개를 띄울 수 있어요.
실제로 달라지는 지점은 세 가지예요.
| 항목 | 3.0 로컬 에이전트 | 3.5 Cloud Agents |
|---|---|---|
| 동시 실행 | RAM 한계로 2~3개 | 훨씬 여유 있음 |
| 내 PC 부하 | 에이전트당 램 점유 큼 | 거의 없음 |
| 노트북 닫으면 | 중단 | 계속 진행 |
| 적합한 작업 | 빠른 반복·디버깅 | 긴 리팩터링·전체 테스트 |
저는 지금 긴 작업은 Cloud, 짧은 반복은 로컬로 나눠 써요. 전체 테스트 스위트 고치기 같은 30분짜리는 Cloud 에 던져놓고 노트북 덮고 나가요. 반대로 5분 안에 결과 보고 바로 다시 지시할 작업은 로컬이 왕복이 빨라요.
주의: Cloud Agents 는 Pro($20) 플랜에도 포함돼요. 다만 크레딧은 똑같이 나가요. "클라우드니까 공짜"가 아니라 내 RAM 만 아끼는 것이라고 이해하시면 정확해요.
아래 5개 중 몇 개에 해당하는지 세보세요.
저는 3번·4번이 걸려서 Pro+ 에 정착했어요. 플랜 구성과 가격은 바뀌니 결제 전 Cursor 공식 가격 페이지에서 최신 확인하세요.
Agents Window 의 값어치는 "AI 가 코드를 대신 짜준다"가 아니에요. 같은 문제에 대한 서로 다른 답을 나란히 놓고 내가 고르는 것이에요. 이 차이가 중요한 이유는, 모델 하나만 쓰면 그 모델이 틀렸을 때 틀린 줄 모르고 머지하기 때문이에요.
지금 IDE 고민 중이라면 Pro+ 한 달만 써보고 결정하세요. 첫 달은 풀을 다 못 써도, 두 번째 달부터 병렬 흐름이 익숙해지며 제 값을 해요.
AI 코딩 도구 자체가 처음이라면: AI 코딩 에이전트 순위 2026 — Claude Code·Cursor·Codex 실사용 비교로 전체 판을 먼저 훑고 오는 게 나아요. 도구별 성격을 알고 나면 Cursor 의 슬래시 명령어 체계가 훨씬 빨리 붙어요.
Composer는 한 번에 한 작업을 한 모델에게 시키는 구조였는데, Agents Window는 같은 작업을 여러 에이전트가 병렬로 git worktree 위에서 돌리는 구조예요. 예를 들어 리팩터링 하나를 Claude Opus 4.8·GPT-5.5·Gemini 3 Flash 세 모델에 동시에 던지고, 가장 깔끔한 결과만 PR로 머지할 수 있어요. 여러 개를 동시에 띄울 수 있어서, 순서대로 돌릴 때보다 대기 시간이 줄어요. 단 크레딧은 띄운 수만큼 배로 나가요.
Pro에서 기본 기능은 다 쓸 수 있어요. 다만 Pro는 크레딧 풀 $20어치라 병렬 에이전트 몇 번 돌리면 금방 소진. 헤비 유저는 Pro+ $60(3배 풀) 또는 Ultra $200을 써야 해요. 저는 처음에 Pro 쓰다 일주일 만에 풀 다 쓰고 Pro+로 옮겼어요.
/best-of-n 3 prompt 형태로 입력하면 같은 프롬프트를 모델 여러 개에 동시 실행해요. 몇 개까지 걸 수 있는지는 버전에 따라 달라지니 공식 문서에서 확인하세요. 각 결과는 별도 worktree(브랜치)에 저장되고, 사이드바에서 diff 비교 후 채택할 결과 하나만 main에 머지. 코드 품질이 모델별로 편차 큰 작업(테스트 작성·문서 생성)에 효과적이에요.
Cursor는 VSCode fork라 단축키 99% 호환돼요. Cmd+P, Cmd+Shift+P, 멀티 커서, 익스텐션까지 그대로. 단 Agents Window 호출은 신규 단축키 Cmd+Shift+A. /worktree·/best-of-n 같은 슬래시 명령어는 채팅 입력창에서 / 누르면 자동완성 떠요.
기본 MCP 서버 5~6개(Filesystem·Git·Brave Search·Memory 등) 쓰면 도구가 25~30개 정도라 여유 있어요. 다만 Slack·Linear·Notion·Postgres 풀 세팅하면 50개 넘어가서 끊겨요. 해결법 ① 자주 쓰는 도구만 enabled: true 명시 ② cursor.mcp.json에 server별로 토글 ③ 프로젝트별 .cursor/mcp.json 분리. 40 ceiling은 단일 컨텍스트 안에서 한 번에 노출되는 도구 수 제한.