IT/AI
Claude Code 2.1.84, 되는 것과 안 되는 것
2026년 3월 26일, Claude Code 2.1.84가 배포됐습니다. 핵심은 Windows PowerShell 네이티브 지원, MCP 도구 설명 2KB 상한, 75분 유휴 후 /clear 안내 — 이 세 가지입니다. 그런데 공식 문서를 직접 읽어보면 “된다”는 말 뒤에 조건이 하나씩 붙어 있습니다.
(공식 문서 기준)
(Tool Search 활성화 시)
유휴 기준 시간
Windows PowerShell 지원 — 진짜 쓰려면 조건이 있습니다
Claude Code 2.1.84의 가장 눈에 띄는 변화는 Windows에서 PowerShell을 네이티브 도구로 쓸 수 있게 됐다는 점입니다. 지금까지 Windows 사용자들은 Git Bash를 통해서만 명령을 실행할 수 있었는데, 이제 settings.json에 환경 변수 하나를 추가하면 PowerShell 도구가 활성화됩니다. (출처: code.claude.com, 공식 Tools Reference)
settings.json에 아래 추가:
{ "env": { "CLAUDE_CODE_USE_POWERSHELL_TOOL": "1" } }
그런데 공식 문서 하단에 “Preview limitations” 항목이 따로 있습니다. 여기서 밝힌 미지원 조건이 정확히 4가지입니다.
- Auto mode 미지원 — 모델이 자동으로 도구를 선택하는 방식이 아직 비활성화
- PowerShell 프로필 미로드 — 사용자의
$PROFILE환경이 적용되지 않음 - 샌드박싱 미지원 — 보안 격리 없이 실행됨
- WSL 미지원 — 네이티브 Windows 전용, WSL에서는 동작하지 않음
실제 Reddit 커뮤니티에서도 비슷한 목소리가 나옵니다. Claude Code r/ClaudeCode에서 2026년 3월 22일 올라온 스레드에서 여러 사용자들이 “CC 스캐폴드 자체가 bash 중심이라 PowerShell을 써도 Claude가 자꾸 Bash 구문으로 교정한다”고 보고했습니다. 한 사용자는 “WSL2에서 소스 파일을 Linux 파티션으로 옮겼더니 빌드가 25% 빨라졌다”고 공유했는데, 이건 PowerShell 지원이 생겨도 환경 자체의 한계가 남아 있다는 뜻입니다. (출처: reddit.com/r/ClaudeCode, 2026.03.22)
결론적으로, PowerShell 도구는 .ps1 스크립트 실행이나 Get- cmdlet 위주의 작업에는 확실히 유용합니다. 다만 “Auto mode도 되겠지”라고 생각했다면 아직 안 됩니다.
MCP 2KB 상한 — 제한이 오히려 비용을 줄이는 이유
2.1.84에서 MCP 도구 설명과 서버 지시문에 2KB 상한이 생겼습니다. 언뜻 보면 기능 제약처럼 보이지만, 이게 왜 도입됐는지를 따져보면 이야기가 달라집니다. (출처: code.claude.com/docs/en/changelog, v2.1.84)
MCP 서버를 여러 개 연결하면 각 서버의 도구 정의가 전부 컨텍스트 창으로 올라옵니다. 도구 이름, 설명, JSON 스키마, 파라미터 타입까지 포함하면 서버 하나에 수천 토큰이 들어가고, 4개만 연결해도 67,000토큰이 사라진다는 케이스가 실제로 보고된 바 있습니다. MCP Tool Search가 도입되면서 이미 46.9%의 토큰을 절감했는데 — 51,000토큰에서 8,500토큰 수준으로 — 이번 2KB 제한은 그 다음 단계입니다. 특히 OpenAPI로 자동 생성된 서버들이 도구 설명을 필요 이상으로 길게 만드는 경향이 있어서, 이 제한이 없으면 클라이언트가 제어할 방법이 없었습니다.
같은 버전에서 MCP 관련 변경이 하나 더 있었습니다. 로컬 설정과 claude.ai 커넥터에 동시에 등록된 서버가 있으면 로컬 설정이 우선되고 중복이 제거됩니다. 이전까지는 같은 서버가 두 번 연결되면서 도구 목록이 중복으로 올라가는 경우가 있었는데, 이게 자동으로 처리됩니다.
| 구분 | 2.1.84 이전 | 2.1.84 이후 |
|---|---|---|
| MCP 도구 설명 길이 | 제한 없음 | 최대 2KB |
| 중복 서버 처리 | 수동 제거 필요 | 자동 중복 제거(로컬 우선) |
| 재연결 시 캐시 | 캐시 누수 발생 | 누수 수정됨 |
75분 유휴 안내 — UX가 아니라 돈 얘기입니다
이번 업데이트에서 눈길이 가는 기능 중 하나가 “75분 이상 자리를 비운 뒤 돌아오면 /clear를 권유하는 안내 메시지”입니다. 얼핏 보면 사용자 편의를 위한 UX 개선처럼 보이지만, 공식 문서가 설명하는 이유를 읽으면 다릅니다.
Claude Code의 비용 최적화 공식 문서에는 이렇게 나옵니다. “Stale context wastes tokens on every subsequent message(오래된 컨텍스트는 이후 메시지마다 토큰을 낭비한다).” Claude의 프롬프트 캐시는 세션이 오래되면 만료됩니다. 이 상태로 계속 작업하면 이미 만료된 캐시를 처음부터 다시 생성하는 데 토큰이 소모되는데, 이걸 사용자에게 알리지 않으면 불필요한 비용이 쌓입니다. 75분이라는 기준은 바로 이 캐시 만료 타이밍과 연동됩니다. (출처: code.claude.com/docs/en/costs)
Claude Code 공식 문서 기준, 개발자 1인 평균 하루 약 $6, 월 100~200달러 비용이 발생합니다. 여기서 “오래된 세션 유지”로 발생하는 캐시 재생성 비용은 별도 측정이 어렵지만, 공식 문서는 스스로 “배경 프로세스 포함 세션당 최대 $0.04″라고 추정합니다. 하루에 3~4번 세션을 그냥 방치했다 돌아오면, 이 비용이 실제 코딩 비용과 맞먹는 수준이 될 수 있습니다.
같은 맥락에서, CLAUDE_STREAM_IDLE_TIMEOUT_MS라는 환경 변수도 새로 추가됐습니다. 스트리밍이 멈춘 것처럼 보일 때 타임아웃을 설정하는 변수로, 기본값은 90초입니다. 오래된 세션에서 연결이 끊기는 상황을 더 명확하게 제어할 수 있게 됩니다.
같은 날 배포된 2.1.85가 말해주는 것
흥미로운 점이 있습니다. 2.1.84는 3월 26일에 배포됐는데, 같은 날 2.1.85도 함께 배포됐습니다. 2.1.85의 내용을 보면 2.1.84에서 미처 처리하지 못한 항목들이 그대로 나열돼 있습니다. 예를 들어 PowerShell의 위험 명령 감지 개선, deniedMcpServers 설정이 claude.ai MCP 서버를 막지 못하던 버그 수정 등이 포함됩니다. (출처: code.claude.com/docs/en/changelog, v2.1.85)
2.1.85에서 특히 눈에 띄는 추가 사항은 Hook의 조건부 실행(if 필드)입니다. 기존에는 Hook이 매 이벤트마다 실행됐는데, 이제 권한 규칙 문법(Bash(git *) 형태)으로 조건을 걸 수 있습니다. 불필요한 프로세스 생성을 줄이는 데 직접적으로 효과가 있습니다.
그리고 /compact 명령이 컨텍스트 초과로 실패하던 버그도 수정됐습니다. 2.1.84를 쓰다가 “너무 커서 compact 자체가 안 된다”는 상황을 겪었다면, 2.1.85로 업데이트하면 됩니다.
한국어 사용자에게 직접 영향을 주는 변화
2.1.84의 버그 수정 중 한국어 사용자에게 바로 와닿는 항목이 있습니다. CJK 입력기 커서 추적 문제가 수정됐습니다. 터미널에서 한국어를 입력할 때 IME 조합 창이 실제 커서 위치가 아닌 엉뚱한 곳에 표시되던 현상이 고쳐졌습니다. 스크린 리더도 입력 위치를 정확히 추적할 수 있게 됐습니다. (출처: code.claude.com/docs/en/changelog, v2.1.84)
작은 수정처럼 보이지만, 실제로 터미널에서 한국어를 직접 입력하는 방식으로 Claude Code를 쓰는 경우라면 매번 불편함이 있었을 겁니다. 조합 중인 문자가 화면 한쪽에 뜨면서 현재 어떤 글자가 입력되고 있는지 파악하기 어렵던 문제입니다.
그 외에도 토큰 수 표시 방식이 바뀌었습니다. 100만 이상의 토큰 수가 "1512.6k" 대신 "1.5m"으로 표시됩니다. 숫자 가독성 측면의 변화지만, 1M 컨텍스트 창을 주로 쓰는 경우라면 /stats에서 확인할 때 훨씬 직관적입니다.
- IME 조합 중 커서 위치 오류 수정 → 한국어 입력 시 정상화
- 토큰 수 표시: 1512.6k → 1.5m (1M 이상)
- MCP 중복 제거로 한국어 MCP 서버 환경 안정성 향상
Q&A
Q. Claude Code 2.1.84로 업데이트하려면 직접 해야 하나요?
네이티브 설치(npm)는 백그라운드에서 자동 업데이트됩니다. Homebrew로 설치한 경우에는 자동 업데이트가 되지 않으므로 brew upgrade claude-code를 수동으로 실행해야 합니다. 현재 버전은 claude --version으로 확인 가능합니다. (출처: code.claude.com/docs/en/quickstart)
Q. PowerShell 도구를 켜면 기존 Bash 도구가 사라지나요?
아닙니다. 공식 문서에 “Bash 도구는 PowerShell 도구와 함께 등록된 상태를 유지한다”고 명시돼 있습니다. 두 도구가 동시에 활성화되기 때문에, Claude에게 PowerShell을 명시적으로 쓰도록 안내하지 않으면 Bash로 먼저 시도할 수 있습니다. CLAUDE.md에 선호 셸을 명시하는 게 좋습니다. (출처: code.claude.com/docs/en/tools-reference#powershell-tool)
Q. MCP 도구 설명이 2KB를 초과하면 어떻게 되나요?
공식 changelog에는 “2KB로 제한된다”고만 나와 있고, 초과분이 어떻게 처리되는지(잘림 vs. 오류)에 대해 Anthropic이 공식 답변을 내놓지 않은 부분입니다. OpenAPI 자동 생성 서버를 쓴다면 도구 설명을 직접 확인하고 필요 시 줄이는 것이 안전합니다.
Q. 75분 /clear 안내가 뜨면 반드시 /clear를 해야 하나요?
강제는 아닙니다. 그냥 이어서 작업할 수 있습니다. 다만 캐시가 만료된 상태에서 계속하면 이후 메시지마다 캐시를 재생성하는 데 토큰이 더 소모됩니다. 작업 흐름이 끊기지 않아야 한다면 그냥 넘기고, 새 작업으로 전환하는 타이밍이라면 /clear로 정리하는 게 비용 면에서 유리합니다. (출처: code.claude.com/docs/en/costs)
Q. 2.1.84와 2.1.85 중 어떤 버전을 써야 하나요?
2.1.85가 2.1.84의 버그 수정을 포함하고 있으므로 최신 버전인 2.1.85를 쓰는 것이 맞습니다. 특히 /compact 명령 오류, PowerShell 위험 명령 감지, deniedMcpServers 설정 문제가 2.1.85에서 수정됐습니다. 자동 업데이트가 설정돼 있으면 이미 반영됐을 가능성이 높습니다.
마치며
솔직히 말하면, 2.1.84의 핵심 변화는 크게 세 가지로 압축됩니다. Windows PowerShell 도구는 “프리뷰”라는 단어 뒤에 4가지 미지원 조건이 붙어 있고, MCP 2KB 제한은 제약처럼 보이지만 실제로는 비용 보호 장치에 가깝고, 75분 /clear 안내는 UX 편의가 아니라 불필요한 토큰 낭비를 줄이기 위한 기능입니다.
같은 날 2.1.85가 함께 나온 것도 기억해둘 만합니다. Anthropic이 하루에 두 버전을 내보낸다는 건 배포 속도가 상당히 빠르다는 뜻이기도 하고, 반대로 2.1.84에서 다 잡지 못한 부분이 있었다는 뜻이기도 합니다. 업데이트 주기를 따라가려면 공식 changelog를 주기적으로 확인하거나, claude --version으로 현재 버전을 체크해두는 습관이 필요합니다.
한국어 사용자라면 IME 커서 오류 수정이 가장 즉각적으로 체감되는 변화입니다. 터미널에서 한국어를 직접 입력하며 Claude Code를 써왔다면, 이번 업데이트 후 조합 입력이 정상 위치에서 표시되는 걸 확인할 수 있을 겁니다.
- Claude Code 공식 Changelog (code.claude.com)
- Claude Code Tools Reference — PowerShell tool (code.claude.com)
- Claude Code 비용 관리 공식 문서 (code.claude.com)
- Reddit r/ClaudeCode — “Claude code struggling with Windows” 스레드 (2026.03.22)
- Medium — “Claude Code Just Cut MCP Context Bloat by 46.9%” (2026.01.16)
본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. Claude Code는 지속적으로 업데이트되는 소프트웨어이며, 본문의 수치·기능·인터페이스는 v2.1.84~v2.1.85 기준(2026년 3월 26일)입니다. 최신 정보는 공식 문서(code.claude.com)에서 확인하세요.
댓글 남기기