claudekit / updates / claude-code-2-1-181
[ PATCH · ]

Claude Code 2.1.181

프롬프트에서 `/config thinking=false`처럼 임의의 설정을 바로 지정하는 `/config key=value` 문법이 추가됐습니다(인터랙티브, `-p`, Remote Control 모두 지원). 컴퓨터 앞에 있을 때 모바일 푸시를 끄는 `CLAUDE_CLIENT_PRESENCE_FILE` 환경변수, 번들 Bun 1.4 업그레이드, 긴 문단을 줄 단위로 바로 보여주는 스트리밍 개선도 들어왔습니다. 시작 회귀(약 120ms), 느린 네트워크에서 빈 터미널로 최대 15초 멈춤, 네트워크 드라이브에서 0바이트 파일 생성, 커스텀 `ANTHROPIC_BASE_URL`과 Foundry에서 프롬프트 캐싱이 읽히지 않던 문제, macOS error -600 인증 실패 등 시작, 파일 쓰기, 인증, 렌더링 전반의 버그 수정이 대거 포함됐습니다.

Claude Code
공식 발표 →

이 글은 공식 문서를 바탕으로 요약·정리한 내용입니다.

무엇이 바뀌었나?

Claude Code 2.1.181이 2026년 6월 17일 출시됐습니다. 프롬프트에서 바로 설정을 바꾸는 /config key=value 문법이 추가되고, 스트리밍, 서브에이전트 패널, 자동 재시도 같은 사용성 개선이 들어왔습니다. 여기에 시작 속도, 파일 쓰기, 인증, 자격 증명, 터미널 렌더링 전반의 회귀와 버그가 대거 정리됐습니다.

새 기능

  • /config key=value로 프롬프트에서 설정 변경

    설정 하나를 바꾸려면 전용 슬래시 명령이나 설정 파일을 거쳐야 했습니다. 이제 /config thinking=false처럼 프롬프트에서 임의의 설정을 직접 지정할 수 있고, 인터랙티브, -p, Remote Control 모두에서 동작합니다.

  • CLAUDE_CLIENT_PRESENCE_FILE 환경변수

    컴퓨터 앞에 있어도 모바일 푸시 알림이 계속 도착했습니다. 이 환경변수를 마커 파일에 연결하면, 자리에 있는 동안 모바일 푸시 알림을 억제합니다.

  • sandbox.allowAppleEvents 옵트인 설정

    샌드박스 명령은 macOS에서 Apple Events를 보낼 수 없었습니다. 새 sandbox.allowAppleEvents 설정을 켜면 샌드박스 명령이 Apple Events를 전송할 수 있습니다.

주요 개선

  • Bun 런타임 1.4로 업그레이드

    번들된 Bun 런타임이 1.4로 올라갔습니다.

  • 긴 문단 스트리밍 개선

    긴 문단은 첫 줄바꿈이 나올 때까지 텍스트가 표시되지 않고 대기했습니다. 이제 줄 단위로 바로 나타납니다.

  • thinking 중 연결 끊김 자동 재시도

    thinking 도중 API 연결이 끊기면 “Connection closed while thinking”만 표시되고 멈췄습니다. 이제 자동으로 재시도합니다.

  • 서브에이전트 패널 개선

    서브에이전트 목록이 쌓이면 화면을 차지하고 조작 힌트도 보이지 않았습니다. 유휴 서브에이전트는 30초 후 자동으로 숨겨지고, 목록은 5행으로 제한되며 스크롤 힌트가 붙고, 푸터에 키보드 힌트가 표시됩니다.

  • MCP OAuth 브라우저 페이지 개선

    MCP OAuth 인증 페이지가 Claude Code의 비주얼 스타일과 어울리지 않았고 수동으로 닫아야 했습니다. 이제 스타일을 맞추고 성공 시 자동으로 닫힙니다.

  • 전체화면 모드 URL 열기에 Cmd/Ctrl+클릭 요구

    전체화면 모드에서 URL이 단순 클릭으로 열려 네이티브 터미널 동작과 달랐습니다. 이제 macOS는 Cmd+클릭, 그 외는 Ctrl+클릭을 요구해 네이티브 터미널과 맞춥니다.

  • Improved N memories 줄 간소화

    메모리 정리 줄이 개별 파일을 모두 나열해 길어졌습니다. 이제 verbose 모드 밖에서는 개별 파일을 나열하지 않습니다.

