---
task_id: task-2056
type: plan
scope: task
created: 2026-04-21
updated: 2026-04-25
status: in-progress
---

# 계획서: task-2056

**task**: task-2056
**목표**: 카카오톡 정제 프로세스 비정상 종료 버그 수정
**승인**: 제이회장님 2026-04-21
**근거**: 대시보드 카카오톡 정제 기능에서 149개 스레드 LLM 정밀 분리 시작 직후 프로세스 crash

---

## 목표

카카오톡 정제 프로세스가 `_llm_refine_thread_splits` 단계에서 crash 없이 정상 완료되거나, 실패 시 명확한 에러 메시지를 반환하도록 수정한다.

## 범위

### 포함
1. `_call_claude()` 함수: 프롬프트를 CLI arg 대신 stdin으로 전달하도록 수정 (docstring과 실제 구현 불일치 해소)
2. `_call_claude()` 함수: CLAUDECODE 환경변수 제거하여 claude CLI 정상 동작 보장
3. `_llm_refine_thread_splits()` → `_call_claude()` 호출 시 crash 방어 강화
4. 관련 테스트 업데이트

### 제외 (다음 페이즈 이후)
- 프론트엔드 UI 변경 (에러 표시는 이미 정상 동작)
- 정제 성능 최적화
- 다른 LLM 호출 관련 기능 변경

## 위임 계획

- 백엔드 수정: **불칸** — `_call_claude()` stdin 전환 + CLAUDECODE 제거
- 테스트: **아르고스** — 관련 테스트 작성/업데이트

## 검증 기준

- `_call_claude()` 함수가 stdin으로 프롬프트 전달: `grep "stdin" knowledge_extractor_v2.py` → 매치
- CLAUDECODE 제거: `grep "CLAUDECODE" knowledge_extractor_v2.py` → 매치
- pytest: `pytest tests/test_knowledge_extractor_v2.py` → PASS