Claude 실무

Claude Code Code Mode, 켜기 전 확인할 조건

Claude Code Code Mode를 켜기 전에 버전·화면·계정 요건과 훅·자동 모드 제한을 확인하고, 같은 작업을 켜고 끄며 사용량을 비교해 보세요.

GROWBEAT Editorial
첫 공개
12분

이 사례, 나한테 해당될까요?

  • 지금 해 보기터미널에서 Claude Code로 여러 파일을 한꺼번에 읽고 고치는 사람v2.1.323 이상인지 확인하고 같은 작업을 켜고 끄며 돌려 /usage로 비교하기
  • 조건 확인 후훅·플러그인(mod)·자동 모드나 회사 관리 설정을 쓰는 사람시작 화면 맨 위 안내 줄과 /status로 켜졌는지, 훅이 도구 호출을 막지 않는지 먼저 보기
  • 기다려도 됨데스크톱 앱·VS Code 패널·폰 Remote Control로 Claude Code를 쓰는 사람지원 범위가 넓어지는지 변경 기록을 지켜보기

실험 기능이라 바뀌거나 없어질 수 있고, 공식 문서에 사용량 절감 수치는 없습니다(2026-11-17 확인).

읽는 대신, 내 AI에게 시켜 보세요

새 기능의 공식 요건과 내 사용 환경을 붙여 넣으면, 지금 켜도 되는지 요건별로 대조한 점검표와 켜고 끄며 비교할 시험 계획을 만들어 줍니다.

프롬프트 내용 펼쳐 보기
당신은 AI 코딩 도구의 새 기능을 켜기 전에 내 사용 환경과 공식 요건을 대조하는 점검 담당자입니다. 아래 두 칸에 붙여 넣은 자료만 근거로, 이 기능을 지금 켜도 되는지 점검표를 만들어 주세요.

규칙
- 자료에 없는 요건, 기능, 버전, 숫자는 지어내지 마세요. 모르면 "확인 필요"라고 적으세요.
- 버전 번호·시간·개수는 자료에 적힌 그대로 쓰세요. 같은 항목의 값이 자료끼리 다르면 하나로 고치지 말고 "불일치"로 표시하세요.
- 이미 지난 날짜나 오래된 안내로 보이는 내용은 그대로 따르지 말고 "다시 확인"으로 표시하세요.
- 공식 자료에 없는 효과 수치나 "무조건 절약된다" 같은 보장 문구는 결과에 쓰지 말고, 뺀 문구와 이유를 한 줄씩 알려 주세요.
- 설정 파일을 어떻게 고칠지는 대신 정하지 말고, 내가 확인할 항목으로만 적으세요.

출력 형식
1. 요건 대조표: 요건 / 공식 자료 내용 / 내 환경 / 판정(충족·불충족·확인 필요)
2. 켜면 쓸 수 없게 되는 기능 가운데 내가 쓰는 것
3. 시험해 볼 작업 1개와, 켰을 때와 껐을 때 비교할 항목
4. 불일치·다시 확인·뺀 문구 목록

공식 자료: [기능 안내 문서의 요건·제한 부분을 그대로 붙여 넣기]

내 환경: [도구 버전 / 쓰는 화면(터미널·데스크톱 앱·편집기) / 로그인 방식 / 켜 둔 플러그인·훅·권한 모드 / 회사 관리 설정 여부]
붙여 넣을 곳 ChatGPT · Claude · Gemini

API 키·토큰·회사 내부 주소 같은 비밀 값은 붙여 넣지 말고 도구 이름과 버전만 적으세요.

대표 이미지 — Claude Code 로고

Claude Code를 터미널에서 쓰며 사용량 한도가 빨리 차서 고민인 1인 개발자와 자동화 담당자를 위한 글입니다. "Code Mode를 켜면 한도가 덜 준다"는 이야기가 돌지만, 공식 문서에는 켜면 못 쓰게 되는 기능과 맞출 조건이 적지 않습니다.

