Claude Code v2.1.290 업데이트: 보안 점검 강화와 백그라운드 세션 안정화
v2.1.290은 새 기능보다 권한 검사와 백그라운드 세션, 예약 작업의 결함을 바로잡은 항목이 많은 릴리스입니다. 플러그인 훅과 mod 쪽 이벤트에도 필드가 추가되었습니다.
핵심 요약
- Bash 권한 검사가 rg, git grep, ps, pyright 등 일부 명령을 자동 승인하지 않고 묻도록 바뀌었습니다.
- claude attach, claude logs가 세션 이름의 일부만으로 동작합니다.
- WebSearch 한도가 200회 소진형에서 시간당 100회 충전형으로 바뀌었습니다.
- PreToolUse 훅이 입력을 고쳐 쓴 뒤에도 권한 규칙과 안전 점검이 적용됩니다.
- 예약 작업이 compact 이후 재개 때 사라지거나 재개마다 한 번 더 실행되던 문제가 고쳐졌습니다.
릴리스 노트 전체
공식 릴리스 노트의 190개 항목을 원문 순서대로 한 줄씩 옮겼습니다. 더하거나 뺀 항목은 없습니다.
- mod의 `turn.step` 훅 결과에 `serverToolUses`를 추가했습니다. API가 직접 실행한 도구 호출(advisor)이 id, 이름, 입력, 시작 및 종료와 함께 담깁니다
- 플러그인 훅의 `tool.check` 이벤트에 `agentId`를 추가했습니다. 훅이 서브에이전트의 권한 확인과 메인 세션의 권한 확인을 구분할 수 있습니다
- mod의 `tool.check` 훅이 읽는 질문과 판정에 `ceiling`을 추가했습니다. 조직이 도구에 요구하는 승인을 나타냅니다
- 플러그인 훅 타입 정의에 `ThemeKey`와 `Color` 타입을 추가했습니다. 에디터가 mod의 그리기에서 지정할 수 있는 테마 색상을 목록으로 보여 줍니다
- `claude plugin validate`에 추가했습니다. mod가 게이팅 지점에 등록한 각 훅이 `.catch`를 가졌는지 여부와 함께 표시됩니다(`--json`에서는 `gatingHooks`)
- Claude 앱 게이트웨이의 로그인 승인 페이지에 거부 버튼을 추가했습니다. 대기 중인 로그인을 종료하여 기다리던 터미널이 몇 초 안에 멈춥니다
- `claude attach <name>`와 `claude logs <name>`를 추가했습니다. id 대신 세션 이름의 일부를 사용할 수 있습니다
- `/claude-api managed-agents-onboard <url>`를 추가했습니다. 페이지가 설명하는 Managed Agents 패턴을 `ant apply` 파일로 설정합니다
- `/claude-api managed-agents-onboard <quickstart-name>`를 추가했습니다. `deep-researcher` 같은 Console 빠른 시작 템플릿을 `ant` CLI로 만듭니다
- 관리형 설정 파일이 관리형 설정 폴더 밖의 파일로 연결된 링크일 때 경고를 추가했습니다
- 관리형 설정이 사용자가 구성한 샌드박스 allowRead 경로나 허용 도메인을 무시할 때 /status와 doctor에 경고를 추가했습니다
- Claude Code의 베타 헤더 중 하나를 400이 아닌 상태 코드로 거부하거나, 두 번째 베타와 함께 거부하는 프록시와 게이트웨이 뒤에서 요청이 실패하던 문제를 고쳤습니다
- 이미지가 수백 개인 긴 세션이 "Request rejected as unprocessable by the model" 오류에서 벗어나지 못하던 문제를 고쳤습니다
- Claude가 아직 생각하는 중에 API의 출력 콘텐츠 필터가 응답을 중단하면 턴이 바로 끝나던 문제를 고쳤습니다. 이제 오류를 표시하기 전에 요청을 한 번 다시 시도합니다
- 재개된 서브에이전트와 팀원이 실행 도중 메시지를 받은 뒤 이전의 생각과 프롬프트 캐시를 잃던 문제를 고쳤습니다
- WebFetch가 100,000자를 넘는 페이지 텍스트를 말없이 버리던 문제를 고쳤습니다. 이제 읽지 못한 분량을 알려 주며 이어서 읽을 수 있는 `offset`을 받습니다
- 응답에 수천 단계로 중첩된 목록이나 인용문이 있을 때 발생하던 충돌("Maximum call stack size exceeded")을 고쳤습니다
- Claude가 작업하는 중에 보낸 프롬프트가 `/rewind` 목록에 나타나지 않던 문제를 고쳤습니다
- 대화가 압축된 후 재개할 때 예약 작업(간격을 지정한 `/loop`, 알림)이 말없이 복원되지 않던 문제를 고쳤습니다. 이 버전부터 수행된 압축에 적용됩니다
- 포그라운드에서 설정한 예약 작업이 ← 또는 `/background` 전환 후 실행되지 않던 문제와, 반복 작업이 재개, 재생성 또는 포크할 때마다 한 번씩 더 실행되던 문제를 고쳤습니다
- 구조화된 출력이 이미 전달된 후 연결이 끊어지면 헤드리스 `--json-schema` 실행이 `success` 결과에서 `is_error: true`와 함께 0이 아닌 코드로 종료되던 문제를 고쳤습니다
- 계획 모드에서 자동 모드 분류기가 서버가 푸시한 ask 정책을 가진 읽기 전용이 아닌 커넥터 도구를 승인하던 문제를 고쳤습니다
- 작업 디렉터리 밖으로 심볼릭 링크된 프로젝트 `CLAUDE.md`, 규칙 또는 `AGENTS.md`가 `permissions.blockReadsOutsideWorkingDirectories`나 `Read` 거부 규칙에도 불구하고 로드되던 문제를 고쳤습니다
- `xn--` 호스트 레이블 안에 와일드카드가 있는 URL 허용 및 거부 패턴이 프로세스마다 다르게 일치하던 문제를 고쳤습니다
- 조직이 제공한 MCP 서버가 로그인이나 재연결 후, 헤드리스 및 SDK 세션의 늦은 결과를 포함해, 사용자 본인의 것으로 다시 나열되던 문제를 고쳤습니다
- Windows에서 `git stash create`가 실패하면 `/ultrareview`가 커밋되지 않은 변경 사항을 경고 없이 버리던 문제와, `git add -N` 파일이 삭제되거나 이동된 후 이를 거부하던 문제를 고쳤습니다
- macOS와 Linux에서 백슬래시가 포함된 경로에 대한 `plansDirectory` 설정의 프로젝트 루트 확인을 고쳤습니다
- 매우 긴 Remote Control 및 클라우드 세션에서 응답이 스트리밍되지 않고 한 블록씩 나타날 수 있던 문제를 고쳤습니다
- `claude daemon run`과 `claude daemon logs`에서 백그라운드 데몬의 로그가 터미널 제어 문자를 화면에 그대로 전달하던 문제를 고쳤습니다. 이제 `\uXXXX` 이스케이프로 표시됩니다
- 셀프 호스팅 러너: 세션 오류 출력에 조작된 매우 긴 줄이 있으면 러너가 몇 초간 멈추던 문제를 고쳤습니다
- `.catch`가 있는 플러그인 훅이 프롬프트나 도구 호출로 훅 워커를 계속 점유할 때 언로드되고 `.catch`도 건너뛰어지던 문제를 고쳤습니다
- 응답 도중 모델 폴백으로 폐기된 도구 호출이 mod의 `turn.step` 결과에 나열되던 문제를 고쳤습니다
- Claude가 메시지나 파일을 보낸 직후 컨테이너가 재시작되면 Cowork 클라우드 세션의 응답이 끝나지 않을 수 있던 문제를 고쳤습니다
- 최상위 함수 중 하나와 같은 이름의 옵션을 구조 분해하는 훅 모듈을 `claude plugin validate`와 플러그인 로딩이 거부하던 문제를 고쳤습니다
- git 설정에 `core.safecrlf=true`가 있을 때 `/ultrareview`가 커밋되지 않은 변경 사항을 업로드하지 못하던 문제를 고쳤습니다
- 플래그가 지정된 메시지를 설정에 다른 수준이 저장된 폴백 모델에서 다시 시도할 때 노력 수준이 바뀌던 문제를 고쳤습니다
- Windows: 스킬과 명령의 여러 줄 `!` 셸 블록이 파일을 CRLF 줄바꿈으로 저장하면 실패하던 문제를 고쳤습니다
- 전체 화면 모드에서 검색 중 `/permissions` 탭을 클릭하면 Claude Code가 종료될 때까지 멈추던 문제를 고쳤습니다
- 대화 압축이 간혹 "null is not an object" 오류로 실패하던 문제를 고쳤습니다
- 자동 모드에서 보고서를 돌려주는 서브에이전트의 `turn.complete`에서 플러그인 훅이 빈 `answer`를 읽던 문제를 고쳤습니다
- mod의 다시 로드가 실패한 뒤 새로 고침이 이어지면 메시지 없이 mod가 언로드되던 문제를 고쳤습니다. 이제 실패 줄에 이전에 로드된 버전이 언로드된다고 표시됩니다
- `next(e)`를 호출한 뒤 프롬프트를 버리는 mod의 `prompt.submit` 훅이 말없이 무시되던 문제를 고쳤습니다. 이제 해당 훅이 이름과 함께 실패한 것으로 보고됩니다
- 매번 그릴 때마다 높이가 바뀌는 트리 위에서 끝을 따라가는 mod의 창 또는 밴드가 끝없이 다시 그려지던 문제를 고쳤습니다
- macOS와 Windows에서 이미지를 읽는 도중 링크를 바꿔치기하면 승인된 범위 밖의 파일이 반환될 수 있던 문제를 고쳤습니다
- 사용자가 설치한 mod 때문에 조직의 플러그인이 언로드될 수 있던 문제를 고쳤습니다. 이제 해당 mod가 언로드됩니다
- `.mcp.json`, 플러그인 또는 에이전트에 선언된 일부 MCP 항목에 `disableClaudeAiConnectors`와 `allowedMcpServers` URL 규칙이 적용되지 않던 문제를 고쳤습니다
- 매번 그릴 때마다 트리의 높이가 바뀌면 mod의 인라인 창이 끝없이 다시 그려지던 문제를 고쳤습니다
- 읽기 차단 또는 `--restricted` 상태에서 `@` 멘션이 읽는 도중 바뀐 링크를 통해 작업 디렉터리 밖의 파일을 읽을 수 있던 문제를 고쳤습니다
- 에이전트 보기에서 Esc가 "Press enter again to restart this session — it isn't responding"를 확정하던 문제를 고쳤습니다. 이제 Esc는 세션을 다시 열기만 합니다
- 백그라운드 세션이 자체 생성한 워크트리로 들어간 후 에이전트 보기에서 해당 세션의 `/loop` 실행 횟수, 카운트다운, 실시간 상태 줄이 사라지던 문제를 고쳤습니다
- 수동 권한 모드의 `claude agents` 세션이 답장이나 새 에이전트의 프롬프트에 붙여 넣은 이미지를 읽을 때 승인을 요청하던 문제를 고쳤습니다
- `declare`, `typeset`, `export` 또는 `readonly`의 접두사로 설정한 변수에서 이름을 가져온 명령이나 경로를 거부 또는 확인 규칙이 놓치던 문제를 고쳤습니다
- 프롬프트에 붙여 넣거나 끌어다 놓은 이미지 경로와, @ 멘션한 폴더에 나열된 파일 이름에 Read 거부 규칙이 적용되지 않던 문제를 고쳤습니다
- 사용자가 설치한 mod 때문에 조직의 가드가 검사를 건너뛸 수 있던 문제를 고쳤습니다. 이제 해당 mod가 언로드됩니다
- mod가 비라틴 문자가 포함된 긴 여러 줄 텍스트를 그릴 때 플러그인 훅이 다시 그릴 때마다 멈추던 문제를 고쳤습니다
- 섹션의 맨 아래 세션을 삭제한 뒤 에이전트 보기에서 Ctrl+X를 반복하면 다음 섹션 전체가 삭제되던 문제를 고쳤습니다
- You should know가 `language` 설정과 관계없이 노트를 영어로 작성하던 문제를 고쳤습니다
- 매우 긴 일부 메시지를 보낸 후 멈추던 문제를 고쳤습니다
- 화살표, 대시, 상자 그리기 문자 같은 비ASCII 문자가 포함된 큰 도구 출력 위에서 대화 기록(ctrl+o)을 확장하거나 크기를 조절할 때 느려지던 문제를 고쳤습니다
- `claude respawn`이 저장된 대화 기록이 없는 백그라운드 세션을 빈 대화로 시작하지 않고 이전 메시지를 다시 보내던 문제를 고쳤습니다
- agents 보기에서 `n:` 또는 Ctrl+F 검색 후 Esc를 누르면 포커스가 섹션 헤더로 이동하고, 이때 Ctrl+X를 두 번 누르면 해당 섹션의 모든 세션이 삭제되던 문제를 고쳤습니다
- `claude agents`가 중지된 세션에 전달하지 못한 슬래시 명령을 저장해 두었다가 해당 세션이 다음에 다시 시작될 때 저절로 실행하던 문제를 고쳤습니다
- `unset` 또는 `unspecified`라는 이름의 git 필터 드라이버가 적용된 파일에 대해 `/ultrareview`가 커밋되지 않은 변경 사항을 필터 없이 업로드하던 문제를 고쳤습니다. 이제 업로드를 중단하고 드라이버 이름을 바꾸도록 안내합니다
- auto 모드 거부 시, 도구 전체에 대해 분류기를 건너뛰게 하거나 Claude Code가 무시할 권한 규칙을 제안하던 문제를 고쳤습니다
- `claude --teleport`와 `/teleport`에서 stash를 선택했을 때, 추적 중이던 같은 이름의 파일을 대체한 폴더 안의 파일이 삭제되던 문제를 고쳤습니다. 이제 stash를 거부하고 그 이유를 알려 줍니다
- Esc를 누르면 agent view의 "Press enter again to restart this session fresh" 확인 프롬프트가 승인되던 문제를 고쳤습니다
- `/clear` 후 agent view의 `/loop` 실행 횟수가 멈추고 카운트다운이 사라지던 문제를 고쳤습니다. 이제 횟수가 새 대화와 함께 다시 시작됩니다
- `--channels` 권한 릴레이를 고쳤습니다. 한 세션 안에서 반복되는 응답 ID는 이제 다른 프롬프트를 승인하지 않고 무시됩니다
- Chrome 연결에 실패한 뒤 `/chrome`의 "Reconnect extension"이 브라우저 도구를 복원하지 못하던 문제를 고쳤고, 복원할 수 없을 때는 그 이유를 설명하도록 추가했습니다 (anthropics/claude-code#98135)
- 게이트웨이(`ANTHROPIC_AUTH_TOKEN`과 함께 쓰는 `ANTHROPIC_BASE_URL`)를 통해 Claude를 사용하며 Anthropic 계정이 없는 사용자에게 mods가 계속 꺼져 있던 문제를 고쳤습니다
- 백그라운드 세션이 비정상 종료된 직후 `claude agents`에서 보낸 응답이 2초 만에 거부되던 문제를 고쳤습니다. 이제 세션이 다시 시작되는 동안 최대 12초까지 재시도합니다
- `claude agents`가 실행 중인 세션에 전달하지 못한 슬래시 명령과 객관식 질문의 답변이 저장되었다가 세션이 다음에 다시 시작될 때 저절로 전송되던 문제를 고쳤습니다
- heredoc을 다른 명령으로 파이프하는(`cat <<EOF | python3`) 샌드박스 명령이 실행할 때마다 승인을 요청하던 문제를 고쳤습니다
- Homebrew 업그레이드 후 `claude agents`가 "Couldn't restart the background service" 오류로 실패하고 백그라운드 세션이 중지되던 문제를 고쳤습니다 (다음 업그레이드부터 적용됩니다)
- agent view의 "restart this session fresh"가 빈 대화로 시작하지 않고 세션의 이전 메시지를 다시 보내던 문제를 고쳤습니다
- 인수를 셸이 와일드카드로 확장할 수 있는 일부 읽기 전용 명령(`rg`, `git grep` 등)을 Bash 권한 검사가 자동 승인하던 문제를 고쳤습니다. 이제 승인을 요청합니다
- 오래된 저장 설정 때문에 업그레이드 후 `claude plugin test`가 실행을 거부하던 문제를 고쳤습니다
- zsh가 bash와 다르게 해석하는 변수 이름을 가진 일부 명령을 Bash 권한 검사가 자동 승인하던 문제를 고쳤습니다. 이제 승인을 요청합니다
- `git clone` 옵션의 짧은 형태가 `sandbox.excludedCommands`의 `git *` 같은 git 패턴에 따른 샌드박스 예외를 유지하던 문제를 고쳤습니다. 이제 긴 형태와 똑같이 처리됩니다
- 세션의 첫 기능 플래그 요청이 프로젝트 설정에 지정된 프록시나 API 엔드포인트를 무시하던 문제를 고쳤습니다
- 브랜치를 `.git` 밖에 보관하는 저장소(git 2.54 이상)에서 로컬 브랜치에 대한 `/ultrareview`가 커밋되지 않은 작업을 알리지 않고 업로드에서 빠뜨리던 문제를 고쳤습니다. 이제 이유를 설명하고 실행을 거부합니다
- 컨테이너 재시작으로 대기 중이던 `/loop` 깨우기나 예약된 작업이 사라진 뒤 클라우드 세션이 계속 잠든 채로 남던 문제를 고쳤습니다. 이제 Claude에게 이를 알려 주어 다시 예약할 수 있습니다
- 2025년 11월 수정 사항이 없는 PostgreSQL 버전에서 Claude apps 게이트웨이의 보존 정리 작업이 같은 시점에 갱신된 재방문 개발자의 ID 행을 삭제하던 문제를 고쳤습니다
- 샌드박스 자동 허용 상태에서 샌드박스 Monitor 도구 명령이 권한 프롬프트를 건너뛰던 문제를 고쳤습니다. 이제 사용자의 권한 규칙을 따릅니다
- ID 공급자에 제시하는 인증서의 subject가 비어 있을 때 Claude apps 게이트웨이가 시작되지 않던 문제를 고쳤습니다
- `store.postgres_url`을 파싱할 수 없을 때 Claude apps 게이트웨이가 "Invalid URL"만 출력하고 종료하던 문제를 고쳤습니다. 이제 오류에 설정 이름과 URL에 들어갈 수 있는 내용이 표시됩니다
- Mac이 절전에서 깨어날 때 백그라운드 에이전트가 "Agent stalled"로 실패하고 Workflow 도구 서브에이전트가 프롬프트부터 다시 시작되던 문제를 고쳤습니다
- 관리형 설정이 느린 파일 시스템(특히 WSL의 Windows 드라이브)에서 많은 경로의 읽기를 거부할 때, VS Code 확장 같은 SDK 호스트에서 2.1.285 이후 시작이 느려지거나 실패하던 문제를 고쳤습니다
- 컴퓨터 절전으로 중단된 응답이 Bedrock, Vertex, Foundry, 사용자 지정 게이트웨이에서 멈춘 스트림으로 처리되던 문제를 고쳤습니다
- `~/**/.env` 같은 샌드박스 읽기 규칙이 큰 폴더를 포함할 때 Linux와 WSL에서 첫 요청 전과 `/sandbox` Config 탭에서 멈추던 문제를 고쳤습니다
- 폴더 이름이 SKILL.md의 이름과 다른 경우(예: 영어가 아닌 이름) 해당 SKILL.md의 이름으로 요청한 skill을 찾지 못하던 문제를 고쳤습니다. 이제 skill 목록에 두 이름이 모두 표시됩니다
- 계획이 제시되기 전에 클라우드 세션의 컨테이너가 재시작되면 plan mode에서 작성한 계획이 사라지던 문제를 고쳤습니다
- 새 설정 디렉터리에서 시작 후 몇 초 만에 첫 명령이 실행되면 Bash 도구가 세션 내내 셸 별칭, 함수, 플러그인 PATH 항목을 가끔 잃어버리던 문제를 고쳤습니다
- HTTP MCP 서버가 매우 큰 응답을 보낼 때 메모리 사용량이 끝없이 늘어나던 문제를 고쳤습니다
- 클라우드 세션 안에서 시작한 Claude Code 실행(예: Bash 도구에서 실행한 `claude -p`)에서 아티팩트 작업이 실패하던 문제를 고쳤습니다
- 원격 세션에서 네 개 이상의 파일을 한꺼번에 보내면 일부가 "not the one approved"로 거부되던 문제를 고쳤습니다
- 터미널에서 `--continue` 또는 `--resume <session-id>`로 세션을 재개할 때 plan mode가 복원되지 않던 문제를 고쳤습니다
- 다른 GitHub 마켓플레이스의 다운로드 폴더와 같은 이름을 가진 마켓플레이스 때문에 그 마켓플레이스를 다운로드하지 못하던 문제를 고쳤습니다
- 자동 압축 중에 Mac이 절전 상태가 되면 "Prompt is too long"으로 압축을 포기하던 문제를 고쳤습니다
- 대화에 매우 큰 스택 트레이스나 소스 파일을 붙여넣은 내용이 있으면 되감기 메뉴(Esc Esc / `/rewind`)가 키를 누를 때마다 수백 밀리초씩 멈추던 문제를 고쳤습니다
- 하위 디렉터리 안의 파일을 @로 언급해도 해당 하위 디렉터리의 AGENTS.md가 첨부되지 않던 문제를 고쳤습니다
- 세션 폴더가 상대 심볼릭 링크일 때, 중지된 러너 이후 재개한 자체 호스팅 러너 세션이 "missing but already registered worktree"로 실패하던 문제를 고쳤습니다
- 비밀 정보 검사나 권한 프롬프트가 토큰처럼 보이는 긴 텍스트를 만날 때 멈추던 문제를 고쳤습니다
- 읽기 전용 명령의 일부 옵션 값에 있는 와일드카드에 대해 Bash 권한 검사가 Read 거부 규칙이나 디렉터리 밖 읽기 차단을 적용하지 않던 문제를 고쳤습니다
- `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS=5m`이 5ms로 해석되어 원격 대화 상자가 즉시 취소되던 문제를 고쳤습니다. 이제 단위 접미사가 붙은 값은 `dialogExpiry`로 대체됩니다
- MCP 서버의 도구 목록에 결합 문자가 매우 길게 이어질 때 멈추던 문제를 고쳤습니다
- 한 프롬프트에서 서로 겹치는 두 붙여넣기가 하나의 붙여넣기 블록이 아니라 일부는 입력한 텍스트로 모델에 전송되던 문제를 고쳤습니다
- 선택한 브라우저의 연결이 끊어졌을 때 Claude in Chrome의 브라우저 선택기가 Claude에게 보내는 메시지를 표시하던 문제와, 전환 후 VS Code 대화 상자의 목록이 갱신되지 않던 문제를 고쳤습니다
- 메인 세션이 다른 worktree에 들어가거나 나온 뒤 백그라운드 서브에이전트가 자신의 worktree에서 쓰기 및 Bash 권한을 잃던 문제를 고쳤습니다
- 머신의 관리형 설정이 게이트웨이 로그인을 강제하지 않을 때, Claude apps 게이트웨이 뒤에서 백그라운드 명령, agents 보기, 데몬 워커가 Anthropic에 텔레메트리와 기능 플래그 요청을 보내던 문제를 고쳤습니다
- `--restricted`(및 `CLAUDE_CODE_RESTRICTED=1`) 세션이 세션 간 메시징 소켓을 열던 문제를 고쳤습니다
- 유휴 상태에서 백그라운드로 옮긴 세션이 재시작이나 유휴 정리 후 "no saved transcript"로 다시 열리던 문제를 고쳤습니다. 이제 대화를 이어서 재개합니다
- bypass-permissions 고지를 수락하지 않았는데도 백그라운드 워커가 다시 생성될 때 `--allow-dangerously-skip-permissions`를 따르던 문제를 고쳤습니다
- 플러그인의 비동기 Stop 훅이 Application Support처럼 공백이 있는 폴더 아래의 스크립트 경로를 따옴표 없이 전달하면 Claude가 끝없이 응답을 반복하던 문제를 고쳤습니다
- 비밀 정보 마스킹이 끊김 없이 매우 긴 텍스트를 만날 때 몇 초간 멈추던 문제를 고쳤습니다
- PreToolUse 훅이 입력을 다시 쓴 뒤 도구 호출에 일부 권한 규칙과 안전 검사가 적용되지 않던 문제를 고쳤습니다
- `claude auth login` 후 또는 설정 디렉터리에 자격 증명 파일이 이미 있는데도 첫 실행 시 로그인 방법을 다시 선택하라고 요청하던 문제를 고쳤습니다
- 줄바꿈이 포함된 파일 이름이 파일 도구 오류와 권한 프롬프트에서 잘못 표시되던 문제를 고쳤습니다
- macOS 파일 이름처럼 분리된 문자로 저장된 악센트가 포함된 큰 붙여넣기가 제자리에서 확장된 뒤, 다음 키 입력 후 모델에 입력한 텍스트로 전송되던 문제를 고쳤습니다
- 키체인이 새 로그인을 거부하고 제거할 수 없는 이전 로그인을 유지했는데도 macOS `/login`이 성공했다고 보고하던 문제를 고쳤습니다
- `--include-partial-messages`를 사용하는 SDK 호스트에서 스트림이 끊기거나 중단되거나 비스트리밍으로 전환되었을 때, 턴이 끝난 뒤에도 응답이 열린 채로 보이던 문제를 고쳤습니다
- `.claude/settings.json` 또는 `.claude/settings.local.json`이 없을 때 Linux의 샌드박스 Bash 명령이 실행 도중 `ConfigChange` 훅을 실행하고 설정을 다시 불러오던 문제를 고쳤습니다
- git이나 gh처럼 Claude Code가 실행하는 도구가 설치되어 있지 않을 때, 누락된 프로그램의 이름 대신 "Premature close"라는 오류가 표시되던 문제를 고쳤습니다 (macOS, Linux)
- Linux의 샌드박스 Bash 명령 이후 또는 `.claude/scheduled_tasks.json`이 삭제된 후에 `/loop` 등 세션 한정 반복 예약 작업이 한 번 더 실행되던 문제를 고쳤습니다
- 심볼릭 링크로 연결된 설정 파일이 가리키는 파일을 편집할 때 설정 파일 권한 확인 없이 실행되던 문제를 고쳤습니다
- 네트워크 프록시 뒤에서의 MCP 시작을 개선했습니다. 프록시가 차단한 서버(HTTP 403)는 더 이상 세 번 재시도하지 않습니다
- 백그라운드 에이전트의 권한 확인 창에 모든 백그라운드 에이전트를 중지하는 Ctrl+X Ctrl+K 단축키가 표시되도록 개선했습니다
- 내장 `plugin-authoring` 스킬을 개선했습니다. 이제 Claude가 직접 만든 모드를 다른 사람이 설치할 때 실행할 명령 하나를 알려 주고, README의 설치 항목에도 적어 줍니다
- 데스크톱 앱 Code 탭에서 `/plugin`에 대한 응답을 개선했습니다. 이제 그곳에서 플러그인을 설치하고 관리할 위치를 안내합니다
- Bash 변경 파일 보기를 개선했습니다. 연결된 명령에 git merge, pull 또는 checkout이 포함되면 전체 diff 없이 파일 목록만 표시합니다
- 업스트림의 클라우드 자격 증명이나 연결이 실패할 때 Claude 앱 게이트웨이의 로그를 개선했습니다. 이제 경고가 근본 원인으로 끝납니다
- claude.ai 로그인 없이 클라우드 세션을 시작할 때 표시되는 오류를 개선했습니다. 이제 `claude auth login`과 /login을 안내하며 API 키 인증을 탓하지 않습니다
- Read 도구의 바이너리 파일 메시지를 개선했습니다. 이제 해당 형식을 읽을 수 있는 스킬이나 셸 명령을 Claude에게 안내합니다
- git 설정 파일 때문에 `/ultrareview` 업로드가 중단될 때 표시되는 오류를 개선했습니다. 길이가 절반 정도로 줄었고 어떤 종류의 파일이 문제인지 알려 줍니다
- `/ultrareview` 업로드가 체크아웃을 거부할 때 표시되는 오류를 개선했습니다. 이제 알려진 원인마다 해결 방법이 담긴 별도의 메시지가 표시됩니다
- Claude 앱 게이트웨이가 아이덴티티 공급자에 제시하는 인증서가 만료되기 전 마지막 30일 동안 경고를 로그에 남기도록 개선했습니다
- Claude in Chrome을 개선했습니다. `browser_batch` 호출이 시간 초과로 보고되기까지 기존 60초에서 90초로 늘어났습니다
- Claude 앱 게이트웨이의 브라우저 로그인 페이지를 개선했습니다. 브랜드 글꼴, 가운데 정렬 레이아웃, 다크 모드가 적용됩니다
- 대규모 세션을 재개할 때의 반응성을 개선했습니다. 대화 기록을 불러오는 동안에도 타이머, 입력, 렌더링이 계속 동작합니다
- / 및 @ 제안 목록을 개선했습니다. 선택된 행이 ❯ 포인터로 시작하므로 색상 없이도 확인할 수 있습니다
- `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`가 시작 시 연결 워밍업도 건너뛰도록 변경했습니다
- 프로젝트의 설정 파일로는 더 이상 Claude in Chrome을 켤 수 없도록 변경했습니다. `--chrome`, `/chrome` 또는 사용자 설정을 사용하세요
- Bash 도구가 `pyright`를 실행하기 전에 권한을 묻도록 변경했습니다. `pyright`는 더 이상 읽기 전용 명령으로 취급되지 않습니다
- 자식 프로세스가 실행된 뒤 다른 모드가 모드의 `$.process.spawn`을 거부할 때의 거부 내용을 변경했습니다. 이제 호출은 실행되었으나 플러그인이 결과를 보류했다고 안내합니다
- 백그라운드 데몬의 로그가 여러 줄 메시지를 JSON 따옴표 처리된 한 줄로 기록하도록 변경했습니다
- 스킬과 사용자 지정 명령이 탭과 줄바꿈을 제외한 원시 제어 문자가 포함된 `!` 셸 명령을 거부하도록 변경했습니다. 제어 문자의 위치를 보여 주는 메시지가 함께 표시됩니다
- `/artifacts`를 변경했습니다. 브라우저에서 아티팩트를 열면 이제 목록이 닫힙니다
- Bash 권한 검사를 변경해 더 많은 형태의 `ps` 명령이 묻지 않고 실행되는 대신 승인을 요청하도록 했습니다
- 플러그인 훅에서 긴 텍스트를 거부하거나 조용히 버리는 대신 잘라서 로그에 남기도록 변경했습니다
- 예약 작업이 사라진 백그라운드 세션을 변경했습니다. 이제 약 20초 뒤 Completed로 이동하며, 유휴 상태일 때 업데이트하거나 종료할 수 있습니다
- 방금 비운 프롬프트의 "Press ← again" 확인을 변경했습니다. 두 번째 ←를 누를 때 1초를 기다릴 필요가 없고, ←를 계속 누르고 있어도 전환됩니다
- `/ultrareview` 업로드가 git 단계에서 실패할 때 표시되는 오류를 변경했습니다. 이제 해당 단계와 시도할 방법을 알려 주며 git 자체의 오류 문구는 반복하지 않습니다
- 중간 effort의 `/code-review`가 Opus 5.5와 Sonnet 5.5를 포함해 조정된 리뷰 설정이 없는 모델에서도 정리 및 CLAUDE.md 규칙 관련 결과를 함께 보고하도록 변경했습니다
- Agent 결과에서 인프로세스 팀원의 `agent_id`를 해당 에이전트 ID로 변경했습니다 (`name@team` 주소는 `teammate_id`에 유지됩니다). TeammateIdle 훅은 더 이상 그 팀원의 서브에이전트나 포크에서 실행되지 않습니다
- 예약된 깨우기(`/loop`)를 기다리는 백그라운드 세션을 변경했습니다. 이제 업데이트나 메모리 부족 상황에서도 계속 실행 상태로 유지됩니다. 재시작되거나 종료되면 깨우기가 조용히 사라질 수 있었습니다
- `claude agents`에서 바쁜 백그라운드 세션으로 보낸 `/model`, `/effort`, `/rename`이 턴이 끝날 때가 아니라 확인 없이 즉시 적용되도록 변경했습니다
- Claude 앱 게이트웨이가 지원하는 최소 PostgreSQL 버전을 14에서 11로 변경했습니다
- 대화형 세션의 WebSearch 한도를 200회 호출 후 종료되는 방식에서 시간이 지나면 다시 채워지는 방식(시간당 100회, `CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR`로 속도를 설정하며 0이면 끔)으로 변경했습니다
- 저장소의 `.claude/settings.json` 또는 `.claude/settings.local.json`에서 더 이상 `CLAUDE_CODE_DISABLE_ATTACHMENTS`를 설정할 수 없도록 변경했습니다. 셸, 사용자, 관리형 설정에서는 여전히 설정할 수 있습니다
- 디렉터리에서 불러온 플러그인에 대한 `claude plugin update`가 내장 플러그인처럼 "Failed to update plugin" 접두어 없이 사유만 출력하도록 변경했습니다
- 클라우드 세션의 내장 `gh api`를 변경했습니다. `GH_HOST` 또는 `GH_REPO`에 설정된 github.com 이외의 호스트는 이제 거부되며(`--hostname`이나 전체 URL을 사용하세요), stderr에 다른 호스트로의 요청이 표시됩니다
- `claude-api` 스킬의 Managed Agents 예제를 에이전트에 필요하지 않으면 웹 도구를 끄고 `auto` 권한 정책을 사용하도록 변경했습니다
- Self-hosted runners: `claude --environment <id>`가 현재의 Sessions API로 세션을 생성하도록 변경했습니다. 출력되는 세션 ID와 JSON 세션 ID는 session_… 형식을 유지합니다
- [VSCode] Claude가 작업 중일 때 메시지를 보내면 "Message queued."라는 스크린 리더 안내를 추가했습니다
- [VSCode] Manage plugins 대화상자에서 플러그인 마켓플레이스의 설치 또는 업데이트 명령을 검토하고 실행하는 기능을 추가했습니다
- [VSCode] 아무것도 입력하지 않은 빈 채팅이 있는 상태에서 그 자리에 저장된 대화를 열면 백그라운드 Claude 프로세스가 계속 실행되던 문제를 고쳤습니다
- [VSCode] 저장 중 Claude Code가 예기치 않게 중지되었을 때 설정 대화상자가 시간 초과 탓을 하던 문제를 고쳤습니다
- [VSCode] 커밋되지 않은 변경 사항을 확인하지 못했을 때도 브랜치 전환 대화상자가 전환을 제안하던 문제를 고쳤습니다
- [VSCode] 열려 있는 대화상자 뒤로 도착한 권한 확인 창이 키보드 포커스를 가져가, 대화상자에서 누른 키가 그 요청에 응답하던 문제를 고쳤습니다
- [VSCode] Claude Code가 자신의 프로그램을 찾거나 시작하지 못할 때 로그인과 새 세션에서 명확한 이유가 표시되지 않던 문제를 고쳤습니다
- [VSCode] 에이전트 맵에서 중첩된 서브 에이전트가 "Tool calls (0)"으로 표시되고, 그 에이전트가 시작한 에이전트가 메인 에이전트 아래에 배치되던 문제를 고쳤습니다
- [VSCode] Continue After Reload를 개선했습니다. VS Code가 확장을 다시 시작한 뒤 다시 열린 탭도 이제 재시작으로 중단된 단계를 마무리합니다
- [VSCode] 메시지의 파일 pill을 개선했습니다. 마우스를 올리면 프로젝트 폴더 기준 파일 경로가 표시되어 이름이 같은 파일을 구분할 수 있습니다
- [VSCode] 메시지 타임스탬프가 기본적으로 표시되도록 변경했습니다 (Claude Code: Show Message Timestamps 설정으로 끌 수 있습니다)
- [Cloud sessions] 클라우드 환경의 환경 변수로 프롬프트 제안을 꺼도 새 클라우드 세션에 적용되지 않던 문제를 고쳤습니다
- [Cloud sessions] Claude의 응답이 끝난 뒤에도 클라우드 세션의 작업 표시기가 몇 초간 계속 돌던 문제를 고쳤습니다. 이제 응답과 함께 멈춥니다
- [Cloud sessions] 한 번도 실행되지 않은 루틴 페이지의 History가 Run now를 눌러도 "No runs yet"으로 표시되던 문제를 고쳤습니다. 이제 새 실행이 표시됩니다
- [Cloud sessions] 보관 해제한 클라우드 세션이 다른 메시지를 보낼 때까지 Claude가 여전히 작업 중인 것처럼 보이던 문제를 고쳤습니다
- [Remote Control] Remote Control을 막 시작한 컴퓨터가 새 세션의 Remote Control 메뉴에 나타나기까지 최대 1분이 걸리던 문제를 고쳤습니다. 이제 몇 초 안에 나타납니다
- [Claude Tag] Slack에서 빠른 모드를 추가했습니다. Claude를 `!fast`로 멘션하면 스레드가 빠른 모드로 전환되며 필요하면 Opus로 옮기고, `!fast off`로 되돌립니다. 켜져 있는 동안 응답에 (fast)가 표시됩니다
- [Claude Tag] 액세스 번들에서 사용자 지정 연결을 만들 때 선택 항목인 Path prefixes 필드를 추가했습니다. 이제 허용 규칙이 호스트 전체 대신 지정한 경로만 포괄하도록 할 수 있습니다
- [Claude Tag] Claude Tag Admin 권한이 있는 멤버가 Activity 페이지의 Memory 탭에서 "Couldn't load memory files" 오류를 보던 문제를 고쳤습니다. 이제 워크스페이스 및 채널 메모리를 읽을 수 있습니다
- [Claude Tag] Slack의 Claude 설정 카드에서 워크스페이스 게스트가 Confirm을 누르면 모든 사람에게서 버튼이 사라지던 문제를 고쳤습니다. 이제 거부 메시지는 해당 게스트에게만 표시되며, 멤버는 계속 확인하거나 취소할 수 있습니다
- [Claude Tag] Slack 채널의 예약된 루틴이 채널의 기본 모델이 아닌 다른 모델로 실행되던 문제를 고쳤습니다. 새 세션을 시작하는 각 실행은 이제 현재 기본 모델을 사용합니다
- [Claude Tag] 채널 이름 규칙으로 연결된 액세스 번들의 GitHub 저장소가 규칙이 적용되는 채널에서 거부되던 문제를 고쳤습니다. 이제 Claude가 해당 채널에서 저장소를 추가하고, 나열하고, 클론할 수 있습니다
- [Claude Tag] 본인의 Claude 요금제 사용 한도에 도달했을 때 다이렉트 메시지로 표시되는 Claude의 안내를 개선했습니다. 이제 몇 초 안에 표시되며 한도가 초기화되는 시점도 알려 줍니다
- [Claude Tag] 이전 Claude in Slack 앱이 세션을 시작하지 못할 때 보내는 답변을 개선했습니다. 이제 무엇이 실패했고 누가 해결할 수 있는지 알려 주며, 전체 내용은 스레드당 한 번만 표시합니다
- [Claude Tag] 채널 지침 제한을 바이트 대신 8,192자로 변경해 영어가 아닌 텍스트도 같은 분량을 쓸 수 있게 했고, Configure 페이지의 Save 옆에 글자 수 표시를 추가했습니다
- [Code Review] 차단성 리뷰 코멘트가 심각도와 모순되는 "nit" 라벨로 시작하는 경우가 있던 문제를 고쳤습니다
- [Code Review] Code Review를 꺼 둔 조직의 포크 및 Manual 모드 풀 리퀘스트에 "@claude review" 코멘트를 남기라는 팁이 게시되던 문제를 고쳤습니다
함께 읽기: X(트위터) 아카이브 데이터 다운로드 및 로컬 변환 도구 사용 가이드 · 구글 제미나이 반복 업무 자동화 스킬 사용법 및 설정 안내 · 노트북 업무 효율을 높이는 외부 모니터 확장 및 디스플레이 설정 세부 가이드
새로 쓸 수 있게 된 기능
이번 업데이트로 새로 쓸 수 있게 된 기능은 9가지입니다. 근거 항목은 위 릴리스 노트의 번호입니다.
| 기능 | 달라진 점 | 근거 항목 |
|---|---|---|
| 세션 이름 일부로 attach·logs | claude attach <name>과 claude logs <name>에서 id 대신 세션 이름의 일부를 쓸 수 있습니다. | 7번 |
| WebSearch 한도 충전식 전환 | 대화형 세션의 WebSearch 예산이 시간당 100회씩 채워지며, CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR로 속도를 정하고 0이면 끕니다. | 158번 |
| WebFetch 오프셋 읽기 | 10만 자를 넘는 페이지는 읽지 못한 분량을 알려 주고, offset으로 이어서 읽을 수 있습니다. | 16번 |
| 플러그인 훅 이벤트 필드 추가 | tool.check 이벤트에 agentId가 붙어 서브에이전트와 메인 세션의 권한 확인을 구분할 수 있습니다. 조직이 요구하는 승인 수준을 알리는 ceiling도 추가되었습니다. | 2번, 3번 |
| claude plugin validate 개선 | 게이팅 지점에 등록된 훅마다 .catch 유무를 목록으로 보여 주며, --json에서는 gatingHooks로 나옵니다. | 5번 |
| Managed Agents 온보딩 | /claude-api managed-agents-onboard로 URL이 설명하는 패턴이나 Console 퀵스타트 템플릿을 ant CLI 기반으로 구성합니다. | 8번, 9번 |
| 관리형 설정 경고 | 관리형 설정 파일이 폴더 밖 링크일 때, 그리고 사용자 sandbox 허용 경로가 무시될 때 경고가 나옵니다. | 10번, 11번 |
| 스킬 이름 표시 개선 | SKILL.md 이름과 폴더 이름이 다를 때 스킬 목록에 두 이름이 함께 표시됩니다. | 91번 |
| 에이전트 뷰 명령 즉시 적용 | claude agents에서 바쁜 백그라운드 세션에 보낸 /model, /effort, /rename이 확인 없이 바로 적용됩니다. | 156번 |
업데이트하고 버전 확인하기
이 글의 변경을 모두 쓰려면 Claude Code 2.1.290 이상이 필요합니다. 터미널에서 claude update로 새 버전을 받고, claude --version으로 2.1.290 이상인지 확인합니다.
claude update
claude --version
새 글: OpenAI Pollo AI 영상 제작 사례와 최신 API 업데이트
출처
- Claude Code v2.1.290 릴리스 노트 · github.com
작성일 2026-10-06 12:19
소개 · 문의 · 개인정보처리방침 · 면책 안내 · 저작권 안내 · AI, IT 글 모음
© 2026 MinoSui. 이 글의 무단 전재·재배포를 금합니다. 원문: https://minoss0918.blogspot.com/
댓글
댓글 쓰기