YouTube메이커 에반·2026년 11월 19일·0

클로드 코드 쓰시는 분, 도구 호출이 코드로 바뀐 거 아세요? 코드 모드 총정리

Quick Summary

Claude Code의 실험 기능인 Code Mode를 켜면 Claude가 여러 도구 호출을 JavaScript로 묶고, 세션에서 실행한 뒤 다음 판단에 필요한 결과만 읽는다.

영상 보기

클릭 전까지는 가벼운 미리보기만 먼저 불러옵니다.

원본 열기

🖼️ 인포그래픽

클로드 코드 쓰시는 분, 도구 호출이 코드로 바뀐 거 아세요? 코드 모드 총정리 내용을 설명하는 본문 이미지

🖼️ 4컷 인포그래픽

클로드 코드 쓰시는 분, 도구 호출이 코드로 바뀐 거 아세요? 코드 모드 총정리의 핵심 내용을 4단계로 요약한 인포그래픽
클로드 코드 쓰시는 분, 도구 호출이 코드로 바뀐 거 아세요? 코드 모드 총정리 핵심 내용을 4단계로 압축한 4컷 인포그래픽

💡 한 줄 결론

Claude Code의 실험 기능인 Code Mode를 켜면 Claude가 여러 도구 호출을 JavaScript로 묶고, 세션에서 실행한 뒤 다음 판단에 필요한 결과만 읽는다.

📌 핵심 요점

  1. 기존 방식에서는 도구를 한 번 쓸 때마다 Claude가 결과를 읽고 다음 행동을 정한다. Code Mode에서는 스크립트가 앞선 결과를 다음 도구에 넘기고, 독립적인 작업은 동시에 실행할 수 있다.
  2. 문서의 재시도 정책 수정 예시에서는 파일 검색부터 수정과 테스트까지 네 차례의 왕복을 코드 한 조각으로 묶는다. Claude는 수정된 파일 경로와 테스트 결과를 받아 실패 여부까지 판단할 수 있다.
  3. 여러 파일에 같은 변경을 적용하거나 긴 검색 결과에서 필요한 항목만 추릴 때 이점이 크다는 설명이다. 파일 하나를 짧게 고치는 작업에서는 체감 차이가 작을 수 있다.
  4. 영상이 인용한 문서상 최소 버전은 2.1.323이며, 지원 모델과 계정으로 네이티브 빌드의 대화형 터미널 세션을 사용해야 한다. 대기 실행은 권한 확인 시간을 포함해 10분까지이고, 조건을 충족한 백그라운드 실행은 최대 2시간 동안 대화와 병행할 수 있다.
  5. 대화창에는 도구 호출과 수정 내역이 표시되고, 작성된 JavaScript는 트랜스크립트에서 확인할 수 있다. 개별 호출에는 권한 규칙이 적용되지만, 자동 분류기가 실행 전에 검토할 수 있는 정보에는 한계가 있다.

🧩 배경과 문제 정의

Claude Code가 파일을 찾고 읽고 수정할 때마다 모델이 중간 결과를 검토하면, 비슷한 변경도 파일 수에 따라 왕복이 늘어난다. 검색 결과 수백 줄 중 몇 줄만 필요해도 전체 출력이 컨텍스트에 들어갈 수 있다. 영상은 공식 개발자 계정이 소개한 Code Mode와 관련 문서를 바탕으로, 이 반복 작업을 코드에 맡기면 무엇이 달라지고 어디까지 사용할 수 있는지 설명한다.

🕒 시간순 섹션별 상세정리

1. 도구를 부를 때마다 쌓이는 왕복

  • 공식 개발자 계정은 Claude가 도구를 엮는 스크립트를 작성하고, 긴 명령이 실행되는 동안에도 대화를 이어갈 수 있는 실험 기능을 소개했다. [00:14]
  • 기존 방식에서 파일 50개에 비슷한 수정을 적용하면 모델의 판단도 수십 번으로 늘어난다. 긴 검색 결과까지 매번 읽으면 작업 시간과 컨텍스트 사용량이 함께 커진다. [01:19]

2. JavaScript가 묶는 작업과 모델이 읽는 결과

  • Claude Code는 Claude가 작성한 JavaScript를 세션 안에서 실행한다. 스크립트는 독립 명령을 병렬로 실행하고, 앞선 결과를 다음 호출로 넘기며, 모델에 돌려줄 출력도 고른다. [01:50]
  • 재시도 정책 수정 예시에서는 파일을 찾아 값을 고치고 테스트한 뒤 파일 경로와 테스트 결과만 돌려준다. 테스트가 실패해도 Claude가 그 결과를 읽고 다음 행동을 정한다. [02:33]
  • 도구 호출과 수정 내역은 대화창에서, 작성된 코드는 트랜스크립트에서 볼 수 있다. 문서는 여러 파일의 반복 수정, 검색 결과 필터링, 독립적인 검사 병행을 적합한 작업으로 꼽는다. [03:57]

3. 활성화 범위와 긴 작업의 실행 시간

  • 영상이 인용한 최소 버전은 2.1.323이다. 사용자가 환경변수로 기능을 켤 수 있으며, 저장소가 임의로 활성화하는 일을 막기 위해 프로젝트 설정의 해당 값은 무시한다. [04:32]
  • 비활성화 값이 우선하므로 관리자는 조직에서 사용을 막을 수 있다. 관리 설정으로 모든 사용자에게 활성화를 강제할 수는 없다. [05:00]
  • 대기 실행의 10분 한도에는 권한 확인 시간도 포함된다. 백그라운드 실행은 최대 2시간이며, 긴 작업을 맡기면서 대화를 이어가려면 세션 시작 조건을 충족해야 한다. [05:57]

