Claude Code 2.1.243

무엇이 바뀌었나?

Claude Code 2.1.243이 2026년 8월 24일 출시됐습니다. 조직 단위 운영에 필요한 설정(modelPicker, modelPricing, promptCacheTtl)과 관리 상태를 드러내는 표시가 대거 추가됐고, 시작 속도, 메모리, 설치 파일 크기 같은 실행 비용이 전반적으로 낮아졌습니다. 연결이 끊긴 뒤 복구되지 않거나 응답 없이 멈춰 있던 경로도 함께 정리됐습니다.

새 기능

• /usage의 Loops 사용량 분해

  /loop로 반복 실행되는 작업이 얼마나 많은 토큰을 쓰는지 확인할 방법이 없어, 과도하게 도는 루프를 찾아내기 어려웠습니다. /usage에 Loops 항목이 추가되어 루프별 실행 횟수, 총 토큰, 실행당 토큰, 마지막 실행 시각을 볼 수 있습니다.

• modelPicker 설정으로 /model 목록 구성

  /model 피커에는 기본 모델 목록이 그대로 나와, 조직이 실제로 쓰는 모델만 남기거나 순서를 바꿀 수 없었습니다. modelPicker 설정으로 순서와 라벨을 지정한 모델 목록을 만들 수 있고, Vertex, Bedrock 형식을 포함한 어떤 ID 표기도 사용할 수 있습니다. 기본 목록에 덧붙이거나 기본 목록을 대체하는 방식 모두 가능합니다.

• promptCacheTtl, subagentPromptCacheTtl 설정

  프롬프트 캐시 유지 시간을 조정할 수 없어, API 키나 클라우드 프로바이더로 접속하는 사용자는 긴 대화에서도 짧은 캐시만 쓸 수 있었습니다. 두 설정이 추가되어 메인 대화는 1시간 프롬프트 캐시를 유지하면서 서브에이전트는 5분으로 두는 구성이 가능합니다.

• modelPricing 관리형 설정

  조직이 계약한 모델 단가가 있어도 /cost, 상태 표시줄, 텔레메트리의 비용 수치는 정가 기준으로 계산돼 실제 지출과 어긋났습니다. modelPricing 관리형 설정으로 모델별 계약 단가와 할인 배수를 지정하면 세 곳 모두 그 값을 사용합니다.

• API 키 없이 Anthropic Console 계정으로 로그인

  Console을 쓰는 조직이라도 로그인하려면 API 키를 만들어야 해서, API 키 발급을 허용하지 않는 조직은 접속할 방법이 없었습니다. /login → Anthropic Console에 “Sign in with your Console account” 항목이 추가됐고, API 키 생성과 나란히 제공되며 권장 방식으로 표시됩니다.

• /tasks에 서브에이전트가 사용한 모델 표시

  서브에이전트가 어떤 모델과 effort 레벨로 실행됐는지 확인할 수 없었습니다. /tasks와 에이전트 상세 대화상자에 실행 모델과 effort 레벨이 표시됩니다.

• 관리 상태와 연결 상태를 드러내는 표시 추가

  설정이 왜 적용되지 않았는지, 무엇이 조직 관리 대상인지 화면에서 알기 어려웠습니다. /status에 Skipped sources 줄이 추가되어 managed-settings.json처럼 존재하지만 우선순위가 더 높은 관리형 소스 때문에 적용되지 않은 항목을 보여줍니다. /mcp와 /plugins에서는 조직이 인증을 관리하는 claude.ai 커넥터에 managed 표시가 붙습니다. 웹에서 Claude Code를 쓰는 Pro, Max 사용자를 위해 GitHub 연결 여부를 알리는 /status 줄과 /web-setup을 안내하는 팁도 추가됐습니다.

주요 개선

• 시작 시간 단축

  샌드박스와 MCP 준비가 끝날 때까지 첫 화면이 그려지지 않았습니다. 이제 두 작업이 첫 프레임을 막지 않고, 하위 명령 없이 실행하면 서브커맨드 등록을 건너뛰며, 워크플로 탐색과 설정, 신뢰 저장소 처리 비용도 줄었습니다.

