Claude Code 2.1.268 릴리스 노트

📌 이 글은 Claude Code 2.1.268 릴리스 노트를 한국어로 번역한 것입니다.

✨ 새 기능

• Claude 앱 게이트웨이 추가: gateway.yaml에 pricing:이 설정되어 있으면 로그인한 Claude Code 클라이언트가 관리형 설정을 통해 동일한 요율을 전달받아 /cost 및 원격 측정이 지출 측정기와 일치하게 됨
• 게이트웨이에서 access_control.allow_cidrs가 비어 있을 때 시작 경고를 표시하고, 퍼블릭 주소에서 첫 요청이 들어올 때 1회성 경고를 표시하는 기능 추가
• 관리자가 조직의 자체 퍼블릭 IPv4 블록에서 Claude 앱 게이트웨이로의 /login을 허용할 수 있는 gatewayInternalNetworks 관리형 설정 추가
• claude self-hosted-runner --remove-session-state(기본값 꺼짐) 추가: 세션 종료 시 <base-dir>/_sessions/ 하위의 세션별 디렉터리를 삭제함
• claude auth status --json 출력에 configDirectory 추가
• claude plugin install, uninstall, update, enable, disable 명령어에 --json 옵션 추가 및 claude plugin list --json의 각 행에 errorDetails/noteDetails 추가
• 게시된 아티팩트에 대해 각 페이지에 어울리도록 Claude가 선택한 브라우저 탭 아이콘 추가
• [VS Code] 키보드 및 스크린 리더 사용자를 위해 상시 허용 권한 규칙이 저장되는 위치를 변경할 수 있는 좌우 방향키 기능 추가
• [VS Code] 키보드 및 스크린 리더 사용자를 위해 대화의 가장 최신 메시지로 키보드 포커스를 이동하는 "Claude Code: Focus last message" 명령어 추가
• [Claude Tag] Slack 채널 구성 페이지에서 조직의 Claude in Slack 관리자 설정으로 돌아가는 링크 추가
• [Code Review] 후속 리뷰의 미해결 지적 사항(findings) 목록 아래에 안내 추가: 지적 사항 스레드에 단순 답글 작성이 아닌 '해결(resolve)' 처리를 해야 이후 리뷰에서 미해결로 집계되지 않음

🔧 개선

