오늘 아침에 갑자기 맥(Mac)이 응답하지 않게 되었습니다. 디스크 공간이 거의 가득 찼고, /tmp 폴더 안에 있는 하나의 텍스트 파일이 약 12분 만에 288GB까지 커져 있었습니다.
저는 한 번에 많은 Claude Code 세션을 실행하기 때문에, 가장 먼저 의문은 어떤 세션이 이 파일을 쓰고 있는지였습니다.
작성자 찾기
lsof는 열려 있는 파일이 있는 프로세스를 나열합니다:
lsof /tmp/qa/review-all.txt
결과는 cat과 grep을 보여주었습니다. ps -o pid,ppid,command -p <pid> 명령어를 사용하여 부모 체인(parent chain)을 거슬러 올라가 보니, 이 두 명령어 모두 동일한 Claude Code 세션에서 시작된 셸(shell)로부터 연결되어 있었습니다.
루프(Loop)
해당 세션은 일련의 페이지에 대한 디자인 리뷰를 실행하고 있었습니다. 각 리뷰는 발견 사항을 담은 작은 텍스트 파일을 작성했고, 마지막 단계에서는 이 파일들을 하나의 파일로 결합했습니다:
for f in /tmp/qa/review-*.txt; do
echo "=== $(basename "$f")"
cat "$f"
...
출력 파일은 review-all.txt이며, 이 이름은 또한 review-*.txt와 일치합니다.
마지막의 리디렉션(redirect)은 전체 루프에 적용되므로, 셸은 글롭(glob)을 확장하기 전에 먼저 review-all.txt 파일을 생성합니다. 새로 만들어진 빈 출력 파일이 입력 목록에 포함됩니다. 루프가 이 파일에 도달하면, cat은 자신이 추가하고 있는 파일(appending to)의 내용을 읽기 시작합니다. cat이 읽는 모든 블록은 다시 끝 부분에 쓰여지므로, 파일의 끝 부분이 cat이 읽는 속도만큼 멀어지고, 결국 cat은 그 끝에 도달할 수 없게 됩니다.
한 줄 버전도 지연 시간(delay)을 두고 동일한 함정을 가집니다:
cat /tmp/qa/review-*.txt > /tmp/qa/review-all.txt
여기서는 리디렉션이 파일을 생성하기 전에 글롭이 먼저 확장되므로, 첫 번째 실행은 문제가 없습니다. 하지만 두 번째 실행에서는 기존의 review-all.txt가 입력 중 하나가 되고 루프가 시작됩니다. 에이전트(Agents)들은 명령을 끊임없이 재실행합니다.
리눅스에서 멈췄을 이유
저는 동일한 루프를 GNU coreutils가 설치된 리눅스 머신에서 실행했고, 다음과 같은 메시지를 받았습니다:
cat: review-all.txt: input file is output file
GNU의 cat은 입력이 출력과 동일한 파일인지 확인하고 건너뜁니다. macOS에 포함된 cat은 BSD에서 왔기 때문에 그러한 확인 절차가 없어 쓰기가 실패할 때까지 계속 실행됩니다. 제 것은 12분 후에 저절로 멈췄는데, 아마도 공간 부족으로 인해 쓰기에 실패했기 때문일 것입니다. 그때 파일 크기는 288 GB였고, 실행된 매 초마다 약 400 MB씩 증가했으며, 디스크는 96%가 가득 차 있었습니다.
에이전트가 상황을 악화시킨 방법
해당 명령어는 에이전트의 10분 명령 시간 초과(command timeout)에 직면하여 도구가 이를 백그라운드로 옮겼고, 에이전트는 다른 작업을 계속했습니다. 이후 파일에 대한 전체 읽기가 두 번 더 발생했습니다:
- 원래 명령어는 결합된 파일을 대상으로
grep -c를 사용하여 깨끗한 페이지 수를 계산하는 것으로 끝났습니다. 이 grep은 288 GB 전체를 읽어야 했습니다.
- 몇 분 후 에이전트는 진행 상황을
cat review-all.txt | wc -c로 확인했는데, 이는 단순히 개수를 세기 위해 모든 바이트를 다시 읽는 작업입니다.
파일을 발견했을 때 둘 다 여전히 실행 중이었습니다. 어느 것도 파일을 변경하지 않았지만, 함께 수백 기가바이트를 읽느라 디스크를 바쁘게 만들었습니다. 서두르는 사람이라면 이 명령어들을 모두 작성할 수도 있었을 것입니다.
정리하기
삭제하기 전에 파일이 열려 있는 모든 것을 중지하세요. 파일을 삭제하는 것은 이름만 제거할 뿐이며, 해당 공간은 마지막으로 파일을 붙잡고 있던 프로세스가 닫힐 때 돌아옵니다.
lsof /tmp/qa/review-all.txt
rm /tmp/qa/review-all.txt
남은 공간이 37 GiB에서 306 GiB로 돌아갔습니다.
이를 피하는 방법
- 전역(glob)이 일치시킬 수 없는 곳, 예를 들어 다른 폴더나 다른 확장자(
> /tmp/qa/combined.md)에 결합된 파일을 작성하세요. 또는 루프 상단에서 명시적으로 건너뛰도록 할 수도 있습니다: [ "$f" = /tmp/qa/review-all.txt ] && continue.
- 파일 크기를 확인하려면
ls -l 또는 stat을 사용하세요. 이들은 메타데이터(metadata)를 읽습니다. cat file | wc -c는 전체 파일을 읽습니다. 이는 에이전트에게 제공하는 지침에 포함할 가치가 있습니다.
- 에이전트가 실행되는 셸(shell)에서 파일 크기에 상한선을 설정하세요.
ulimit -f는 프로세스가 작성하는 파일이 제한을 초과하면 SIGXFSZ로 해당 프로세스를 종료시키며, 관대한 제한이라도 디스크가 가득 차기 훨씬 전에 통제 불능의 파일을 멈추게 합니다. 단위는 셸마다 다릅니다: zsh는 512바이트 블록을 세고 bash는 1 KB 블록을 세므로, ulimit -f 200은 zsh에서는 100 KB를, bash에서는 200 KB를 의미합니다.