Claude Code v2.1.323 — Code Mode 출현: 도구 호출을 JavaScript로 쓰다
v2.1.323의 플래그십은 Code Mode입니다. 실험적 옵트인 기능으로, Claude가 도구를 하나씩 호출하는 대신 도구를 호출하는 JavaScript 코드를 직접 작성합니다. 문서(code.claude.com/docs/en/code-mode)에서 켤 수 있고, 조직 단위로 끄는 스위치도 제공됩니다.
한마디로 말하면, 에이전트-도구 상호작용의 패러다임 후보가 공식 진입한 것입니다 — 개별 툴 콜의 왕복 오버헤드 대신, 컴파일된 로직 한 덩어리로 워크플로를 실행하는 방식입니다.
Code Mode — 왜 패러다임 후보인가
개별 도구 호출은 매번 모델 왕복이 필요합니다. 20단계 워크플로우는 20번의 모델 응답을 의미하죠. Code Mode에서는 Claude가 그 20단계를 JavaScript 한 파일로 작성하고, 실행은 코드가 합니다 — 토큰 소비와 지연이 단계 수에서 상수로 바뀌는 구조적 변화입니다. 조직이 끌 수 있는 스위치를 함께 제공한 것은, 이 모드가 검증·감사 관점에서 기존 도구 호출 감시 체계와 다른 형태라는 인식의 반영이기도 합니다. MCP 생태계가 확장된 지금, "도구 호출을 코드로"는 자연스러운 다음 단계였고 — 실험적 옵트인이라는 태그가 붙은 만큼, 기본 워크플로우는 기존 방식을 유지합니다.
플러그인 생태계에 QA 체계가 생기다
플러그인 개발자를 위한 정합성 도구가 일괄 도착했습니다. plugin.json에 engines["claude-code"] 필드가 추가돼 선언된 버전 범위 밖의 플러그인은 설치·업데이트·로드가 거부되고, 설치 시 범위에 맞는 최신 버전을 자동 선택합니다. claude plugin validate는 플러그인의 TypeScript 훅 모듈 타입 체크를 수행하고(--strict면 경고를 실패로), 모드의 engine.create 훅이 추가·보류·교체하는 $ 명사를 보고합니다. 여기에 플러그인 언어 서버 기동 실패 시 서버명과 점검 항목을 알려주는 경고, Bash(PORT=* npm run dev)처럼 변수값에 *가 든 허용 규칙의 시작 경고까지 — 플러그인 생태계가 커진 만큼 그 품질 게이트가 공식화된 것입니다.
무인 운영의 심장박동과 나머지
claude -p·SDK 세션에서 훅이 오래 실행될 때 30초마다 진행 하트비트를 보내, Claude Desktop 같은 호스트가 세션을 '멈춤'으로 종료하지 않게 했습니다 — 311~319의 무인 신뢰성 시리즈에 붙는 마지막 안전장치입니다. 이외에 Artifact 업로드에 .docx 지원, 사용 크레딧이 꺼졌거나 소진된 모델에 대한 옵션 메뉴(중단·크레딧 전환·업그레이드), 관리 설정에서 서드파티 프로바이더용 CLAUDE_CODE_AUTO_MODE_MODEL 지원, Perforce 설정 발견 시 모드 안내(엔터프라이즈 VCS 신호), 그리고 318에서 추가됐던 서브에이전트 진행 요약을 끄는 DISABLE_AGENT_PROGRESS_SUMMARIES의 공식 문서화가 포함됐습니다.
실전 가이드
Code Mode는 실험 단계이니 프로덕션 워크플로우에 바로 붙이기보다 사이드 프로젝트에서 eval과 함께 테스트하는 것을 권합니다 — 특히 도구 호출이 많은 데이터 파이프라인이라면 토큰 절감 폭이 실측될 겁니다. 플러그인 개발자는 engines 필드 선언과 plugin validate --strict를 릴리즈 게이트에 넣으세요. 장시간 훅을 돌리는 운영자는 하트비트가 호스트 타임아웃을 방지하는지 319→321→323 업그레이드로 확인할 시점입니다.
마무리로 — 도구 호출을 코드로 바꾸는 시도는 에이전트 엔지니어링의 최전선 논쟁입니다. Claude Code가 그 논쟁을 실험 플래그로 품는 속도 자체가, 이 도구가 여전히 프론티어를 달리고 있다는 증거입니다.
출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.323
태그: AI Claude Claude Code 개발도구