• 설치 파일과 자동 업데이트 다운로드 크기 감소

  네이티브 설치와 자동 업데이트가 매번 큰 파일을 내려받아야 했습니다. 바이너리를 zstd로 압축해 Linux x64 기준 340MB에서 약 75MB로 줄었고, 번들에 포함된 스킬과 프롬프트 텍스트를 더 조밀하게 저장해 바이너리 자체도 약 2MB 작아졌습니다.

• 메모리 사용량 감소

  네이티브 빌드가 번들 전체를 메모리에 올린 채 유지했습니다. 이제 코드를 필요할 때 불러오는 방식으로 바뀌어 세션당 약 40-70MB를 덜 쓰고, 오래 실행되는 세션에서는 힙이 커질 때 더 일찍 가비지 컬렉션이 돌아 최대 메모리 사용량도 낮아졌습니다.

• SSH 환경의 /login 개선

  SSH로 접속한 터미널에서는 로그인 URL이 늦게 나타나고, c를 눌러 복사하면 실제 결과와 무관하게 성공했다고 표시됐습니다. 이제 URL이 즉시 표시되고, c를 누르면 어떤 방식으로 복사했는지 알려주며, 전체 화면에서 텍스트를 선택하는 방법을 안내하는 힌트가 함께 나옵니다.

• effort xhigh, max 오류 메시지 개선

  thinking이 꺼진 상태에서 높은 effort를 쓰면 무엇이 문제인지 알기 어려운 오류가 나왔습니다. 이제 어떤 레벨을 쓰려 했는지, thinking을 끈 설정이 무엇인지, 그리고 /effort high로 해결할 수 있다는 점까지 알려줍니다.

• /loop 대기 출력 정리

  할 일이 없는 상태로 깨어날 때마다 터미널에 한 줄씩 쌓였습니다. 이제 연속된 빈 대기는 한 줄로 접혀 표시됩니다.

• 텔레메트리의 조직 귀속 개선

  ANTHROPIC_AUTH_TOKEN으로 Anthropic API에 직접 인증하는 세션과 Claude 계정으로 로그인한 VS Code 확장의 사용량 텔레메트리가 조직에 제대로 귀속되지 않았습니다. 이제 귀속이 정확해져 해당 조직의 데이터 처리 설정이 적용됩니다.

• [VS Code] 긴 세션의 히스토리 정리 기준 변경

  긴 세션에서 히스토리를 잘라낼 때 대화 내용까지 사라졌습니다. 이제 오래된 도구 실행 기록을 먼저 지워 사용자의 메시지와 Claude의 답변이 화면에 남습니다.

• 다른 터미널이 Remote Control을 쥐고 있을 때의 안내 개선

  안내 문구만으로는 왜 접근할 수 없는지 알기 어려웠습니다. 이제 다른 컴퓨터에서 실행 중인 세션은 이쪽에서 볼 수도, 접근할 수도 없다는 점을 명시합니다.

주요 버그 수정

연결과 응답 복구

• -p 비대화형 실행과 SDK 세션에서 원격 MCP 서버가 연결이 끊긴 뒤 전혀 복구되지 않던 문제 — 이제 자동으로 재연결하거나 실패로 보고합니다.
• Anthropic API가 응답을 시작하지 않아 세션이 10분 넘게 조용히 멈춰 있던 문제 — 약 3분 후 요청이 타임아웃되고 한 번 재시도한 뒤 API Error: No response from API를 표시합니다.
• 데스크톱 앱에서 시작한 MCP 서버 로그인이 “Invalid redirect URI”로 실패하던 문제 수정. Linear처럼 client ID metadata document를 지원하는 서버에서 발생했습니다.
• 2.1.232의 소켓 디렉토리 보안 강화 이후 사용자 네임스페이스와 rootless 컨테이너에서 세션 간 메시징이 조용히 꺼지던 문제 수정.
• 마지막 백그라운드 Bash 작업이 끝나도 백그라운드 서브에이전트가 깨어나지 않던 문제 수정.

