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

Claude Code 2.1.267

`maxEffortLevel` 설정이 추가돼 Bedrock, Vertex, Foundry를 포함한 모든 제공자에서 노력 수준의 상한을 정할 수 있게 됐고, `--system-prompt-snapshot off`로 시스템 프롬프트를 매 요청 새로 만들 수 있습니다. 개선 9건은 `/diff` 패널 표시, Bash 도구 설명 지침, 많은 Bash 호출이 있는 세션의 `--resume` 첫 화면 속도, 프롬프트 입력 반응성 등을 다룹니다. 버그 수정 41건은 대화 도중 도구 목록이 다시 쓰여 프롬프트 캐시가 깨지고 확장 사고가 사라지던 문제 여러 건, 5MB를 넘는 큰 세션을 재개할 때 병렬 도구 호출과 훅 출력이 사라지던 문제, 읽을 수 없는 관리형 허용 목록이 모든 것을 허용하던 문제, 서버 자격 증명 만료로 `claude remote-control`이 종료되며 붙어 있던 세션이 모두 끊기던 문제 등을 포함합니다.

Claude Code
공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.267이 2026년 9월 9일 출시됐습니다. 이번 릴리스는 수정이 대부분(41건)이고, 그중 가장 큰 묶음은 대화 도중과 재개 시점에 도구 목록과 시스템 프롬프트 앞부분이 다시 쓰이던 문제입니다. MCP 서버가 도구를 다시 보내거나, 도구가 도중에 사라지거나, /model로 모델을 바꾸거나, 커넥터가 이전과 다른 시점에 다시 연결되는 상황마다 요청 앞부분이 달라져 프롬프트 캐시에 적중하지 못하고 앞서 진행된 확장 사고(extended thinking)까지 사라졌습니다. 나머지는 아티팩트 게시의 실패 처리, 그리고 관리형 설정을 읽을 수 없거나 자격 증명이 만료됐을 때의 동작을 안전한 쪽으로 되돌리는 수정에 몰려 있습니다. 새로 추가된 것은 세 가지로, 노력 수준의 상한을 정하는 maxEffortLevel 설정이 여기에 해당합니다.

새 기능

  • maxEffortLevel 설정

    노력 수준(effort level)은 사용자가 고르는 값이라, 조직 차원에서 상한을 정할 방법이 없었습니다. 이제 최상위 또는 modelSettings 아래 모델별로 maxEffortLevel을 지정하면 Bedrock, Vertex, Foundry를 포함한 모든 제공자에서 상한이 적용됩니다. 사용자는 그보다 낮은 수준을 고를 수 있습니다.

  • --system-prompt-snapshot off

    대화는 처음 기록해 둔 시스템 프롬프트를 계속 재사용하기 때문에, 프롬프트 문구를 고쳐도 이미 진행 중인 대화에는 반영되지 않았습니다. 이제 --system-prompt-snapshot off를 주면 매 요청마다 시스템 프롬프트를 새로 만들어 보냅니다. 프롬프트 문구를 다듬어 가며 확인할 때 쓰는 옵션입니다.

  • [Claude Tag] 사전 설정 연결 양식의 “Use a custom connector” 링크

    Claude Tag 관리자 설정에서 사전 설정된 연결 양식을 열면, 사용자 지정 연결로 바꾸려면 처음부터 다시 시작해야 했습니다. 이제 양식 안에 “Use a custom connector” 링크가 있어 그 자리에서 전환할 수 있습니다.