이 글은 2026년 11월 16일(UTC) r/ClaudeCode 화제 글과 GitHub 이슈 보고를 공식 문서와 대조해, Code Mode가 하는 일과 쓸 수 있는 환경, 켜는 법, 사용량 재는 법을 정리합니다.

Claude Code Code Mode는 무엇이 달라지나요?

Code Mode는 Claude가 자바스크립트 코드를 써서 여러 도구 호출을 한 번에 실행하는 실험 기능입니다. 2026년 11월 12일 v2.1.323에 추가됐고 기본으로 꺼져 있습니다.

평소에는 도구를 한 번 쓸 때마다 결과를 확인하고 다음 단계로 넘어갑니다. 켜면 여러 명령을 동시에 돌리고 앞 결과를 다음 호출에 넘기는 일을 코드가 처리하고, Claude는 걸러진 결과만 받습니다.

화면에는 코드 대신 도구 호출만 보이고, Ctrl+O로 코드를 펼쳐 볼 수 있습니다. 공식 문서는 여러 파일의 반복 수정, 걸러 읽을 검색, 동시에 돌릴 명령 여러 개를 시험할 만한 작업으로 꼽습니다.

화제가 된 것은 2026년 11월 16일 20:53(UTC) r/ClaudeCode 글로, 작성자는 v2.1.325에서 켜 봤다며 큰 저장소 점검과 MCP 연결 작업에 유리하다고 적었습니다. 11월 17일 15:33(UTC) 점수 452, 댓글 109개는 관심도입니다.

Code Mode를 켜면 사용량이 정말 줄어드나요?

공식 Code Mode 문서에는 사용량이나 토큰을 얼마나 줄이는지에 대한 수치가 없습니다(2026-11-17 확인). 절감 폭은 사용자 측정으로만 확인됩니다.

