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

Claude Code 2.1.234

claude.ai 사용 한도에 걸려 멈춘 세션이 한도가 초기화되면 자동으로 이어집니다(`/config`에서 끌 수 있음). GitLab 원격과 glab CLI를 쓰는 저장소는 푸터와 상태 표시줄에 merge request 배지가 표시되고, 텍스트 선택을 해제하는 `selection:clear` 키 바인딩과 프로젝트별 대화 기록 디렉터리 이름을 짧게 지정하는 `CLAUDE_CODE_PROJECT_DIR_NAME` 환경변수가 추가됐습니다. 내장 `claude-api` 스킬의 컨텍스트 비용은 20만 토큰대에서 2만 5천 토큰 수준으로 줄었고, `/permissions`와 `/add-dir`는 작업 중에도 열 수 있습니다. 권한 미리보기 전달과 자격 증명 마스킹, Remote Control 동기화, 대기 중인 `!` 셸 명령 처리 등 30건이 넘는 수정도 함께 들어왔습니다.

공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.234가 2026년 8월 17일 출시됐습니다. 사용 한도로 중단된 세션을 사람이 지켜보지 않아도 다시 이어가게 하는 자동 재개가 들어왔고, GitLab 사용 팀을 위한 표시가 푸터와 상태 표시줄까지 확장됐습니다. 나머지는 작업 중에도 설정 대화 상자를 열 수 있게 한 편의 개선, 내장 스킬의 컨텍스트 비용 절감, 그리고 권한 처리와 Remote Control 동기화, 터미널 화면 표시에 몰려 있던 30건 이상의 수정입니다.

새 기능

  • 사용 한도가 초기화되면 세션 자동 이어가기

    claude.ai 사용 한도에 걸리면 세션이 그 자리에서 멈춰, 한도가 풀린 뒤 사람이 직접 돌아와 다시 시작해야 했습니다. 이제 한도가 초기화되면 Claude Code가 세션을 자동으로 이어갑니다. 원치 않으면 /config의 “Continue automatically at usage limit”에서 끌 수 있습니다.

  • GitLab merge request 배지 (푸터, 상태 표시줄)

    2.1.233에서 --worktree 플래그와 claude agents 화면이 GitLab merge request 주소를 받게 됐지만, 작업 중인 MR의 상태는 화면에 드러나지 않았습니다. 이제 GitLab 원격이 있고 glab CLI에 로그인된 저장소는 푸터와 상태 표시줄에 MR !N 배지를 표시하며, 초안(draft), 대기(pending), 통과(green) 상태가 함께 나타납니다.

  • selection:clear 키 바인딩 동작

    마우스로 잡아 둔 텍스트 선택을 해제하려면 Esc를 눌러야 했고, 그 과정에서 진행 중인 작업이 함께 중단되기도 했습니다. 이제 선택 해제만 하는 selection:clear 동작에 원하는 키를 지정할 수 있고, agents 화면에서도 동작합니다.

  • CLAUDE_CODE_PROJECT_DIR_NAME 환경변수

    세션마다 별도의 설정 디렉터리를 만들어 주는 호스트 환경에서는 프로젝트별 대화 기록 디렉터리 이름이 길고 알아보기 어려웠습니다. 이제 이 환경변수로 짧은 이름을 지정할 수 있습니다. 직접 설정해야 적용됩니다.

