← 에디토리얼

클로드 코드 실험 · 2026.11.17 · 7분

클로드 코드 Code Mode, 한도 진짜 아껴질까?

AItoZ 개발팀 · 2026.11.17 발행

클로드 코드 Code Mode, 한도 진짜 아껴질까? — 클로드 코드 실험

클로드 코드 code mode(Code Mode)를 켜면 클로드 코드 한도가 덜 닳는다는 말이 돌아서, 마크다운 60개에서 깨진 링크 찾기를 끈 채 · 켠 채로 두 번씩 시키고 Ctrl+O로 클로드가 쓴 코드를 열어 봤습니다. 켜는 법, 측정 표, 켤 일과 끌 일을 정리했습니다.

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

Ctrl+O로 펼친 Code Mode 실제 화면 — 클로드가 직접 쓴 자바스크립트

클로드 코드로 앱을 만들다 보면 한도에 자주 걸립니다. 그런데 2.1.323에 들어온 실험 기능 Code Mode를 켜면 한도가 더 오래 간다는 말이 돌더라고요. 공식 문서에는 그런 문장이 없어서, 같은 일을 끈 채로 두 번 · 켠 채로 두 번 시키고 세션 기록의 토큰 · 요청 횟수 · 걸린 시간을 나란히 놓아 봤습니다. 결론부터 말하면 이 일에서는 켠 쪽이 토큰을 약 16% 더 썼고, 시간은 12분씩 걸렸습니다.

Code Mode가 뭔가요?

클로드가 도구를 하나씩 부르는 대신, 자바스크립트를 써서 여러 도구 호출을 한 번에 돌리는 기능입니다. 원래 방식은 '파일 찾기 → 결과 읽기 → 파일 읽기 → 또 결과 읽기'처럼 도구를 부를 때마다 모델이 결과를 받아 다음 행동을 정합니다. Code Mode에서는 클로드가 이 과정을 코드 한 덩어리로 짜서 실행하고, 결과만 받아 봅니다.

끔과 켬의 차이 — 도구를 하나씩 부르기 vs 코드로 한 번에

공식 문서는 이 기능을 실험 기능 · 기본 꺼짐 · 언제든 바뀌거나 없어질 수 있음으로 적고 있습니다. 변경 기록을 보면 2.1.323에 추가됐고 2.1.325 · 2.1.326에서 고친 것이 여러 건 있습니다. 문서가 권하는 일은 여러 파일을 반복해서 고치는 일, 결과를 걸러 읽어야 하는 검색, 서로 상관없는 명령을 동시에 돌리는 일입니다.

어떻게 켜나요?

환경 변수 한 줄을 넣고 클로드를 실행하면 됩니다. 저는 이 PC가 2.1.322여서 먼저 일반 업데이트로 올렸습니다.

  1. 터미널에서 claude --version으로 버전을 봅니다. 2.1.323보다 낮으면 claude update.
  2. PowerShell에서 $env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"을 입력합니다(이 창에만 적용돼요).
  3. 같은 창에서 claude를 실행하고 "Yes, turn on Code Mode"를 고릅니다.
  4. 맨 위에 "Code Mode (experimental) is on" 줄이 보이면 켜진 겁니다.

켜졌을 때 맨 위에 뜨는 줄 — 이 세션은 Code Mode를 켠 채로만 이어 할 수 있다

켜지는 곳은 좁습니다. 터미널 대화형 세션에서만 되고, 데스크톱 앱 · 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개인데 하나하나 파일이 있는지 셸로 물어본 거예요.

켬 1회차 — 링크마다 Bash(test -e …)가 이어진다

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

켬 — 10분 제한에 걸린 뒤 다시 짠 코드로 마무리, 12분 15초

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

끔 — 스크립트 하나로 60개 검사, 24초

숫자로 보면 얼마나 달랐나요?

같은 요청 · 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번으로 늘면서 합계가 뒤집혔습니다.

각 2회 평균 — 요청 1번은 가볍지만 횟수가 늘었다

그럼 켜야 하나요, 꺼야 하나요?

저는 짧은 일엔 끄고, 도구를 길게 오가는 작업에만 켜 보려고 합니다. 이번처럼 스크립트 하나로 끝나는 일은 원래 방식도 이미 한 번에 처리해서 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개를 한 번에 고쳐 보겠습니다.

출처

다음 글클로드 코드 스킬, 크롬 팀이 만든 걸 깔았더니 옛날 코드가 빠졌다→