주요 버그 수정

시작

  • 새 환경 시작 회귀(약 120ms) — 2.1.169에서 들어온 회귀로, MCP 서버가 없을 때도 첫 프롬프트가 managed-settings 가져오기를 기다렸습니다. 이제 MCP 서버가 설정되지 않았으면 기다리지 않습니다.
  • 느린 네트워크에서 빈 터미널로 최대 15초 멈춤 — 계정 설정 가져오기가 느릴 때 시작이 빈 화면으로 차단되던 문제 수정.
  • 손상된 .claude.json으로 인한 시작 크래시 — .claude.json에 손상된 null 프로젝트 항목이 있으면 TypeError: Cannot read properties of null로 크래시하던 문제 수정.
  • Spotlight 재색인 중 macOS TUI 멈춤 — Spotlight가 재색인 중일 때 세션 시작에서 TUI가 멈춰 Ctrl+C도 듣지 않던 문제 수정.

세션과 모델

  • 유휴 세션 기록 손실 — 다른 Claude Code 프로세스가 30일 트랜스크립트 정리를 실행하면 장시간 유휴 세션이 기록을 잃던 문제 수정.
  • 모델 전환 직후 /recap과 포크가 이전 모델 사용 — 모델을 바꾼 직후에도 /recap과 대화 포크가 이전 모델을 쓰던 문제 수정.
  • 커스텀 ANTHROPIC_BASE_URL과 Foundry에서 프롬프트 캐싱 미적용 — 매 턴 바뀌는 요청별 attestation 토큰 때문에 프롬프트 캐시가 읽히지 않던 문제 수정.
  • 재시도 성공 후에도 남던 재시도 표시 — “Retrying in 0s · attempt N/10” 표시가 재시도가 성공한 뒤에도 화면에 남던 문제 수정.

서브에이전트

  • 포그라운드 서브에이전트 무한 중첩 — 포그라운드 서브에이전트가 제한 없이 중첩 체인을 만들던 문제 수정. 이제 백그라운드 서브에이전트와 동일하게 5단계 깊이 제한을 따릅니다.
  • 서브에이전트 “Thinking” 시간이 부모 시간 표시 — 서브에이전트의 Thinking 경과 시간이 자신이 아니라 부모 에이전트의 경과 시간을 보여주던 문제 수정.
  • 중첩 에이전트 대기 중 시간 표시 — 중첩 에이전트에서 막힌 서브에이전트가 agent panel에 “waiting” 대신 경과 시간을 계속 올리던 문제 수정.

인증과 자격 증명

  • macOS error -600 (open, osascript, 브라우저 인증) — open, osascript, 브라우저 기반 인증 흐름이 macOS에서 error -600으로 실패하던 문제를 Apple Events 엔타이틀먼트 추가로 수정.
  • AWS awsCredentialExport 잦은 갱신 — 남은 수명이 짧은 자격 증명이 매분 갱신을 일으키던 문제 수정. 이제 aws configure export-credentials의 JSON 형태도 받습니다.

MCP와 원격 제어

  • claude mcp get/list의 잘못된 Connected 표시 — tools/list가 실패해도 ✓ Connected로 보이던 문제 수정. 이제 ! Connected · tools fetch failed로 오류 내용과 함께 표시됩니다.
  • /remote-control의 stale “connecting…” 줄 — 연결된 뒤에도 “connecting…” 줄이 남던 문제 수정. 이제 연결되면 트랜스크립트에 확정 표시됩니다.