주요 개선

  • /diff 패널의 표시

    패널을 열면 “0 files changed”와 로딩 표시가 잠깐 나타났다가 실제 내용으로 바뀌었습니다. 이제 그 깜빡임이 없어졌고, 변경이 없을 때의 안내 문구도 패널 가운데에 놓입니다.

  • Bash 도구 설명 지침

    Claude가 명령을 실행할 때 붙이는 설명이 명령어를 그대로 되풀이하는 경우가 있었습니다. 이제 그 명령이 무엇을 하는지 평이한 말로 설명하도록 도구 설명이 다듬어졌습니다.

  • 샌드박스 안에서 클립보드 명령이 실패할 때의 안내

    pbcopy 같은 클립보드 명령은 샌드박스 안에서 실패하는데, 그다음에 무엇을 해야 하는지 안내가 없었습니다. 이제 Claude가 /copy를 대신 제안합니다.

  • Bash 호출이 많은 세션의 --resume 첫 화면 속도

    Bash 도구 호출이 많이 쌓인 세션은 재개했을 때 첫 화면이 그려지기까지 오래 걸렸습니다. 이제 더 빠르게 그려집니다.

  • 프롬프트 입력 반응성

    로딩 표시나 응답이 화면에 그려지는 동안 입력한 키가 한 프레임 늦게 반영되는 경우가 있었습니다. 이제 그렇지 않습니다.

  • 프롬프트 캐시 안정성

    서브에이전트, 그리고 --system-prompt나 --append-system-prompt로 시작한 세션은 시스템 프롬프트와 도구 정의를 매번 다시 만들어 요청 앞부분이 달라졌습니다. 이제 한 번만 기록해 두고 그대로 재사용합니다.

  • Artifact 도구의 게시 오류 메시지

    게시가 거부되면 실패했다는 사실만 알 수 있었습니다. 이제 왜 거부됐는지와 어떻게 해야 하는지가 함께 표시됩니다.

  • 셀프 호스팅 러너의 --use-anthropic-git-proxy

    이 옵션을 쓰는 러너가 있어도 서버 쪽에서는 알 수 없었습니다. 이제 러너 등록 시점에 이 옵션 사용 여부가 서버에 보고되고, 레거시 git 프록시를 거쳐 복제하는 세션마다 경고가 표시됩니다.

  • 게이트웨이의 forward_user_identity 업스트림이 반환하는 429

    사용자 이메일을 전달하는 업스트림이 429(요청 한도 초과)를 반환하면 다음 업스트림으로 넘어갔고, 그 결과 사용자별 한도가 사실상 지켜지지 않았습니다. 이제 429를 그대로 해당 개발자에게 돌려줍니다.

주요 버그 수정

도구 목록과 프롬프트 캐시

  • MCP 서버가 도구를 다시 보내거나 내장 도구가 다시 그려질 때, 모델이 이미 불러온 도구를 두고 앞서 진행된 사고가 사라지던 문제 수정.
  • 연결이 끊긴 MCP 서버나 업그레이드 때문에 도구가 대화 도중 사라지면 도구 목록이 다시 쓰이며 앞서 진행된 사고가 사라지던 문제 수정.
  • 대화에서 갈라져 나온 백그라운드 작업이 대화의 도구 목록에 EnterWorktree를 도중에 추가해 프롬프트 캐시 재사용이 깨지던 문제 수정.
  • ToolSearch가 없는 세션에서 MCP, 플러그인 도구가 대화 도중 도구 목록에 추가돼 프롬프트 캐시 재사용이 깨지던 문제 수정. 지원되는 모델에서는 이제 지연 정의(필요할 때 불러오는 도구 정의)로 전달됩니다.
  • /model로 모델을 바꾸면 모든 도구 정의가 다시 전송돼 프롬프트 캐시에 적중하지 못하던 문제 수정. 커밋과 PR 귀속 문구는 이제 모델이 바뀔 때 갱신되는 대화 안 메모로 전달됩니다.
  • MCP 커넥터가 이전과 다른 시점에 다시 연결되면 재개된 세션이 본문에 들어간 도구 목록을 다시 쓰던 문제 수정.
  • 첫 턴에서 도구를 실행한 세션을 재개하면 기록된 도구 설명을 그대로 재생하지 않고 다시 만들어 넣던 문제 수정.
  • claude.ai 커넥터의 도구가 세션과 재개 사이에 달라지면 프롬프트 캐시에 적중하지 못하고 확장 사고가 사라지던 문제 수정.
  • 재개된 세션이 커넥터가 다시 연결되기 전에 앞서 기록된 MCP 도구 안내를 다시 쓰며 확장 사고를 없애던 문제 수정.
  • -p 모드로 진행한 대화를 대화형으로 재개하면 시스템 프롬프트 앞부분이 달라져 프롬프트 캐시가 깨지던 문제 수정.