그로우빗이 확인한 자료 중 방법과 결과를 밝힌 측정은 2026년 11월 16일 네이버 블로그 「AI 인턴 다해줘」(작성자가 AI라고 밝힘) 글 하나였습니다(GitHub 이슈 #110673의 37~60% 감소 언급은 출처 없음). 작성자는 터미널 v2.1.325에서 글 12편 표 정리와 유튜브 설명란 12개 수정을 켜고 끄며 모두 8번 돌렸다고 밝혔습니다. 사용량은 표 정리에서 47%, 설명란 수정에서 33% 줄었고 결과는 8번 모두 맞았다고 적었습니다.

작업 2종을 4번씩 잰 소규모 측정이며 그로우빗은 재실험하지 않았습니다. 작성자는 필요한 부분만 골라 읽어 줄었고, 잘못 고르면 내용을 놓칠 수 있다고 적었습니다.

내 작업으로 직접 재 보기

같은 저장소 사본에서 같은 지시를 끈 세션과 켠 세션에 한 번씩 주고, /usage 숫자와 결과의 정확도를 함께 적으세요.

내 환경에서 Code Mode를 쓸 수 있나요?

터미널에서 대화형으로 여는 claude 세션만 됩니다. 공식 문서는 -p 실행, Agent SDK, VS Code 패널, 데스크톱 앱, 클라우드 세션을 지원하지 않는 곳으로 적었습니다(2026-11-17 확인).

요건공식 문서 내용
버전v2.1.323 이상(stable 채널은 늦게 올라올 수 있음)
계정Claude 구독 또는 Console 계정(게이트웨이, Amazon Bedrock, Claude Platform on AWS, Google Cloud 경유, Microsoft Foundry로는 사용 불가)
모델Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable 5.2
설치·조직네이티브 빌드(Windows는 Git for Windows 필요), 조직이 HIPAA 구성·데이터 무보존을 쓰면 불가
함께 못 쓰는 것Remote Control, Claude in Chrome, 컴퓨터 사용(computer use)

켠 세션은 데스크톱 앱으로 옮길 수 없고 Code Mode를 켠 터미널에서만 다시 열립니다. apiKeyHelper나 DISABLE_TELEMETRY 같은 설정이 있으면 Code Mode 없이 시작됩니다.

11월 16일 GitHub 이슈에서도 한 사용자가 Windows 11의 v2.1.325 터미널에서는 켜졌지만 데스크톱 앱 Orca의 채팅 패널에서는 안 됐다고 적었습니다.

Code Mode는 어떻게 켜고 끄나요?

환경 변수 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE를 1로 두고 Claude Code를 시작한 뒤, 처음 뜨는 확인 창에서 켜기를 고르면 됩니다.

01claude --version으로 버전을 보고, v2.1.323보다 낮으면 claude update를 실행합니다.
02macOS·Linux에서는 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude로 시작합니다. 매번 켜려면 ~/.claude/settings.json의 env에 같은 값을 넣습니다.
03첫 확인 창에서 Yes, turn on Code Mode를 고르면 다시 시작되며 맨 위에 켜졌다는 줄이 보입니다.
04끌 때는 셸과 ~/.claude/settings.json 양쪽에서 변수를 지우거나, 한 곳을 0으로 바꾸고 새 세션을 엽니다.

남의 저장소를 받아도 그 안의 프로젝트 설정으로는 Code Mode를 켤 수 없습니다. 회사 관리자는 관리 설정(managed settings)에 0을 넣어 막을 수 있습니다. 켜지지 않으면 시작 안내 줄과 /status에 이유가 나옵니다.

켜기 전에 훅과 권한 설정은 무엇을 봐야 하나요?

자동 모드(auto mode)에서 검사 대상은 도구 호출 하나하나가 아니라 Claude가 쓴 코드이고, 코드가 돌면서 정해지는 파일 경로는 분류기 눈에 띄지 않습니다. 그래서 공식 문서는 꼭 막을 작업을 규칙이나 훅에 두라고 권합니다.

확인할 것공식 문서 내용
권한 규칙코드 안의 호출도 deny·ask 규칙과 PreToolUse 훅을 원래 도구 이름으로 거침
셸 명령 훅폴더 이동이 붙은 복합 명령으로 들어올 수 있어 각 부분을 검사해야 함
오래 걸리는 작업기다리는 코드는 권한 질문 시간까지 합쳐 10분에 멈춤(auto·bypassPermissions로 시작해야 백그라운드 실행이 가능하고 이때 최대 2시간)
훅 실패코드에서 나온 호출에 PreToolUse 훅이 시작되지 못하거나 시간 안에 끝나지 않으면 거부됨(command·http 훅에 onFailure를 continue로 설정하면 진행)

도구 호출을 검사하는 플러그인(mod)이 있어도 켜지지 않습니다. GitHub 이슈 #110347에는 결과를 읽기만 하는 mod도 막힌다는 보고와 v2.1.326 재현 댓글이 있습니다. 앞의 블로그 작성자도 위험 명령 차단 장치를 시험 창에서만 빼고 켰습니다. 안전장치를 빼야 켜진다면 그 위험부터 따져 보세요.

비용과 한국 사용 조건은 어떤가요?

Code Mode 문서에는 별도 요금 안내가 없습니다(2026-11-17 확인). Claude 구독 또는 Console 계정으로 쓰므로 기존 요금제 한도나 API 사용량에서 차감됩니다(계정 요건에서 한 추론).

공식 비용 문서에 따르면 /usage의 Session 토큰 값은 API 사용자용이고, Pro·Max 같은 구독자는 같은 화면의 요금제 사용량 막대로 봅니다. 모델을 나눠 쓰는 방법은 서브에이전트 비용 글에 있습니다.

공식 문서는 한국어판도 있고 한국 계정 제한 내용은 없었습니다. 다만 계정에 아직 열리지 않았다는 안내가 나올 수 있어 직접 켜 봐야 합니다. v2.1.325(11월 13일) 오류 수정과 v2.1.326(11월 16일) 에이전트 팀 지원이 이어졌으니 최신판에서 시험하세요. 2.1.326의 권한 변경은 업데이트 글에 있습니다.

처음이라면 무료 입문 강의부터 보세요.

참고 자료

태그
#Claude Code#Code Mode#클로드 코드 코드 모드#토큰 절약#실험 기능
무료 맞춤 보고서 받기