주요 개선

  • 내장 claude-api 스킬의 컨텍스트 비용 절감

    Claude API 관련 작업에 쓰이는 내장 스킬을 불러오면 참조 문서 전체가 함께 올라와 20만 토큰이 넘는 분량을 차지했습니다. 이제 참조 문서를 필요할 때만 읽어 2만 5천 토큰 수준으로 줄었습니다.

  • 작업 중에도 /permissions/add-dir 사용

    권한 규칙을 고치거나 작업 디렉터리를 추가하려면 진행 중인 턴이 끝날 때까지 기다려야 했습니다. 이제 /permissions는 Claude가 작업하는 도중에도 열 수 있고, 바꾼 규칙은 남은 턴에 바로 적용됩니다. /add-dir <path>도 작업 중 사용할 수 있으며, 전체 화면 TUI에서는 /add-dir, /autocompact, /theme, /help, /config, /advisor 대화 상자가 턴 도중에 열립니다.

  • 내가 보낸 프롬프트도 마크다운으로 표시

    대화 기록에서 답변만 마크다운으로 그려지고, 사용자가 입력한 프롬프트는 서식 없는 글자로 남았습니다. 이제 내 프롬프트도 코드 블록 강조, 인라인 코드, 목록이 답변과 같은 방식으로 표시됩니다.

  • /goal이 멈춰 선 상태를 스스로 정리

    되돌릴 수 없는 오류(인증 해제, 크레딧 소진, 컨텍스트 초과 등)로 턴이 끝나도 /goal은 계속 걸린 상태로 남아 있었습니다. 이제 이런 경우 안내와 함께 스스로 해제됩니다. 또한 백그라운드 작업 때문에 목표가 30분 이상 대기하면 Claude가 해당 작업의 상태를 확인하며, 무한정 기다리지 않습니다. 이 확인이 불필요하면 CLAUDE_CODE_GOAL_CHECKIN_MINUTES=0으로 끌 수 있습니다.

  • “API returned an empty or malformed response” 오류 설명 보강

    이 오류는 무엇이 잘못됐는지 알 수 없어 원인을 좁히기 어려웠습니다. 이제 실제로 무엇이 돌아왔는지(콘텐츠 타입, 본문 종류, 크기, 요청 ID)와 원래의 스트리밍 요청이 왜 실패했는지가 함께 표시됩니다.

  • 자동 생성 세션 제목 개선

    자동으로 붙는 세션 제목이 요청을 그대로 옮긴 문장이라(“Fix the login button on mobile”) 목록에서 구분하기 어려웠습니다. 이제 짧고 구체적인 이름(“Login button bug”) 형태로 만들어집니다.

  • 전체 화면에서 Esc가 마우스 선택을 지우지 않음

    전체 화면 모드에서 Esc를 누르면 작업 중단이나 대화 상자 닫기와 함께 마우스로 잡아 둔 텍스트 선택까지 사라졌습니다. 이제 Esc는 기존대로 중단하거나 닫기만 하고, 선택은 그대로 남습니다.

  • 계정 이메일 사용 범위 제한

    Claude에게 계정 이메일을 사용자 식별 용도로만 쓰고, 요청하지 않는 한 관련 없는 서비스로 보내지 않도록 하는 지시가 추가됐습니다.

  • Windows NT 네임스페이스 경로 차단 확대

    2.1.233은 \??\로 표기한 Windows 경로가 UNC 경로 검증을 지나치던 문제를 막았지만, 승인 이전 단계에서 파일에 접근하는 경로가 일부 남아 있었습니다. 이제 원격 파일 읽기, 세션 복원, CLAUDE.md include, 워크플로 스크립트, 파일 업로드에서도 이 형식의 경로를 거부해 NTLM 자격 증명이 새어 나갈 수 있는 통로를 함께 막았습니다.

  • /config에서 “Default teammate model” 설정 제거

    팀 에이전트의 기본 모델을 따로 지정하는 설정이 실제 동작과 어긋나 혼란을 줬습니다. 이제 이 설정은 사라지고, 팀 구성원 에이전트는 생성 시 모델을 지정하지 않는 한 리더의 모델을 그대로 사용합니다.

  • claude setup-token의 인자 검사

    잘못 입력한 인자가 조용히 무시돼 명령이 의도대로 실행됐다고 오해하기 쉬웠습니다. 이제 예상하지 않은 인자가 있으면 실행을 거부합니다.

  • auto 모드의 중복 안내 줄 제거

    auto 모드는 Agent 도구 호출마다 “Allowed by auto mode classifier” 줄을 반복해서 보여줬습니다. 이 줄은 제거됐고, 실행 중인 도구 헤더의 경과 시간 표시도 흐리게 처리되어 굵게 표시되는 숫자와 덜 경쟁합니다.