세션 재개

  • -p --resume으로 /compact나 다른 슬래시 명령을 실행한 뒤 세션을 재개하면 “Continue from where you left off.”라는 턴이 임의로 끼어들던 문제 수정.
  • 기록이 5MB를 넘는 큰 세션을 재개하면 병렬 도구 호출과 그 훅 출력이 다시 불러온 대화에서 빠지던 문제 수정.

Remote Control과 원격, 클라우드 세션

  • 관리형 설정이 샌드박스를 요구하는 조직에서 클라우드의 Cowork 예약 작업이 시작 단계에서 실패하던 문제 수정.
  • /context를 비롯한 로컬 명령의 출력이 모바일 클라이언트에서 빈 화면으로 표시되던 문제 수정.
  • Claude Desktop이나 VS Code 세션에 참여한 Remote Control 클라이언트가, 권한 모드를 한 번 더 바꾸기 전까지 이전 값을 계속 보여주던 문제 수정.
  • 서버 자격 증명이 만료되면(시작 후 약 30일) claude remote-control이 종료되며 붙어 있던 세션이 모두 끊기던 문제 수정. 이제 호스트가 다시 등록하고 계속 동작합니다.

입력과 화면

  • 에이전트 화면 안에서 tmux나 ssh 세션에 다시 연결하면 shift+enter와 option+backspace가 동작하지 않던 문제 수정.
  • 전체 화면 모드에서 위로 스크롤할 때 대화 맨 위에 흐리게 표시되는 직전 프롬프트 머리글이 나타나지 않던 문제 수정.
  • 모델이나 모드에 따라 서로 다른 한도 구간이 보고되면 사용량 한도 경고가 세션 중에 나타났다 사라졌다 하던 문제 수정.

명령과 도구

  • 워크플로의 agent() 호출에 출력 스키마가 크면 안전 분류기의 확인을 거치지 않고 auto 모드에서 바로 거부되던 문제 수정.
  • 업로드 도중 연결이 끊겨 아티팩트 게시가 중단되면 결과를 알 수 없다고만 보고하던 문제 수정. 이제 업로드가 완료되지 않았음을 확인할 수 있으면 한 번 다시 시도합니다.
  • 페이지 파일이 올바른 UTF-8이 아니거나 대체 문자(U+FFFD)를 포함할 때 아티팩트 게시가 도움이 되지 않는 오류로 실패하던 문제 수정. 이제 고쳐야 할 줄과 열 위치를 알려줍니다.
  • 기본 노력 수준이 고정된 모델(Opus 4.7, Opus 4.8, Fable 5)에서 사용자 지정 명령, 스킬, 서브에이전트의 effort: 프론트매터가 무시되던 문제 수정.
  • claude agents의 @ 디렉터리 메뉴가 세션 시작 이후에 만들어진 저장소를 보여주지 않던 문제 수정.

기업 환경과 게이트웨이

  • 가져온 마켓플레이스의 항목 경로에 역슬래시가 들어가면 macOS와 Linux에서 격리 검사를 통과할 수 있던 문제 수정.
  • Claude Desktop 같은 호스트 앱에서 AWS나 Google Cloud 자격 증명이 만료됐을 때, 다시 인증하라는 오류가 나오기 전에 “request failed”라는 일반 메시지로 열 번 재시도하던 문제 수정.
  • 관리형 allowedHttpHookUrls, httpHookAllowedEnvVars, allowedChannelPlugins를 읽을 수 없을 때 아무것도 허용하지 않는 대신 전부 허용하던 문제 수정.
  • 관리형 설정이 Claude apps gateway 로그인을 요구하는 기기에서 /login 대화상자가 Esc로 닫히지 않던 문제 수정.

