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

Claude Code 2.1.186

CLI에서 바로 MCP 서버에 인증하는 claude mcp login, claude mcp logout 명령이 추가됐습니다. ! 셸 명령의 출력을 이제 Claude가 자동으로 이어받아 응답하며(이전 동작은 respondToBashCommands: false로 유지), /workflows 상세 뷰에 상태 필터(f), /plugin Installed 탭에 Skills 섹션이 생겼습니다. 백그라운드 서브에이전트의 권한 프롬프트는 자동 거부 대신 메인 세션에 표시되도록 바뀌었고, Agent(type) 거부 규칙이 named 서브에이전트 생성에 적용되지 않던 문제, 머신이 슬립에서 깨어난 뒤 스트리밍 요청이 "Content block not found"로 실패하던 문제, claude agents 화면의 여러 표시 문제 등이 정리됐습니다.

Claude Code
공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.186이 2026년 6월 22일 출시됐습니다. CLI에서 바로 MCP 서버에 로그인, 로그아웃하는 명령이 추가됐고, ! 셸 명령의 출력을 Claude가 자동으로 이어받아 응답하도록 기본 동작이 바뀌었습니다. 그 외 백그라운드 에이전트(claude agents) 표시, 권한 규칙 적용, 슬립에서 깨어난 뒤 스트리밍 실패 등 다수의 버그가 정리됐습니다.

새 기능

  • CLI에서 MCP 서버 로그인, 로그아웃 (claude mcp login / claude mcp logout)

    MCP 서버 인증은 대화형 /mcp 메뉴를 열어야만 가능했습니다. SSH 같은 원격 환경에서는 인증 흐름을 진행하기 번거로웠습니다. 이제 claude mcp login <name>, claude mcp logout <name>으로 메뉴 없이 CLI에서 인증할 수 있고, --no-browser 옵션으로 stdin 리다이렉트를 받아 SSH 세션에서도 인증을 완료할 수 있습니다.

  • ! 셸 명령 출력에 Claude가 자동으로 응답

    !로 실행한 셸 명령의 출력은 컨텍스트에만 추가될 뿐, Claude가 그 결과를 보고 곧바로 반응하지는 않았습니다. 이제 ! 명령의 출력에 Claude가 자동으로 응답합니다. 이전처럼 출력을 컨텍스트로만 넣고 응답은 하지 않게 하려면 settings.json에 "respondToBashCommands": false를 지정합니다.

  • /workflows 상세 뷰에 상태 필터 (f)

    실행 중인 에이전트가 많으면 /workflows의 agent detail view에서 원하는 상태의 항목을 눈으로 찾아야 했습니다. 이제 f를 눌러 상태별로 필터링할 수 있습니다.

  • /plugin Installed 탭에 “Skills” 섹션 추가

    /plugin의 Installed 탭에 설치된 Skill을 모아 보는 “Skills” 섹션이 생겼습니다.

  • teammateMode: "iterm2" 설정 추가

    iTerm2를 쓰는 팀 모드 구성에 teammateMode: "iterm2" 설정이 추가됐습니다. auto 모드가 it2 CLI를 찾지 못하면 경고를 표시합니다.

  • /login에 “Claude Platform on AWS - refresh credentials” 옵션

    awsAuthRefresh가 구성된 경우 /login에서 “Claude Platform on AWS - refresh credentials” 옵션으로 자격 증명을 갱신할 수 있습니다.

주요 개선

  • 백그라운드 서브에이전트 권한 프롬프트를 메인 세션에 표시

    백그라운드 서브에이전트가 권한이 필요한 작업을 시도하면 프롬프트를 띄울 곳이 없어 자동으로 거부됐습니다. 이제 권한 프롬프트가 메인 세션에 표시되며, 어느 에이전트가 요청하는지 함께 보여줍니다. Esc를 누르면 해당 도구만 거부됩니다.

  • /review <pr>가 /code-review medium과 같은 리뷰 엔진 사용

    /review <pr>와 /code-review가 서로 다른 리뷰 경로를 타 결과가 일관되지 않았습니다. 이제 /review <pr>는 /code-review medium과 동일한 리뷰 엔진을 사용합니다.

  • claude mcp get, claude mcp remove의 오타 보정과 긴 목록 처리

    서버 이름에 오타가 있으면 그냥 실패했고, 서버가 많으면 목록이 길게 출력됐습니다. 이제 가장 가까운 구성된 서버 이름을 제안하고, 긴 서버 목록은 잘라서 보여줍니다.

  • MEMORY.md 인덱스 압축 안내

    메모리 인덱스(MEMORY.md)가 크기 한도에 가까워져도 별도 안내가 없었습니다. 이제 한도에 근접하면 에이전트가 MEMORY.md 인덱스를 압축하도록 안내받습니다.

  • Skill frontmatter 키의 다중 표기 허용

    display-name, default-enabled, fallback, metadata.* 같은 Skill frontmatter 키는 한 가지 표기만 인식됐습니다. 이제 kebab-case, snake_case, camelCase를 모두 허용합니다.

  • 잘못된 SKILL.md frontmatter 처리 개선

    SKILL.md의 YAML frontmatter가 잘못된 형식이면 조용히 로딩에 실패했습니다. 이제 메타데이터를 비운 채 Skill 본문을 로드해, 실패를 알아채지 못하는 상황을 피합니다.

  • CLAUDE_CODE_MAX_RETRIES 상한 변경

    CLAUDE_CODE_MAX_RETRIES를 과도하게 높이면 무인 세션이 비정상적으로 오래 재시도를 반복할 수 있었습니다. 이제 상한이 15로 제한됩니다. 무인 세션에는 대신 CLAUDE_CODE_RETRY_WATCHDOG를 사용합니다.

주요 버그 수정

세션과 스트리밍

  • 머신이 슬립에서 깨어난 뒤 스트리밍 요청이 “Content block not found” 또는 JSON 파싱 오류로 실패하던 문제 수정.
  • 워크플로의 agent({schema}) 서브에이전트가 스키마 검증에 반복 실패하면 5회 후 중단하지 않고 무한히 반복하던 문제 수정. 이제 5회 시도 후 중단합니다.
  • usage 기반 Enterprise, Team 구독자에게 세션 비용이 표시되지 않던 문제 수정.

백그라운드 에이전트 (claude agents)

  • 서브에이전트 채팅에서 나갈 때 transcript 스크롤 위치가 메인 transcript로 번지던 문제 수정.
  • 에이전트의 plan이 로드되기 전에 백그라운드 작업 미리보기가 raw 도구 이름을 잠깐 보여주던 문제 수정.
  • 백그라운드 세션 recap이 중복되던 문제 수정. 이제 에이전트 자신의 턴 종료 요약이 recap 줄로 표시됩니다.
  • claude agents에서 백그라운드 세션을 열면 이전 화면이 뒤에 남아 그려지던 문제 수정.
  • 메인 턴이 끝난 뒤에도 백그라운드 에이전트가 실행 중이면 Esc와 Ctrl+C가 반응하지 않던 문제 수정.
  • claude agents에서 답변한 뒤에도 백그라운드 작업 상태가 오래된 “needs input” 메시지를 보여주던 문제 수정.
  • 밝은 테마 터미널에서 claude agents로 백그라운드 세션을 열 때 다크 테마가 잠깐 깜빡이던 문제 수정.
  • claude agents에서 마우스로 선택한 텍스트를 삭제한 뒤에도 하이라이트가 남던 문제 수정.
  • agent teams: tmux/pane 백엔드로 생성된 teammate가 리더의 --effort 레벨을 상속하지 못하던 문제 수정.

권한과 도구

  • Agent(type) 거부 규칙과 Agent(x,y) 허용 유형 제한이 named 서브에이전트 생성에는 적용되지 않던 문제 수정.
  • 동시 실행 CLI 세션에서 in-product 권한 게이트가 꺼져 있으면 Chrome 탭 그룹 격리가 적용되지 않던 문제 수정.
  • cold first launch에서 플래그가 로드되기 전, --tools가 feature-gated 도구를 통과시키던 문제 수정.

표시와 UI

  • 권한 프롬프트에서 옵션 텍스트가 넘칠 때 옵션 번호가 어긋나던 문제 수정.
  • agent panel에서 완료된 서브에이전트에 x를 눌러도 닫히지 않던 문제 수정.
  • 이전 세션을 재개할 때, 의도적으로 폐기된 도구에 대해 오해를 부르는 “MCP server disconnected” 알림이 뜨던 문제 수정.
  • 이미 맨 위로 스크롤된 상태인데도 /plugin Installed가 “more above” 표시를 보여주던 문제 수정.
  • assistant 메시지에서 ~~strikethrough~~가 취소선으로 렌더링되지 않고 물결표(~)가 그대로 보이던 문제 수정.

알아두면 좋은 점

  • ! 셸 명령 자동 응답이 기본 동작 — 이제 ! 명령의 출력에 Claude가 자동으로 응답합니다. 이전처럼 출력을 컨텍스트로만 넣으려면 settings.json에 "respondToBashCommands": false를 지정합니다.
  • 무인 세션의 재시도 상한 — CLAUDE_CODE_MAX_RETRIES는 이제 최대 15로 제한됩니다. 무인 실행에서 더 끈질긴 재시도가 필요하면 CLAUDE_CODE_RETRY_WATCHDOG를 사용합니다.
  • 백그라운드 서브에이전트 권한 흐름 변경 — 이전에는 백그라운드 서브에이전트의 권한 요청이 자동 거부됐지만, 이제 메인 세션에 프롬프트가 떠 어느 에이전트의 요청인지 확인하고 응답할 수 있습니다.
  • MCP CLI 인증 흐름 — SSH 등 브라우저를 띄울 수 없는 환경에서는 claude mcp login <name> --no-browser로 stdin 리다이렉트를 받아 인증을 완료할 수 있습니다.