주요 버그 수정

권한과 보안

  • 대화가 압축된 뒤 auto 모드가 샌드박스 명령의 네트워크 접근을 반복해서 다시 확인하고 거부하던 문제 수정. 매우 긴 세션에서 발생했습니다.
  • 백그라운드 서브에이전트의 도구 권한 확인에 답할 때 세션 범위 응답이 무시되던 문제 수정. 거부 응답도 함께 사라졌습니다.
  • 권한 미리보기가 신뢰 관문을 통과하지 않은 채널 서버에도 전달되던 문제 수정. 서버가 권한 기능을 명시적으로 거부한 설정도 이제 존중됩니다.
  • 자격 증명 마스킹이 승인자에게 보여야 할 명령, 경로, 대상까지 가리던 문제 수정. 지나치게 큰 개인 키 블록은 이제 전체를 가리는 방식으로 처리됩니다.
  • 권한 미리보기에서 가려지는 프로바이더 API 토큰이 셸 구분 기호 바로 뒤에 올 때는 가려지지 않던 문제 수정.
  • MCP 진단 메시지가 실제 비밀 값을 그대로 출력하던 문제 수정. 범위 충돌 경고는 설정에 적은 ${VAR} 형태로 표시되고, 연결 실패 상세에는 서버 주소만 표시됩니다.
  • strictKnownMarketplaces 허용 목록이 SCP 형식 git 마켓플레이스 주소를 통과시키던 문제 수정. git이 실제로 접속하는 호스트와 다른 주소가 허용될 수 있었습니다.
  • 신뢰 확인 창이 저장소 전체 범위 경고를 빠뜨리던 문제 수정. 해당 위치에 저장소가 생기기 전부터 알고 있던 디렉터리에서 발생했습니다.

터미널 화면과 입력

  • 특이한 유니코드 문자가 섞인 메시지에서 마크다운 렌더링이 매우 느려지던 문제 수정.
  • 마크다운의 --- 수평선이 바로 다음 줄과 붙어 표시되던 문제 수정.
  • 전체 화면에서 /login 인증 주소 같은 대화 상자 안 글자를 복사하면 일부가 빠지던 문제 수정.
  • “Try the new fullscreen renderer?” 안내를 수락하면 세션이 재시작되면서 권한 모드(예: --dangerously-skip-permissions), 도구 허용, 거부 규칙, 모델, effort(추론 강도) 플래그가 사라지던 문제 수정.
  • /tui가 재시작하면서 실행 시 지정한 --allowed-tools, --disallowed-tools 규칙을 잃던 문제 수정. 재시작으로 옮길 수 없는 제한이 걸린 세션에서는 이유를 밝히고 전환을 거절합니다.
  • 대기열에 넣은 ! 셸 명령 관련 문제 묶음 수정. 위 화살표로 대기 중인 입력을 고치면 명령이 일반 텍스트로 모델에 전달되던 문제, 대기 중인 메시지가 프롬프트 기록에 다시 나타나던 문제, 대기 중인 메시지를 고르는 중 Esc를 누르면 턴이 중단되던 문제, 턴 도중 전송한 뒤 ! 모드가 그대로 남던 문제가 함께 정리됐습니다.
  • ! 셸 명령이 실행되는 동안 연 /permissions 같은 대화 상자가 명령이 끝나면 닫히던 문제 수정.
  • 연속 실행한 셸 명령이 여러 개의 “Ran 1 shell command” 행으로 나뉘던 문제 수정. 사이에 작업 목록 갱신이 끼어들 때 발생했습니다.
  • 권한을 다시 묻는 도중 IDE의 diff 탭이 닫히면 이전 입력이 새 확인 창의 답으로 들어가던 문제 수정.

