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

Claude Code 2.1.259

조직이 모든 구성원에게 같은 HTTP/SSE MCP 서버를 내려주는 `managedMcpServers` 관리형 설정과, 사람이 지켜보지 않는 헤드리스 환경에서 확인 요청이 뜰 동작을 자동으로 거부하는 `--permission-prompts none`이 추가됐습니다. `glab mr` 명령을 인식해 GitLab 병합 요청을 `MR !N`으로 표시하고, `claude plugin validate`에는 기계가 읽는 `--json` 보고서가 생겼습니다. 버그 수정 26건은 여러 세션이 서로의 `~/.claude.json` 변경을 되돌리던 문제, 관리형 설정을 해석하지 못해도 그대로 실행되던 문제, 작업 트리 격리 세션이 평범한 Bash 반복문과 xargs 파이프라인을 거부하던 문제, 대화형 세션에서 frontmatter `model:`이 무시되던 문제 등을 다룹니다.

Claude Code
공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.259가 2026년 9월 2일 출시됐습니다. 새 기능 가운데 눈에 띄는 두 가지는 여러 사람이 같은 설정으로 쓰는 환경을 겨냥합니다. 조직이 MCP 서버를 한 번에 배포하는 관리형 설정과, 사람이 답할 수 없는 자동 실행 환경에서 확인 요청을 자동으로 처리하는 옵션입니다. 나머지는 대부분 수정입니다. 여러 세션을 동시에 띄웠을 때 설정이 서로 덮어써지던 문제, 관리형 설정을 읽지 못해도 아무 일 없다는 듯 실행되던 문제, 작업 트리로 격리된 세션이 평범한 명령을 거부하던 문제가 함께 정리됐습니다.

새 기능

  • managedMcpServers 관리형 설정

    조직 구성원 모두에게 같은 MCP 서버를 쓰게 하려면 각자 설정하게 하거나 별도 배포 절차를 만들어야 했습니다. 이제 관리형 설정의 managedMcpServers에 서버를 적어 두면 모든 사용자에게 전달됩니다. 항목 형식은 .mcp.json과 같고, 실행할 명령을 지정한 항목은 건너뛰므로 HTTP/SSE 서버가 대상입니다.

  • --permission-prompts none

    사람이 지켜보지 않는 헤드리스 환경(화면 없이 자동으로 실행되는 환경)에서는 확인 요청이 뜨는 순간 답할 사람이 없어 세션이 멈췄습니다. 이제 이 옵션을 주면 확인 요청이 필요한 동작이 자동으로 거부됩니다. 판단 자체는 활성 권한 모드(auto mode 포함)가 그대로 하므로, 모드가 허용하는 동작은 계속 실행됩니다.

  • GitLab 병합 요청 명령 인식

    glab mr create/merge/close/reopen/note/update로 병합 요청을 다뤄도 도구 요약에는 명령이 그대로 표시되고 하단 표시줄의 MR 배지도 갱신되지 않았습니다. 이제 이 명령들을 인식해 접힌 도구 요약에 MR !N 형태로 표시하고 하단 MR 배지를 갱신합니다.

  • claude plugin validate --json

    검증 결과가 사람이 읽는 형식으로만 나와, CI에서 통과 여부를 판별하려면 출력 문자열을 해석해야 했습니다. 이제 --json으로 기계가 읽는 검증 보고서를 받을 수 있습니다.

  • [VSCode] 세션 목록의 Active 빠른 필터와 상태 필터 메뉴

    세션이 쌓이면 지금 손이 필요한 세션을 목록에서 골라내기 어려웠습니다. 이제 사이드바 세션 목록에 Active 빠른 필터와 Needs input, Working, Completed 상태 필터 메뉴가 생겼습니다.

