Claude Code v2.1.304 업데이트: 새 명령어와 모드 제어 기능 추가

Claude Code v2.1.304 버전이 릴리스되었습니다. 이번 버전에는 개발 환경 분석을 통한 자동 모드 설정과 에이전트 보안 검사 도구가 포함되었습니다. 확장 모드 제어 옵션과 코드 리뷰 관리 기능도 함께 보강되었습니다.

핵심 요약
  • 자동 모드 설정을 지원하는 /auto-mode-setup 명령어가 추가되었습니다.
  • 에이전트 보안 설정을 점검하는 /claude-api managed-agents-secure 명령어가 도입되었습니다.
  • 모드 개발자를 위해 tool.check 이벤트에 decider 및 e.isReadOnly 속성이 추가되었습니다.
  • 코드 리뷰 기능에 3단계 리뷰 레벨과 조직 전체 저장소 자동 적용 옵션이 추가되었습니다.
목차
  1. 릴리스 노트 모아 보기
  2. 이번에 새로 생긴 기능
  3. 업데이트 효과 직접 재보기
  4. 업데이트 방법과 버전 확인

릴리스 노트 모아 보기

공식 릴리스 노트의 76개 항목을 원문 순서대로 한 줄씩 옮겼습니다. 더하거나 뺀 항목은 없습니다.

  1. 먼저 실행된 플러그인이 모드의 훅 중 하나를 건너뛸 때 이벤트와 플러그인 이름을 표시하는 트랜스크립트 한 줄을 추가했습니다
  2. 모드의 `tool.check` 응답에 `decider: "person"`을 추가했습니다: 권한 대화상자나 호스트의 콜백만 요청을 승인할 수 있으며, 물어볼 대상이 없으면 모드의 사유와 함께 거부됩니다
  3. 도구 호출이 읽기 전용일 때 설정되는 `e.isReadOnly`를 모드의 `tool.check` 이벤트에 추가했습니다
  4. 환경을 자동 모드에 학습시키기 위해 프로젝트와 최근 세션을 읽는 안내형 설정인 `/auto-mode-setup`을 추가했으며, 이제 Bedrock, Vertex, Foundry, Claude 앱 게이트웨이 및 원격 측정이 비활성화된 세션에서도 사용할 수 있습니다
  5. 아무것도 변경하지 않고 Managed Agents 에이전트의 설정을 Anthropic이 게시한 보안 가이드와 비교하는 `/claude-api managed-agents-secure`를 추가했습니다
  6. 트랜스크립트 뷰(Ctrl+O)의 압축 요약에 이전에 호출된 도구들의 이름을 추가했습니다
  7. 비활성 대화를 재개할 때 5시간 사용량 한도의 상당 부분을 소모할 경우 표시되는 경고를 Pro 및 Max 요금제에 추가했습니다: 그대로 재개하거나 새 대화를 시작할 수 있으며, 이전 대화를 언급하면 Claude가 이를 찾아볼 수 있습니다
  8. 시작 시 `ANTHROPIC_API_KEY`를 승인하거나 `/config`에서 "Use custom API key"를 전환한 후 매시간 확인이 이루어질 때까지 조직 정책이 새로고침되지 않던 문제를 고쳤습니다
  9. Linux에서 `sandbox.filesystem.denyRead` glob에 `[user-id]` 라우트 폴더처럼 문자 클래스가 아닌 대괄호가 포함되어 있을 때 샌드박스 명령이 시작되지 않던 문제를 고쳤습니다
  10. 마운트된 드라이브나 최상위 레벨 폴더(`/Volumes`, `/media`, WSL의 `/mnt/c`)에 대한 `rm -r` 실행 시 `rm -rf /Applications`에서 표시되는 안전 확인 프롬프트가 뜨지 않던 문제를 고쳤습니다
  11. 파일을 정리하는 동안 디스크가 가득 차면 `CLAUDE_CODE_TRANSCRIPT_LOCAL_GC`가 저장된 트랜스크립트에서 메시지를 누락하던 문제를 고쳤습니다
  12. 플러그인이 서브에이전트를 생성하거나 완료된 서브에이전트를 다시 실행하여 `--max-turns`, Stop, 또는 종료된 입력을 지나 헤드리스 실행을 계속 유지하던 문제를 고쳤습니다
  13. 모드 다시 로드가 실패했을 때 계속 로드된 상태로 유지되는 버전의 도구와 명령어가 제거되고, 이전 버전이 여전히 로드되어 있는지 여부에 대해 메시지가 잘못 표시되거나 침묵하던 문제를 고쳤습니다
  14. 동일한 라벨을 가지고 `key`가 없는 버튼들이 변경 없이 다시 그려질 때 모드 버튼 클릭이 누락되던 문제를 고쳤습니다
  15. 관리형 설정이 적용된 머신과 Team 및 Enterprise 요금제에서 기본 내장 `plugin-authoring` 스킬의 모드 공유가 비밀 스캔 단계에서 멈추던 문제를 고쳤습니다
  16. 예약된 Cowork 클라우드 세션에서 승인해 줄 사람이 없는 상황임에도 WebFetch에 URL 승인이 필요한 각 서브에이전트마다 다시 5분씩 대기하던 문제를 고쳤습니다
  17. Write 결과 및 거부된 편집에서 작업 디렉터리 외부의 파일이 `../../…`로 표시되던 문제를 고쳤습니다. 이제 `~/…` 또는 전체 경로로 표시됩니다
  18. Cowork 클라우드 세션의 "/" 메뉴에서 선택했을 때 claude.ai Directory 플러그인의 스킬이 명령어로 실행되지 않던 문제를 고쳤습니다
  19. 터미널에 다른 계정으로 로그인되어 있을 때 Remote Control이 데스크톱 대화 기록을 영구적으로 보류하던 문제를 고쳤습니다
  20. 유료 요금제에서 DISABLE_TELEMETRY 또는 DO_NOT_TRACK이 설정되어 있을 때 Claude Desktop에서 Remote Control이 시작되지 않던 문제를 고쳤습니다
  21. SDK 및 데스크톱 세션에서 모델 전환, 메시지 및 인터럽트가 컨텍스트 사용량 확인 뒤에서 대기하던 문제를 고쳤습니다
  22. LLM 게이트웨이 뒤에서 `context_management: Extra inputs are not permitted` 오류가 발생하던 문제를 고쳤습니다. Claude Code는 이제 해당 필드 없이 요청을 다시 보냅니다
  23. 최초 실행 설정 중 로그인하거나 /logout 후 첫 시작 시 서버 관리형 설정을 통해 전달된 OpenTelemetry 설정이 세션 전체에서 무시되던 문제를 고쳤습니다
  24. macOS 및 Linux의 Claude Desktop Code 탭 세션에서 샌드박스 처리되지 않은 Bash 명령이 ~/.zshrc 같은 셸 시작 파일에 내보낸 환경 변수를 인식하지 못하던 문제를 고쳤습니다
  25. 서버 오류 이후 소비자 약관 알림이 하루 이상 건너뛰어지던 문제를 고쳤습니다
  26. 네트워크 또는 서버 오류 후 `/privacy-settings`에서 사용자에게 적용되지 않을 수 있는 선택지를 제공하던 문제를 고쳤습니다
  27. API에서 너무 길다고 거부한 대화를 Claude Code가 압축하는 동안 턴을 중지한 후 "Context limit reached" 또는 "Prompt is too long" 오류가 발생하던 문제를 고쳤습니다
  28. 서브에이전트가 완료된 직후 메시지를 받거나 재개될 때 가장 최근의 작업을 때때로 잊어버리던 문제를 고쳤습니다
  29. 실제 동작과 일치하도록 `--tools`, `--resume`, `--debug`, `--json-schema`, `--disable-slash-commands`, `--system-prompt-snapshot` 및 `claude update`에 대한 `claude --help` 텍스트를 고쳤습니다
  30. HEAD가 분리되었거나 다른 브랜치에 있을 때 `claude --worktree`가 종료 시 묻지 않고 워크트리와 해당 브랜치를 삭제하여 커밋이 손실될 수 있던 문제를 고쳤습니다
  31. 재개된 세션 및 클라우드 세션에서 시작 시 플러그인이 다시 로드될 때마다 Claude에게 전체 스킬 목록을 다시 보내던 문제를 고쳤습니다
  32. 유휴 파이프나 이미지처럼 명명된 장치에서 대기하는 Read를 인터럽트가 종료하지 못하던 문제를 고쳤습니다
  33. `CLAUDE_CODE_EFFORT_LEVEL`이 `auto` 또는 `unset`이고 아무 수준도 전송되지 않았을 때 `/effort status`, `/effort ultracode` 및 프롬프트의 노력 지표가 추측된 노력 수준을 표시하던 문제를 고쳤습니다
  34. 동일한 도구 호출에 대한 Agent SDK 콜백 훅에서 시간 초과가 발생했을 때 PreToolUse 훅의 거부 사유가 시간 초과 오류로 대체되던 문제를 고쳤습니다
  35. 디스크가 가득 찬 경우를 제외하고, 큰 명령어의 출력 파일을 세션의 tool-results 폴더로 복사할 수 없을 때 Bash와 PowerShell이 이를 삭제하던 문제를 고쳤습니다
  36. 약 100열 미만의 터미널에서 미리보기가 있는 객관식 질문에 입력한 메모가 "…"로 잘려 입력 내용이 가려지던 문제를 고쳤습니다 (anthropics/claude-code#82768)
  37. 최대 1시간으로 예약된 자체 진행 `/loop` 웨이크업이 1시간 프롬프트 캐시 만료 직후에 실행되던 문제를 고쳤습니다. 이제 이러한 웨이크업은 캐시되지 않은 대화를 다시 읽지 않습니다
  38. 에이전트 팀 문제를 고쳤습니다: 메인 세션의 종료 요청을 승인해도 더 이상 CLI 전체가 종료되지 않습니다
  39. 한 스킬의 `once` 훅이 실행된 후 다른 스킬의 동일한 훅까지 제거하던 문제를 고쳤습니다
  40. 트랜스크립트 모드의 `{` 및 `}`가 프롬프트를 트랜스크립트의 첫 번째 행 대신 일관되지 않은 행이나 화면 밖으로 이동시키던 문제를 고쳤습니다
  41. `CLAUDE_CODE_AUTO_COMPACT_WINDOW=200k`가 조용히 100K 윈도우를 설정하던 문제를 고쳤습니다: 이제 해당 변수는 `--autocompact`처럼 `k` 및 `M` 접미사를 허용하며, 값이 범위를 벗어나거나 무시될 때 경고합니다
  42. 마우스 버튼을 놓기 전에 누를 경우 에이전트 뷰의 Ctrl+C가 텍스트 선택 영역을 복사하지 않고 지워버리던 문제를 고쳤습니다
  43. 사용량 데이터의 속도 제한이 "잠시 후 다시 시도하세요" 대신 언제 끝나는지 알려주도록 `/usage`를 개선했습니다
  44. 세션에서 작성된 모드가 로드, 다시 로드 또는 로드 실패할 때 표시되는 줄을 개선했습니다
  45. 여러 뷰가 있는 아티팩트를 개선했습니다: 링크를 요청하면 Claude가 각 뷰의 링크를 작성하고 뷰를 전환해도 주소 표시줄이 동일하게 유지된다고 설명합니다
  46. 클라우드 세션을 개선했습니다: 서버가 `alwaysLoad: true`를 설정하지 않는 한, 새 대화의 첫 번째 턴이 claude.ai에서 동기화된 플러그인의 로컬(stdio) MCP 서버를 더 이상 기다리지 않습니다
  47. 서버가 다른 세션 데이터를 담고 있는 상태 업데이트를 거부할 때 원격 세션이 상태를 복구하는 방식을 개선했습니다
  48. 자동 모드에서의 세션 파일 크기를 개선했습니다: 안전 분류기의 컨텍스트가 더 이상 모든 요청마다 저장되지 않습니다
  49. `claude -p`의 잘못된 설정 경고를 개선했습니다: 로드되지 않은 파일은 로드를 막은 항목만 나열하며, 긴 목록은 파일당 제한됩니다
  50. SDK 및 헤드리스 모드에서 압축된 대형 세션의 재개를 개선했습니다: 재개 후 첫 번째 요청이 더 빨리 전송됩니다
  51. 많은 서브에이전트가 동시에 실행될 때의 응답성과 처리량을 개선했습니다
  52. 길거나 재개된 대화에서 요청을 보낼 때의 메모리 사용량을 개선했습니다
  53. 자체 호스팅 러너: 세션 저장소에 대해 git 호스트가 "찾을 수 없음"으로 응답할 때 표시되는 오류를 개선했습니다. 이제 저장소 이름과 문의할 대상을 알려줍니다
  54. Windows: 표준 Git for Windows 설치 환경에서 cmd 런처 대신 git.exe를 직접 실행하여 git 명령어 시작 성능을 개선했습니다
  55. 관리형 모드가 보존 정리 작업에서 사용하는 `cleanupPeriodDays`를 포함하여 조직의 설정을 상한선으로 설정할 수 있도록, 모드의 `settings.read` 훅이 각 설정 계층을 수신하고 병합된 설정을 다시 작성하도록 변경했습니다
  56. 번호가 매겨진 선택지를 표시하도록 `/artifacts` 삭제 확인을 변경했습니다: 1 또는 Enter는 아티팩트를 유지하고, 2는 삭제하며, y, n 및 Esc도 여전히 동작합니다
  57. 세션에서 Claude가 작성한 모드를 켜는 질문을 링크나 세션 ID가 없는 일반 텍스트로 변경했습니다. 새 턴이 시작되어도 질문이 유지되며, 모드를 켤 때 Claude가 로드된 내용을 알려줍니다
  58. 사용자 지정 `ANTHROPIC_BASE_URL` 뒤에서 도구 검색이 기본적으로 켜지도록 변경했습니다. 게이트웨이의 400 또는 422 오류는 도구 검색 없이 재시도됩니다
  59. 압축 후 Claude에게 스킬 목록을 다시 보내도록 변경했습니다. `/reload-skills`는 이제 신규 또는 변경된 스킬만 보냅니다
  60. 스킬 훅을 변경했습니다: 한 소스(저장소, 개인 폴더 또는 플러그인)의 스킬은 세션당 최대 1,024개의 훅과 16,384개의 일치자 문자를 등록할 수 있습니다
  61. 플러그인의 훅만 허용하는 정책에 따라 스킬 동작을 변경했습니다. 메인 대화에서 사용되는 스킬의 훅이 제외된 경우 더 이상 해당 스킬의 `allowed-tools`를 가져오지 않습니다.
  62. AWS 환경의 Claude Platform에서 SDK나 curl로 대체하는 대신 `ant` CLI를 사용하도록 /claude-api 스킬을 업데이트했습니다.
  63. `claude plugin validate`에서 모드의 훅이 어디서 실행될지 예측하던 안내 문구를 제거했습니다.
  64. Opus 5.5에서 `/fast` 대화상자 제목의 "(research preview)" 라벨을 제거했습니다.
  65. [VSCode] Amazon Bedrock, Google Vertex AI, Microsoft Foundry 환경, LLM 게이트웨이 뒤에 있거나 원격 측정이 비활성화된 세션의 채팅 패널에 모드 그리기를 추가했습니다.
  66. [VSCode] 세션 시작 시 "Subprocess initialization did not complete within 60000ms" 오류가 발생하던 원인 중 하나를 고쳤습니다. 이제 SessionStart 커맨드 훅 실행 시간이 최대 10분까지 제한 시간에 포함되지 않습니다.
  67. [VSCode] 시작 도중에 닫힌 세션의 Claude Code 프로세스가 시작이 끝날 때까지 계속 실행되던 문제를 고쳤습니다.
  68. [VSCode] 이전 버전의 Claude Code도 함께 실행 중인 머신에서 오랫동안 열려 있던 패널의 모드 그리기가 다음 턴까지 사라지던 문제를 고쳤습니다.
  69. [VSCode] `claudeCode.claudeProcessWrapper`가 설정되었을 때 Past conversations에서 세션이 숨겨지던 문제를 고쳤습니다.
  70. [VSCode] 백그라운드 보조 에이전트의 모든 단계를 채팅창으로 스트리밍하는 대신 Agent 카드 아래의 상태 한 줄로 표시하도록 변경했습니다. 전체 기록은 /tasks에 유지됩니다.
  71. [Cloud sessions] 클라우드 세션에서 작성기 @ 목록의 폴더 이름이 표시되지 않고, 폴더 선택 시 멘션 대신 공백만 추가되던 문제를 고쳤습니다.
  72. [Claude Tag] 작업 중간에 채널이 Enterprise Grid 워크스페이스 간에 공유될 때 스레드에서 Claude가 응답하지 않던 문제를 고쳤습니다. 이제 새 스레드에서 @ 멘션하라는 일회성 알림을 게시합니다.
  73. [Claude Tag] 스레드 외부에서 입력된 `@Claude !fork`에 눈에 보이는 응답이 없던 문제를 고쳤습니다. 이제 Claude가 스레드 내부에서 실행하라는 비공개 알림을 표시합니다.
  74. [Code Review] Code Review에 리뷰 단계를 추가했습니다. 소유자는 조직에 대해 Quick, Standard(기본값), Deep 중 하나를 선택할 수 있으며, 개별 리포지토리에 별도의 단계를 부여할 수도 있습니다.
  75. [Code Review] 관리자가 나중에 추가되는 리포지토리를 포함하여 GitHub 조직의 모든 리포지토리를 일일이 선택하지 않고 한 번에 리뷰할 수 있도록 Code Review 관리자 설정에 옵션을 추가했습니다.
  76. [Code Review] 관리자가 Code Review를 켠 직후 1~2분 내에 생성된 풀 리퀘스트가 알림 없이 건너뛰어지던 문제를 고쳤습니다. 이제 다시 시도되어 정상적으로 리뷰됩니다.

함께 읽기: Claude Code v2.1.303 릴리스: 버그 수정과 안정성 개선 · Claude Code v2.1.302 변경 사항: 유휴 압축 설정과 서브에이전트 기본값 · Claude Code v2.1.301: vim % 이동과 OTel 분류기 필드 추가

▲ 맨 위로

이번에 새로 생긴 기능

이번 업데이트로 새로 쓸 수 있게 된 기능은 6가지입니다. 근거 항목은 위 릴리스 노트의 번호입니다.

기능달라진 점근거 항목
/auto-mode-setup 명령어 추가프로젝트 구성과 최근 세션을 분석해 현재 환경에 맞게 자동 모드를 학습시키는 안내형 설정 명령어를 제공합니다.4번
Managed Agents 보안 점검 명령어/claude-api managed-agents-secure를 실행해 설정을 변경하지 않고 Anthropic 보안 가이드와 비교 점검합니다.5번
모드 tool.check 제어 속성 확장도구 호출 시 사람 승인만 허용하는 decider: 'person'과 읽기 전용 여부를 판별하는 e.isReadOnly 속성을 지원합니다.2번, 3번
비활성 대화 재개 시 사용량 경고Pro 및 Max 플랜에서 비활성 세션 재개 시 5시간 사용량 한도를 크게 소모할 위험이 있으면 경고를 표시합니다.7번
코드 리뷰 레벨 및 조직 단위 자동 지정코드 리뷰를 Quick, Standard, Deep 3단계로 지정할 수 있으며, GitHub 조직 내 신규 저장소까지 일괄 자동 검토하도록 설정합니다.74번, 75번
VS Code 모드 UI 렌더링 지원 확대Bedrock, Vertex AI, Foundry 및 원격 측정 비활성화 세션에서도 VS Code 채팅 패널 내 모드 그래픽 렌더링을 지원합니다.65번

▲ 맨 위로

업데이트 효과 직접 재보기

에이전트, effort, 속도, 재시도에 관한 변경이 내 작업에서 얼마나 차이 나는지는 직접 재 보면 숫자로 확인됩니다. claude -p를 JSON 출력으로 실행하면 걸린 시간과 턴 수, 서브에이전트 결과가 함께 나옵니다.

claude -p "<작업 지시>" \
  --output-format json < /dev/null

작업 지시는 옵션보다 앞에 둡니다. --allowedTools Agent "<작업 지시>"처럼 쓰면 --allowedTools가 값을 여러 개 받는 옵션이라 작업 지시까지 도구 이름으로 읽습니다. 옵션을 뒤에 쓰려면 --allowedTools=Agent처럼 =로 붙입니다. 아무것도 보내지 않는 파이프에 표준 입력이 연결돼 있으면 3초를 기다린 뒤 경고를 띄우고 진행하는데, < /dev/null로 표준 입력을 막아 두면 이 대기가 없습니다.

  • duration_ms: 실행 전체에 걸린 시간(밀리초)
  • num_turns: 결과가 나오기까지 걸린 턴 수
  • subagent_stats.completed / subagent_stats.failed: 서브에이전트가 끝까지 마친 수와 실패한 수

단순 조회 작업 하나(예: 어떤 함수가 어디서 호출되는지 찾기)와 코드 수정 작업 하나(예: 함수 하나에 테스트 추가)를 정해 둡니다. 같은 저장소에서 설정마다(업데이트 전후, effort 수준별) 두 작업을 각각 여러 번 실행하고, 조회와 수정의 기록을 따로 모아 비교합니다.

아래는 Claude Code 2.1.292에서 서브에이전트 한 개를 띄운 실행의 실제 출력에서 위 네 값만 남긴 것입니다. 나머지 키는 ...로 줄였습니다.

{
  "duration_ms": 14271,
  "num_turns": 4,
  "subagent_stats": {
    "completed": 1,
    "failed": 0,
    ...
  },
  ...
}

기록표의 첫 줄은 이 실행을 옮긴 것입니다. 조회 작업과 코드 수정 작업을 나눠, 실행할 때마다 한 줄씩 더합니다.

작업설정시간(ms)턴완료/실패
예시2.1.2921427141 / 0

▲ 맨 위로

업데이트 방법과 버전 확인

이 글의 변경을 모두 쓰려면 Claude Code 2.1.304 이상이 필요합니다. 터미널에서 claude update로 새 버전을 받고, claude --version으로 2.1.304 이상인지 확인합니다.

claude update
claude --version

▲ 맨 위로

글쓴이 MinoSui · 블로그 운영자·편집 책임

편집 방침. 오류 제보는 문의로 받습니다. 글쓴이·블로그 소개

새 글: Google Gemini 대학생 기능 11가지 활용법과 무료 유료 한도 정리

#IT·AI#클로드AI#ClaudeCode

작성일 2026-10-20 09:20

소개 · 문의 · 개인정보처리방침 · 면책 안내 · 저작권 안내 · AI, IT 글 모음

© 2026 MinoSui. 이 글의 무단 전재·재배포를 금합니다. 원문: https://minoss0918.blogspot.com/

댓글

이 블로그의 인기 게시물

트럼프 AI 속도조절론 거부와 글로벌 빅테크 및 한국 IT의 파장

KT 모두의 AI 서비스 추진 일정과 일상 속 핵심 기능 총정리

스타크래프트 AI 플루토 김성현 대결 전략 분석 및 최신 AI 기술

아이티센클로잇 AI 에이전트, 폐쇄망 연동 필수 보안 기준과 활용법

난폭운전 보복운전 기준 차이와 스마트폰 영상 신고 정리

초보 귀농인을 위한 농작물 병해충 진단 앱 설치 및 스마트팜 활용 가이드

카카오 카나나 상담매니저 도입 및 고객 응대 효율화 방법

백화점 3사 정기 휴무일 확인법과 정기 세일 공략 팁

마인크래프트 코블몬 모드 전설 포켓몬 스폰 설정 및 소환 알아둘 점

그록 AI 반도체 설계 원리와 GPU 대비 성능 벤치마크