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

Claude Code 2.1.178

`Tool(param:value)` 형태로 도구의 입력 파라미터까지 매칭하는 권한 규칙 문법이 추가되어 `Agent(model:opus)`처럼 Opus 서브에이전트만 선별 차단할 수 있습니다. 작업 중인 파일이 위치한 중첩 `.claude/skills`의 스킬도 자동으로 로드되며, 이름 충돌 시 `<dir>:<name>`으로 둘 다 유지됩니다. 부모 프로세스의 stale한 websocket/OAuth 파일 디스크립터 환경변수가 CLI를 OOM 크래시시키던 문제, `ANTHROPIC_BASE_URL`, `ANTHROPIC_AUTH_TOKEN`으로 시작된 데몬에서 `claude agents` 워커가 401로 실패하던 문제, compaction이 `--fallback-model` 체인을 따르지 않던 문제, 서브에이전트 `disallowedTools`의 MCP 서버 단위 명세가 조용히 무시되던 문제 등 인증, 서브에이전트, MCP, 백그라운드 세션 영역의 회귀가 폭넓게 정리되었습니다.

Claude Code
공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.178이 2026년 6월 15일(현지 시간) 릴리스되었습니다. 도구 입력 파라미터까지 매칭하는 Tool(param:value) 권한 문법과 중첩 .claude/skills의 작업 디렉터리 기반 자동 로드라는 두 가지 추가와 함께, 중첩 .claude/ 디렉터리 우선순위, auto 모드 서브에이전트 사전 분류, /doctor와 /bug UX, Remote Control 오류 메시지 등을 다듬은 릴리스입니다. 부모 프로세스로부터 상속된 stale한 환경변수가 CLI를 OOM으로 크래시시키던 문제, 커스텀 API 게이트웨이로 시작된 데몬에서 claude agents 워커가 인증으로 실패하던 문제, compaction이 --fallback-model을 무시하던 문제처럼 운영에 직접 영향을 주는 결함이 다수 포함되어 있습니다.

새 기능

  • Tool(param:value) — 도구 입력 파라미터까지 매칭하는 권한 규칙 문법

    기존 권한 규칙은 도구 이름까지만 매칭할 수 있어, 같은 도구라도 특정 파라미터 값일 때만 차단하거나 허용하고 싶은 경우 표현할 방법이 없었습니다. 이번 릴리스에서 Tool(param:value) 형태로 도구의 입력 파라미터까지 매칭할 수 있고 * 와일드카드도 지원됩니다. 예를 들어 Agent(model:opus)로 Opus 서브에이전트만 선별 차단할 수 있습니다.

  • 중첩 .claude/skills의 작업 디렉터리 기반 자동 로드

    하위 디렉터리의 .claude/skills에 둔 스킬은 해당 디렉터리에서 작업할 때 자동으로 로드되지 않아, 모노레포처럼 패키지별 스킬을 두는 구성에서 매번 끌어오는 번거로움이 있었습니다. 이제 작업 중인 파일이 위치한 중첩 .claude/skills의 스킬이 자동으로 로드되고, 상위와 이름이 충돌하면 중첩 쪽이 <dir>:<name> 형태로 표시되어 양쪽 모두 사용할 수 있습니다.

주요 개선

  • 중첩 .claude/ 디렉터리 — 작업 디렉터리에 가장 가까운 정의가 우선

    중첩된 .claude/ 디렉터리에서 에이전트, workflow, output-style이 이름 충돌을 일으키면 어느 쪽이 적용되는지 예측이 어려웠습니다. 이제 작업 디렉터리에 가장 가까운 정의가 우선 적용되며, 프로젝트 범위 workflow 저장도 가장 가까운 기존 .claude/workflows/를 대상으로 합니다.

  • auto 모드 — 서브에이전트 spawn 사전 분류

    auto 모드에서 서브에이전트가 spawn된 뒤에야 분류기를 거치다 보니, 차단되어야 할 동작을 검토 없이 요청할 수 있는 빈틈이 있었습니다. 이제 서브에이전트 spawn 자체가 분류기로 사전 평가되어 launch 전에 차단할 수 있습니다.

  • /doctor 레이아웃과 아이콘 정리

    /doctor 출력이 섹션마다 다른 들여쓰기와 아이콘을 써서 진단 결과를 한눈에 읽기 어려웠습니다. 모든 섹션이 일관된 flat tree 레이아웃을 따르고, 섹션 상태 아이콘과 명령 이름 강조가 명확해졌습니다.

  • 스킬 목록 truncation 경고에 영향 받은 개수 표시

    스킬 설명이 잘려 표시될 때 몇 개가 영향을 받았는지 알 수 없었습니다. 이제 경고에 영향 받은 스킬 description 개수가 함께 표시됩니다.

  • Workflow 프롬프트 키워드 — 명시적 표현일 때만 트리거

    워크플로 키워드가 단어가 등장하기만 해도 트리거되어 의도하지 않은 자동완성이 일어났습니다. 이제 보라색 시머 하이라이트로 표시되며, “run a workflow”나 “workflow:” 같은 명시적 표현일 때만 트리거됩니다.

  • Remote Control 오류 메시지 명확화

    Remote Control 연결 실패와 “not yet enabled” 오류 원인을 사용자가 구분하기 어려웠습니다. 이제 연결 실패는 푸터에 빨간색 “/rc failed” 지속 표시로 노출되고, “not yet enabled” 오류는 gate인지, check 실패인지, stale entitlement인지, 조직 정책인지 구분해 안내합니다.

  • /bug — 설명 필수, 모델 거부 텍스트가 제목으로 들어가지 않음

    /bug 제출이 설명 없이도 가능했고, 모델이 응답을 거부한 문구가 그대로 GitHub 이슈 제목으로 들어가는 경우가 있었습니다. 이제 제출 전에 설명이 필수이며, 모델 거부 텍스트는 더 이상 이슈 제목으로 사용되지 않습니다.

