ToolNavs 유용한 AI 도구 찾기
도구 제출 로그인
돌아가기 AI Q&A
Claude Code Code Mode 사용법은? 환경 변수 한 줄로 켜고, 모델이 스크립트로 도구를 일괄 호출합니다

Claude Code Code Mode 사용법은? 환경 변수 한 줄로 켜고, 모델이 스크립트로 도구를 일괄 호출합니다

AI Q&A • Admin • • 10 회 조회

Claude Code의 Code Mode를 쓰면 모델이 말을 줄이고 일을 더 많이 합니다. Bash, Read, Edit를 하나씩 부르는 대신 JavaScript를 써서 여러 도구를 한 번에 호출합니다. 2026년 11월 12일 Claude Code v2.1.323과 함께 나왔고, 11월 17일 Claude Devs 공식 계정이 소개했습니다. 실험 기능으로 기본값은 꺼져 있으며 언제든 바뀌거나 사라질 수 있습니다.

Code Mode가 실제로 바꾸는 것

지금까지 Claude는 도구를 호출할 때마다 결과를 읽고 다음 단계를 정했습니다. Code Mode를 켜면 JavaScript를 써서 도구 호출을 한 번에 묶어 보내고, 필요한 부분의 결과만 다시 읽습니다. 아끼는 것은 왕복 대기와 반복 출력입니다. 바뀌는 것은 호출 방식뿐으로, 모델 자체나 요금 체계가 아닙니다.

켜기 전에 충족해야 할 3가지 조건

  1. 버전: Claude Code v2.1.323 이상. claude --version으로 확인하고, 뒤처졌으면 claude update를 실행합니다.
  2. 모델: Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable 5.2 네 가지 모델만 지원합니다.
  3. 세션: 터미널 안의 대화형 세션에서만 동작합니다. -p 비대화형 모드, Agent SDK, VS Code 패널, 데스크톱 앱, 클라우드 세션은 모두 안 됩니다. Bedrock, Google Cloud, Microsoft Foundry 같은 서드파티 경로도 지원되지 않습니다.

터미널에 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude를 입력하고 Enter를 누른 뒤, 세션 시작 시 한 번 확인하면 됩니다. 조직 관리자는 관리 설정에서 끌 수 있지만, 사용자를 대신해 켤 수는 없습니다. 권한 규칙은 그대로입니다. 스크립트 안의 모든 도구 호출은 deny와 ask 규칙을 통과해야 하며, Remote Control, Claude in Chrome, 컴퓨터 사용 기능은 켜져 있는 동안 쓸 수 없습니다.

흔한 2가지 오해

널리 퍼진 '토큰 37% 절감'이라는 숫자는 공식 수치가 아닙니다. Anthropic 문서에는 그런 내용이 없고, 다른 오래된 글에서 나온 것이니 판단 근거로 삼지 마세요. Code Mode는 여러 파일을 한 번에 고치거나 찾는 것처럼 도구 호출이 많은 작업에 맞습니다. 간단한 질문에는 쓸모가 없습니다. 실험 기능이라 언제든 바뀔 수 있으니, 중요한 워크플로를 이것 하나에만 맡기지 마세요.

추천 도구

더보기