Claude Code 주간 브리핑 Week 14 — CLI Computer Use·Flicker-free 렌더링

hiwony7933 6월 3, 2026 3 min read

시리즈: 이 글은 시리즈의 일부다. 전체 목록은 Claude Code 주간 브리핑 시리즈(Week 1~14 아카이브)에서 확인할 수 있다.

Week 14 개요 — v2.1.86~v2.1.91, 3/30~4/3

지난주 Auto Mode·Conditional Hooks가 권한 제어와 훅 최적화에 집중했다면, 이번 주는 CLI의 물리적 제어 범위가 확장됐다. 2026년 3월 30일부터 4월 3일까지 v2.1.86~v2.1.91 업데이트에서 5개 feature가 릴리스됐다.

이번 주의 큰 줄기는 다섯 방향이다. 첫째, Plugin executables on PATH(v2.1.91) — 플러그인 bin/ 디렉토리를 Bash 도구 PATH에 자동 추가. 둘째, CLI Computer use(research preview) — Desktop 앱에 이어 CLI에서도 GUI 앱을 직접 제어. 셋째, /powerup(v2.1.90) — 터미널 안에서 Claude Code 기능을 애니메이션 데모로 익히는 인터랙티브 레슨. 넷째, Flicker-free 렌더링(v2.1.89) — 긴 대화에서 화면 깜빡임과 마우스 선택 문제 해결. 다섯째, MCP per-tool result-size override(v2.1.91) — MCP 서버 작성자를 위한 도구별 결과 크기 제어.

아래에서 활용 우선순위(★★ → ★) 순서로 각 기능을 정리한다.

Plugin executables on PATH ★★ — 즉시 적용 권장 (v2.1.91)

공식 docs 동작

v2.1.91에서 플러그인 루트에 bin/ 디렉토리를 두면, 해당 플러그인이 활성화된 동안 Claude Code가 그 디렉토리를 Bash 도구의 PATH에 자동 추가한다. 공식 docs에 따르면 이 덕분에 Claude는 Bash 도구 호출에서 해당 바이너리를 절대경로나 래퍼 스크립트 없이 bare 명령으로 바로 실행할 수 있다.

플러그인 구조는 다음과 같다.

my-plugin/
├── .claude-plugin/
│   └── plugin.json
└── bin/
    └── my-tool

공식 docs는 이 방식이 commands·agents·hooks 옆에 CLI 헬퍼를 함께 패키징하는 데 유용하다고 설명한다.

