Claude Code를 활용해 방치된 개인 프로젝트 되살리기: 실용 가이드

Matthew Brunelle은 AI 코딩 도우미 도구(특히 Opus 4.6이 포함된 Claude Code)를 사용하여 중단된 개인 프로젝트를 부활시키는 방법에 대해 글을 썼습니다. 그의 프로젝트는 YouTube Music과 OpenSubsonic API 사이의 shim으로, Subsonic 호환 클라이언트(Navidrome, Feishin, Symfonium)가 YouTube Music에서 음악을 스트리밍할 수 있게 해줍니다. 프로젝트가 원래 중단된 이유는 구현해야 할 엔드포인트가 너무 많았기 때문입니다.

설정

Brunelle은 종속성으로 fastapi, pydantic, ytmusicapi, yt-dlp를 사용하는 uv 프로젝트를 만들었습니다. OpenSubsonic OpenAPI 스펙을 폴더에 넣고, 간단한 README와 빈 TODO 파일을 추가했으며, /init을 통해 CLAUDE.md를 생성했습니다. 또한 CLAUDE.md에 다음과 같은 규칙을 추가했습니다:

## 규칙
- 메서드는 인수와 반환값에 타입 애너테이션과 독스트링을 포함해야 합니다.
- 데이터 모델링에는 Pydantic을 사용합니다. 최신 Pydantic V2 규칙을 따릅니다.
- 독스트링은 인수와 반환 섹션이 있는 Google 스타일 형식을 사용합니다.
- 단위 테스트는 최신 pytest 스타일로 작성합니다. 예: 최상위 메서드에 `assert`와 fixture 사용.

워크플로

Brunelle의 일반적인 워크플로:

• 계획 모드로 전환합니다. 다음 작업을 프롬프트로 입력합니다.
• 초기 계획을 받은 후, 부족한 부분/문제점을 찾고 만족스러울 때까지 후속 질문을 합니다.
• Claude가 틀릴 때 리소스 링크를 제공합니다.
• Claude에게 관용적인 접근 방식을 위해 검색 도구를 사용하도록 요청합니다.
• 'Accept and clear context'를 사용합니다. 반복합니다.

초기 구현

첫 번째 프롬프트: openapi.json 파일을 살펴보십시오. 이것은 opensubsonic API의 스펙입니다. 모든 메서드를 스텁 처리하는 비동기 fastapi 서버를 구현하십시오. 새로운 JSON 엔드포인트만 처리하면 됩니다.

스텁을 구현한 후, 후속 프롬프트로 정확성을 재확인했습니다. 스펙이 있었음에도 Claude는 처음에 실수를 했지만 두 번째 시도에서 바로잡았습니다. 또한 /init을 다시 실행하여 CLAUDE.md를 업데이트했습니다.

다음 주요 프롬프트

이제 모든 엔드포인트에 대한 메서드가 스텁 처리되었습니다. Subsonic 클라이언트를 연결하여 노래를 검색하고 스트리밍하고 싶습니다. 이를 구현하는 데 필요한 최소한의 기능은 무엇입니까? 검색에는 ytmusicapi를, 스트리밍에는 yt-dlp를 사용하십시오.

Brunelle은 초기 스트리밍 구현이 합리적으로 보였지만 Feishin에 연결할 때 실패했다고 보고합니다. 기사는 수정 방법을 자세히 설명하기 전에 끝나지만, 전체 게시물에는 해결 방법이 포함되어 있습니다.

Brunelle은 중단된 프로젝트가 AI 코딩 도우미를 테스트하기에 이상적인 대상이라고 언급합니다: "어차피 끝낼 일이 없었으니까요." 그는 OpenCode에 대한 후속 게시물을 계획하고 있습니다.