대화가 끝나면 백그라운드 작업도 멈춘 Claude Code의 실패 사례를 'CLAUDE.md', '코드', '메모리'에 기록하는 방법
요약
AI 기반 개발 프로젝트 'ALPHA FORGE' 운영 중 발생한 세 가지 실패 사례와 해결책을 공유합니다. 특히, 대화 세션이 종료되면 AI가 구동시킨 백그라운드 작업(워커/beat)도 함께 멈추는 문제를 발견했습니다. 이를 통해 시스템의 지속적인 작동과 중요한 판단 기준 기록의 중요성을 강조합니다.
핵심 포인트
- 대화 세션 종료 시 자식 프로세스까지 종료되는 문제 해결 필요
- PID 파일만으로는 '성공'으로 오인할 수 있는 함정 방지
- 판단 습관(Memory)은 주기적으로 업데이트하여 최신 방침 반영 필수
AI는 대화가 끝나면 모든 것을 잊어버립니다😇 그래서 '같은 함정에 두 번 빠지지 않기' 위해서는, 그 함정을 어딘가에 기록해 둘 수밖에 없습니다. 문제는, 그 '어디か'를 어디로 하느냐입니다. 의외로 여기서 차이가 생겼습니다.
일본 주식 AI 종목 스크리닝 및 지속 학습 단말기 'ALPHA FORGE(알파포지)'를 Claude Code와 함께 개인 개발하고 있습니다. 이번에는 운영 중에 빠졌던 3가지 함정과, 각각을 어디에 기록해 두었는지 정리했습니다🗂️
※본 기사는 note 연재 [ALPHA FORGE 개발 비화 #14]를 개발자용으로 재구성한 것입니다.
🌙 대화를 닫으면 백그라운드 작업도 함께 멈췄다
| 항목 | 내용 |
|---|---|
| 개발 | Claude Code (CLI). 시스템 구동까지 AI에게 의존함 |
| ... | |
| ALPHA FORGE에는 화면 뒤에서 계속 움직이는 처리가 있습니다. 아침의 종목 추출, 장중 감시, 밤의 정답 맞히기와 학습입니다. 이것들을 작동시키는 것이 Celery의 워커와 beat입니다. 가게 뒷방에서 조용히 일하는 직원이라고 생각해 주세요🧑🍳 |
9월 25일 저녁, Claude Code에게 시스템 구동을 시켜 작업을 마치고 대화를 닫았습니다. 17시 44분경이었습니다. 그리고 다음 날 아침, '어? 주기적 실행이 작동하지 않네…?'라고 깨달았습니다😳
원인은 이렇습니다. AI가 커맨드로 구동한 처리는, AI 자신의 '자식' 프로세스로 태어납니다. 부모인 대화 세션이 끝나면, 자식도 함께 종료합니다. 대화를 닫는 순간, 워커와 beat 모두 함께 귀가해 버린 것입니다🏃
🕳️ '성공'라고 말하면서, 2주 동안 아무것도 하지 않았다

표시는 '성공'이었지만, 뒤에서는 아무것도 구동하지 않았다. 함정은 에러를 내지 않고 숨어 있었다
PC에 로그인했을 때 모든 것을 자동으로 구동하는 시스템도 마련해 두었습니다. 그런데 그 2일 후. 여기에도 또 다른 함정이 숨어 있었습니다😱
- 구동 스크립트는 이중 구동을 막기 위해 '구동 중의 표시'로 기록 파일(PID 파일)을 둡니다.
- 이 파일이 내용물이 비어 있는 채로, 9월 15일부터 남아있었습니다.
- 스크립트는 '파일이 있다 = 구동 중'이라고 판단하고, 아무것도 하지 않은 채 종료합니다.
- 게다가 실패를 호출한 곳에 전달하지 않았기 때문에, 자동 구동 태스크는 '성공'으로
함정 3 (키 이름 충돌) → CLAUDE.md
클라우드용 실행 절차를 CLAUDE.md에 추가하고, 앱용 키는 다른 이름으로 보관한 뒤, 실행 시에만 앱 설정 파일로 복사하도록 결정했습니다. '값은 채팅과 로그에도 노출하지 않는다' 역시 같은 조항에 포함되어 있습니다🔑
🧠 메모리는 '판단의 습관', 그리고 오래됨
메모리(Memory)는 대화를 거쳐 남아있는 저의 취향이나 방침을 기록하는 공간입니다. 예를 들어, '비용이 많이 드는 실기 검증은 계획 승인 후에도 실행 직전에 다시 한번 확인한다'와 같은 내용입니다. 이는 프로젝트의 약속이라기보다는 제가 어디서 멈추고 싶은지에 대한 판단 습관이기 때문에 메모리에 보관하고 있습니다. 실제로 다른 회차에서 이야기 나눈 '테스트 실행(試し打ち)' 기능 검증에서도 AI는 비용이 드는 실행 전에 저에게 제대로 확인을 요청해 왔습니다🙆
다만, 메모리는 오래됩니다. 솔직한 예가 있습니다. 9월 22일에 '앱 이름은 공개물에 노출하지 않는다'라고 메모에 남겼는데, 다음 날 제가 스스로 '브랜드로서 전면에 내세운다'고 방침을 바꿨습니다.

방침이 바뀌었는데도 메모가 오래된 상태라면, AI는 예전의 저를 따르게 된다
오래된 메모가 남아있으면, AI는 예전의 저를 따라 하게 됩니다😅 방침이 바뀌면 메모도 수정해야 합니다. 메모리는 '키우는' 것보다는 '관리하는(손질하는)' 것이라고 느낍니다🌱
🧰 하네스 기법: 보관 장소를 정하는 네 가지 질문
함정을 발견하면, 다음 순서로 질문을 던지면 보관 장소가 결정됩니다👇

위에서부터 차례대로 물어보면, 기록할 장소가 결정된다
- 코드로 막을 수 있는가 → 가능하다면 코드와 테스트에 (함정 2)
- AI가 매번 작업 전에 알아야 하는가 → CLAUDE.md에 (함정 1・함정 3)
- 정해진 절차 도중에 발생하는 함정
AI 자동 생성 콘텐츠
본 콘텐츠는 Zenn AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기