• 전체 화면 모드 개선: 줄바꿈(Shift+Enter)으로 프롬프트 줄을 추가하거나 제거할 때 전체 트랜스크립트를 다시 렌더링하지 않고 일반 글자 입력만큼 빠르게 화면이 다시 그려짐
• --continue / /resume 개선: SessionStart 훅 완료를 대기하지 않고 대화가 즉시 표시되며, 첫 번째 메시지에서 전체 트랜스크립트를 다시 읽지 않음
• 도구 호출이 많은 턴에서 숨겨진 도구 배치별 리마인더로 인해 트랜스크립트를 다시 그리지 않도록 하여 응답 속도 개선
• .claude/workflows/ 스크립트가 포함된 프로젝트의 시작 시간 개선: 목록 조회 시 각 스크립트를 매번 파싱하지 않음
• 자동 모드(auto mode) 거부 알림 개선: 작업을 차단한 규칙 이름이 Claude에게 전달되며, 사용자에게 확인을 요청하기 전에 더 안전한 방법을 시도하고 관련 없는 작업을 먼저 완료하도록 안내함
• Claude in Chrome 개선: 긴 웹페이지를 읽을 때 파일로 저장한 뒤 다시 읽지 않고 인라인 상태를 유지함
• MEMORY.md 잘림 경고 개선: 잘려 나간 줄 수와 잘림이 시작된 위치를 명시하도록 개선
• 아티팩트에 대한 터미널 권한 프롬프트 개선: 확인 질문을 프롬프트 맨 위에 표시함
• 프롬프트 푸터 개선: 에디터 또는 /diff 선택 영역이 프롬프트 입력창 내부에 표시되며, 전체 화면 모드에서는 Remote Control 상태가 푸터 대신 헤더에 표시됨
• "Usage credits required for 1M context" 메시지 개선: 세션 도중 활성화된 사용량 크레딧은 Claude Code를 재시작해야 적용된다는 안내 추가
• /plugin 개선: 메뉴를 닫을 때 플러그인 설치, 활성화, 비활성화가 즉시 적용되며 이후 /reload-plugins를 별도로 실행할 필요가 없음
• Bedrock, Vertex, Foundry의 시스템 프롬프트가 퍼스트 파티 세션과 동일하게 환경, 모델, 설정 세부 정보를 첨부 파일로 전달하도록 변경됨
• Bedrock, Vertex, Foundry 세션에서 퍼스트 파티 세션과 동일하게 대화 전반에 걸쳐 도구 목록을 바이트 단위로 안정적으로 유지하도록 변경됨 (늦게 연결된 도구는 목록을 덮어쓰지 않고 지연 로드됨)
• 작업 추적 도구(TaskCreate/Get/Update/List, TodoWrite)가 Claude 3.x, Opus 4.0–4.7, Sonnet 4.0–4.6, Haiku 4.5에서만 기본 제공되도록 변경됨 (그 외 환경에서는 CLAUDE_CODE_ENABLE_TODO_TOOLS=1 설정 필요)
• 터미널의 아티팩트 데이터 수정 권한 프롬프트가 문서 수와 아티팩트를 열 수 있는 사용자를 보여주는 카드 형태로 변경됨
• 모든 승인을 건너뛰도록 설정된 로컬 Cowork 세션 변경: Artifact 도구가 세션 폴더 외부나 심볼릭 링크 뒤에 있는 로컬 파일을 묻지 않고 읽지 않고 거부함
• 일반 WebFetch의 거부(deny) 및 확인(ask) 규칙이 Artifact 도구의 읽기 및 업데이트에 적용되지 않도록 변경됨 (차단 또는 제어하려면 Artifact 규칙 또는 WebFetch(domain:claude.ai) 사용 필요)
• "N MCP servers need authentication" 시작 알림이 매번 실행될 때마다 뜨지 않고 각 서버당 한 번만 표시되도록 변경됨
• [VS Code] 플러그인 관리 대화상자에서 설치, 활성화, 비활성화, 삭제 작업이 재시작 없이 현재 열려 있는 세션에 즉시 적용되도록 변경됨
• [VS Code] 터미널 환경과 일치하도록 일부 아티팩트 권한 프롬프트에서 "다시 묻지 않음" 선택지를 생략하도록 변경됨
• [Claude Code on the web] 대화를 통한 루틴 생성 개선: 새 루틴에 커넥터가 없는 경우 단순 생성 확인만 하지 않고 커넥터가 없다는 사실과 추가 방법을 안내함
• [Claude Tag] 차단된 작업에 대한 설명 개선: 권한 검사, 자체적인 사전 확인 판단, 접근 권한 부족 중 무엇 때문에 작업이 중단되었는지 명시함
• [Claude Tag] 응답 속도 개선: Slack 검색, 스레드 읽기, 사용자 조회 등 여러 읽기 전용 조회를 순차적이 아닌 병렬로 동시에 실행함
• [Claude Tag] 비교 서식 개선: 문장 단위의 비교 내용이 가로 스크롤 표 대신 목록 형태로 제공되며 긴 표 셀은 자동 줄바꿈됨
• [Claude Tag] Claude 계정과 Slack 워크스페이스의 조직이 다를 때 표시되는 안내 메시지 개선: 워크스페이스를 조직에 연결하는 방법 안내
• [Claude Tag] 공개 채널 메모리 동작 변경: 각 채널이 자체 노트를 유지하며 다른 공개 채널에 저장된 노트를 불러오지 않음 (워크스페이스 공유 노트는 유지됨)

🐛 버그 수정