auto mode와 모델 선택

• 서버 측에서 일시적으로 비활성화된 상태가 캐시되고 이후 플래그 조회가 실패하면 시작 시 auto mode를 계속 쓸 수 없던 문제 수정.
• API가 일시적으로 과부하되어 클라이언트에 재시도를 요청했을 때, 약 1분을 기다린 뒤 auto mode 도구 호출이 “temporarily unavailable”로 거부되던 문제 수정.
• /model 피커에서 Ultracode를 선택해도 조용히 무시되던 문제 수정. 이제 선택하면 현재 세션에 적용됩니다.

세션 관리와 재개

• /resume이 최근 50개 세션만 보여주던 문제 — 이제 스크롤하면 더 불러옵니다.
• 턴 도중 재시작된 클라우드 세션을 재개할 때, 대기 중이던 훅이나 백그라운드 작업 알림이 평소의 이어가기 메시지 대신 프롬프트로 다시 전송되던 문제 수정.
• claude --teleport <session>이 커밋되지 않은 변경이 있으면 그냥 종료되던 문제 수정. 세션 피커와 마찬가지로 stash 후 계속할지 물어봅니다.
• /clear가 프롬프트 바에서 /rename으로 지정한 세션 이름을 지우던 문제 수정. 이름은 새 세션에도 유지되고 있었습니다.

터미널 렌더링과 입력