주요 버그 수정

인증, 자격 증명

  • 부모 프로세스에서 상속된 stale한 websocket/OAuth 파일 디스크립터 환경변수 때문에 CLI가 OOM으로 크래시하던 문제 수정.
  • Claude in Chrome의 OAuth 토큰이 Claude Code 로그인 계정과 다를 때 연결이 조용히 실패하던 문제 수정.
  • ANTHROPIC_BASE_URL과 ANTHROPIC_AUTH_TOKEN으로 커스텀 API 게이트웨이를 지정한 셸에서 데몬이 시작되었을 때 claude agents 워커가 401 Invalid bearer token으로 실패하던 문제 수정.
  • 세션 밖에서 자격 증명이 갱신된 뒤에도 캐시된 요청 설정이 그대로 남아 모델 요청이 인증 오류로 계속 실패하던 문제 수정.

서브에이전트, 백그라운드 세션

  • 서브에이전트 관련 여러 문제 수정 — 서브에이전트 transcript를 열어도 도구 결과와 실시간 진행이 보이지 않던 문제, 서브에이전트가 턴을 마치는 동안 보낸 메시지가 누락되던 문제, 실행 중인 서브에이전트를 백그라운드로 보낼 때(ctrl+b) 처음부터 다시 시작되던 문제 모두 정리.
  • 턴이 끝난 뒤 /bg나 ←←로 만든 백그라운드 세션이 에이전트 목록에 “Working” 상태로 무한히 남던 문제 수정.

스킬, 권한, MCP

  • 중첩 .claude/skills에 디렉터리 한정 이름을 가진 스킬이 비대화식 실행에서 권한 프롬프트에 막히던 문제 수정.
  • 서브에이전트 disallowedTools의 MCP 서버 단위 명세(mcp__server, mcp__server__*, mcp__*)가 조용히 무시되던 문제 수정.

모델, compaction

  • compaction이 --fallback-model을 따르지 않던 문제 수정 — 이제 overload나 모델 가용성 오류 시 설정된 fallback 모델 체인으로 폴백합니다.

플러그인

  • CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1이 설정되어 있을 때 신규 마켓플레이스 설치의 clone이 막히던 문제 수정.

UI, 입력

  • vim 모드 undo에서 u가 빠르게 연속된 NORMAL/VISUAL 모드 명령을 하나의 undo 단계로 묶어 처리하던 문제 수정 — 이제 명령을 한 번에 하나씩 단계별로 되돌립니다.
  • vscode://처럼 커스텀 URI 스키마를 사용하는 statusline 링크가 claude agents에서 클릭해도 열리지 않던 문제 수정.
  • [VSCode] CJK IME 후보창을 Esc로 닫을 때 실행 중이던 Claude 작업까지 취소되던 문제 수정.

알아두면 좋은 점

  • Tool(param:value) 권한 규칙 — 도구 입력 파라미터까지 매칭해 더 세분화된 권한 정책을 표현할 수 있습니다. Agent(model:opus)처럼 특정 모델의 서브에이전트만 차단하고 싶을 때 활용하세요. * 와일드카드도 지원됩니다.
  • 중첩 .claude/skills 자동 로드 — 모노레포처럼 디렉터리별로 스킬을 둔 구성에서, 작업 중인 파일이 속한 디렉터리의 스킬이 자동으로 합류합니다. 상위와 이름이 겹치면 중첩 쪽이 <dir>:<name>으로 표기되니, 두 스킬을 동시에 사용하고 싶다면 그대로 두면 됩니다.
  • auto 모드 사전 분류 — 분류기가 서브에이전트 spawn 전에 평가하므로, 차단 정책으로 통제하던 동작이 서브에이전트를 통해 우회되던 빈틈이 메워졌습니다. 차단 정책에 의존하는 조직은 업데이트가 권장됩니다.
  • claude agents 워커 401 문제 — ANTHROPIC_BASE_URL과 ANTHROPIC_AUTH_TOKEN으로 커스텀 API 게이트웨이를 사용하는 환경이라면 이 릴리스에서 데몬을 다시 시작해 두는 것이 좋습니다.
  • compaction --fallback-model 적용 — overload 시 대체 모델로 자동 폴백하도록 설정해 두었다면, 이번 릴리스부터 compaction에도 동일하게 적용됩니다.
  • 서브에이전트 disallowedTools의 MCP 와일드카드 — mcp__*나 mcp__server__* 같은 서버 단위 명세를 사용하던 정책이 그동안 적용되지 않았을 수 있으니, 이번 릴리스에서 의도대로 동작하는지 확인해 두는 것이 좋습니다.
  • CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1을 사용 중인 환경 — 이 옵션이 신규 마켓플레이스 설치를 막던 문제가 해소되었으므로, 마켓플레이스 추가가 멈춰 있었다면 다시 시도해 보세요.