Claude Code 주간 브리핑 Week 13 — Auto Mode·Conditional Hooks·Transcript Search
Claude News

Claude Code 주간 브리핑 Week 13 — Auto Mode·Conditional Hooks·Transcript Search

hiwony7933 6월 3, 2026 2 min read

시리즈: Claude Code 주간 브리핑 시리즈 전체 목록

Week 13 개요 — v2.1.83~v2.1.85, 3/23~3/27

지금까지 Claude Code를 쓰면서 반복되는 권한 프롬프트 응답, 세션마다 실행되는 훅 오버헤드, 긴 세션에서 이전 명령을 스크롤로 찾는 불편함이 세 가지 공통 불편이었다. 2026년 3월 23일부터 27일까지 v2.1.83~v2.1.85 업데이트는 이 세 방향을 각각 개선했다.

이번 주의 큰 줄기는 세 가지다. 첫째, 매번 권한 프롬프트에 응답하는 반복 작업을 분류기(classifier)에 위임하는 Auto Mode. 둘째, hooks 실행 범위를 특정 명령으로 좁혀 세션 오버헤드를 줄이는 Conditional Hooks. 셋째, 긴 대화 중 특정 Bash 명령이나 텍스트를 즉시 찾아낼 수 있는 Transcript Search다.

나머지 세 기능(Computer use, PR auto-fix, PowerShell tool)은 각각 Desktop 앱·Web·Windows 전용이라 현재 CLI 환경에서는 직접 사용할 수 없다. 아래에서 주요 기능부터 순서대로 정리한다.

Auto Mode (research preview) ★★★

공식 docs 동작

Auto Mode는 Claude Code의 권한 프롬프트를 내장 분류기(classifier)에 위임하는 기능이다. 공식 docs에 따르면 동작 방식은 다음과 같다.

  • 안전한 편집·명령: 인터럽트 없이 자동 실행
  • 파괴적이거나 의심스러운 작업: 차단 후 사용자에게 표면화

이는 “모든 파일 쓰기마다 승인 요청”과 --dangerously-skip-permissions(모든 권한 건너뛰기)의 중간 지점으로 설계됐다. 분류기가 “안전/파괴적” 두 범주로 작업을 자동 판별하지만, 판단 기준의 세부 경계는 아직 공식 docs에 완전히 문서화되어 있지 않다. 현재 research preview 상태임을 공식 docs가 명시하고 있다.

활성화 방법은 두 가지다.

  1. Shift+Tab으로 순환하여 Auto Mode 선택
  2. ~/.claude/settings.json에서 기본값으로 지정:
// ~/.claude/settings.json
{
  "permissions": {
    "defaultMode": "auto"
  }
}

출처: Claude Code 공식 docs — Permission modes guide (/docs/en/permission-modes)

★ 우리 다중 에이전트 시스템 적용 시사점

이 섹션은 공식 docs 동작 설명을 바탕으로 한 활용 전망이다. Auto Mode가 research preview 단계여서 분류기의 정확한 판단 기준이 아직 공개되지 않은 부분이 있다. 검증 결과는 Auto Mode 심층편에서 다룬다.

현재 이 블로그의 에이전트 파이프라인은 editorial-pipeline.sh가 각 에이전트 세션을 순차 호출하는 구조다. 세션마다 파일 쓰기·git add·git commit 등의 권한 프롬프트가 반복 발생한다.

Auto Mode의 분류기가 파일 쓰기를 “안전”, 대규모 삭제 명령을 “파괴적”으로 분류해준다면, 파이프라인 자동화 세션에서 인터럽트 빈도를 줄일 수 있다. 단, 분류 기준이 문서화되지 않은 영역이 있으므로 지금 바로 프로덕션에 적용하기보다는 현시점에서 활용 가능한 범위(단일 세션 자동화, 개발 전용 환경)로 시작하고, 분류 경계는 심층편에서 추가 검증할 예정이다.

Conditional Hooks (v2.1.85) ★★★

공식 docs 동작

v2.1.85에서 hooks에 if 필드가 추가됐다. 문법은 permission rule 문법을 그대로 따른다.

기존에는 PreToolUse 훅이 모든 Bash 호출마다 발동했다. if 조건을 쓰면 특정 패턴에 매칭되는 호출에만 훅이 실행된다. 공식 docs 예시는 pre-commit 체크를 Bash(git commit *) 호출에만 발동시키는 것이다.

아래 설정은 hooks 배열 안에 if 필드를 추가하는 구조다. PreToolUse 아래 훅 배열이 한 번 더 중첩되는데, 각 훅 항목에 if 조건이 붙는 방식이다.

// .claude/settings.json
{
  "hooks": {
    "PreToolUse": [{
      "hooks": [{
        "if": "Bash(git commit *)",
        "type": "command",
        "command": ".claude/hooks/lint-staged.sh"
      }]
    }]
  }
}

이 설정에서 lint-staged.sh는 git commit 명령이 실행될 때만 기동한다. 다른 모든 Bash 호출에서는 훅 프로세스가 생성되지 않아 바쁜 세션의 프로세스 오버헤드가 줄어든다고 공식 docs가 설명한다.

설정 위치: .claude/settings.json → hooks.PreToolUse[].hooks[].if

출처: Claude Code 공식 docs — Hooks reference (/docs/en/hooks)

★ 우리 hooks 범위 좁히기 시사점

현재 운영 중인 editorial-pipeline.sh에는 파일 쓰기·git 작업·로그 기록 등 다양한 Bash 명령이 혼재한다. 모든 Bash 호출에 훅이 붙어 있으면, 파일 하나 쓸 때마다 보안 검증 스크립트가 실행되는 낭비가 발생할 수 있다.