• 2.1.265 이후 타사 Anthropic 호환 엔드포인트(ANTHROPIC_BASE_URL)에서 Artifact 도구의 입력 스키마 정규식을 거부하여 매 턴마다 HTTP 400 오류가 발생하던 문제 수정
• 서버가 응답을 완료하지 않고 열어둘 때 WebFetch가 무한 대기하던 문제 수정 (이제 300초 후 요청이 실패하며, CLAUDE_CODE_WEBFETCH_DEADLINE_MS로 타임아웃 조정 가능, 0은 비활성화)
• 프로세스 내에서 재생성된 팀원 에이전트가 신뢰하지 않은 폴더의 동명 에이전트 파일로부터 도구나 시스템 프롬프트를 가져오던 문제 수정
• 장시간 대기 중인 세션의 비지 루프(busy loop)로 인한 CPU 코어 점유 문제 및 세션 요약 중 빠른 터미널 포커스 보고로 인해 CPU 사용량이 높게 유지되던 문제 수정
• MCP 도구 호출 후 Claude가 "your message came through empty"라고 응답하던 간헐적 문제 수정
• 실제 경로로 지정 시 심볼릭 링크 디렉터리(macOS의 /etc, /tmp, /var, Linux의 /bin)의 거부 및 확인 권한 규칙이 적용되지 않던 문제와 Bash 명령어가 심볼릭 링크 경로로 작성된 거부 규칙을 무시하던 문제 수정
• env -C, eval 등 권한 검사기가 분석할 수 없는 명령어가 같은 줄에 있을 때 Read 또는 Edit 거부 규칙이 적용되지 않던 문제 수정
• 플러그인 및 마켓플레이스 오류에 Git 소스 URL의 토큰이나 비밀번호가 노출되던 문제 수정
• /mcp, /plugin 서버 상세 정보, claude mcp list/get, MCP 로그인 오류에 MCP 설정의 ${VAR} 플레이스홀더에서 확인된 비밀값이 노출되던 문제 수정
• excludeDynamicSections를 사용하는 SDK 세션에서 프롬프트 캐싱 및 확장 사고(extended thinking)가 세션 도중 중단되던 문제 수정 (첫 번째 메시지가 매 요청마다 다시 렌더링되지 않음)
• 캐시된 모델 접근 거부 정보가 만료되었음에도 재시작 후 또는 Desktop Code 탭에서 권한이 있는 사용자에게 모델이 제한되었다고 안내하던 문제 수정
• 다른 Claude Code 프로세스가 만료된 모델 접근 항목을 갱신할 때 실행 중인 세션이 조직의 기본 모델로 조용히 전환되던 문제 수정
• Pro 및 Team 플랜에서 Fable 모델의 긴 컨텍스트 429 오류 발생 시 1M 컨텍스트 메시지 대신 사용량 크레딧 동의 프롬프트가 표시되던 문제 수정
• 프로필을 통한 워크로드 아이덴티티 페더레이션(claude-code-action 설정 등) 사용 시 프로필을 공유하는 프로세스들이 실행 도중 401 … jti reused 오류로 실패하던 문제 수정
• 로컬 콜백 포트 범위를 바인딩할 수 없을 때 MCP 서버 OAuth 로그인이 "No available ports for OAuth redirect" 오류와 함께 실패하던 문제 수정
• /compact 및 자동 압축으로 생성된 대화 요약에 $ 시퀀스가 포함된 텍스트가 깨지던 문제 수정
• /compact로 종료된 대화를 재개할 때 복원된 파일 노트가 매번 동일한 순서로 로드되지 않던 문제 수정
• SDK 프롬프트 제안, 보조 질문, /rename이 압축 이전의 대화를 전송하던 문제 수정
• 위쪽 화살표로 이전 프롬프트를 불러와 수정한 후 @ 파일 및 / 명령어 제안이 나타나지 않던 문제 수정
• claude agents에서 에이전트 목록으로 돌아가기 위해 ← 키를 자연스러운 속도로 다시 누를 때 1초 이상 멈추지 않으면 무시되던 문제 수정
• 워크트리를 제거할 수 없을 때 claude agents 세션 삭제가 멈추던 문제 수정 (원인과 다음 단계를 안내하며, Git 워크트리의 경우 Ctrl+X를 다시 누르면 강제 삭제됨)
• 에이전트 패널의 백그라운드 에이전트 및 워크플로 행에 줄바꿈 텍스트가 포함되어 있을 때 여러 줄로 확장되던 문제 수정
• 조직 관리형 설정에서 MCP 허용 목록을 지정했을 때 Claude in Slack 세션에서 Slack 도구를 잃어버리던 문제 수정
• Claude in Chrome에서 이동 URL에 스킴은 있지만 호스트를 파싱할 수 없을 때 "https" 호스트 허용을 묻던 문제 수정
• 현재 작업 라벨이 길 때 스피너가 여러 줄로 줄바꿈되던 문제 수정 (라벨과 "Next:" 작업 줄이 한 터미널 행 내에 유지됨)
• 터미널 기본 커서가 활성화되어 있을 때 /bug 및 /feedback 설명 필드에 커서가 표시되지 않던 문제 수정
• claude remote-control로 서비스되는 Remote Control 세션이 ListAgents에서 세션 제목 대신 생성된 이름을 표시하던 문제 수정
• claude plugin validate가 플러그인 로더에서는 허용되는 점 두 개(..)로 시작하는 디렉터리 경로를 거부하던 문제 수정
• 플러그인이 확인할 수 없는 기본 모니터 파일이나 루트 SKILL.md를 경고 없이 건너뛰던 문제 수정
• WebFetch에서 localhost 및 점(.)이 없는 호스트 이름에 대해 URL 거부 이유를 설명하고 curl 사용을 제안하도록 오류 메시지 수정
• --print 모드에서 PermissionRequest 훅이 트리거되지 않던 문제 수정
• 헤드리스(-p) 실행 시 정책 도우미 경고가 출력되지 않던 문제 수정
• /resume 실행 시 /fork 백그라운드 세션이 자체 ⑂ 포크 이름 대신 부모 세션 이름으로 표시되던 문제 수정
• 로그아웃 상태일 때 /remote-control 및 기타 claude.ai 제한 명령어가 Claude for Enterprise 마이그레이션 메시지 대신 /login을 제안하도록 수정
• CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS 설정 시 개별 타임아웃이 없는 SessionEnd 훅의 대기 시간이 연장되지 않던 문제 수정 (기존 1.5초 후 취소됨)
• GitHub 계정이 연결되지 않았을 때 /autofix-pr 등 클라우드 세션 명령어가 재시도 또는 Claude GitHub App 설치를 안내하던 문제 수정 (이제 /web-setup 또는 웹 연결 페이지로 안내함)
• 조직 정책에 의해 비활성화된 /teleport, /remote-env 등의 클라우드 세션 명령어가 "Unknown command" 대신 정책에 따른 비활성화 상태를 설명하도록 수정
• Bash 샌드박스 안내문이 격리 범위를 과장하여 설명하던 문제 수정 (파일시스템 격리가 꺼져 있을 때 미적용 경로 목록을 안내하지 않으며, Strict 모드에서 명령어가 절대 샌드박스 외부에서 실행될 수 없다고 잘못 안내하지 않음)
• [VS Code] 설정 파일 또는 environmentVariables 설정에 CLAUDE_CONFIG_DIR이 지정되어 있을 때 세션 목록, 설정 토글, 채팅 탭에서 발생하던 문제 수정
• [VS Code] 로그인, 로그아웃, 계정 전환 후 열려 있는 탭에서 모델 뱃지, 모델 선택기, 명령어 메뉴가 몇 초간 빈칸으로 표시되던 문제 수정
• [VS Code] 프로젝트 또는 로컬 설정이 ~/.claude/settings.json의 모델 설정을 재정의할 때 새 탭이나 새로고침된 대화의 모드 선택기에서 Auto 모드가 사라지던 문제 수정
• [VS Code] SessionStart 훅이 설정되어 있을 때 창을 새로고침하면 세션 이름이 마지막 프롬프트 내용으로 되돌아가던 문제 수정
• [VS Code] 창 내에 다른 탭이 이미 열려 있음에도 새 탭의 푸터 모델 뱃지와 Remote Control 뱃지가 새 Claude 프로세스 시작을 대기하던 문제 수정
• [VS Code] 세션 탭 실행이 설정 읽기 후 0.5초 이상 지연될 때 두 번째 Claude 프로세스가 전체 시작 과정을 다시 거치던 문제 수정
• [VS Code] 세션 목록에서 세션을 재개할 때 claudeCode.preferredLocation: "sidebar" 설정을 무시하고 항상 패널로 열리던 문제 및 프로그래밍 방식 실행 시 해당 설정이 "panel"로 초기화되던 문제 수정
• [VS Code] Windows 환경 오류 수정: WSL이 설치되지 않은 환경에서 WSL 설치 프롬프트가 표시되지 않으며, WSL이 설치된 환경에서도 Windows 파일에 대한 IDE 진단 정보가 올바르게 반환됨
• [VS Code] 설정을 통해 CLAUDE_CONFIG_DIR이 지정된 경우 커스텀 스타일 빌더가 CLI에서 읽지 않는 폴더에 User 레벨 스타일을 저장하던 문제 수정
• [Claude Code on the web] 약 6시간 이상 실행된 클라우드 세션에서 지속 세션 폴더에 저장된 파일이 유실되던 문제 수정 (최대 1일까지 유지됨)
• [Claude Code on the web] 관리자가 모델 노력을 제한한 조직에서 루틴이 세션을 재개하거나 노력 수준 없이 세션이 시작될 때 "Invalid effort level" 오류가 발생하던 문제 수정
• [Claude Tag] 일시적인 로드 실패 후 관리자 설정 페이지가 스켈레톤 화면에서 멈추거나 빈 화면이 되던 문제 수정 (로드 실패 시 '다시 시도' 버튼 표시)
• [Claude Tag] Slack Enterprise Grid 채널을 다른 워크스페이스로 이동한 후 Claude 설정(저장소, 환경, 접근 권한)이 초기화되던 문제 수정
• [Claude Tag] 자체 세션이 있는 스레드에서 @Claude !restart 실행 시 "이 스레드는 채널 세션에 의해 처리됩니다"라는 모순된 알림이 함께 게시되던 문제 수정
• [Claude Tag] 꺾쇠괄호(< >)로 묶인 Markdown 링크가 Slack에서 클릭 가능한 링크 대신 괄호 텍스트 그대로 표시되던 문제 수정
• [Claude Tag] 게스트 사용이 허용된 채널에서 워크스페이스 게스트가 최상위 멘션을 보냈을 때 답변 대신 "Slack 계정이 연결되지 않았습니다"라는 응답을 받던 문제 수정
• [Claude Tag] 대화 도중 채널의 장기 실행 세션이 새 세션으로 교체되던 문제 수정 (예약된 갱신은 채널 및 스레드가 유휴 상태일 때까지 대기함)
• [Claude Tag] 채널 설정 카드를 여러 번 클릭했을 때 변경 사항이 이미 적용되었음에도 제안 세션에 변경이 거부되었다고 알리던 문제 수정 (결과를 1회만 전송함)
• [Code Review] 지적 사항을 검증하는 에이전트 중 하나가 중간에 실패하여 리뷰가 불완전하게 끝나던 문제 수정 (에이전트를 교체하여 정상적으로 판정을 완료함)
• [Code Review] 실행 중인 리뷰 뒤에 대기 중이던 푸시 트리거 리뷰가 PR이 초안(Draft)으로 전환된 후에도 게시되던 문제 수정
• [Code Review] PR에서 루트 파일(예: README.md)을 수정할 때 CLAUDE.md에 나열된 파일과 이름만 같은 경우 해당 디렉터리의 CLAUDE.md 컨벤션을 무시하던 문제 수정