# Claude Code 알려진 이슈 추적

> 버전: 1.0 | 작성일: 2026-03-24
> 목적: Claude Code 버전별 알려진 이슈 및 워크어라운드 관리

---

## 현재 환경

- **Claude Code 버전**: v2.1.80
- **마지막 확인일**: 2026-03-24

---

## 추적 중인 이슈

### #22264: Bash 병렬 호출 시 Promise.allSettled 미전환

- **상태**: Open (미해결)
- **영향**: 병렬 Bash tool 호출 시 하나가 exit code != 0이면 나머지 sibling 호출 전체가 에러됨
- **원인**: 내부적으로 `Promise.all()` 사용 추정. `Promise.allSettled()`로 전환되면 각 호출이 독립적으로 처리됨
- **발견 경위**: task-888.1 조사에서 pkill exit code 144로 인한 sibling 실패 확인
- **워크어라운드**:
  - 프로세스 종료 명령(`pkill`, `kill`, `fuser`)에 반드시 `|| true` 추가
  - 프로세스 종료 명령은 단독 순차 실행 (병렬 묶음 금지)
  - `lsof | xargs kill` 대신 `lsof | xargs -r kill 2>/dev/null || true` 사용
- **참조**: DIRECT-WORKFLOW.md "병렬 Tool 호출 안전 규칙" 섹션

---

## 업데이트 시 확인 체크리스트

Claude Code가 업데이트될 때 아래 항목을 확인하세요:

- [ ] `claude --version`으로 현재 버전 확인
- [ ] #22264 (Promise.allSettled 전환 여부): 병렬 Bash 호출 중 하나를 의도적으로 실패시켜 sibling 호출이 독립적으로 실행되는지 테스트
  ```bash
  # 테스트 방법: 두 Bash 호출을 병렬로 실행
  # 호출 1: exit 1 (의도적 실패)
  # 호출 2: echo "success"
  # 호출 2가 정상 실행되면 → #22264 해결됨
  ```
- [ ] 해결 확인 시 이 문서 업데이트 + DIRECT-WORKFLOW.md 워크어라운드 유지 여부 검토
- [ ] 새로운 알려진 이슈가 있는지 릴리즈 노트 확인

---

## 해결된 이슈 (아카이브)

(아직 없음)

---

## 변경 이력

| 버전 | 일시 | 변경 내용 |
|------|------|-----------|
| 1.0 | 2026-03-24 | 최초 생성. #22264 이슈 등록 (task-889.1) |