Claude Code끼리 질문하게 하는 Phonebook, 저장소를 연결하기 전에 무엇을 정해야 할까요?

핵심 요약 (TL;DR)

Phonebook은 실행 중인 Claude Code 세션끼리 질문과 답을 주고받게 하는 도구입니다. 한국 시간 10월 5일 새벽 제작자는 프런트엔드 프로젝트가 API 프로젝트에 동작을 묻는 용도로 소개했습니다.[7] 핵심은 저장소를 모두 한곳에 복사하는 일이 아니라, 다른 프로젝트에 물을 질문을 구체적으로 만드는 데 있습니다. 다만 질문과 답변은 외부 서비스를 거칩니다.[8]

데모에서는 무엇을 주고받나요?

공식 페이지의 축약 대화록에서는 웹 클라이언트 쪽 세션이 작업 제출 API의 재시도와 중복 처리 방식을 묻습니다. 답변하는 세션은 자기 저장소의 문서와 코드를 읽고, 결과를 돌려줍니다.[8] 이 과정에서 문서에 언급된 응답 헤더가 실제 코드에는 설정되지 않는 차이도 지적합니다.[8]

여기서 중요한 것은 에이전트끼리 대화했다는 사실만이 아닙니다. 같은 기능을 설명하는 문서와 코드가 다른지 확인하는 질문이 들어갔다는 점입니다. 공식 설명은 데모의 도구 호출을 사람이 승인했다고 밝힙니다.[8] 이를 완전 자율 개발이나 무인 협업의 검증 결과로 소개해서는 안 됩니다. 이 글 역시 대화록을 읽은 해설이며 직접 설치한 사용기는 아닙니다.

작은 MVP에도 이런 질문이 필요한가요?

신청 화면과 저장 API를 나누어 만들었다면 “연결해 주세요”만으로는 부족합니다. 같은 사람이 버튼을 다시 누를 때 신청이 두 번 생기는지, 통신이 끊겼다가 돌아오면 다시 보내도 되는지를 정해야 합니다. 화면이 예쁘게 열리는 문제와 데이터가 의도대로 남는 문제는 다르기 때문입니다.

다음처럼 물어보면 검토할 대상을 좁힐 수 있습니다. “같은 신청을 두 번 보내면 API가 어떻게 처리하나요? 근거가 되는 파일을 알려 주고, 문서와 실제 코드가 다른 부분도 구분해 주세요. 아직 코드는 수정하지 마세요.” 이는 원작의 보장 기능이 아니라, 데모에서 배울 수 있는 요청 방식입니다.

답을 받은 뒤에는 해당 변경을 적용할 사람이 작은 재현 시험을 남기는 편이 좋습니다. 에이전트의 설명이 도착했다는 기록과 중복 신청이 실제로 막혔다는 결과를 같은 것으로 취급하지 마세요.

주제를 제한하면 접근 권한도 좁아지나요?

공식 안내는 그렇지 않다고 명시합니다. 등록한 주제는 의도한 사용처를 설명할 뿐, 답변 세션이 볼 수 있는 문맥이나 사용할 도구를 격리하지 않습니다.[8] 또한 이메일 로그인에 GitHub 연결이 필요하지 않더라도, 보내는 질문과 답변에는 저장소의 정보가 포함될 수 있습니다.[8]

등록 이름과 설명, 주제는 공개되며, 질문과 답변은 종단간 암호화되지 않고 완료 후 최대 7일 보관된다고 안내합니다.[8] 따라서 고객 데이터나 비밀값이 없는 프로젝트로 범위를 잡고, 공개되는 설명에도 내부 명칭을 무심코 넣지 않는 편이 좋습니다. 연결 편의와 정보 공개 범위는 함께 판단해야 합니다.

FAQ: 동료가 바로 질문을 보낼 수 있나요?

답변 세션을 명시적으로 등록하고 질문을 보낼 상대를 승인하는 절차가 필요합니다. 안내에 따르면 승인은 해당 등록에만 유효하며, 재연결 뒤에는 다시 등록하고 승인해야 합니다.[8] 한 번 연결했다고 권한이 영구히 유지된다고 가정하지 마세요.

FAQ: 지금 모든 환경에서 쓸 수 있나요?

공식 페이지는 Claude Code와 Node.js 24를 요구하며, macOS는 시험했고 Linux는 자동화 테스트로 다루지만 Windows는 지원하지 않는다고 안내합니다.[8] 실제 가입과 연결은 이번 조사에서 수행하지 않았습니다. 먼저 질문을 주고받을 필요가 있는지 판단하고, 도입 시점의 제공 상태와 데이터 처리 안내를 다시 확인하시는 편이 좋겠습니다.

출처:
[7] https://news.ycombinator.com/item?id=49957109
[8] https://phonebook.dev