주요 개선

  • 긴 응답의 터미널 크기 조정과 첫 렌더링 성능

    긴 응답이 있는 상태에서 터미널 크기를 바꾸거나 화면을 처음 그릴 때 같은 텍스트의 폭을 매번 다시 계산했습니다. 이제 계산 결과를 재사용해 두 경우 모두 빨라졌습니다.

  • /workflows의 에이전트 상세 표시

    에이전트가 JSON 결과를 내면 줄바꿈 없이 한 덩어리로 나와 읽기 어려웠고, 결과가 길면 화면을 가득 채웠습니다. 이제 JSON 결과는 색을 입혀 실제 줄바꿈이 반영된 형태로 표시되고, 긴 결과는 펼침 버튼 뒤로 접힙니다.

  • 헤드리스, SDK 세션의 시작 속도

    MCP 서버 연결이 끝난 뒤 첫 턴이 시작되기까지 불필요한 대기가 있었습니다. 이제 첫 턴이 최대 50밀리초 빨리 시작합니다.

  • GitLab 저장소에서 실행한 /install-github-app의 안내

    GitLab 저장소에서 이 명령을 실행하면 왜 적용되지 않는지 알기 어려웠습니다. 이제 GitHub 전용이라는 사실을 설명하고 GitLab CI/CD 문서를 안내합니다.

  • 중첩된 백그라운드 서브에이전트 결과 보존

    서브에이전트가 다시 띄운 백그라운드 서브에이전트의 결과는 부모 서브에이전트의 대화 기록에 남지 않아, 서브에이전트를 재개하면 사라졌습니다. 이제 부모 서브에이전트의 대화 기록에 저장되어 재개해도 유지되고, 공유한 대화 기록에서도 결과가 전달된 사실이 보입니다.

주요 버그 수정

관리형 설정과 권한

  • 관리형 설정 파일, 드롭인 파일, MDM plist, HKLM 값을 해석하지 못하면 관리형 설정이 적용되지 않은 채 그대로 실행되던 문제 수정. 이제 Claude Code가 실행을 거부하고 어느 출처가 문제인지 알려줍니다.
  • Bash Read() 거부 규칙이 옵션 값으로 넘긴 파일(--ignore-revs-file=.env, -f.env, @file), git diff, git grep의 파일 인자, cd DIR && cat FILE 형태의 복합 명령에는 적용되지 않던 문제 수정. 거부 대상 파일이 들어 있는 디렉토리를 grep -r, cp -r로 훑는 경우에도 이제 확인을 묻습니다.
  • MDM이나 관리형 설정 파일로 지정한 정책 헬퍼가 이미 실행된 뒤에는 시작 시점의 관리형 forceRemoteSettingsRefresh가 무시되던 문제 수정.

설정과 시작

  • 여러 세션을 동시에 실행하면 서로의 ~/.claude.json 변경을 조용히 되돌리던 문제 수정. 세션을 많이 띄워도 작업 공간 신뢰 설정이 초기화되거나 MCP, 프로젝트 상태가 사라지지 않습니다.
  • Claude Code가 모르는 모델 버전의 Vertex 형식 모델 ID(@YYYYMMDD 접미사)에는 CLAUDE_CODE_MAX_CONTEXT_TOKENS가 적용되지 않던 문제 수정.
  • claude.ai 사용자는 실행할 때마다 GitHub 연결 확인이 백그라운드로 실행되던 문제 수정. 이제 결과를 기억해 다음 실행에 재사용합니다.
  • 일시적인 git 조회 실패 이후 이미 확인해 둔 저장소 정보를 잃던 문제 수정.

모델 지정과 대화 재개

  • 직접 만든 명령과 스킬의 frontmatter model:이 대화형 세션에서 무시되던 문제 수정.
  • 명령이나 스킬의 frontmatter model:이 auto mode가 지원하지 않는 모델을 지정하면 auto mode가 그 모델로 턴을 실행하던 문제 수정. 이제 세션 모델을 그대로 유지합니다.
  • 사고 과정이 한 번 거부된 대화가 이후 모든 턴에서 계속 거부되던 문제 수정.
  • 저장된 세션에 내용이 비어 있는 첨부 항목이 들어 있으면 --resume이 실패하고 --continue가 빈 대화를 열던 문제 수정.
  • 텔레메트리를 끈 세션에서 OAuth 토큰이 갱신되면 프롬프트 캐시가 무효화되던 문제 수정.
  • Stop 훅이 턴을 차단하면 그다음 턴이 해당 턴의 사고 내용을 잃고, 일부 모델에서는 프롬프트 캐시까지 놓치던 문제 수정.

