## 변경 사항 - `CLAUDE_CODE_DISABLE_WEB_FETCH` 환경 변수를 추가하여 WebFetch 도구를 비활성화할 수 있게 되
요약
Anthropic Claude Code 데스크톱 앱에 여러 기능 개선과 환경 변수 설정을 추가했습니다. WebFetch 도구 비활성화, `claude --desktop` 명령어 추가 등 개발 편의성이 높아졌습니다. 또한 플러그인 설정 및 API 제공업체 관리 기능을 강화하고 다양한 버그를 수정하여 안정성을 크게 향상시켰습니다.
핵심 포인트
- WebFetch 도구를 환경 변수로 제어할 수 있게 됨.
- Claude 데스크톱 앱 실행 및 세션 관리가 용이해짐.
- 플러그인 설정 및 API 제공업체 관리 기능 추가.
- 다양한 버그 수정으로 전반적인 안정성이 향상됨.
변경 사항
CLAUDE_CODE_DISABLE_WEB_FETCH환경 변수를 추가하여 WebFetch 도구를 비활성화할 수 있게 되었습니다.- 현재 디렉터리에서 Claude 데스크톱 앱을 열거나,
--continue/--resume <id>가 있는 세션에서 열기 위해claude --desktop명령어를 추가했습니다. - 플러그인의 옵션과 설정되지 않은 항목을 표시하거나,
--values-stdin으로 읽은 새 값을 저장하기 위해claude plugin configure <plugin>명령어를 추가했습니다. claude plugin install --config에<server>.<key>=<value>를 추가하여, 번들된.mcpbMCP 서버 자체의 설정을 설치 시점에 설정할 수 있게 되었으며,/plugin→ Configure를 방문하지 않고도 시작됩니다.- 기계가 사용할 수 있는 API 제공업체를 제한하는
allowedProviders관리 설정을 추가했습니다 (Anthropic API, 사용자 지정 엔드포인트, Bedrock, Mantle, Vertex AI, Foundry, AWS의 Claude Platform 또는 클라우드 게이트웨이). - 타임아웃된 비스트리밍 폴백 요청의 재전송 횟수를 제한하는
CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES환경 변수를 추가했습니다. CLAUDE_CODE_FORK_SUBAGENT=1을 사용한claude -p에서 수정되었습니다: 서브 에이전트 자체의 Agent 호출이 이제 포그라운드에서 실행되어, 서브 에이전트가 자식의 결과를 받을 수 있습니다.- SSH를 통한 플러그인 및 마켓플레이스 설치와 업데이트 시,
GIT_SSH에 설정된 프로그램이나 git config의core.sshCommand에 있는 프로그램을 무시하도록 수정되었습니다. - OS가 관리 설정 파일 읽기를 거부할 때 Claude Code가 시작을 거부하던 문제가 수정되었습니다. 이제 경고 메시지를 표시하고 해당 파일 정책 없이도 시작됩니다.
다른 읽기 오류 및 파싱할 수 없는 파일로 인해 모든 세션이 중단되는 문제 수정
-
대화가 압축된 후 재시작한 클라우드 세션에서, 해당 세션이 이미 읽거나 게시한 아티팩트에 대한 다음 업데이트를 거부하던 문제 수정
-
claude plugin disable및enable명령어가 설치된 플러그인 자체의 설정 대신 다른 대소문자로 된 레터 케이스로 다른 설정 항목을 변경하던 문제 수정 -
원격 제어(Remote Control)를 통해 전송된 메시지에 첨부된 파일이 단 한 번 실패한 다운로드 후 누락되던 문제 수정; 이제 네트워크 오류, 시간 초과 또는 서버 오류는 최대 두 번까지 재시도됩니다.
-
set_model요청을 사용하여 세션 중간에 모델을 전환할 때(예: Agent SDK의setModel), 새 모델이 재시작될 때까지 내장된 출력 토큰 제한 및 자동 압축 창에 남아있던 문제 수정 -
URL 비밀번호에
@가 포함되거나, URL이@를%40으로 작성하는 경우 전체 부분이 표시되는 마스킹 로그 및 기록 수정 -
worktree와
/teleport가져오기에서 SSH 패스프레이즈 및 새 호스트 프롬프트가 터미널을 가로채던 문제 수정; 이제 이러한 가져오기는 요청하기보다 빠르게 실패합니다. -
SDK 및
-p세션 중간에 추가된 MCP 서버를 끄는 기능이 작동하지 않던 문제 수정하여 해당 도구들이 사용 가능하게 유지됩니다. -
claude -p --permission-prompt-tool: 백그라운드 서브 에이전트의 권한 요청이 자동으로 거부되는 대신 프롬프트 도구로 전달되도록 수정 -
claude mcp list,claude mcp get, 그리고claude mcp remove,login,logout의 '찾을 수 없음' 오류에서 MCP 서버 이름 및 값의 줄 바꿈과 터미널 이스케이프 시퀀스가 출력되던 문제 수정 -
샌드박스의 자동 허용 기능이 많은 인라인 스크립트(
python3 -c,node -e)가 단순히=를 포함한다는 이유만으로 실행할 때마다 승인을 요청하던 문제 수정 -
포크 서브 에이전트가 세션의 플랜 모드 또는
dontAsk모드를 유지하지 못하던 문제 수정: 이제 포크는 부모의 권한 모드 하에서 실행되며 플랜 모드를 벗어날 수 없습니다. -
claude remote-control --help가--[no-]chrome이 기계의/chrome설정에 기본값이라고 표시하던 문제 수정; 생성된 세션은--chrome을 전달하지 않는 한 Claude를 Chrome에서 분리 상태로 유지합니다. -
자동 모드에서 백그라운드 에이전트가 보고서마다 두 번째의 중복 응답을 요청하던 문제 수정
-
클라우드 세션 생성 및
/remote-env읽기가 계정 환경 중 최신 20개만 처리하던 문제 수정 -
원격 제어(Remote Control)에서 메시지를 받은 시점이 아닌 Claude가 해당 메시지에 시작한 시점에 '읽음'으로 표시하고, 터미널이 종료될 때 대기열에 남아있던 메시지가 손실되던 문제 수정 (이제 다음 재개 시 도착함)
-
claude plugin install또는/plugin을 사용하여 플러그인을 설치할 때, ID가.,-,@또는 (macOS, Windows) 대소문자만 다른 경우에 해당 플러그인이 설치된 캐시 폴더나 데이터 폴더에 들어가는 문제 수정; 이제 설치를 거부함 -
워크플로우 스크립트가 나중에 기다리거나 아예 실행하지 않는
agent(),parallel()또는pipeline()호출이 처리되지 않은 promise rejection으로 간주되어 백그라운드 세션을 종료시킬 수 있던 문제 수정 (ExitPlanMode에서 계획을 같은 응답에 작성했을 때 hooks 및 SDK 권한 콜백이 누락되거나 오래된 플랜을 보는 문제) -
클라우드 세션의 첫 번째 응답이 십여 밀리초 지연되어 도착하던 문제 수정 (2.1.283 버전의 회귀 현상)
-
ANTHROPIC_AUTH_TOKEN으로 Anthropic API와 인증하는 세션에서 조직의 정책을 로드하지 않던 문제 수정 -
워크플로우 스크립트가 나중에 기다리거나 아예 실행하지 않는 실패한
agent(),parallel()또는pipeline()호출이 처리되지 않은 promise rejection으로 간주되어 백그라운드 세션을 종료시킬 수 있던 문제 수정 -
hooks 및 SDK 권한 콜백이 백그라운드 프로세스가 시작된 동안 Claude 코드를 멈추게 하던 문제 수정 (예:
some-daemon &가 출력 스트림을 열어두는 경우); 이제 hook은 자신의 프로세스가 종료된 직후에 마무리됨 -
WebFetch가 속도 제한이 걸린 도메인 안전 검사를 네트워크 또는 엔터프라이즈 정책 차단으로 보고하던 문제 수정
-
수백 개의 파일 읽기나 검색이 있는 턴에서 전체 화면
ctrl+o기록(transcript)이 잠시 멈추던 문제 수정; 기록을 열 때 실행 중인 도구 호출은 이제 완료될 때 그 결과를 표시함 -
Amazon Bedrock의 스트림 중간(
mid-stream)에서 발생하는modelTimeoutException및serviceUnavailableException오류가 에러 메시지 대신 원본 JSON 본문을 보여주던 문제 수정 -
/autofix-pr및/schedule에서 Claude GitHub App이 설치 상태가 확인되지 않은 리포지토리에 설치되어 있지 않다고 표시하던 문제 수정 -
/artifacts에서 행을 닫는 것(x)이 파일의 아티팩트 연결을 해제하지 않아, 동일한 파일을 다시 게시할 때 업데이트하는 대신 새로운 아티팩트를 생성하던 문제 수정 -
아티팩트 도구가 대화 되감기(Esc Esc) 후 게시될 때, Claude가 되감긴 턴에서만 읽었던 파일의 최신 내용을 덮어쓰던 문제 수정; 이제는 Claude가 파일을 다시 읽을 때까지 게시를 거부합니다
-
Artifact허용 규칙( -
동시에 두 세션이 충돌한 프로세스가 남긴 로그인 새로고침 잠금(login refresh lock)을 복구할 때 발생하는 드문 인증 실패 문제 수정
-
PowerShell 도구의 명령어 파서가 시작하지 못했을 때(예: 메모리 부족 시), 권한 확인에서 거부 및 요청 규칙 건너뛰기 및 해당 실패를 나중에 확인할 수 있도록 캐싱하는 문제를 수정
-
macOS와 Linux에서
/ultrareview업로드가 일부 특이한 파일 이름에서 느리게 작동하던 문제, 그리고 자격 증명 파일 검사 시 백업 또는 편집자 표시가 많은 파일이나 폴더 이름을 누락시키던 문제를 수정 -
취소된 셸 명령어 또는 후크(hook)가 설정되는 도중에 취소가 도착했을 때 여전히 시작하여 끝까지 실행되던 문제 수정
-
vim 모드: 외부 에디터에서 편집한 후(Ctrl+G), NORMAL 모드에서
x또는r을 눌러도 더미 텍스트 자리 표시자(placeholder)가 깨지지 않도록 수정 -
API의 출력 콘텐츠 필터에 의해 차단된 응답이 즉시 필터 오류를 보여주는 대신, 때로는 몇 분 동안 다시 전송되고 재시도되던 문제 수정
-
플러그인이 여전히 구성이 필요한 번들
.mcpbMCP 서버를 조용히 건너뛰는 문제를 수정: 이제/plugin, 설치 메시지 및claude plugin install은 이를 표시하고 '구성(Configure)'으로 안내합니다 -
세션을 압축하거나 재개하는 것이 실패하거나, 기록이 없는 상태로 열리거나, 저장된 전사본(transcript)에 누락되거나 잘못된 필드를 가진 압축 마커 또는 루프 웨이크업 항목을 포함할 때 충돌하던 문제 수정
-
WSL: 변경된 파일의 이름에 콜론(:)이나 점(.) 또는 공백으로 끝나는 경우 Linux 볼륨에 대한 체크아웃 업로드를
/ultrareview가 거부하던 문제 수정 -
CLAUDE_CODE_RESUME_INTERRUPTED_TURN이--max-turns에서 끝났던 턴을 다시 실행하던 문제 수정 -
브라우저가 성공을 표시한 후 무기한 대기할 수 있던 로그인 문제를 수정
-
Windows: 일부 경우 홈 폴더에 루트화된 저장소의 연결된 작업 트리(linked worktree)를
/ultrareview가 업로드하던 문제 수정 -
파일이 업로드되기 전이라도 클라우드 세션에서 업로드 폴더가 누락되었다고 보고하던 문제를 수정
-
claude agents가 권한 프롬프트를 기다리는 백그라운드 세션에 보낸 답장이 때때로 대기 중인 명령을 승인하던 문제 수정 -
옵션이 먼저 오는 경우(예: 셸 별칭)에도,
claude attach,logs,stop,respawn및rm이 명령어 이름을 프롬프트로 시작하며 새 세션을 시작하는 문제를 수정 -
claude mcp list가 WebSocket (ws) MCP 서버를 누락하던 문제 수정; 이제 각 서버는 URL과 상태 정보와 함께 나열됩니다. -
claude mcp get이 구성 항목에type필드가 생략된 stdio 서버의 경우 Type, Command, Args 또는 Environment를 표시하지 않던 문제 수정 -
.claude/settings.local.json에서 git의 trace2 출력이 구성된 경우, 허용 규칙이 git 저장소 외부에서 유지되던 문제 수정 -
/claude-apieval runner scaffold 및 report builder가 출력 파일에 심볼릭 링크 또는 하드 링크를 작성하던 문제 수정 -
/claude-apieval runner scaffold가 점수 평균 계산 시max_tokens에서 잘린 응답을 세는 문제를 수정; 이제 이들은 '잘림(truncated)'으로 표시되며 별도로 계산됩니다. -
답장이 텍스트 들여쓰기(예: 마크다운 테이블의 행 레이블)에 사용될 때 터미널에서
가 문자 그대로 표시되던 문제 수정 -
전체 화면 모드 외부에서 긴 세션 중간에 일시적인 멈춤 현상(최대 1초)이 발생하여
/clear또는/compact실행 후 복구되던 문제 수정 -
대상이 장치인 경우(예: /dev/null에 심볼릭 링크된 파일) 승인된 편집 사항이 진행되지 않던 문제를 수정했으며, 이는 IDE diff 뷰에서 승인이 이루어졌거나 편집 내용이 변경되었을 때 발생했습니다.
-
스트리밍 실패가 계속될 때 API 요청이 최대 21회까지 재시도되던 문제가 있었습니다. 이제 비스트리밍 폴백(fallback)은 새 재시도 세트를 받는 대신 요청의 재시도 예산을 공유합니다.
-
Claude in Chrome 개선: 네이티브 호스트가 사용자의 컴퓨터 이름을 보고하므로, 연결된 브라우저를
-
기본 모델에 대한 접근 권한이 관리자에 의해 제거될 경우 실패하는 대신, 동일 등급의 이전 사용 가능한 모델로 전환되도록 Bedrock 및 Vertex AI 세션 개선: 이제 세션 제목과 요약도 함께 대체됩니다.
-
플러그인 마켓플레이스 오류 개선: 엔터프라이즈 정책을 인용하는 대신 git 주소가 거부된 이유를 명시합니다.
-
플러그인, 마켓플레이스 및 현재 리포지토리 원격 저장소의 git URL 유효성 검사 개선
-
Artifact 도구 결과 개선: 이제 페이지 작성 또는 편집과 같은 단계에서 게시할 것을 제안하여 왕복 횟수를 줄일 수 있습니다.
-
원격 제어 개선: Claude Desktop과 같은 앱이 호스팅하는 세션에
/btw측 질문을 할 경우, 마지막으로 완료된 것뿐만 아니라 진행 중인 턴도 볼 수 있게 되었습니다. -
Claude가 BMP, HEIC, HEIF, AVIF 또는 TIFF 파일로 보내는 사진 개선: 이제 Claude 앱에서 미리보기를 표시하여 Claude Code가 이를 변환할 수 있습니다.
-
자동 모드에서의 서브 에이전트 개선: 서브 에이전트의 실행은 호출자에게 보고서를 전달하는 즉시 종료되며, 더 이상 아무도 받지 않는 추가 턴을 거치지 않습니다.
-
Bedrock 및 Vertex 시작 모델 확인 개선: 계정에서 사용할 수 없는 모델은 이제 매번 시작할 때 재확인되는 대신 최대 하루 동안 기억됩니다.
-
Artifact 도구 게시 결과 개선: 아티팩트 업데이트에 대한 메모가 짧아졌고, 아티팩트를 찾는 위치가 모든 게시 후에 반복되지 않습니다.
-
비스트리밍 대체 요청 중 SDK 활성 상태 개선: 부분 메시지 기능이 켜져 있을 때, Anthropic API, AWS의 Claude Platform 및 게이트웨이에서 30초마다
ping스트림 이벤트를 전송합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Claude Code Releases의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기