2026년 11월 17일 직접 측정 · Claude Code 2.1.326 · Sonnet 5.5 · 윈도우 PC 1대 · 같은 일을 끔 2회 · 켬 2회 · 공식 문서(code.claude.com/docs/en/code-mode)와 변경 기록은 같은 날 확인

클로드 코드로 앱을 만들다 보면 한도에 자주 걸립니다. 그런데 2.1.323에 들어온 실험 기능 Code Mode를 켜면 한도가 더 오래 간다는 말이 돌더라고요. 공식 문서에는 그런 문장이 없어서, 같은 일을 끈 채로 두 번 · 켠 채로 두 번 시키고 세션 기록의 토큰 · 요청 횟수 · 걸린 시간을 나란히 놓아 봤습니다. 결론부터 말하면 이 일에서는 켠 쪽이 토큰을 약 16% 더 썼고, 시간은 12분씩 걸렸습니다.
Code Mode가 뭔가요?
클로드가 도구를 하나씩 부르는 대신, 자바스크립트를 써서 여러 도구 호출을 한 번에 돌리는 기능입니다. 원래 방식은 '파일 찾기 → 결과 읽기 → 파일 읽기 → 또 결과 읽기'처럼 도구를 부를 때마다 모델이 결과를 받아 다음 행동을 정합니다. Code Mode에서는 클로드가 이 과정을 코드 한 덩어리로 짜서 실행하고, 결과만 받아 봅니다.

공식 문서는 이 기능을 실험 기능 · 기본 꺼짐 · 언제든 바뀌거나 없어질 수 있음으로 적고 있습니다. 변경 기록을 보면 2.1.323에 추가됐고 2.1.325 · 2.1.326에서 고친 것이 여러 건 있습니다. 문서가 권하는 일은 여러 파일을 반복해서 고치는 일, 결과를 걸러 읽어야 하는 검색, 서로 상관없는 명령을 동시에 돌리는 일입니다.
어떻게 켜나요?
환경 변수 한 줄을 넣고 클로드를 실행하면 됩니다. 저는 이 PC가 2.1.322여서 먼저 일반 업데이트로 올렸습니다.
- 터미널에서
claude --version으로 버전을 봅니다. 2.1.323보다 낮으면claude update. - PowerShell에서
$env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"을 입력합니다(이 창에만 적용돼요). - 같은 창에서
claude를 실행하고 "Yes, turn on Code Mode"를 고릅니다. - 맨 위에 "Code Mode (experimental) is on" 줄이 보이면 켜진 겁니다.

켜지는 곳은 좁습니다. 터미널 대화형 세션에서만 되고, 데스크톱 앱 · VS Code 패널 · 클라우드 세션 · claude -p에서는 안 됩니다. 모델은 Opus 5.5 · Sonnet 5.5 · Haiku 5.5 · Fable 5.2이고, Remote Control · Claude in Chrome · computer use는 함께 못 씁니다. 켠 채로 시작한 세션은 Code Mode를 켠 터미널에서만 이어 할 수 있다는 점도 기억해 두세요.

무엇을 어떻게 재 봤나요?
공식 문서에 예시로 나온 요청을 그대로 썼습니다. 저장소 밖 임시 폴더에 마크다운 60개(README 1 + 문서 59)를 만들고, 일부러 없는 파일을 가리키는 링크 8개를 섞어 뒀습니다. 그리고 "이 프로젝트의 마크다운 파일을 전부 읽고, 없는 로컬 파일을 가리키는 링크를 목록으로 정리해 줘"를 같은 모델(Sonnet 5.5)로 끈 채 2번, 켠 채 2번 보냈습니다.
- 환경 변수는 그 터미널에만 줬고,
~/.claude/settings.json은 건드리지 않았습니다. - 토큰은 세션마다 남는 대화 기록 파일(jsonl)의 usage 합(입력 · 캐시 쓰기 · 캐시 읽기 · 출력)입니다.
- 걸린 시간은 화면 맨 아래 'Baked for 24s'처럼 클로드 코드가 보여 준 시간입니다.
네 번 모두 깨진 링크 8개를 정확히 찾았습니다. 차이는 찾아가는 길에서 났습니다.
켰더니 속에서 무슨 일이 있었나요?
Ctrl+O로 펼쳐 보니, 클로드가 쓴 코드가 링크마다 셸 명령(test -e)을 하나씩 돌리고 있었습니다. 전체 링크가 373개인데 하나하나 파일이 있는지 셸로 물어본 거예요.

