Claude Code · 2026년 9월 30일 ★★★★

클로드 코드 v2.1.285 부터 백그라운드로 띄운 Bash 명령이 기본 30분, 최대 2시간이 지나면 멈추고, 환경변수 하나로 WebFetch 도구를 끌 수 있어요

9월 29일 나온 클로드 코드 v2.1.285 는 run_in_background 로 띄운 Bash·PowerShell 명령을 그 명령의 timeout 이 지나면 멈추게 바꿨고, 기본값은 30분·최대 2시간이며 멈추면 클로드에게 알림이 가요. 다만 공식 도구 참조 문서는 9월 30일 현재도 개발 서버·watch 빌드를 백그라운드 작업의 예로 들면서 메인 대화가 시작한 명령은 계속 돈다고만 적었고, 이 시간 제한은 릴리스 노트에만 있어요. 함께 CLAUDE_CODE_DISABLE_WEB_FETCH 환경변수로 WebFetch 도구를 끌 수 있게 됐고, 관리형 설정 allowedProviders 로 한 장비가 쓸 수 있는 API 제공처(Anthropic API·사용자 지정 엔드포인트·Bedrock·Vertex AI·Foundry 등)를 제한할 수 있는데, 두 항목도 아직 환경변수·설정 참조 문서에는 없어요. 플러그인을 SSH 로 설치할 때 GIT_SSH·core.sshCommand 로 지정한 SSH 프로그램을 무시하던 버그도 고쳐졌어요.

용어 풀이
run_in_background
Bash 도구 호출을 백그라운드 작업으로 시작하게 하는 매개변수
WebFetch
클로드 코드가 주소 하나의 웹 페이지를 받아 읽는 내장 도구
allowedProviders
장비에서 쓸 수 있는 API 제공처를 제한하는 관리형 설정 키
GIT_SSH
git 이 SSH 연결에 쓸 프로그램을 지정하는 환경변수
운영자 인사이트

개발 서버나 긴 watch 빌드를 클로드에게 백그라운드로 맡겨 두던 팀은 업데이트 뒤 30분이 지나면 그 프로세스가 내려가요. 몇 시간 띄워 둘 프로세스는 timeout 을 최대 2시간으로 잡으라고 지시하거나, 별도 터미널에서 직접 띄우고 클로드에게는 로그 파일만 읽게 하세요. 외부 조회를 막아야 하는 조직은 CLAUDE_CODE_DISABLE_WEB_FETCH 를 쓸 수 있지만, 공식 문서 설명대로 Bash 의 curl 은 그대로 열려 있으니 샌드박스 네트워크 허용 목록과 함께 거세요.

여러 관점으로 보기
  • 변경 기록 같은 버전 항목에 백그라운드 명령 시간 제한(기본 30분·최대 2시간), CLAUDE_CODE_DISABLE_WEB_FETCH, allowedProviders 추가가 똑같이 적혀 있어요. GitHub
  • 공식 문서(도구 참조) 백그라운드 명령은 개발 서버·watch 빌드용이고 메인 대화가 시작한 명령은 최종 응답 뒤에도 계속 돈다고 적혀 있을 뿐, 30분·2시간 제한은 아직 반영되지 않았어요. Claude Code 공식 문서
  • 공식 문서(관리자 설정) WebFetch 를 막아도 Bash 가 허용돼 있으면 curl·wget 으로 어떤 주소든 닿을 수 있어, 운영체제 수준의 샌드박스 네트워크 허용 목록으로 막아야 한다고 설명해요. Claude Code 공식 문서

원본 보기 (github-releases:claude-code)