클로드 코드 v2.1.323 및 v2.1.325 핵심 업데이트 요약

앤스로픽이 클로드 코드 최신 버전에서 에이전트가 도구를 다루는 방식을 근본적으로 바꾸는 실험 기능인 코드 모드를 공개했습니다. 도구를 하나씩 부르고 답을 기다리는 대신 클로드가 직접 짧은 자바스크립트 코드를 짜서 파일 검색, 수정, 테스트 실행을 한 스텝에 연쇄 처리하며, v2.1.325에서는 VS Code 탭 프롬프트 자동 제안과 중요 보안 패치가 함께 적용되었습니다.

왜 도구를 하나씩 부르지 않고 자바스크립트 코드로 묶어서 실행할까

기존의 Claude Code는 프로젝트 안의 마크다운 파일 50개를 읽어 깨진 링크를 찾으라고 시키면 파일 목록 조회 도구를 부르고, 결과를 읽고, 다시 파일 읽기 도구를 수십 번 왕복 호출하며 매 턴마다 생각하는 시간을 썼습니다.

v2.1.323부터 실험 기능으로 추가된 코드 모드를 켜면 작동 방식이 완전히 달라집니다. 클로드가 직접 서너 줄짜리 자바스크립트 스크립트를 작성해 검색 명령어를 병렬로 돌리고, 그 출력값에서 원하는 첫 번째 파일 경로만 골라내 문자열을 고친 뒤 단위 테스트까지 한 번에 실행하고 꼭 필요한 요약 결과만 돌려받습니다. 대화창은 평소처럼 깔끔한 수정 비교 화면만 보여주고, 실제로 클로드가 짠 자바스크립트가 궁금하면 Ctrl+O를 눌러 트랜스크립트 뷰어에서 펼쳐볼 수 있습니다.

기존 일반 도구 호출 방식 vs 클로드 코드 모드 비교

비교 기준	기존 표준 도구 호출 방식	신규 실험적 코드 모드
다수 파일 반복 작업	매 파일마다 모델 왕복 추론이 발생해 시간과 토큰 증가	자바스크립트 반복문과 병렬 실행으로 한 스텝에 일괄 처리
중간 검색 결과 필터링	수천 줄 검색 원문이 모델 컨텍스트로 그대로 유입	코드 안에서 필요한 줄만 걸러낸 뒤 핵심 값만 모델에 반환
지원 모델 및 환경	모든 지원 모델 및 클라우드 게이트웨이 전반 호환	앤스로픽 직접 API 기준 Opus 5.5, Sonnet 5.5, Claude Haiku 5.5, Claude Fable 5.2 전용 터미널 세션
장시간 작업 한도	일반 턴 단위 대기	대기 모드 최대 10분, 오토 모드 백그라운드 실행 시 최대 2시간 구동

코드 모드 켜는 법과 v2.1.325에서 꼭 알아야 할 보안 변경사항

1. 환경 변수 한 줄로 코드 모드 체험하기

터미널에서 버전이 v2.1.323 이상인지 확인한 뒤 쉘 실행 앞에 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 값을 붙여 claude를 실행하거나 사용자 홈 폴더의 settings.json 파일 안 env 항목에 넣어두면 됩니다. 외부에서 내려받은 낯선 저장소가 몰래 코드 모드를 켜지 못하도록 프로젝트 내부 설정 파일에 적힌 값은 철저히 무시되도록 안전하게 설계되었습니다.

2. v2.1.325 샌드박스 배시 기본 권한 변경 주의하기

보안 강화를 위해 v2.1.325부터는 샌드박스 안에서 돌아가는 배시 명령어도 기본적으로 일반 권한 확인 절차를 거치도록 정책이 바뀌었습니다. 만약 예전처럼 샌드박스가 켜진 상태에서 승인 창 없이 자동으로 명령을 계속 통과시키고 싶다면 본인의 최상위 설정 파일에 sandbox.autoAllowBashIfSandboxed 항목을 참으로 명시해 주어야 합니다. 또한 zstd 압축 응답을 해독하는 과정에서 발견된 보안 취약점도 이번 패치로 수정되었으므로 빠른 업데이트가 권장됩니다.

3. VS Code 탭 키 다음 프롬프트 제안으로 손가락 피로 줄이기

VS Code 확장 패널을 쓰는 개발자라면 이제 터미널과 똑같이 작업 흐름에 알맞은 다음 후속 질문이 입력창에 흐릿하게 제안됩니다. 제안된 지시문이 마음에 들면 키보드의 Tab 키만 가볍게 눌러 바로 전송할 수 있어 수정 후 테스트 돌려줘 같은 상투적인 문장을 매번 타이핑할 필요가 없습니다.

자주 묻는 질문 Q&A

Q. 아마존 베드록이나 구글 버텍스 AI 사내 게이트웨이를 통해서도 코드 모드를 켤 수 있나요?
현재 실험 단계인 코드 모드는 앤스로픽 직접 구독 계정이나 콘솔 API에서만 동작하며 클라우드 서드파티 게이트웨이나 원격 제어, 데스크톱 앱 세션에서는 아직 지원되지 않습니다.

Q. 우리 회사 보안 정책상 직원들이 실험적인 코드 모드를 쓰지 못하게 막을 수 있나요?
관리자용 매니지드 설정 파일의 env 항목에 해당 환경 변수 값을 0으로 지정해 배포하면 사내 모든 직원의 터미널에서 코드 모드가 강제로 비활성화되어 안전하게 통제할 수 있습니다.

#Claude Code v2.1.325 관련 아티클

클로드 코드 v2.1.325 자바스크립트 코드 모드와 샌드박스 권한 변경점