그러다 두 번 다 "Stopped at the 10m limit before a shell call finished" — 코드 한 번 실행에 걸린 10분 제한에 걸렸습니다. 그 뒤에야 클로드가 "파일 목록을 한 번만 가져와 자바스크립트에서 비교하는 방식으로 바꿔 다시 진행합니다"라며 코드를 고쳤고, 결과는 맞게 나왔습니다. 걸린 시간은 12분 15초와 11분 56초였습니다.

끈 쪽은 오히려 단순했습니다. 클로드가 파일을 찾은 뒤 PowerShell 스크립트 하나로 60개를 한 번에 읽고 링크를 검사했어요. 도구 호출은 2번, 걸린 시간은 24초와 1분 36초였습니다.

숫자로 보면 얼마나 달랐나요?
| 같은 요청 · Sonnet 5.5 | 끔 1회 | 끔 2회 | 켬 1회 | 켬 2회 |
|---|---|---|---|---|
| 걸린 시간(화면 표시) | 24초 | 1분 36초 | 12분 15초 | 11분 56초 |
| 모델 요청 횟수 | 3번 | 3번 | 7번 | 7번 |
| 토큰 합계(usage 합) | 177,939 | 167,873 | 201,593 | 199,365 |
| 그중 출력 토큰 | 1,858 | 1,605 | 2,900 | 2,570 |
| 깨진 링크 찾은 수 | 8 | 8 | 8 | 8 |
평균을 내면 끔 17.3만 토큰, 켬 20.0만 토큰으로 켠 쪽이 약 16% 많았습니다. 흥미로운 건 요청 한 번에 실리는 입력량입니다. 켠 쪽이 평균 2.8만 토큰으로 끈 쪽 5.7만의 절반이었어요. 요청 한 번은 가벼워졌지만, 10분 제한에 걸려 다시 짜느라 요청 횟수가 3번에서 7번으로 늘면서 합계가 뒤집혔습니다.

그럼 켜야 하나요, 꺼야 하나요?
저는 짧은 일엔 끄고, 도구를 길게 오가는 작업에만 켜 보려고 합니다. 이번처럼 스크립트 하나로 끝나는 일은 원래 방식도 이미 한 번에 처리해서 Code Mode가 얹을 이득이 적었고, 코드가 셸을 많이 부르면 10분 제한이라는 새 벽이 생겼습니다. 반대로 요청 한 번의 입력량은 절반이었으니, 문서가 권하는 '여러 파일 반복 수정'처럼 오가는 횟수가 많은 일에서는 다를 수 있습니다.
주의할 점도 적어 둡니다.
- 한 PC · 한 가지 일 · 각 2번 잰 값입니다. 다른 일 · 다른 환경(맥 등)에서는 결과가 다를 수 있습니다.
- 토큰은 세션 기록의 usage 합이고, 실제 한도에서 깎이는 방식과 같지 않을 수 있습니다(캐시 읽기 비중이 큽니다).
- 공식 문서와 변경 기록에는 "한도가 더 오래 간다"는 문장이 없습니다(11월 17일 확인).
- 실험 기능이라 동작이 바뀌거나 없어질 수 있습니다. 켜 볼 때는 버전과 맨 위 줄을 먼저 확인하세요.
한 번에 정리
- Code Mode는 클로드가 자바스크립트로 여러 도구 호출을 한 번에 돌리는 실험 기능(2.1.323~, 기본 꺼짐)입니다.
- 켜기: PowerShell
$env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"→claude, 터미널 대화형 세션에서만 됩니다. - 깨진 링크 찾기에서는 켠 쪽이 토큰 약 16% 더, 시간 12분(10분 제한 2번)이었습니다.
- 요청 한 번의 입력량은 켠 쪽이 절반 — 오가는 횟수가 많은 긴 작업에서 다시 재 볼 만합니다.
다음 편에서는 이걸 켠 채로 파일 100개를 한 번에 고쳐 보겠습니다.
출처
- Claude Code Code Mode 공식 문서: https://code.claude.com/docs/en/code-mode (2026.11.17 확인)
- Claude Code 변경 기록(2.1.323 추가, 2.1.325 · 2.1.326 수정): https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md
- 측정: 제 윈도우 PC, Claude Code 2.1.326, Sonnet 5.5, 2026.11.17 — 화면은 모두 이 PC의 실제 화면입니다.
- 영상: AItoZ 쇼츠 '클로드 코드 Code Mode, 한도 진짜 아껴질까?'