출처: Claude Code 공식 docs — Plugins reference (https://code.claude.com/docs/en/plugins-reference#file-locations-reference)

★★ 이 블로그의 파이프라인 적용 시사점

이 섹션은 공식 docs 동작 설명을 바탕으로 한 활용 전망이다. 실제 파이프라인 통합 결과는 심층편에서 검증할 예정이다.

현재 이 블로그의 파이프라인은 editorial-pipeline.sh·guard.sh 등 CLI 헬퍼를 절대경로로 참조하는 구조다. Plugin executables on PATH를 활용하면 이 헬퍼들을 플러그인 bin/ 아래에 패키징해 bare 명령으로 호출하는 구조로 단순화할 수 있다. commands·agents·hooks와 같은 플러그인 안에 헬퍼 바이너리까지 묶어두면 경로 관리와 이식성이 함께 개선될 것으로 전망된다. 심층편에서 검증 예정.

CLI Computer use (research preview) ★

공식 docs 동작

지난주 Desktop 앱에 들어온 computer use가 이번 주 CLI에도 도착했다. 공식 docs에 따르면 CLI에서 Claude가 네이티브 앱을 열고, UI를 클릭하고, 변경 결과를 직접 테스트하고, 문제가 생기면 수정하는 것이 가능해졌다.

공식 docs는 배경을 다음과 같이 설명한다. 웹 앱은 이미 검증 루프(verification loop)가 있었지만, 네이티브 iOS·macOS 및 기타 GUI 전용 앱에는 이런 루프가 없었다. CLI computer use는 그 빈자리를 채운다. API가 없는 앱이나 도구의 루프를 닫는 데 적합하다고 공식 docs가 설명한다.

활성화 방법은 /mcp 명령을 실행해 computer-use 항목을 찾아 토글을 켜는 것이다. 공식 docs 예시 프롬프트는 아래와 같다.

> Open the iOS simulator, tap through onboarding, and screenshot each step

현재 상태: research preview. 공식 docs는 아직 초기 단계(still early)이며 거친 부분(rough edges)이 있음을 명시하고 있다. features.md 분류상 macOS 권한 셋업이 필요한 조건부 PoC에 해당한다.

출처: Claude Code 공식 docs — Computer use guide (https://code.claude.com/docs/en/computer-use)

★ 이 블로그의 파이프라인 적용 시사점 (전망)

이 섹션은 공식 docs 동작 설명을 바탕으로 한 활용 전망이다. CLI computer use가 research preview 단계이므로 현시점 프로덕션 적용 전 동작 범위 확인이 필요하다.

API가 없는 GUI 도구의 검증 루프를 닫을 수 있다는 점은 자동화 파이프라인 관점에서 흥미로운 가능성이다. 단, research preview임을 감안해 심층편에서 macOS 권한 셋업 포함 동작 범위를 검증할 예정이다.

/powerup (v2.1.90) ★

공식 docs 동작

v2.1.90에서 /powerup이 추가됐다. 공식 docs에 따르면 터미널 안에서 애니메이션 데모를 통해 Claude Code 기능을 가르치는 인터랙티브 레슨이다.

공식 docs는 배경을 이렇게 설명한다. Claude Code는 자주 릴리스되기 때문에 지난달 작업 방식을 바꿨을 기능이 사용자에게 알려지지 않은 채 지나치기 쉽다. /powerup 한 번이면 어떤 기능이 추가됐는지 파악할 수 있다.

실행은 단순하다.

> /powerup

출처: Claude Code 공식 docs — Commands reference (https://code.claude.com/docs/en/commands)

★ 시사점

잦은 업데이트 속에서 놓친 기능을 빠르게 파악하는 데 특히 유용하다. 주간 브리핑 시리즈와 병행해 사용하면 릴리스 흐름을 터미널 안에서도 따라갈 수 있다.

Flicker-free 렌더링 (v2.1.89) ★

공식 docs 동작

v2.1.89에서 virtualized scrollback을 갖춘 새 alt-screen 렌더러가 opt-in으로 제공된다. 공식 docs에 따르면 이 렌더러를 활성화하면 세 가지가 달라진다.

프롬프트 입력이 화면 하단에 고정된다
긴 대화에서 마우스 선택이 동작한다
리드로우 시 깜빡임이 사라진다

활성화 방법은 env var를 설정하고 Claude Code를 재시작하는 것이다.

export CLAUDE_CODE_NO_FLICKER=1
claude

사용해보다가 원래대로 돌리고 싶으면 CLAUDE_CODE_NO_FLICKER env var를 unset하면 롤백된다고 공식 docs가 명시한다.

출처: Claude Code 공식 docs — Fullscreen rendering (https://code.claude.com/docs/en/fullscreen)

MCP result-size override (v2.1.91) — 자체 MCP 서버 필요

공식 docs 동작

v2.1.91에서 MCP 서버 작성자는 특정 도구의 truncation cap을 per-tool로 올릴 수 있게 됐다. 공식 docs에 따르면 tools/list 항목에 anthropic/maxResultSizeChars를 설정하면 되며, 하드 상한은 500K자다.

기존에는 cap이 전역(global)이어서 DB 스키마나 전체 파일 트리처럼 본래 큰 페이로드를 가끔 반환하는 도구가 기본 한도에 걸려 디스크에 파일 참조로 저장됐다. per-tool override를 쓰면 정말 필요한 도구의 결과를 inline으로 유지할 수 있다고 공식 docs가 설명한다.

tools/list 응답의 예시는 다음과 같다.

{
  "name": "get_schema",
  "description": "Returns the full database schema",
  "_meta": {
    "anthropic/maxResultSizeChars": 500000
  }
}

현재 상태: features.md 분류상 불가(자체 MCP 서버 필요). MCP 서버를 직접 운영하는 경우에 한해 적용 가능하며, 현재 이 블로그의 파이프라인에서는 직접 적용 대상이 아니다.

출처: Claude Code 공식 docs — MCP reference (https://code.claude.com/docs/en/mcp#raise-the-limit-for-a-specific-tool)

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

이번 주 릴리스에는 위 주요 기능 외에도 파이프라인 운영과 연관된 개선이 다수 포함됐다. 공식 docs 표현 그대로 소개한다.

PermissionDenied 훅: 분류기가 거부할 때 발동하는 새 훅. retry: true를 반환하면 Claude가 다른 접근 방식을 시도한다. /permissions → Recent에서 r 키로 수동 재시도도 가능하다.
PreToolUse 훅의 defer permissionDecision: -p 세션이 tool call 시점에 멈추고 deferred_tool_use 페이로드와 함께 종료한다. SDK 앱이나 커스텀 UI가 이를 받아 처리한 뒤 --resume으로 재개하는 방식으로 활용할 수 있다.
disableSkillShellExecution 설정: skills·slash commands·plugin commands의 inline shell 실행을 차단한다.
Edit 도구의 참조 범위 확장: cat 또는 sed -n으로 본 파일을 별도 Read 없이 Edit 도구로 편집할 수 있다.
50K 초과 훅 출력 처리: 훅 출력이 50K를 초과하면 컨텍스트 주입 대신 디스크에 저장하고 경로와 미리보기만 전달한다.
/buddy: 코딩 중 화면을 지켜보는 작은 생물 소환 — 4월 1일 만우절 항목으로 공식 changelog에 그대로 실린 내용이다.

정리

Week 14의 핵심은 CLI 제어 범위 확장과 터미널 UX 개선이다. Plugin executables on PATH와 Flicker-free 렌더링, /powerup은 현재 바로 적용하거나 실행 가능하다. CLI Computer use는 research preview 단계이므로 macOS 권한 셋업을 포함한 동작 범위를 먼저 확인하는 것이 좋다. MCP result-size override는 자체 MCP 서버를 직접 운영하는 경우에만 해당하며, 현재 이 블로그의 파이프라인에서는 직접 적용 대상이 아니다.