Claude Code v2.1.181 신기능 및 버그 수정 정리 ─ /config 구문과 중대 버그 수정

Claude Code v2.1.181이 출시되었습니다. 이번 버전은 단순한 마이너 업데이트가 아니라, 일상적인 개발 작업에 직결되는 중대한 버그를 여러 개 수정한 중요한 릴리스입니다.

특히 주목해야 할 점은 다음 3가지입니다.

• 프롬프트에서 설정을 직접 변경할 수 있는 /config key=value 구문 추가
• 네트워크 드라이브나 OneDrive 환경에서 파일이 손상되는 문제 수정
• 실행 시 프리징(Freezing), 세션 이력 소실 등의 안정성 향상

📌 영향을 받는 사람

• Claude Code를 일상적으로 사용하는 모든 개발자
• 네트워크 드라이브, 클라우드 동기화 폴더(OneDrive, Dropbox 등)에서 파일을 편집하는 사람
• 커스텀 ANTHROPIC_BASE_URL이나 AWS Bedrock / Foundry를 사용하는 사람
• MCP 서버를 도입하거나 운용하고 있는 사람

이번 릴리스는 「신기능」, 「개선」, 「버그 수정」의 3가지 카테고리로 나뉩니다.

신기능

프롬프트에서 임의의 설정값을 직접 변경할 수 있게 되었습니다.

# 예: thinking 모드를 끔
/config thinking=false
# 예: 모델을 전환 (기존의 /model과 동일)
...

인터랙티브 모드(Interactive mode), -p 모드, 리모트 컨트롤(Remote control) 중 어느 것이든 동작합니다. 설정 파일을 수동으로 편집하는 번거로움을 줄이고, 대화 흐름 속에서 즉석에서 설정을 조정할 수 있다는 것이 큰 장점입니다.

마커 파일을 지정함으로써, 사용자가 컴퓨터 앞에 있는 동안에는 모바일로의 푸시 알림을 억제할 수 있습니다.

# .bashrc / .zshrc에 추가하는 예
export CLAUDE_CLIENT_PRESENCE_FILE="$HOME/.claude_presence"
# 세션 시작 시 마커를 생성
...

PC 앞에 있는데 스마트폰으로 알림이 오는 문제를 스스로 제어할 수 있습니다.

macOS 환경에서 샌드박스(Sandbox) 내의 명령어가 Apple Events를 보낼 수 있도록 하는 옵트인(Opt-in) 설정입니다. settings.json에서 활성화합니다.

항목	개요
Bun 1.4 업그레이드	동봉된 런타임(Runtime)을 최신 버전으로 업데이트. 퍼포먼스 및 안정성 향상
...

개선

여러 실행 문제가 동시에 수정되었습니다.

• 120ms 리그레션(Regression): v2.1.169에서 유입된 신규 환경에서의 실행 리그레션(매 실행 시 약 120ms의 추가 지연)을 수정
• 블랭크 화면 프리징(Blank screen freezing): 네트워크 환경이 악화되어 계정 설정 취득이 느릴 경우, 실행이 최대 15초간 차단되던 문제를 수정
• 실행 크래시(Crash): .claude.json에 손상된 null 엔트리가 있는 경우의 TypeError: Cannot read properties of null 크래시를 수정
• macOS TUI 프리징(Freezing): Spotlight 재인덱싱 중에 세션 시작 시 프리징(Ctrl+C 무반응)되는 문제를 수정

장시간 유휴(Idle) 상태인 세션에서, 별도 프로세스가 30일 치의 트랜스크립트(Transcript) 클린업을 실행하는 타이밍에 대화 이력이 사라지던 문제가 수정되었습니다. 여러 개의 Claude Code 창을 병행해서 사용하는 분들은 특히 혜택을 볼 수 있습니다.

버그 수정

⚠️ Breaking Change에 준하는 중대 버그

OneDrive, Dropbox, NAS 등의 클라우드 동기화 폴더나 네트워크 드라이브 상에서 Write/Edit를 실행하면, 0바이트 또는 파일 내용이 잘린(Truncated) 파일이 생성되는 경우가 있었습니다. 이번 버전에서 수정되었습니다.