4. 권한 검사와 지원 환경의 제약

  • 코드 안의 도구 호출에도 개별 거부·확인 규칙과 훅이 적용된다. 자동 분류기는 실행 전 코드만 볼 수 있어, 문서는 반드시 차단해야 하는 동작에 별도의 규칙이나 훅을 두도록 안내한다. [06:33]
  • 지원 모델과 계정이 제한되며 네이티브 빌드의 대화형 터미널 세션이 필요하다. 데스크톱 앱과 VS Code 패널 등은 지원 대상에서 빠지고, 세션을 재개할 때도 터미널에서 Code Mode를 켜야 한다. [07:58]
  • 실행이 겹치면 남은 호출에 대해 사용자 확인을 다시 요구할 수 있다. 확인 시간이 지나거나 훅이 실패하면 해당 호출은 거부된다. [09:02]

5. 문서의 설명과 직접 측정할 효과

  • 발표자는 자신의 버전이 2.1.312여서 Code Mode를 직접 켜보지 못했으며, 영상 전체가 공식 문서에 근거한다고 밝혔다. [09:19]
  • 모델 호출과 토큰 사용이 줄어들 가능성은 있지만 공식 절감 수치는 제시되지 않았다. 발표자는 같은 작업을 두 세션에서 실행해 시간과 사용량을 비교하자고 제안했다. [09:58]
  • 마무리에서는 지원 환경을 다시 짚고 익숙한 프로젝트에서 먼저 사용해 보기를 권했다. 시청자에게는 실제로 어떤 작업에서 차이를 느꼈는지 물었다. [10:48]

🧾 결론

  • Code Mode가 줄이려는 것은 도구를 쓸 때마다 모델의 다음 판단을 기다리는 시간이다. 반복과 필터링을 코드에 맡기면 Claude는 추려진 결과를 토대로 다음 결정을 내릴 수 있다.
  • 긴 빌드나 테스트를 기다리는 동안 대화를 이어갈 수 있다는 점은 실행 속도와 별개의 이점이다. 이 기능의 사용 가능 여부는 세션을 시작할 때의 조건에 달려 있다.
  • 발표자는 설치 버전이 2.1.312여서 기능을 직접 실행하지 못했다고 밝혔다. 영상은 공식 문서를 해설한 것이며, 시간과 사용량이 실제로 얼마나 줄어드는지는 측정 과제로 남는다.

📈 투자·시사 포인트

  • 개발 도구의 생산성을 평가할 때는 전체 소요 시간과 함께 모델이 중간 결과를 몇 번 읽는지, 컨텍스트에 얼마만큼의 출력이 들어가는지도 살펴볼 만하다.
  • 팀의 작업 구성에 따라 도입 가치가 달라진다. 여러 파일을 반복 수정하거나 린트·타입 검사·테스트를 병행하는 팀이라면 자주 수행하는 작업을 기준으로 효과를 측정할 수 있다.
  • 조직 차원의 도입에는 실행 환경과 검토 비용도 영향을 준다. 팀이 쓰는 편집기와 계정이 지원되는지, 변경 과정을 확인하기 위해 트랜스크립트를 얼마나 자주 열어야 하는지가 판단 기준이다.

⚠️ 불확실하거나 확인이 필요한 부분

  • 발표자는 직접 사용한 경험이나 벤치마크를 제시하지 않았다. 모델 호출 수와 읽는 토큰이 줄어들 것이라는 설명은 발표자의 해석이며, 영상에서 인용한 공식 절감 수치는 없다.
  • 영상이 인용한 문서에서 Code Mode는 기본값이 꺼진 실험 기능이다. 지원 모델, 최소 버전, 세션 제약은 릴리스에 따라 바뀔 수 있다.
  • 자동 분류기는 실행 전에 코드 단위로 판단하므로 실행 중 정해지는 값을 모두 검토할 수 없다. 실행이 겹쳐 사용자 확인을 다시 요구하거나 훅이 실패해 호출이 거부되는 경우도 문서에 나온다.
  • 자막 기반 정리: 타임스탬프가 있는 자막을 기준으로 정리했으며, 고유명사·수치·인용은 원문 확인 필요 시 별도 검증한다.
  • 영상 속 주장: 발표자의 해석·전망·비교는 확인된 외부 사실이 아니라 영상 속 주장으로 분리해 읽는다.
  • 검증 필요: 수치, 기업 실적, 정책·시장 전망은 발행 전 최신 자료로 별도 검증이 필요하다.

✅ 액션 아이템

  • 설치 버전과 모델·계정·터미널 지원 여부를 확인한다. 시작이 막히면 세션 상단에 표시된 이유를 해당 버전의 문서와 대조한다.
  • 익숙한 프로젝트에서 같은 초기 상태와 같은 작업을 준비해 Code Mode를 켠 세션과 끈 세션의 소요 시간, 사용량, 테스트 결과를 비교한다.
  • 대화창의 수정 내역과 트랜스크립트의 JavaScript를 함께 읽고, 의도한 파일이 바뀌었는지와 테스트 실패가 결과에 드러나는지 확인한다.
  • 팀에서 반드시 차단해야 하는 동작은 기존 권한 규칙과 훅이 개별 도구 호출에서도 의도대로 처리하는지 점검한다.

❓ 열린 질문

  • 실제 프로젝트에서는 반복 수정, 검색 결과 필터링, 독립 검사 병렬 실행 중 어느 작업에서 시간과 사용량 차이가 가장 큰가?
  • 백그라운드 실행 중 대화를 이어가며 아낀 시간과, 실행 기록을 열어 변경 순서를 확인하는 데 드는 시간은 각각 어느 정도인가?

관련 문서

공통 태그와 주제 흐름을 기준으로 같이 보면 좋은 문서를 이어서 제안합니다.