## 변경된 사항 - 텔레메트리 또는 기능 플래그가 비활성화된 상태에서 LLM 게이트웨이 뒤에 있는 자동 모드 변경: 서버가 확인할 수 없는
요약
이번 업데이트는 LLM 게이트웨이 뒤의 자동 모드 변경 및 기능 플래그 비활성화 시 동작 방식을 개선했습니다. 서버 확인 활성화, 새로운 환경 변수 설정, 그리고 개발자 지출량 추적 `/usage` 명령어가 추가되어 개발 편의성이 높아졌습니다.
핵심 포인트
- 자동 모드 변경 시 서버 측 확인 로직이 강화되었으며, 관련 환경 변수를 통해 제어 가능합니다.
- 개발자를 위한 지출액 추적 명령어(`/usage`)가 추가되어 비용 관리가 용이해졌습니다.
- 환경 변수 설정을 통해 기능 플래그 가져오기 및 MCP 작업 백그라운드 처리를 세밀하게 조정할 수 있습니다.
- Claude apps 게이트웨이에 JSON 형식의 운영 로그 포맷과 관리 설정(예: 예산 규칙)이 추가되었습니다.
변경된 사항
-
텔레메트리 또는 기능 플래그가 비활성화된 상태에서 LLM 게이트웨이 뒤에 있는 자동 모드 변경: 서버가 확인할 수 없는 호출은 요청되거나 거부되며, 내장 분류기(built-in classifier)로 폴백되지 않습니다. 계속 사용하려면
CLAUDE_CODE_AUTO_MODE_SERVER=0을 설정하십시오 (Bedrock, Vertex 및 Foundry는 변경 없음). -
LLM 게이트웨이 뒤의 자동 모드 변경:
CLAUDE_CODE_AUTO_MODE_SERVER=1은CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS가 설정되어 있더라도 서버 측 확인을 활성화합니다. 관리형 설정에서 후자를 설정한 경우, 이 역시1로 설정해야 합니다. -
터미널에서 MCP 작업 지원 추가: MCP 서버가 작업을 실행하는 도구 호출(tool call)을 수행할 때, Claude Code는 즉시 이를 백그라운드로 이동시키고 완료되면 Claude에게 결과를 알려줍니다.
-
즉시 백그라운드로 이동시키는 대신, 도구 호출 내부에서 MCP 작업을 기다리도록 하는 환경 변수
CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND가 추가되었습니다. -
permissions.denyInsteadOfPrompting설정 추가: 권한 프롬프트(permission prompt)를 기다려야 하는 도구 호출은 거부되고 턴이 계속 진행됩니다 (터미널 세션, 서브 에이전트 및 팀원 간). -
사용자의 Claude API 코드가 지연을 유발하는 부분을 찾고 평가(eval)를 통해 더 빠른 설정을 시도할 수 있도록
/claude-api latency-optimize가 추가되었습니다. -
텔레메트리를 비활성화하지 않으면서 기능 플래그(feature-flag) 가져오기를 중단하는 환경 변수
CLAUDE_CODE_DISABLE_FEATURE_FLAGS가 추가되었으며, 모든 플래그는 자체 내장 기본값(built-in default)을 사용합니다. -
게이트웨이가 이 버전 또는 이후 버전을 실행할 때, 지출 한도가 없는 Claude apps 게이트웨이 뒤의 개발자를 위해
/usage에 오늘, 이번 주, 그리고 이번 달의 지출액이 추가되었습니다. -
여러 그룹에 속한 개발자를 위해 어떤 풀링된(pooled) 그룹 예산이 먼저 지불될지 설정할 수 있도록 Claude apps 게이트웨이에
admin.pooled_conflict_rule및admin.pooled_priority_order가 추가되었습니다. -
운영자가 정의한 메시지를 게이트웨이의 브라우저 인증 페이지와 Claude Code의 로그인 화면에 표시하는 선택적
login_notice설정이 Claude apps 게이트웨이에 추가되었습니다. -
Claude apps gateway에
CLAUDE_GATEWAY_LOG_FORMAT=json을 추가했습니다: 이제 운영 로그 라인이severity,time,message를 포함하는 JSON 형식으로 변환되어, 레벨을 필드에서 읽는 로그 수집기에 활용할 수 있습니다. -
다른 정책의
availableModels가 특정 정책이 이름으로 나열하는 사용자 지정 모델 ID를 허용하는 경우에 대한 Claude apps gateway 부팅 경고를 추가했습니다. -
Claude Desktop의 11월 10일 변경 사항에 앞서,
desktopHome이 없고coworkTabEnabled: false또는chatSessionRetentionDays에 의존하는 정책에 대해 Claude apps gateway에 시작 시 경고를 추가했습니다. -
claude.ai 로그인이 종료되었으나, 사용량이 Claude Console 조직에 청구되는
ant auth login의 로그인으로 Claude Code가 계속 실행될 때 경고를 추가했습니다. -
Claude Code가
ant auth login의 로그인을 사용하는 경우, 사용량이 청구되는 Claude Console 조직 이름을 시작 시 표시하는 줄을 추가했습니다. -
/tasks에 완료된 서브 에이전트를 나열하는 "이 세션에서 더 이전(Earlier in this session)" 행을 추가했습니다. 이를 통해 목록에서 사라지거나 재시작하더라도 해당 에이전트를 다시 열고 메시지를 보낼 수 있습니다. -
클라우드 세션의
/loop확인 메시지에 타이머가 해당 컨테이너와 함께 중지되며, 대신 유지되는 루프를 제공한다는 메모를 추가했습니다. -
Claude Code가 최신 서버에서만 사용하는 확장 기능을 선언했기 때문에, 구형 핸드셰이크의 MCP 서버 연결 실패 또는 빈 결과를 반환하는 문제를 수정했습니다.
-
claude.ai 커넥터에서 장시간 실행되는 MCP 도구 호출이 때때로
--resume이후 결과를 보고하지 않던 문제를 수정했습니다. -
Claude Code가 실행되는 폴더에
HEAD라는 이름의 파일이나 폴더가 있는 경우, claude.ai 및 모바일 앱에서 세션의 diff 로드가 실패하던 문제를 수정했습니다. -
git 저장소의 최상위 레벨에
HEAD라는 이름의 파일이나 폴더가 있을 경우,/diff에서 "Diff unavailable"을 표시하던 문제를 수정했습니다. -
64회 이상 파일을 편집한 세션에서
/diff창이 비어 있게 열리던 문제를 수정했습니다. -
선행 공백(space), 탭 또는 새 줄 다음에 입력된 슬래시 명령어(slash commands)가 실행되지 않고 일반 텍스트로 Claude에 전송되던 문제를 수정했습니다.
-
재시도할 때마다 로그인 정보를 새로고침하며 401 오류를 지속적으로 발생시키고 다른 세션에서도 401 오류를 유발하던 요청을 수정했습니다.
-
/context가 이후 모든 차례마다 전체 시각 그리드를 Claude에 전송하는 문제를 수정했습니다. 이제 Claude는 테이블만 읽습니다. -
안전 점검(safety check)을 사용할 수 없어 동작이 거부된 경우, 자동 모드에서
claude -p가 0으로 종료되던 문제를 수정했습니다. 이제 텍스트 및 JSON 출력은 1로 종료됩니다. -
네트워크 파일 시스템(NFS, SMB, Lustre 등)에 있는 프로젝트의 경우, Claude Code가 시작 시 모든 프로젝트 파일을 나열하던 사례를 수정했습니다.
-
클라이언트가 모델 변경 요청과 자동 모드(auto mode) 요청을 연속으로 보낼 때, 자동 모드가 잘못 거부되던 사례를 수정했습니다.
-
서버 측 검토(server-side review)가 세션에 도달하지 않는 경우(예: 이를 드롭하는 LLM 게이트웨이 뒤),
/status가 "자동 모드 서버: 활성화됨"을 표시하던 문제를 수정했습니다. -
서버에서 조직에 대한 피드백을 거부했음에도 불구하고, Claude가 초안 작성한 피드백, 설문조사 및
/feedback이 계속 나타나던 문제를 수정했습니다. -
전송할 수 없는 타사 게이트웨이에서 Claude가 피드백을 초안 작성하던 문제를 수정했습니다.
-
권한 규칙(permission rules)이나
autoMode설정이 매우 클 때 자동 모드가 이유를 설명하지 않고 동작을 거부하던 문제를 수정했습니다. 이제 설명을 제공하며,autoMode거부 규칙이 설정되지 않은 경우 터미널에서 사용자에게 요청합니다. -
Bash의 거부 및 질문(deny and ask) 규칙이 따옴표로 작성된 명령어를 놓치던 사례를 수정했습니다.
-
서브 에이전트 인계 보고서(subagent hand-back reports)가 상세 모드(verbose mode) 외부에서 확장될 때 내부 마커와 출처 노트(provenance note)를 표시하던 문제를 수정했습니다.
-
MCP 서버가 누락된 경우 프롬프트와 함께 사용되는
claude -p --resume이 지연된 도구 호출(deferred tool call)을 잃던 문제를 수정했습니다. 이제 실행은 1로 종료되고, 해당 호출을 유지하며 이후 입력을 거부합니다. -
SDK 클라이언트로 전송되는 정보성 메시지에서 텍스트가 누락되던 사례를 수정했습니다.
-
디스크 공간이 부족할 때, 에이전트 SDK 호스트가 실패한 실행 자체의 오류 메시지 대신 일반적인 종료 코드 오류를 받던 사례를 수정했습니다.
-
세션이 다른 권한 모드(permission mode)에서 재개될 때, 계획 모드(plan mode)에서 중단되었던 차례를
CLAUDE_CODE_RESUME_INTERRUPTED_TURN이 다시 실행하던 문제를 수정했습니다. -
Claude Code가 설정 파일을 작성한 직후 몇 초 이내에 이루어진 설정 파일 편집 내용이 무시되던 문제를 수정했습니다.
-
레거시 이름으로 남아 있어 설정 구성을 숨기던 설정 파일에 대한 경고가 없던 문제를 수정했습니다. 이제 Claude Code는 홈 디렉터리에 두 개의 설정 파일이 있을 경우, 어떤 파일이 사용 중인지 stderr로 알려줍니다.
-
읽기 전용 폴더나 바인드 마운트된 파일로 저장하는 과정에서 디스크가 가득 차면
~/.claude.json, 설정 및 편집 파일이 비어 있거나 잘리는 문제가 발생하던 것을 수정했습니다 (한 번에 한 세션만 저장). -
파일을 덮어쓰기 위해 읽을 수 없을 때 Write가 해당 턴을 거부로 끝내던 문제를 수정했습니다.
-
거의 즉시 완료되는 백그라운드 Bash 명령어가 출력을 잃어버린 채로 완료되었다고 보고되던 문제를 수정했습니다.
-
Bash 도구의 변경 파일 비교(diff) 기능이 명령어가 종료되기 직전에 작성한 파일을 누락시키던 문제를 수정했습니다.
-
모델 이름이 오타가 난 경우(예:
opus-5-5)에, 의도한 모델을 제안하는 대신 Claude Code 업데이트를 하라는 메시지가 나타나던 문제를 수정했습니다. -
권한 요청 프롬프트가 열려 있는 동안 노트북이 변경될 때
NotebookEdit이 잘못된 셀을 수정하던 경우를 수정했습니다. -
/login성공 화면에서 Enter 키를 누른 후 약 0.5초간 멈추던 현상을 수정했습니다. 이제 대화 상자는 즉시 사라지고 로그인 후 새로고침은 백그라운드에서 실행됩니다. -
스크린 리더 모드에서 질문에 대해 "기타(Other)" 답변을 입력하는 동안 Ctrl+G가 외부 편집기를 열지 않던 문제를 수정했습니다.
-
CLAUDE_CODE_PROXY_RESOLVES_HOSTS가 설정되어 있고 해당 장치가 자체 DNS를 가지고 있지 않은 환경에서 프록시 뒤의 Monitor WebSocket watch가 "could not resolve" 오류로 실패하던 문제를 수정했습니다. -
호출되어서는 안 되며 절대 통과할 수 없는 도구에 대해
claude plugin eval이max: 0을 제안하는 경고를 수정했습니다. -
백그라운드 플러그인 자동 업데이트 시, 업데이트된 플러그인 버전에서 추가된 종속성(dependency)을 설치하지 못하던 문제를 수정했습니다.
-
에이전트 뷰에서 열린 세션의 경우, Ghostty over tmux 환경에서 Cmd+클릭 시 링크가 열리지 않던 문제를 수정했습니다.
-
모드(mod)가
.claude/skills에서 핫 리로드될 때, 파일이 나타난 직후 삭제되어 누락되거나 반환 값이 누락되던 문제를 수정했습니다. -
/rewind가/branch이전에 체크포인트에서 코드를 복원할 때 "No files were restored" 오류가 발생하는 문제 수정 -
/claude-api스킬이 콘솔 웹 설정이 관리형 에이전트(Managed Agents) 세션에는 적용되지 않는다고 표시하는 문제를 수정하고, 자격 증명 및 권한 예시를 강화함 -
timeout DURATION으로 묶인 읽기 전용 명령어(예:timeout 30 rg foo)에 대한 불필요한 권한 프롬프트가 발생하는 문제 수정 -
WebFetch가 claude.ai 공유 채팅 링크를 빈 페이지로 설명하는 문제를 수정했습니다. 이제는 공유 채팅을 읽을 수 없으며 대신 대화를 붙여넣어야 한다고 안내합니다.
-
데이터베이스 없이 아티팩트(Artifact) 호출이 아티팩트로 재전송되는 문제가 발생하던 것을 수정했으며, 오류 메시지에 다시 게시할 경우 도움이 될지 여부를 명시하도록 변경했습니다.
-
폴더(
out_dir)에 저장하는 아티팩트 데이터베이스 읽기 작업이 거부되던 사례를 수정했습니다. -
상세 베타 추적(detailed beta tracing) 시 클라이언트 인증서가 필요한 수집기(collectors)에게
CLAUDE_CODE_CLIENT_CERT를 제시하지 않던 문제를 수정했습니다. -
OpenTelemetry의
claude_code.session.count지표가 실제로 할당되지 않은 Agent SDK의prewarm()프로세스를 계산하던 문제를 수정했습니다. 이제 사전 시작된 프로세스는 할당될 때 한 번만 카운트됩니다. -
/clear명령어가 계속 실행되는 백그라운드 에이전트, 팀원 및 워크플로우, 그리고 백그라운드 에이전트와 팀원의 포그라운드 서브에이전트를 종료시키는 문제를 수정했습니다. -
Claude 앱 게이트웨이(gateway) 로그인 만료로 인해 텔레메트리 및 관리 설정 요청을 전송하고 게이트웨이가 이를 거부하며
invalid_token으로 기록하던 터미널 문제를 수정했습니다. -
에이전트 보기(agents view)에서 권한 프롬프트를 기다리는 백그라운드 세션에 답장을 보내는 것처럼 보이던 문제를 수정했습니다. 이제 답장은 상자에 유지되며, 해당 세션을 열고 답변하라는 힌트가 표시됩니다.
-
에이전트 보기가 종료될 때 같은 디렉터리에 있는 다른 에이전트 보기에서 저장한 초안을 제거하던 문제를 수정했습니다.
-
에이전트 보기가 자체 업데이트를 위해 재시작된 후, 다른 에이전트 보기의 입력 텍스트가 표시되던 사례를 수정했습니다.
-
에이전트 보기 미리보기가 긴 명령어, 결과 및 상태 라인을 말줄임표 없이 잘라내리거나, 승인이 대기 중인 명령어에서
**, 백틱(backticks), 태그를 누락시키던 문제를 수정했습니다. -
크롬에서 연결이 중간에 끊겼을 때 확장 프로그램이 연결되지 않았다고 보고하던 Claude 문제를 수정했습니다. 이제 Claude는 작업을 반복하기 전에 페이지를 확인합니다.
-
사용량 제한(usage limit)이 세션 외부에서 해제된 후에도 원격 제어(Remote Control) 세션에서 다른 장치에 여전히 "Limit reached"가 표시되던 문제를 수정했습니다.
-
Claude가 단일 파일을 보낼 때 Claude iOS 앱에서 파일 카드가 가끔 누락되던 문제를 수정했습니다.
-
서버가 모델 접근 갱신을 계속 거부할 때 설명 없이 실패하던 자체 호스팅 러너(self-hosted runner) 세션 문제를 수정했습니다. 이제 러너는 더 빨리 재시도하고 세션에 경고를 게시합니다.
-
클라우드 세션의
/permissions가 사용 불가능하다고만 응답하던 문제를 수정했습니다. 이제 해당 세션의 규칙이 어디에 있는지, 그리고 어떻게 변경할 수 있는지 알려줍니다. -
세션이 새 워커(worker)로 이동할 때 클라우드 세션에서 세션 범위 거부 및 권한 요청 규칙(예: PermissionRequest hook이 추가하는 것)을 잃어버리던 문제를 수정했습니다.
-
클라우드 세션에서 질문에 답변하는 대신 메시지를 세 개 입력했을 때 모듈(mod)의 핫 리로딩(hot-reloading)이 꺼지던 문제를 수정했습니다.
-
웹 버전 Claude Code에서 작업 목록에서
/clear가 사라진 후에도 백그라운드 작업이 계속 실행되다가 다른 작업이 시작하거나 끝날 때까지 문제가 발생하던 것을 수정했습니다. -
모바일 및 웹 클라우드 세션의 슬래시 명령어 메뉴에 숨겨진 명령어가 나타나던 문제를 수정했습니다.
-
디렉터리 심볼릭 링크(directory symlink)를 통해
/rewind가 파일을 복원하거나 삭제할 수 있던 경우를 수정했습니다. -
sed명령어가 accept-edits 및 auto 모드에서 권한 검사를 건너뛸 수 있던 경우를 수정했습니다. -
관리 설정(managed settings)에서
CLAUDE_CODE_AUTO_MODE_SERVER=1이 게이트웨이의 URL만 해당되는 LLM 게이트웨이 뒤에서는 무시되고 서버 관리 설정을 가져올 수 없던 경우를 수정했습니다. -
환경 접두사(environment prefix)를 조작하여 명령어 일부를 권한 검사에서 숨길 수 있던 Bash 권한 우회 문제를 수정했습니다.
-
claude.ai 커넥터의 터미널 이름("mcp__claude_ai_Slack")으로 작성된 deny 및 ask 규칙, 후크 매처(hook matchers), 그리고
disallowedTools항목이 Claude Desktop에서 무시되던 사례를 수정했습니다 (Claude Desktop에 이 버전이 포함되면 적용됩니다). -
worktree 생성 시 발생하던 샌드박스 탈출(sandbox escape) 문제를 수정했습니다.
-
셀프 호스팅 러너(self-hosted runners) 수정:
--trust-workspace false가 이제 저장소 설정 파일 및 스킬에 있는 후크 실행도 중지하도록 했습니다. -
쉘로 내보낸(shell-exported) LLM 게이트웨이를 통해 시작된 유휴 백그라운드 세션이 업데이트 후 게이트웨이를 떠나던 사례를 수정했습니다.
-
/status의 도움말 링크와 자동 모드 결제 알림이 줄 바꿈될 때 주소의 일부만 열리던 문제를 수정했습니다. -
TLS 검사 프록시(TLS-inspecting proxy) 뒤에서
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC가 설정되었을 때 인증서 오류가 지속되던 사례를 수정했습니다. 이 설정을 사용하면 Claude Code는 이제 TLS...
AI 자동 생성 콘텐츠
본 콘텐츠는 Claude Code Releases의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기