if: "Bash(git commit *)" 패턴처럼 범위를 좁히면 git 커밋 전 lint·무결성 검사만 선택적으로 발동시킬 수 있다. API 키 마스킹 체크나 frontmatter 유효성 검사를 특정 명령 전에만 걸도록 설정하는 방식을 Conditional Hooks 심층편에서 구체적으로 검증할 예정이다.

Transcript Search (v2.1.83) ★

공식 docs 동작

v2.1.83에서 transcript 모드에 검색 기능이 추가됐다. 키 시퀀스는 다음과 같다.

Ctrl+O      # transcript 모드 열기
/migrate    # 검색어 입력 (예: "migrate")
n           # 다음 매치로 이동
N           # 이전 매치로 이동

메시지가 수백 개 쌓인 긴 세션에서 Claude가 실행한 Bash 명령을 찾아야 할 때 활용할 수 있다. 공식 docs는 이 기능을 “fullscreen” 모드의 일부로 분류하고 있다.

출처: Claude Code 공식 docs — Fullscreen guide (/docs/en/fullscreen#search-and-review-the-conversation)

시사점

파이프라인 디버깅 시 특정 에러 메시지나 커밋 해시를 대화 중에서 재확인하는 데 즉시 활용 가능하다. CLI 외부 도구 없이 / 키만으로 검색이 되므로 학습 비용이 낮다.

참고: Desktop·Web·Windows 전용 기능 현황

이번 Week 13에는 현재 CLI 환경에서 직접 사용할 수 없는 기능 세 가지가 포함됐다. 상태를 정확히 고지한다.

Computer use (Desktop 전용)

Claude Code Desktop 앱에서만 동작한다. 실제 데스크톱 제어(네이티브 앱 열기, iOS 시뮬레이터 클릭, 하드웨어 제어판 조작, 화면 변경 검증)를 Claude에게 위임할 수 있다. 기본 off 상태이며 각 동작 전 사용자 확인을 요청한다. API가 없는 앱이나 GUI 전용 도구에 적합하다고 공식 docs가 설명한다.

현재 CLI 환경: 미제공 (Desktop 앱 전용)

출처: Claude Code 공식 docs — Computer use guide (/docs/en/desktop#let-claude-use-your-computer)

PR auto-fix (Web 전용)

Claude Code Web에서 PR 생성 후 CI 패널의 “Auto fix” 토글을 켜면, Claude가 CI를 감시하고 실패를 수정하며 lint 지적을 처리해 green 상태까지 자동으로 push한다.

현재 CLI 환경: 미제공 (Claude Code Web 전용)

출처: Claude Code 공식 docs — Auto-fix pull requests (/docs/en/claude-code-on-the-web#auto-fix-pull-requests)

PowerShell tool (preview, Windows 전용, v2.1.84)

Windows 환경에서 Bash 도구와 함께 네이티브 PowerShell 도구를 제공한다. cmdlet 실행, 객체 파이프, Windows 네이티브 경로 처리가 Git Bash 경유 없이 가능하다. 현재 preview 상태이며 opt-in으로 활성화한다.

// .claude/settings.json
{
  "env": {
    "CLAUDE_CODE_USE_POWERSHELL_TOOL": "1"
  }
}

현재 CLI 환경: 미제공 (Windows 전용 + preview)

출처: Claude Code 공식 docs — PowerShell tool docs (/docs/en/tools-reference#powershell-tool)

그 외 소소한 개선 (Other wins 발췌)

이번 주 릴리스에는 위 6개 주요 기능 외에도 소소한 개선이 다수 포함됐다. 그중 파이프라인 운영과 관련 있는 것들을 골라 짧게 언급한다.

  • managed-settings.d/ 드롭인 디렉토리: 팀마다 다른 설정을 각자 파일로 쪼개서 관리할 수 있게 됐다. 팀별 정책 분리에 유용하다.
  • 에이전트 frontmatter initialPrompt: 에이전트 헌법 파일에 initialPrompt를 선언하면 첫 번째 턴이 자동 제출된다. 에이전트 세션 시작 자동화에 활용 가능한 항목이다.
  • CwdChanged·FileChanged 훅 이벤트: 작업 디렉토리 변경이나 파일 변경 시점에 훅을 발동할 수 있다. direnv 스타일 환경 자동화에 적합하다.
  • 응답 전 인터럽트 시 입력 복원: Claude가 응답하기 전에 Ctrl+C로 취소해도 입력이 사라지지 않는다.
  • 75분 이상 자리 비울 경우 /clear 넛지: 장시간 세션 이탈 후 복귀 시 /clear로 컨텍스트를 초기화하도록 안내한다.

정리

Week 13의 핵심은 권한 자동화와 훅 최적화다. Auto Mode는 research preview 단계이므로 프로덕션 적용 전 동작 범위 확인이 필요하다. Conditional Hooks는 v2.1.85에서 정식 추가된 기능으로, 지금 바로 .claude/settings.json에 if 조건을 추가하는 것이 가능하다. Transcript Search는 메시지가 수백 개 쌓인 긴 세션 디버깅에서 바로 쓸 수 있는 실용적인 개선이다.

이 시리즈의 다른 주차 브리핑은 Claude Code 주간 브리핑 시리즈 전체 목록에서 확인할 수 있습니다.

출처: 이 글은 Claude Code 공식 docs (code.claude.com) Week 13 릴리스 노트 및 Changelog v2.1.83~v2.1.85를 기반으로 작성됐다.

  • Claude Code Changelog v2.1.83~v2.1.85: https://code.claude.com/docs/en/changelog#2-1-83
  • Permission modes guide: https://code.claude.com/docs/en/permission-modes
  • Hooks reference: https://code.claude.com/docs/en/hooks
  • Fullscreen guide: https://code.claude.com/docs/en/fullscreen#search-and-review-the-conversation
Tags: