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

Claude Code 2.1.142 업데이트

`claude agents`로 디스패치되는 백그라운드 세션을 호출 시점에 직접 구성할 수 있도록 `--add-dir`, `--settings`, `--mcp-config`, `--plugin-dir`, `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions` 플래그가 추가되었고, 패스트 모드 기본 모델이 Opus 4.6에서 Opus 4.7로 올라갔습니다(`CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1`로 고정 가능). 루트에 `SKILL.md`만 둔 플러그인이 스킬로 노출되고, `/plugin` 상세와 `claude plugin details`는 플러그인이 제공하는 LSP 서버까지 보여줍니다. `MCP_TOOL_TIMEOUT`이 원격 HTTP·SSE MCP 서버의 60초 캡을 풀지 못하던 문제, macOS 슬립/웨이크 후 백그라운드 세션이 사라지고 데몬 재연결이 깨지던 문제, `brew upgrade` 직후 데몬이 깔끔히 종료되지 않아 디스패치된 에이전트가 크래시 루프에 빠지던 문제를 포함해 백그라운드 세션·`claude agents`·플러그인·MCP·UI 영역의 결함이 한 차례에 정리되었습니다.

Claude Code
공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.142가 2026년 5월 14일(현지 시간) 릴리스되었습니다. claude agents로 백그라운드 세션을 디스패치할 때 호출 시점에 디렉터리·설정·MCP 구성·플러그인 디렉터리·권한 모드·모델·effort·권한 우회까지 직접 지정할 수 있도록 8개 플래그가 한꺼번에 추가되었고, 패스트 모드 기본 모델이 Opus 4.6에서 Opus 4.7로 올라갔습니다(CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1로 4.6에 고정). 플러그인 패키징 측면에서는 루트에 SKILL.md만 두고 별도 skills/ 디렉터리가 없는 플러그인이 그 자체로 스킬로 노출되고, /plugin 상세 패널과 claude plugin details가 플러그인이 제공하는 LSP 서버를 함께 보여주며, /web-setup은 기존 GitHub App 연결을 덮어쓰기 전에 경고합니다. 동시에 MCP_TOOL_TIMEOUT이 원격 HTTP·SSE MCP 서버의 60초 캡을 풀지 못하던 문제, macOS 슬립/웨이크 후 백그라운드 세션이 사라지고 데몬 재연결이 깨지던 문제, brew upgrade 직후 데몬이 깔끔히 종료되지 않아 디스패치된 에이전트가 삭제된 경로에서 크래시 루프에 빠지던 문제처럼 운영에 직접 영향을 주는 결함이 한 번에 해결되었습니다.

새 기능

  • claude agents 디스패치 플래그 8종 추가 — --add-dir/--settings/--mcp-config/--plugin-dir/--permission-mode/--model/--effort/--dangerously-skip-permissions

    지금까지 claude agents로 백그라운드 세션을 디스패치할 때 호출 시점에 환경을 조정할 방법이 제한적이라, 미리 셸·환경변수에 손을 댄 뒤에 띄워야 하는 경우가 많았습니다. 이번 릴리스에서 디렉터리 추가(--add-dir), 설정 파일(--settings), MCP 구성(--mcp-config), 플러그인 디렉터리(--plugin-dir), 권한 모드(--permission-mode), 모델(--model), effort(--effort), 권한 우회(--dangerously-skip-permissions)까지 8개 플래그가 한꺼번에 추가되어 백그라운드 세션 구성을 호출 라인에서 직접 잡을 수 있습니다.

  • 패스트 모드 기본 모델 Opus 4.7로 변경 — 4.6 고정용 CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE 제공

    패스트 모드(fast mode)가 Opus 4.6을 기본으로 쓰던 것이 이번 릴리스에서 Opus 4.7로 올라갔습니다. 일관성·재현성을 위해 4.6에 머물러야 하는 환경에서는 CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1을 설정해 패스트 모드를 Opus 4.6으로 고정할 수 있습니다.

  • 루트 SKILL.md만 가진 플러그인이 그대로 스킬로 노출

    지금까지는 플러그인 안에서 스킬을 제공하려면 skills/ 하위 디렉터리에 SKILL.md를 넣어야 인식되었습니다. 이제 루트에 SKILL.md만 두고 별도 skills/ 디렉터리가 없는 플러그인은 그 자체가 하나의 스킬로 인식되어, 단일 스킬을 배포할 때 디렉터리 구조를 단순하게 유지할 수 있습니다.

  • /plugin 상세·claude plugin details — LSP 서버 표시

    플러그인이 제공하는 컴포넌트를 확인할 때 LSP(Language Server Protocol) 서버 정보가 누락되어 있어 어떤 LSP가 활성화되는지 별도 추적이 필요했습니다. 이제 /plugin 상세 패널과 claude plugin details가 해당 플러그인이 제공하는 LSP 서버를 함께 보여줍니다.

  • /web-setup — 기존 GitHub App 연결을 덮어쓰기 전 경고

    /web-setup을 실행하면 별도 확인 없이 기존 GitHub App 연결을 교체해버려, 이미 연결된 환경을 의도치 않게 덮어쓰는 경우가 있었습니다. 이제 기존 GitHub App 연결이 있으면 교체 전에 경고를 띄웁니다.

주요 개선

  • 반응형 컴팩션 — 첫 요약 시도가 원본 요청 오버플로 크기에서 시작

    반응형(reactive) 컴팩션의 첫 요약 시도가 컨텍스트 한계 근처에서 시작되어 사실상 한 번 더 거의 풀-컨텍스트로 재시도해야 하는 낭비가 있었습니다. 이제 첫 시도가 원본 요청의 오버플로 크기에서 시작되도록 시드되어 한 번의 요약 시도가 그대로 통과할 가능성이 높아졌습니다.

  • 훅 설정 오류 메시지 — SessionStart/Setup/SubagentStart에 잘못된 타입 사용 시 안내 명확화

    prompt나 agent 타입의 훅을 SessionStart/Setup/SubagentStart 이벤트에 걸어두면 동작하지 않는데, 이전에는 원인이 명확하지 않았습니다. 이제 “command 타입 훅을 사용하라”는 메시지를 직접 보여줘 잘못된 조합을 빠르게 잡을 수 있습니다.

  • 사용 정책(Usage Policy) 거절 메시지 — /model claude-sonnet-4-20250514 추천 제거

    사용 정책 거절 메시지에 더 이상 존재하지 않는 /model claude-sonnet-4-20250514 모델로 전환을 권유하는 stale 한 추천이 남아 있었습니다. 이번 릴리스에서 제거되었습니다.

주요 버그 수정

MCP

  • 원격 HTTP·SSE MCP 서버의 per-request fetch 타임아웃을 MCP_TOOL_TIMEOUT이 끌어올리지 못하던 문제 — 이전에는 MCP_TOOL_TIMEOUT을 키워도 툴 호출이 60초에서 캡되었는데, 이제 설정 값이 그대로 적용됩니다.

백그라운드 세션·데몬

  • claude agents 백그라운드 세션이 이미 존재하는 git worktree를 인식하지 못하던 문제 — Edit이 막혀 있고 EnterWorktree는 중복 worktree 생성을 거부해 진행이 막히던 상황이 해소됩니다.
  • macOS 슬립/웨이크 후 백그라운드 세션이 사라지고 데몬 재연결이 실패하던 문제 — 데몬이 시계 점프(clock jump)를 idle 시간으로 오인하지 않고 그 자체로 감지합니다.
  • brew upgrade 등으로 바이너리가 업그레이드된 뒤 데몬이 깔끔히 종료되지 않아 디스패치된 에이전트가 삭제된 경로에서 크래시 루프에 빠지던 문제 수정.
  • 공유 탭 없이 Claude-in-Chrome 확장이 연결된 상태에서 백그라운드 에이전트가 크래시 루프에 빠지던 문제 수정.
  • claude --bg --dangerously-skip-permissions가 retire/wake를 가로지르며 유지되지 않던 문제 수정.

claude agents 어태치 UI

  • claude agents 세션에 어태치된 상태에서 링크 클릭이 동작하지 않던 문제 — 백그라운드 워커의 헤드리스 브라우저 shim이 어태치 중에는 적용되지 않도록 수정.
  • claude agents의 “v to open in editor”가 셸의 $EDITOR/$VISUAL 대신 데몬 기본 에디터를 쓰던 문제 수정.
  • Windows에서 네트워크 드라이브를 작업 디렉터리로 사용하는 claude agents가 시작 단계에서 데드락에 빠지던 문제 수정. 시작 도중에도 Ctrl+C가 동작합니다.
  • Apple Terminal 등 256색 단말에서 claude agents에 어태치할 때 발생하던 background-color bleed 수정.

세션 제목·/model 브레드크럼

  • 첫 메시지가 링크일 때 세션 제목이 URL에서 도출되던 문제 수정.
  • 원격 클라이언트가 보낸 중복 set_model 요청이 트랜스크립트에 /model 브레드크럼을 중복으로 끼워 넣던 문제 수정.

플러그인

  • skills: ["./"]을 사용한 플러그인이 “path escapes plugin directory” 에러를 잘못 띄우던 문제 수정.
  • 설치 메타데이터가 없는 경우 플러그인 캐시 정리가 활성 플러그인 버전 디렉터리까지 삭제하던 문제 수정.
  • 갓 게시된 플러그인의 /plugin 브라우즈 패널에 “0 installs”가 표시되던 문제 수정.
  • 기본 폴더 이름(commands/ 등)을 가리는 plugin.json 키를 advisory가 모두 나열하지 않던 문제 수정.

알아두면 좋은 점

  • claude agents 백그라운드 디스패치 구성 — 이제 --add-dir/--settings/--mcp-config/--plugin-dir/--permission-mode/--model/--effort/--dangerously-skip-permissions를 호출 라인에서 직접 잡을 수 있습니다. 사전에 셸·환경을 손대지 않고도 세션마다 구성을 다르게 가져갈 수 있어, 다양한 권한·모델 조합을 자동화 스크립트로 한 줄에 구성할 수 있습니다.
  • 패스트 모드 기본 모델 변경 영향 — 패스트 모드가 Opus 4.7을 기본으로 쓰게 되었습니다. 회귀 테스트나 결정성(determinism)이 중요한 워크플로에서 4.6에 머물러야 한다면 CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1을 설정하세요.
  • 단일 스킬 플러그인 패키징 단순화 — 루트에 SKILL.md만 두면 그대로 스킬로 노출되므로, 단일 스킬을 배포하기 위해 skills/ 디렉터리를 만들 필요가 없어졌습니다.
  • MCP_TOOL_TIMEOUT이 실제로 적용 — 원격 HTTP·SSE MCP 서버에서 60초 이상 걸리는 툴 호출이 있다면, 이제 MCP_TOOL_TIMEOUT 값을 그대로 적용받아 더 이상 60초에서 끊기지 않습니다. 이전에 60초 캡을 우회하려고 분할했던 호출이 있다면 다시 단순화할 수 있습니다.
  • macOS 슬립/웨이크 후 백그라운드 세션 안정화 — 데몬이 시계 점프를 idle로 오인하지 않게 되어, 노트북 환경에서 백그라운드 세션이 슬립/웨이크 후 사라지던 회귀가 해소되었습니다.
  • brew upgrade 후 디스패치 에이전트 크래시 루프 — 바이너리 업그레이드 후 데몬이 잔존하던 회귀가 정리되었습니다. 업그레이드 직후 디스패치 에이전트가 비정상 동작했다면, 이번 버전 이후로는 데몬 재시작 절차를 따로 둘 필요가 없습니다.
  • 루트 SKILL.md 패턴의 부수 효과 — 기존에 skills/ 하위로 SKILL.md를 두던 플러그인은 동작이 동일합니다. 새 패턴은 어디까지나 단일 스킬 플러그인을 단순화하기 위한 추가 옵션입니다.