개발 취재 노트

Claude Code로 띄운 백그라운드 프로세스가 몇 초 뒤 사라진다 — Windows에서 버그가 아니라 에이전트 셸의 프로세스 정리였다

Windows에서 AI 코딩 에이전트(Claude Code)에게 프로그램을 백그라운드로 띄워 보게 했더니, 띄운 프로세스가 20초쯤 지나면 계속 사라졌다. 프로그램이 떠서 바로 죽는 버그처럼 보였지만, 같은 프로그램을 에이전트 셸 밖에서 띄우자 30초 내내 살아 있었다. 프로그램은 "Hey Jarvis"라고 부르면 말을 받아 적어 Claude Code에 넘기고 답을 읽어 주는 로컬 음성 비서(voice-assistant)였고, 재부팅 뒤 비서가 안 떠 있어서 원인을 찾던 중이었다.

결론

에이전트 셸에서 띄운 프로세스가 사라졌다고 프로그램이 죽었다고 단정하면 안 된다. 에이전트의 명령 실행 환경이 호출이 끝날 때 자기가 띄운 자식 프로세스를 함께 정리했을 수 있다. 이 사건에서는 같은 프로그램이 에이전트 셸에서는 사라졌고, 셸 밖(WMI)에서 띄우니 30초 내내 살아 있었고 로그도 계속 쌓였다 .

실행 환경 탓인지 가르는 순서는 이렇다.

  1. 먼저 셸 밖에서 띄워 본다. 살아남는다면 코드가 아니라 실행 환경 문제다 . 이때 처음 WMI로 띄운 시도는 18초 뒤 사라졌고, cmd /c bat을 WMI로 띄운 시도만 30초 살아남았다 . 첫 시도가 정확히 어떤 명령이었는지는 기록에 없지만, 실제 실행 경로(bat)를 그대로 재현해야 결과를 믿을 수 있다.
  2. 띄우는 호출과 확인하는 호출을 나눈다. 띄우는 명령이 끝날 때 정리되는 것인지 보려는 것이다. 이 사건에서는 나눠도 사라졌으니 이것만으로는 가려지지 않았다 .
  3. 프로세스 목록만 보지 말고 로그가 늘어나는지도 본다. 프로세스가 사라지기 전에 로그에 "준비 완료"가 찍혔는지 보면 "못 떴다"와 "떴다가 정리됐다"가 갈린다. 세션에서는 한 호출 안에서 로그 크기와 프로세스 등장·소멸을 촘촘히 추적했다고 하며, 정확한 명령과 간격은 기록에 없다 .
  4. Start-Process가 에러를 내도 인용부호부터 의심한다. 테스트에서 본 unrecognized arguments: USB Audio는 프로그램이 아니라 테스트용 PowerShell Start-Process 명령의 인용부호 문제였다 .

1번을 PowerShell로 하면 다음과 같다. 세션에서 확인된 것은 "WMI로 cmd /c bat을 띄우면 살아남는다"까지이고, 아래 코드는 그 방식을 옮긴 일반적인 예시라 세션의 명령 원문이 아니다. start_assistant.bat은 pythonw로 비서를 실행하고 출력을 로그 파일로 돌리는 시작 스크립트이며, 자기 환경의 시작 스크립트로 바꿔 넣으면 된다.

