Claude Code v2.1.261 — `/skill-doctor`로 안 쓰는 스킬 비용까지 본다

Claude Code에 스킬마다 얼마나 컨텍스트를 잡아먹는지 보여주는 의사 선생님이 들어왔습니다. v2.1.261은 성능·디버깅 편의성을 크게 올린 알찬 업데이트입니다.

한마디로 말하면, 안 쓰는 스킬을 찾아 정리하는 /skill-doctor, 커맨드 출력 한도를 128K까지 올리는 설정, 조직 정책 진단이 추가되고, 빠른 타이핑 중 글자가 섞이는 버그까지 잡힌 릴리스입니다.

눈에 띄는 신기능 3가지

/skill-doctor — 스킬 정리의 시대: 로드된 스킬 중 실제로 안 쓰는 것과 각각이 컨텍스트에 얼마나 비용을 지불하는지 보여줍니다. 스킬을 열두 개씩 깔아 쓰는 파워 유저라면 이 명령 하나로 컨텍스트 낭비를 줄일 수 있습니다. 마치 의존성 패키지 정리하듯 스킬도 주기적으로 진료해야 할 때가 온 거죠.

출력 한도 설정: bashOutputMaxChars와 taskOutputMaxChars 설정으로 명령·백그라운드 작업 출력을 파일로 넘기기 전에 Claude가 인라인으로 받는 양을 최대 128K 문자까지 늘릴 수 있습니다. 긴 빌드 로그나 테스트 결과를 매번 파일 열어보던 분들에게 반가운 변화입니다.

조직 정책 진단: /status와 claude doctor에 "Organization policy" 항목이 생겨, 조직 정책을 못 불러오는 이유(예: 프록시가 엔드포인트를 안 통과시킴)를 바로 알려줍니다. 사내 환경 디버깅 시간이 확 줄어듭니다.

버그 픽스도 알짜다

이번 릴리스는 픽스 품질이 좋습니다. 빠른 타이핑이나 키 반복 입력 시 글자가 순서가 섞이거나 유실되던 문제 — 터미널 도구치고는 치명적인 버그를 잡았습니다. 세션 재개 시 병렬 tool call 주변의 hook 출력이 사라지던 문제도 고쳐서, 재개된 세션이 원래 요청과 동일하게 유지됩니다.

Remote Control 쪽도 두 건 정리됐습니다. 폰이나 브라우저에서 터미널 세션에 붙었을 때 오래된 permission mode를 보여주던 것, 그리고 폰에서 정지시켰는데 터미널엔 스피너가 계속 돌던 유령 작업 표시가 사라졌습니다.

실전에서 어떻게 쓸까?

먼저 /skill-doctor를 한 번 돌려보세요. 설치만 하고 잊고 있던 스킬이 몇 개 나올 겁니다. 대규모 로그를 다루는 CI 디버깅이라면 bashOutputMaxChars를 올려두고, 회사 프록시 뒤에서 Bedrock을 세팅한다면 이제 위저드가 멈추는 대신 명확한 타임아웃 에러를 줍니다.

에이전트 파이프라인 만드는 개발자라면 --append-subagent-system-prompt-file도 눈여겨볼 만합니다. 긴 서브에이전트 시스템 프롬프트를 파일로 넘길 수 있어져서 CLI 인자 길이 제한에서 해방됩니다.

컨텍스트 비용 가시화가 이번 릴리스의 핵심입니다. 스킬·출력·정책 모두 "눈에 보이게" 만들었다는 방향성이 좋습니다. /skill-doctor 돌리는 습관, 지금부터 들이세요.

출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.261

태그: AI Claude Claude Code 개발도구