← 최신 뉴스로 돌아가기
중요도 3개발도구

Claude Code v2.1.261

핵심 요약

Claude Code v2.1.261 은 조직 정책 로딩 오류 표시, 출력 제한 설정 추가, 그리고 대용량 프롬프트 파일 읽기 등 개발 워크플로우 효율성을 높이는 기능들을 도입했습니다. 또한 에이전트 비용 최적화를 위한 사용하지 않는 스킬 식별 기능과 다양한 환경 (AWS, TLS 프록시) 에서의 안정성 문제를 해결하여 실제 코드 작성 및 자동화 작업의 신뢰도를 개선했습니다.

선정 이유

이 업데이트는 새로운 AI 모델 출시나 가격 정책 변화가 아닌, 기존 개발 도구인 Claude Code 의 세부 기능 개선과 버그 수정에 해당합니다. 조직 정책 관리, 스킬 비용 모니터링, 프록시 환경 호환성 등 특정 사용자 (개발자) 에게 유용한 편의성과 안정성을 제공하지만, 산업 전체의 방향을 바꾸거나 핵심 사용 방식을 근본적으로 전환시키는 수준은 아닙니다.

내용

변경 사항 /status 와 claude doctor 에 "Organization policy" 행을 추가하여 조직 정책이 로드되지 않은 이유 (예: 프록시가 엔드포인트를 통과하지 못하는 경우) 를 표시합니다. bashOutputMaxChars 와 taskOutputMaxChars 설정을 추가하여 Claude 가 파일에 저장되기 전에 내선으로 받는 명령어 및 백그라운드 작업 출력량을 최대 128K 문자까지 늘릴 수 있도록 합니다. --append-subagent-system-prompt-file 을 추가하여 커맨드 라인에 전달하기에는 너무 큰 프롬프트의 경우 파일에서 서브 에이전트 시스템 프롬프트를 읽을 수 있습니다. /skill-doctor 를 추가하여 로드된 스킬 중 사용하지 않는 것과 컨텍스트 비용이 많은 것을 표시하여 이를 정리할 수 있도록 합니다. 빠른 입력이나 키 반복 시 타이핑하거나 붙여넣은 문자가 순서가 뒤섞이거나 손실되는 문제를 수정했습니다. /add-dir <subdirectory> 가 작업 디렉토리가 /net 자동 마운트 위치에 있을 때 잘못된 "해당 항목을 해결할 수 없습니다" 오류를 출력하는 문제를 수정했습니다. AWS 나 AWS 자격 증명 헬퍼가 응답하지 않을 때 Bedrock 설정 마법사가 멈추는 문제 (이제 명확한 오류 메시지와 함께 타임아웃됨) 와 TLS 검사 프록시 뒤에서 모델 확인이 실패하는 문제를 수정했습니다. enabledPlugins 에서 관리 설정이 강제 활성화로 설정되어 있더라도 claude.ai 에서 동기화된 플러그인이 클라우드 세션에서 버려지고, 이를 대체할 수 있는 마켓플레이스 클론으로 회귀하여 실패할 수 있는 문제를 수정했습니다. 프롬프트 입력 내선 [Image #N] 칩 바로 앞의 문자를 즉시 삭제할 수 없었던 문제를 수정했습니다. 세션을 재개할 때 병렬 도구 호출 주변의 훅 출력 및 기타 컨텍스트가 손실되어 재개된 요청이 변경되는 문제를 수정했습니다. 휴대폰, 브라우저, 또는 claude.ai 앱이 터미널 세션에 연결하거나 터미널의 모드가 변경될 때 원격 제어 (Remote Control) 가 오래된 권한 모드를 표시하는 문제를 수정했습니다. 연결된 휴대폰이나 브라우저에서 턴을 중지하거나 로컬 슬래시 명령어(/clear)를 실행한 후에도 원격 제어 세션이 여전히 작동 중으로 표시되는 문제 (스피너가 멈추고 정지 버튼이 고장 난 상태) 를 수정했습니다. SDK 및 클라우드 세션이 첫 번째 프롬프트 직후, 턴이 시작되기 전에 보낸 정지 또는 중단 명령을 무시하는 문제를 수정했습니다. 이제 턴은 완료될 때까지 실행되지 않고 올바르게 중지됩니다. /teleport 로 가져온 세션을 연결된 세션에 업로드할 때, 휴대폰과 웹에서 원본에 붙어 추가된 것처럼 보이는 문제를 수정했습니다. 네이티브 Windows 환경에서 TLS 를 검사하는 기업 프록시 뒤에서 원격 제어의 입행 이벤트 스트림이 지연되는 문제를 수정했습니다. effort 가 설정에서 유래할 때 claude.ai 에서 기본 노력 수준을 표시하는 원격 제어 세션 문제를 수정했습니다. Google 인증서 확인이 느릴 때에도 인증서가 유효한 상태라면 시작 시 브라우저가 열리도록 하는 gcpAuthRefresh 문제 를 수정했습니다. 시작 시 커넥터 가져오기 시간이 초과되어 전체 세션 동안 커넥터가 부재로 유지되는 claude.ai 커넥터 문제를 수정했습니다. 이제 CLI 는 백그라운드에서 재시도합니다. 백그라운드 에이전트를 재개할 수 없어 긴 루프에서 깨우기를 재시도했을 때 지속된 높은 CPU 사용량을 수정했습니다. 동일한 머신에서 실행되는 더 오래된 Claude Code 버전에도 새 버전의 기능 플래그가 간헐적으로 적용되는 문제를 수정했습니다. 사용량 엔드포인트가 속도 제한을 받거나 시작 직후에 열렸을 때 모델별 주간 한도 행이 누락되어 /usage 와 VS Code 사용량 패널에서 문제가 발생하는 것을 수정했습니다. 트랜스크립트에 기록된 잘못된 세션 ID 를 채택하여 claude -p --resume <file> 이 문제를 수정했습니다. 이제 새 세션 ID 하에서 재개됩니다. terminal 진행 표시기 (iTerm2, Ghostty, ConEmu) 가 백그라운드 워크플로우 또는 에이전트가 여전히 실행 중임에도 불구하고 세션을 완료된 것으로 표시하는 문제를 수정했습니다. 행렬과 열 방향 간 전환 후 컨테이너의 높이가 잘못 렌더링되는 드문 레이아웃 버그를 수정했습니다. Claude 앱 게이트웨이 클라이언트 IP 를 신뢰할 수 있는 프록시가 X-Forwarded-For 헤더에 포트를 추가하는 경우, 액세스 목록이 설정되어 있어 읽을 수 없는 항목은 이제 403 오류를 반환합니다. 터미널 CLI 가 프로토버프를 사용할 때에도 Claude 데스크톱에서 OpenTelemetry 를 JSON 형식으로 내보내도록 게이트웨이를 수정하여, 프로토버프 전용 수집기가 데스크톱의 데이터를 거부하는 문제를 해결했습니다. de스크톱과 웹이 아티팩트 업데이트만 대기 중임에도 세션을 '사용 중'으로 표시하는 버그를 수정했습니다. Claude 데스크톱 앱에서 실행되는 로컬 Cowork 세션에서 파일 업로드가 "paths: expected array, received undefined" 오류로 실패하는 Claude in Chrome 문제를 수정했습니다. 다른 기계의 오프라인 원격 제어 세션에 SendMessage 를 보냈을 때 '전송됨'으로 표시되던 버그를 수정하여, 해당 기계가 다시 연결될 때까지 전송이 대기 중임을 결과 메시지에 반영합니다. 배경 Bash 명령어에서 실행되는 CLI 에서 플러그인 설치 힌트를 감지하지 못하는 문제를 수정하고, 이제 원본 <claude-code-hint> 태그가 대화에 누출되지 않습니다. 프로세스 내 에이전트 팀 동료들이 두 번째 턴에서 첫 번째 턴의 도구 및 기술 발표를 다시 보내면서 요청 접두사를 변경하고 프롬프트 캐시를 놓치는 버그를 수정했습니다. Claude Code 가 모델을 인식할 때 /model 피커와 VS Code 모델 피리를 통해 베드록, Vertex AI, 또는 LLM 게이트웨이 ID 대신 모델 이름을 표시하도록 개선했습니다. GOOGLE_APPLICATION_CREDENTIALS 가 설정된 상태에서 Google Vertex AI 에서 시작될 때 API 클라이언트 생성이 Google Cloud 프로젝트 발견을 다시 실행하거나 추가 gcloud 프로세스를 생성하지 않도록 개선했습니다. 스트리밍 성능을 개선하여 이미 렌더링된 블록이 각 업데이트마다 레이아웃에서 다시 확인되지 않습니다. dangerous-rm 안전 프롬프트를 개선하여 위치 매개변수 및 이중 인용부호 sh -c 스크립트 내부의 rm -rf 명령어도 포착하도록 했습니다. API 가 응답 헤더를 보내지 않을 때의 처리가 개선되었습니다: 재시도는 이제 3 분을 기다리는 대신 API_TIMEOUT_MS(기본값 10 분)까지 대기하며, 메시지가 변경 사항을 안내합니다. Claude 앱 게이트웨이에서 관리 설정 로드 시 (시작 시 또는 로그인 후) 403 에러를 발생시키는 경우, 조직에 Claude Code 가 활성화되지 않았음을 나타내도록 변경되었으며, 새로운 로그인 안내 대신 해당 메시지를 표시합니다. forceLoginMethod: "gateway"로 고정된 관리 설정이 있는 머신은 남은 API 키나 claude.ai 로그인을 무시하고 /login 을 요청하도록 변경되었습니다. Bedrock, Vertex AI, Foundry 세션에는 영향을 미치지 않습니다. 자동 모드에서 공중 다이어그램 렌더러 URL 에 콘텐츠를 압축하는 링크를 해당 사이트로 업로드 처리하도록 변경되었으며, 요청하지 않은 경우 자동으로 승인되지 않습니다. prompt 의 단어 편집 키가 Bash 와 일치하도록 변경되었습니다: Ctrl+W 는 백스페이스로 흰색 문자까지 삭제하고, Alt+F 와 Alt+D 는 단어 끝에서 정지하며, 문자는 단어를 분리합니다. keybindingFlavor 는 이제 더 이상 효과가 없습니다. /context 토큰 계수가 토큰 계수 API 가 사용할 수 없을 때 추가적인 작은 모델 요청 대신 로컬 추정치를 사용하도록 변경되었습니다. [VSCode] 출력 스타일 메뉴에 "사용자 정의 스타일 만들기" 안내를 추가하여 사용자 정의 출력 스타일 파일을 작성하고 즉시 목록에 표시합니다. [VSCode] MCP 서버 대화상자에 서버 추가 양식과 제거 동작을 추가하여 IDE 를 떠나지 않고 MCP 서버를 추가하거나 제거할 수 있습니다. [VSCode] 터미널, 다른 VS Code 창 또는 Claude Desktop 에서 열린 세션의 경우 세션 목록에 빈 링을 추가하여 닫힌 것처럼 보이지 않게 합니다. 권한 및 질문 프롬프트 옆에 접기 버튼을 추가하여 프롬프트를 해제하지 않고도 뒤의 대화를 읽을 수 있도록 하며, 프롬프트 옆 공간은 이제 대화를 스크롤합니다. [VSCode] 세션 목록의 우클릭 메뉴에 'Archive session(세션 보관)'을 추가하고, Unarchive(보관 해제)에 별도의 아이콘을 부여했습니다. [VSCode] 클라우드 세션이 종료되어 질문이 잘린 부분이 Claude Code 웹 버전에서 전송된 세션으로 잘못 인식되어 거절 처리되는 문제를 수정했습니다. [VSCode] 창을 복원한 탭의 'Rename(이름 변경)' 상자가 비어 열리는 문제를 수정하여, 현재 이름으로 시작하도록 변경했습니다. [VSCode] 세션 목록 패널이 로드될 때마다 축소된 섹션이 일시적으로 확장되어 표시되는 문제를 수정했습니다. [VSCode] Claude 가 다음 작업으로 넘어간 후에도 Focus view(집중 보기) 에서 도구 호출이 여전히 실행 중으로 표시되는 문제를 수정했습니다. 예를 들어, 질문이 사용자의 답변을 기다리는 동안에도 마찬가지였습니다. [VSCode] 초점 없는 Claude 탭의 세션 ID 가 수정되었을 때 세션 목록의 활성 행 강조가 구식화되는 문제를 수정했습니다. [VSCode] Claude 탭에 초점이 있을 때 Cmd/Ctrl+Shift+T 를 통한 재개 및 딥링크 열기가 Claude 탭을 Claude 편집기 그룹 외부로 배치하는 문제를 수정했습니다. [VSCode] 세션 탭의 'Add to group(그룹 추가)' 기능이 Claude Code on the Web 에서 열린 세션을 두 개의 그룹에 넣는 문제를 수정하여, 이제 세션 목록에 표시되는 항목으로 이동하도록 변경했습니다. [VSCode] 창이 다시 로드되기까지 두 번 이상 지연되어 조직에서 비활성화한 모델도 모델 선택기에 표시되는 문제를 수정했습니다. [VSCode] 세션 목록에서 열린 탭이 VS Code 가 탭의 뷰를 다시 로드한 후 해당 세션으로 다시 점프하거나, 웹 세션에서 열린 탭이 텔레포트가 재시작되거나 비어 있는 상태로 유지되는 문제를 수정했습니다. [VSCode] 창을 다시 로드한 직후나 설정 파일에 오류가 있을 때 바로 질문을 할 경우 이전 세션의 side-question(부수적 질문) 이력을 덮어쓰는 문제를 수정했습니다. btw [VSCode] Claude.ai 또는 Console 계정으로 로그인한 후 Claude 패널이 다시 로드되었음에도 불구하고 대기 중인 질문 카드가 다시 나타나지 않는 문제를 수정했습니다. [VSCode] claude.ai 전용 기능이 설정 파일에서 제 3 자 제공자가 선택된 후에도 해당 창 내 다른 Claude 패널에 계속 표시되는 문제를 수정했습니다. [VSCode] Claude Code 가 로그인 중이 아니거나 로그인이 실패한 경우에도 Disable Login Prompt 설정이 있음에도 불구하고 로그인 화면이 나타나는 문제를 수정했습니다. [VSCode] 이전 프롬프트에서 입력된 텍스트가 다음 대기 중인 권한 프롬프트에 유지되고 즉시 두 번째 클릭을 허용하는 문제를 수정했습니다. [VSCode] 세션 목록만 표시된 창에서 설치 대화 상자가 없는 상태에서 Claude 사이드바를 열도록 install-plugin 링크가 동작하는 문제를 수정했습니다. [VSCode] 새 창에서는 계정 및 사용량 대화 상자를 여는 전까지 사이드바 사용량 계량이 비어있고, 0% 사용량 제한이 계량에 표시되지 않는 문제를 수정했습니다. [VSCode] '이 그룹에서 새 세션 시작'을 실행하면 그룹이 사라지고, 사이드바의 읽지 않은 목록이 로드되기 전에 완료된 세션에 대한 읽지 않은 점이 누락되는 문제를 수정했습니다. [VSCode] 실행 중인 턴 동안 편집자 탭 배지가 읽지 않음으로 표시되거나 세션 목록에서 열린 탭에 배지가 표시되지 않고, '그룹에 세션 탭 추가'가 보관된 세션에 대해 아무런 동작을 하지 않는 문제를 수정했습니다. [VSCode] '모든 세션에 원격 제어 활성화'를 토글할 때 다른 VS Code 창에서 열린 세션에도 즉시 적용되도록 수정했습니다. [VSCode] claude.ai 에서 계속된 세션의 탭이 웹 세션 아래에 여전히 기록되어 있는 경우 세션 목록의 Open 필터가 제대로 작동하지 않고, 스크린 리더를 위한 필터 메뉴 섹션을 표시하도록 수정했습니다. [VSCode] 모델 선택기를 모든 모델을 나열한 하나의 평평한 목록으로 변경하고, 이전 모델 철자법이 마지막에 있도록 행을 유지합니다.
원문 보기 ↗