• 컨테이너 밖으로 넘치는 텍스트(예: /login의 로그인 URL)가 화면의 다른 부분이 다시 그려질 때 앞쪽 열을 잃던 문제 수정.
• 이모지 바로 뒤에 오타를 입력하면 spellcheck가 밑줄을 긋지 않던 문제 수정.
• ~/.claude/history.jsonl에 잘못된 항목이 있으면 Ctrl+R 히스토리 검색과 위 화살표 히스토리가 동작하지 않던 문제 수정.
• 수정 키를 인코딩하는 터미널(modifyOtherKeys, kitty 프로토콜)에서 Ctrl+[로 vim INSERT 모드를 빠져나올 수 없던 문제 수정.
• 인증, 모델 가용성 등 클라이언트가 생성한 오류 메시지가 오류 줄이 아니라 모델 출력처럼 렌더링되던 문제 수정.

설정, 훅, 플러그인

• Bash(cat *) 같은 훅 if 조건이 관련 없는 Bash 명령에도 발동하던 문제 수정. 명령에 $()나 백틱 명령 치환이 있고 뒤에 인자가 더 붙은 경우 발생했습니다.
• marketplace 필드로 선언한 플러그인 의존성이 두 플러그인을 --plugin-dir로 함께 로드하면 해석되지 않던 문제 수정.
• 마지막 LSP 플러그인을 비활성화한 뒤에도 /reload-plugins가 LSP 도구를 유지하던 문제 수정. 대화를 다시 읽게 되는 LSP 플러그인 변경 전에는 경고도 표시됩니다.
• --agents가 잘못된 JSON이나 잘못된 에이전트 정의를 조용히 무시하던 문제 수정. 이제 --mcp-config처럼 명확한 오류와 함께 종료됩니다.
• ~/.claude.json에 잘못된 MCP 서버 항목이 있을 때 /status가 파일명 없이 “Found invalid entries in: .”만 표시하던 문제 수정.

조직 환경과 CI

• CI의 workload identity federation에서 한 잡의 여러 프로세스가 일회용 토큰을 각자 다시 교환하던 문제 수정. 이제 교환한 토큰을 공유하며, 교환이 거부되면 서버가 준 메시지와 함께 즉시 실패합니다.
• 서버에서 관리하는 companyAnnouncements가 로그인으로 시작한 세션(예: /logout 이후 첫 실행)에서 표시되지 않던 문제 수정.
• NO_PROXY에 localhost가 있어도 소문자 no_proxy가 없으면 로컬 IDE 연결이 HTTPS_PROXY를 거쳐 실패하던 문제 수정. 이제 대문자와 소문자 표기를 모두 인식합니다.
• 차단된 명령이 그래도 종료 코드 0으로 끝나면(예: curl이 프록시의 403 페이지를 출력한 경우) 샌드박스 네트워크 위반 내역이 Bash 도구 결과에서 누락되던 문제 수정.
• 세션이 유휴 상태인 동안 사용량 한도 창이 초기화돼도 상태 표시줄의 rate_limits 필드와 /usage가 초기화 이전 사용률을 계속 보여주던 문제 수정.

웹, Remote Control, VS Code

• gh auth token이 없는 구버전 GitHub CLI로 이미 인증돼 있어도 /web-setup이 로그인을 반복해서 요구하던 문제 수정.
• 자동 업데이트가 설정 당시 버전을 정리하면서 Claude in Chrome이 Claude Code와의 연결을 잃던 문제 수정. 이제 네이티브 호스트가 고정된 claude 실행기를 통해 시작됩니다.
• 서버가 세션 도중 환경을 내리면 claude remote-control이 종료되면서 연결된 Remote Control 세션이 고립되던 문제 수정. 이제 복구합니다.
• 관리자나 소유자 권한이 없는 Team, Enterprise 구성원에게서, claude remote-control이 제공하는 Remote Control 세션이 중지 후 재시작하면 멈춰 있던 문제 수정.
• [VS Code] 기능 플래그를 처음 가져오기 전에 시작한 세션(예: 설치 직후)이 auto mode나 설정한 기본 모드가 아니라 기본 권한 모드로 열리던 문제 수정.
• [VS Code] 펼쳐 둔 Focus view 섹션이 서브에이전트 도구 활동 중에 저절로 접히던 문제 수정.

알아두면 좋은 점

• 샌드박스 Bash 프롬프트에서 허용 호스트 목록이 빠졌습니다 — 목록에 없는 호스트를 Claude가 차단된 것으로 단정하던 동작을 막기 위한 변경입니다. 이제 일단 요청을 시도하므로, 필요한 호스트를 그 자리에서 승인할 수 있습니다.
• macOS computer use에 Finder 권한이 필요합니다 — 데스크톱, Dock, Finder 창을 클릭하려면 다른 앱과 마찬가지로 접근 권한 대화상자에서 Finder를 허용해야 합니다.
• /model, /fast, /effort가 즉시 적용됩니다 — Bedrock, Vertex, Foundry 환경과 텔레메트리를 끈 환경에서 턴이 끝날 때까지 대기하지 않고 바로 실행됩니다.
• 세션 간 메시징 수신 소켓에 30초 제한이 생겼습니다 — 30초 안에 완결된 한 줄을 보내지 않는 연결은 닫힙니다. 이 소켓으로 메시지를 보내는 스크립트는 데이터가 준비된 뒤에 연결해야 합니다.
• Sonnet 5의 $2/$10 per Mtok은 표시 방식만 바뀐 것입니다 — /model 피커와 번들 claude-api 스킬에서 이 가격을 한시 프로모션이 아니라 표준 정가로 표시하도록 바뀌었습니다. 가격 자체가 변경된 것은 아닙니다.
• promptCacheTtl은 API 키, 클라우드 프로바이더 사용자 대상입니다 — 메인 대화의 1시간 프롬프트 캐시와 서브에이전트의 5분 캐시를 따로 지정하는 용도입니다.
• modelPricing은 관리형 설정입니다 — 개인이 켜는 옵션이 아니라 조직 관리자가 계약 단가와 할인 배수를 배포하는 설정으로, 적용되면 /cost, 상태 표시줄, 텔레메트리의 비용 수치가 모두 그 값을 따릅니다.