대상 환경을 사용 중이며 과거에 파일이 손상된 경험이 있다면, 영향을 받은 파일을 git이나 기존 백업을 통해 확인하는 것을 권장합니다.

커스텀 ANTHROPIC_BASE_URL이나 Foundry 환경에서, 요청(Request)마다 바뀌는 인증 토큰(Auth token) 때문에 프롬프트 캐시(Prompt cache)가 작동하지 않던 문제가 수정되었습니다.

AWS Bedrock의 awsCredentialExport에서 잔존 유효 기간이 짧은 인증 정보가 매분 리프레시를 일으키던 문제도 함께 수정되었습니다.

claude mcp get / claude mcp list에서 tools/list 취득에 실패하더라도 ✓ Connected가 표시되도록 수정되었습니다.

라고 표시되던 오표시가 수정되었습니다.

수정 전:

✓ Connected

수정 후:

! Connected · tools fetch failed: <에러 상세>

MCP 서버 문제를 놓치고 있었던 분들에게는 중요한 개선입니다.

⚠️ Breaking Change

풀스크린 (Full-screen) 모드에서의 URL 오픈이 Cmd+클릭(macOS) / Ctrl+클릭(Windows·Linux) 필수 방식으로 변경되었습니다. 기존의 싱글 클릭으로는 URL이 열리지 않습니다.

네이티브 터미널과 동일한 동작으로 통일하는 것이 목적입니다. 적응이 필요하지만, 의도하지 않은 URL 전환을 방지하는 효과도 있습니다.

상황	대응
네트워크 드라이브·클라우드 동기화 폴더를 사용 중인 경우	v2.1.181 이후 버전으로 업데이트할 것을 강력히 권장. 과거에 생성된 파일 내용을 확인하십시오
풀스크린 모드에서 URL 클릭을 자주 사용하는 경우	Cmd/Ctrl+클릭으로 조작 방식을 전환하십시오
커스텀 ANTHROPIC_BASE_URL이나 Foundry를 사용하는 경우	업데이트 후 캐시 히트율(Cache hit rate)을 확인하여 비용 절감 효과를 확인하십시오
MCP 서버를 운영 중인 경우	연결 상태 표시가 변경됨을 숙지하고, 에러 상세 모니터링 플로우를 업데이트하십시오

# npm으로 설치한 경우
npm update -g @anthropic-ai/claude-code
# 버전 확인
...

# 사고 모드(Thinking mode)를 세션 중에만 끄기
/config thinking=false
# verbose 모드를 켜서 디버그 정보 확인하기
...

#!/bin/bash
# claude_session.sh - 프레즌스(Presence) 파일을 자동 관리하여 세션 시작
PRESENCE_FILE="$HOME/.claude_presence"
...

Claude Code v2.1.181의 주요 포인트를 정리합니다.

신기능: /config key=value를 통해 프롬프트에서 설정을 동적으로 변경할 수 있게 됨

중대 버그 수정: 네트워크 드라이브에서의 파일 손상, 실행 중 멈춤(Hang), 세션 히스토리 소실이라는 3대 문제가 해결됨

안정성 향상: 프롬프트 캐시(Prompt cache), API 자동 재시도(Retry), MCP 상태 표시 등 일상적으로 사용하는 기능의 신뢰성이 전반적으로 개선됨

파괴적 변경 (Breaking Change): 풀스크린 모드의 URL 오픈이 Cmd/Ctrl+클릭 필수 방식으로 변경됨

특히 네트워크 드라이브나 클라우드 동기화 환경을 사용하는 분들은 조속한 업데이트를 권장합니다. 그 외의 사용자들도 실행 안정성이나 세션 히스토리의 신뢰성 향상 혜택을 누릴 수 있는 중요한 업데이트입니다.

💡 Tips

claude --version으로 버전을 확인하고, v2.1.181 미만인 경우에는 npm update -g @anthropic-ai/claude-code로 업데이트하십시오.