# 에이전트 셸의 자식이 아니라 WMI(CIM)가 새 프로세스를 만든다
Invoke-CimMethod -ClassName Win32_Process -MethodName Create `
  -Arguments @{ CommandLine = 'cmd /c "C:\path\to\start_assistant.bat"' }

# 다음 호출에서 따로 확인: 프로세스가 있고, 로그가 늘어나는가
Get-Process pythonw -ErrorAction SilentlyContinue
(Get-Item C:\path\to\data\main_log.txt).Length

정확히 어떤 메커니즘(예: Windows job object)이 프로세스를 정리했는지는 확인하지 못했다. 에이전트의 추정이었다 .

상황

증상

원인

진단에 쓰던 에이전트의 실행 환경이 자기가 띄운 프로세스를 정리하고 있었다. 이 때문에 멀쩡한 프로그램이 죽는 것처럼 보였다.

한계도 있다. vbs 경로는 끝까지 깔끔하게 설명되지 않았다. 같은 세션에서 vbs를 띄운 한 번은 로그가 전혀 늘지 않았고 , 다른 한 번은 로그에 새 "준비 완료"가 찍힌 뒤 20초 만에 사라졌다 . 에이전트는 이것을 "wscript가 곧바로 종료되면서 정리된 것"이며, 부팅 때 explorer가 띄우는 실제 상황과는 다르다고 해석했다 . 이 해석도 검증된 것은 아니다.

해결

덤 — 같은 날 밤 재부팅도 원인은 미확정

같은 날 22:33 재부팅 때도 비서가 뜨지 않았다 . 이번 조사는 wscript로 VBS를 네 번 돌려 네 번 실패하자 "부팅 실패를 재현했다"고 봤지만, 바로 다음 실행은 성공했다 . 이 조사에서는 에이전트 셸에서 띄운 pythonw가 여러 번 살아남았으니 셸 정리 탓으로 돌리기도 어렵다 . 자동 시작은 작업 스케줄러가 배치를 직접 실행하는 방식으로 바꿨고, 재부팅 검증은 하지 못했다 .

취재 후기 — 범인은 우리 손에 든 돋보기였다

박도은
윈도우에서 늘 대기하다가 "Hey Jarvis" 하면 대답하는 음성 비서 있잖아. 재부팅하고 7분이 지났는데 pythonw가 하나도 없어. 로그도 8월 23일에서 멈췄어
정바다
시작 프로그램에서 빠진 거 아냐? 바로가기가 지워지면 부팅할 때 아무것도 안 뜨잖아.
박도은
시작 프로그램 폴더를 열어 봤는데 VoiceAssistant.lnk가 그대로 있어. 가리키는 곳도 숨김 실행용 VBS 그대로고
정하늘
그럼 '안 떴다'인지 '떴다가 죽었다'인지부터 가르자. 우리가 직접 한 번 띄워 보면 알 수 있어.
박도은
내 셸에서 띄워 봤는데 프로세스가 없어. 로그에 새 줄도 안 붙었어
정바다
그럼 떠서 바로 죽는 거네. 코드 어딘가에서 예외가 터지는데, 콘솔 창이 없는 pythonw라 에러가 안 보이는 거야.
정하늘
그건 콘솔 창이 있는 python.exe로 돌려 보면 가려져. 죽는다면 에러가 화면에 찍힐 테니까.
박도은
콘솔로는 45초가 지나도 안 죽어. 마이크 장치도 잡았고 "준비 완료"까지 떴어
정하늘
코드 문제는 아니네. 남는 차이는 pythonw로 띄우는 bat·vbs 경로야.
박도은
Start-Process로 pythonw를 띄웠더니 unrecognized arguments: USB Audio가 나왔어
정바다
이거다. 장치 이름 "KT USB Audio"가 공백에서 쪼개져서 argparse, 그러니까 파이썬 명령줄 인자 해석기가 "USB Audio"를 모르는 인자로 보고 죽은 거야.
정하늘
잠깐, 그 인자는 우리가 테스트 명령에 옮겨 적은 거잖아. 진짜 bat을 cmd /c로 그대로 돌려 보면 갈려.
박도은
bat을 돌렸더니 40초가 넘도록 명령이 안 끝나. 로그에는 "준비 완료. Hey Jarvis"가 찍혔어
정하늘
cmd가 안 끝난다는 건 그 밑에서 pythonw가 살아 있다는 뜻이야. 인자 에러는 우리 테스트 명령의 따옴표 문제였어.
박도현
진단하려고 만든 명령이 실제 경로와 다르면, 그 차이가 새로운 버그처럼 보여. 재현은 원래 실행 경로 그대로 해야 해.
박도은
이번엔 부팅 때처럼 vbs로 띄웠어. 20초 뒤에 사라지더라. 아까 bat도 내 백그라운드 작업이 끝나니까 exit 255로 같이 죽었고
정바다
이번엔 내가 조심할게. 우리 셸이 명령이 끝날 때 자기가 띄운 자식 프로세스까지 같이 치우는 거 아닐까? 부팅 때는 explorer가 부모라서 그럴 일이 없고.
정하늘
그럼 띄우는 호출은 바로 끝내고, 살아 있는지는 다른 호출에서 보자. 그래도 없으면 우리 셸의 프로세스 트리 밖, WMI로 띄워 본다.
박도현
WMI면 윈도우 관리 기능한테 프로세스를 대신 만들어 달라는 거지? 그러면 부모가 우리 셸이 아니게 되고.
박도은
맞아. 근데 호출을 나눠도 없었고, WMI로 처음 띄운 것도 18초 뒤에 사라졌어
정바다
봐, 셸 밖에서도 죽잖아. 역시 프로그램 쪽 문제야.
박도은
그렇게 끝내기엔 일러. 그건 실제 시작 경로랑 다른 방식으로 띄운 거였어. WMI로 cmd /c bat을 띄우니까 30초 내내 pythonw 두 개가 살아 있고 로그도 60615에서 60777바이트로 늘었어
정하늘
셸 밖에서는 살고 안에서는 죽는다. 그동안 본 '떠서 죽는다' 상당수는 우리 실행 환경이 만든 거였어. 다만 어떤 메커니즘이 프로세스를 치웠는지는 아직 확인 못 했어.
정바다
그럼 부팅 때 안 뜬 건? 작업 관리자에서 '사용 안 함'으로 꺼져 있으면 바로가기가 있어도 이 증상이 나잖아.
박도은
레지스트리를 봤는데 두 바로가기 모두 비활성 목록에 없어. 꺼져 있는 건 다른 프로그램 하나뿐이야
정하늘
그럼 이번 부팅에서 자동 시작이 그냥 실행되지 않았다는 데까지만 말할 수 있어. 왜 그랬는지는 재현이 안 돼서 확정 못 해
박도현
그래서 지금 고쳐진 거야, 살려 놓기만 한 거야? 수동으로 띄운 건 로그 리다이렉트도 빠졌잖아
정바다
살려 놓기만 한 거지. 그날 밤 재부팅 때도 또 안 떴고, 작업 스케줄러로 옮겼는데 재부팅으로는 아직 확인 못 했어
정하늘
그럼 다음 부팅 때 스케줄러가 진짜 뜨는지 로그로 확인하는 게 남은 숙제야. 그리고 그 전에 에이전트 셸에서 띄운 프로세스가 사라지면, 프로그램을 의심하기 전에 셸 밖에서 실제 시작 스크립트로 한 번 더 띄워 봐야 해.