[VSCode]

  • 저장된 기록에 부모 링크가 순환하는 대화에서 분기, 이전 메시지 편집, 되감기를 하면 확장 호스트가 CPU 100%로 멈추던 문제 수정.
  • WSL2/WSLg에서 스크린샷을 붙여 넣으면 이미지 원본 바이트가 채팅 입력창에 그대로 들어가던 문제 수정. 이제 클립보드가 이미지를 제공하면 첨부하고, 그렇지 않으면 붙여넣기를 무시합니다.
  • 채팅 안 diff 블록이 항상 어두운 편집기 테마로 표시되던 문제 수정. 이제 고대비 테마를 포함해 현재 적용된 VS Code 색 테마를 따릅니다.
  • 오른쪽에서 왼쪽으로 쓰는 문자(아랍어, 히브리어 등)와 영어가 섞인 글을 메시지 입력창에서 입력할 때 순서가 뒤바뀌어 표시되던 문제 수정.
  • Windows 줄바꿈(CRLF)을 쓰는 파일에서 diff 화면의 편집 수락이 “String not found in file”로 실패하던 문제 수정.
  • @ 멘션이 경로에 공백이 들어간 파일을 빠뜨리던 문제 수정.
  • 작업 폴더가 원격 호스트에만 있는 Remote-SSH 창에서 세션 목록 화면이 열리지 않던 문제 수정.
  • 크거나 심볼릭 링크가 많은 작업 공간에서 파일을 볼 때 ripgrep 프로세스가 통제 없이 늘어나던 문제 수정.

[Claude Code on the web]

  • GitHub Enterprise Server 세션에서 토큰이 만료되면 GitHub 계정이 연결 해제된 것으로 표시되던 문제 수정. 이제 PR과 이슈 작업 시 토큰이 자동으로 갱신됩니다.
  • Claude GitHub App이 없는 조직에서 gh 명령과 GitHub API 호출이 실패하던 문제 수정. 이제 연결된 GitHub 계정을 사용하며, 연결된 계정이 없으면 그 사실을 알려줍니다.

[Claude Tag]

  • 조직의 사용량 크레딧이 모두 소진됐을 때 Claude가 “The API rejected the request as invalid”라고 답하던 문제 수정. 이제 크레딧이 소진됐다는 사실과 충전 방법을 알려줍니다.
  • Claude가 채널 최상위에 올린 메시지를 스레드에서 수정하거나 삭제해 달라고 요청하면, 그 메시지를 올린 세션에 전달되지 않고 정정 답변만 돌아오던 문제 수정.
  • Admin settings > Review requests의 도구 접근 요청에서 Connect가 “Authorization failed”로 실패하거나 요청된 접근 묶음이 삭제된 것으로 표시되던 문제 수정.

알아두면 좋은 점

  • maxEffortLevel은 최상위 또는 modelSettings 아래 모델별로 지정합니다 — Bedrock, Vertex, Foundry를 포함한 모든 제공자에 상한이 적용되며, 사용자는 그보다 낮은 수준을 고를 수 있습니다.
  • --system-prompt-snapshot off는 프롬프트 문구를 다듬어 가며 확인할 때 쓰는 옵션입니다 — 대화가 기록해 둔 시스템 프롬프트를 재사용하지 않고 매 요청 새로 만듭니다.
  • 관리형 허용 목록의 실패 동작이 바뀌었습니다 — allowedHttpHookUrls, httpHookAllowedEnvVars, allowedChannelPlugins를 읽을 수 없으면 이제 전부 허용하지 않고 아무것도 허용하지 않습니다. 관리형 설정 파일이 잘못돼 있으면 지금까지와 반대로 차단되므로, 업그레이드 후 해당 항목이 정상적으로 읽히는지 확인하는 것이 좋습니다.
  • claude remote-control이 서버 자격 증명 만료 후에도 계속 동작합니다 — 시작 후 약 30일이 지나 자격 증명이 만료되면 호스트가 다시 등록하므로, 붙어 있던 세션이 한꺼번에 끊기지 않습니다.
  • 기본 노력 수준이 고정된 모델에서도 effort: 프론트매터가 적용됩니다 — Opus 4.7, Opus 4.8, Fable 5가 여기에 해당합니다.
  • 대화 도중 추가되는 MCP, 플러그인 도구는 지연 정의로 전달됩니다 — 지원되는 모델에 한하며, ToolSearch가 없는 세션에서 프롬프트 캐시가 깨지던 문제를 없애기 위한 변경입니다.
  • 셀프 호스팅 러너에서 레거시 git 프록시를 쓰면 세션마다 경고가 표시됩니다 — --use-anthropic-git-proxy 사용 여부가 러너 등록 시점에 서버로 보고됩니다.