에이전트와 워크플로

  • Remote Control 세션에서 Stop이 백그라운드 에이전트와 워크플로를 실제로 중지시키지 못하던 문제 수정. 중지한 작업은 프로세스가 끝날 때까지 목록에 남아 다시 중지할 수 있습니다.
  • 이전에 중지한 워크플로 실행이 아직 종료되는 중인데 다시 재개하면 같은 에이전트가 중복 실행될 수 있던 문제 수정.
  • 세션이 일시 중지된 동안 커넥터 도구 권한 요청을 승인하면 원격 세션과 예약 세션이 아무 동작도 하지 않던 문제 수정.

작업 트리와 MCP

  • git rev-parse가 “not a git repository”가 아닌 다른 메시지로 실패하는 환경에서, 작업 트리 격리가 훅이 만든 작업 트리를 거부하던 문제 수정.
  • 작업 트리로 격리된 세션이 원래 체크아웃에 닿을 수 없는 Bash 반복문, xargs 파이프라인, 실행기로 감싼 명령까지 거부하던 문제 수정.
  • 시작 시점에 도구 목록을 받아오는 도중 연결이 끊긴 MCP 서버가 오류를 알리는 대신 도구 없이 연결된 상태로 표시되던 문제 수정.
  • 브라우저에서 실행되던 MCP 서버의 페이지가 사라진 뒤 원격(claude.ai) 세션이 턴을 시작하는 데 60초가 걸리던 문제 수정.
  • github.com 마켓플레이스 저장소 주소 끝에 슬래시나 의미 없는 ?, #가 붙어 있으면 사용할 수 없는 .git 복제 주소가 만들어지던 문제 수정.

터미널과 화면

  • 도구 호출이 수백 번 일어난 긴 턴 이후 전체 화면 모드에서 대화가 비어 보이던 문제 수정.
  • 실행 중인 셸 명령의 실시간 출력 미리보기에서, 앞선 줄이 줄바꿈되면 가장 최근 줄이 보이지 않던 문제 수정.
  • 파일 편집 권한 요청 화면에서 변경된 줄이 잘려 표시되면서 잘렸다는 표시가 없던 문제 수정.
  • 이전 버전에서 이어온 대화에서 아티팩트 게시가 “unexpected parameter note” 오류로 한 번 실패하던 문제 수정.
  • 클라우드 세션의 OpenTelemetry 지표와 이벤트에 user.email, organization.id, user.account_uuid 속성이 빠져 있던 문제 수정.

알아두면 좋은 점

  • allowedMcpServers가 사용자가 추가한 서버만 통제합니다 — 이 허용 목록으로 managed-mcp.json에 적힌 서버를 걸러내고 있었다면, 업그레이드 후 그 서버가 다시 로드됩니다. 계속 막으려면 deniedMcpServers를 사용해야 합니다.
  • 관리형 설정을 해석하지 못하면 Claude Code가 시작되지 않습니다 — 관리형 설정 파일, 드롭인 파일, MDM plist, HKLM 값 중 하나라도 형식이 잘못되면 실행이 거부되고 해당 출처가 표시됩니다. 배포 전에 형식을 확인해야 합니다.
  • --permission-prompts none은 권한 모드를 대신하지 않습니다 — auto mode를 포함한 활성 권한 모드가 그대로 판단하고, 그 판단에서 확인이 필요해진 동작만 자동으로 거부됩니다.
  • managedMcpServers는 HTTP/SSE 서버가 대상입니다 — 실행할 명령을 지정한 항목은 배포에서 건너뜁니다.