파일과 설정

  • 네트워크 드라이브에서 0바이트, 잘린 파일 — Write/Edit가 네트워크 드라이브와 클라우드 동기화 폴더에서 0바이트 또는 잘린 파일을 만들던 문제 수정.
  • Windows에서 ExitWorktree 거부 — bare git을 찾지 못할 때 깨끗한 워크트리도 “Could not verify worktree state”로 제거를 거부하던 문제 수정.
  • 에이전트 생성 시 EEXIST (Windows/OneDrive) — 에이전트 디렉토리가 이미 있으면 “EEXIST: file already exists”로 생성이 실패하던 문제 수정.
  • 심링크 설정에서 ENOENT — ~/.claude/settings.json이 심링크된 ~/.claude 아래 상대 심링크일 때 /effort, /model 같은 설정 변경이 ENOENT로 실패하던 문제 수정.

입력과 클립보드

  • 전체화면 Ctrl+C가 클립보드 덮어쓰기 — 네이티브 터미널 선택(모디파이어+드래그) 후 전체화면에서 Ctrl+C를 누르면 앱의 이전 선택으로 클립보드를 덮어쓰던 문제 수정.
  • Ctrl+V 텍스트 붙여넣기 — 클립보드에 텍스트가 있을 때 붙여넣지 않고 “No image found in clipboard”를 표시하던 문제 수정.
  • Linux 클립보드 유틸 감지 — Claude Code 시작 후 설치한 클립보드 유틸을 /copy와 copy-on-select가 감지하지 못하던 문제 수정.

표시와 렌더링

  • IDE 선택 줄 번호 1 차이 — 컨텍스트 알림의 IDE 선택 줄 번호가 1씩 어긋나던 문제(IntelliJ, VS Code) 수정.
  • AskUserQuestion 미리보기 잘림 — 미리보기 내용이 줄바꿈되지 않고 다이얼로그 가장자리에서 잘리던 문제 수정.
  • AskUserQuestion “Other” 입력 누락 — 다중 선택 질문에서 직접 입력한 “Other” 답변이 제출 시 조용히 사라지던 문제 수정.
  • /stats 날짜 하루 빠름 — UTC 음수 시간대에서 “Most active day”와 일일 토큰 차트 날짜가 하루 일찍 표시되던 문제 수정.
  • Write 미리보기 탭 들여쓰기 — 탭으로 들여쓴 코드가 Write(파일 생성) 미리보기에서 잘못된 들여쓰기로 렌더링되던 문제 수정.
  • 턴 중간 대기 프롬프트 강조 — 턴 중간에 큐에 들어간 사용자 프롬프트가 트랜스크립트에서 전체 너비 배경 강조를 받지 못하던 문제 수정.
  • Ghostty 스피너 글리프 — 활동 스피너의 펄스가 Ghostty에서 잘못된 글리프 크기에 머물던 문제 수정.

알아두면 좋은 점

  • /config는 어디서나 — /config key=value는 인터랙티브, -p, Remote Control 모두에서 동작합니다. 예: /config thinking=false.
  • macOS Apple Events 권한 — open, osascript, 브라우저 인증 흐름이 error -600으로 실패하던 문제는 Apple Events 엔타이틀먼트 추가로 해결됐습니다. 샌드박스 명령에서 Apple Events를 보내려면 sandbox.allowAppleEvents를 별도로 켜야 합니다.
  • 자리 비움 시 모바일 푸시 끄기 — CLAUDE_CLIENT_PRESENCE_FILE을 마커 파일에 연결하면, 컴퓨터 앞에 있는 동안 모바일 푸시 알림이 억제됩니다.
  • 포그라운드 서브에이전트도 5단계 제한 — 이제 백그라운드 서브에이전트와 동일하게 중첩 깊이가 5단계로 묶입니다.