Remote Control과 세션 연동

  • Claude Code Desktop이나 VS Code에서 실행한 Remote Control 세션에서 사용자에게 보낸 파일이 업로드되지 않던 문제 수정. 휴대폰과 웹에서 빈 카드만 보이던 것이 이제 정상적으로 열립니다.
  • 이 컴퓨터를 다른 claude.ai 계정이나 조직으로 로그인해도 실행 중인 세션이 몇 시간 뒤에야 HTTP 404로 실패하던 문제 수정. 이제 몇 초 안에 세션이 중지되고 이유가 표시됩니다.
  • Remote Control 세션의 권한 모드와 모델, effort 설정이 클라이언트 간에 어긋나던 문제 수정. Desktop이나 VS Code에서 시작한 세션은 권한 모드 변경을 휴대폰과 claude.ai/code에 계속 알리고, 휴대폰이나 claude.ai/code에서 고른 effort 값이 터미널과 Desktop, VS Code 세션에도 적용됩니다.
  • /loginCLAUDE_CODE_OAUTH_TOKEN이 설정돼 있으면 만료 토큰 안내가 자동 재개된 턴에 섞여 들어가던 문제 수정. 이 안내는 이제 사용자에게만 표시됩니다.
  • Claude Desktop에서 세션 간 메시지가 조용히 사라지던 문제 수정. 받는 세션이 세션 간 메시지 기능을 꺼진 것으로 판단해 메시지를 버렸고, 보낸 쪽은 몇 분씩 응답을 기다렸습니다.
  • SendMessageListAgents가 계정의 세션 목록이 너무 길어 전부 확인하지 못한 경우를 알리지 않던 문제 수정. 확인하지 못한 세션을 없는 것으로 취급하지 않고 그 사실을 알려 줍니다.
  • ListAgents에서 복사한 수신자를 SendMessage가 거부하던 문제 수정. 세션 이름이 200자 상한에 닿거나 이모지가 많을 때 발생했습니다.

그 밖의 수정

  • 비스트리밍 대체 경로로 받은 API 응답에서 발생하던 크래시 수정. thinking 블록에 thinking 필드가 없거나 text 블록에 text 필드가 없을 때 발생했으며, 주로 서드파티 게이트웨이를 거칠 때 나타났습니다.
  • git 원격 주소에 특이한 사용자 정보가 들어 있으면 저장소 호스트를 잘못 읽던 문제 수정. 엉뚱한 호스트 기준으로 링크와 저장소별 동작이 적용됐습니다.
  • 만료된 Anthropic 프로필 자격 증명 안내 개선 — claude.ai 로그인이 우선하는 상황에서는 /login을 안내합니다.
  • [Windows] ~/.claude.json이 읽기 전용일 때 이름 바꾸기를 반복 시도하며 시작이 멈추던 문제 수정.

알아두면 좋은 점

  • 자동 이어가기는 기본으로 켜져 있습니다 — claude.ai 사용 한도가 초기화되면 세션이 자동으로 이어집니다. 한도에 걸린 지점에서 멈춰 있기를 원한다면 /config의 “Continue automatically at usage limit”을 끕니다.
  • 전체 화면에서 Esc의 동작이 바뀌었습니다 — 이제 Esc로는 마우스 텍스트 선택이 지워지지 않습니다. 선택 해제를 키 하나로 하고 싶다면 selection:clear 동작에 원하는 키를 지정합니다.
  • 팀 에이전트 기본 모델 설정이 사라졌습니다/config의 “Default teammate model”에 의존하던 구성이 있다면, 이제 팀 구성원은 생성 시 모델을 지정하지 않는 한 리더의 모델을 사용합니다.
  • /goal의 30분 확인은 끌 수 있습니다 — 백그라운드 작업이 오래 걸리는 것이 정상인 흐름이라면 CLAUDE_CODE_GOAL_CHECKIN_MINUTES=0으로 확인을 끕니다.
  • GitLab MR 배지는 glab CLI 로그인이 필요합니다 — GitLab 원격이 있어도 glab CLI에 인증돼 있지 않으면 배지가 표시되지 않습니다.
  • CLAUDE_CODE_PROJECT_DIR_NAME은 직접 설정해야 적용됩니다 — 설정하지 않으면 대화 기록 디렉터리 이름은 이전과 같습니다.