클로드 코드로 제품 업무 환경 구축하는 법
일반적인 AI 채팅 인터페이스는 대화 내용이 휘발되어 매번 동일한 맥락을 설명해야 하는 비효율이 발생합니다. 이 글은 터미널 기반의 Claude Code를 활용하여 프로젝트 맥락과 반복되는 업무, 그리고 AI에 대한 피드백을 파일로 체계적으로 관리하는 워크스페이스 구축법을 제안합니다. 이를 통해 매번 설명하는 시간을 없애고 AI의 작업 품질을 영구적으로 개선할 수 있습니다.
제품 업무를 위해 클로드 코드를 조직하는 방법. 시작 워크스페이스를 다운로드하세요. 설정 스킬을 실행하세요. 파일이 얼마나 자주 변경되는지에 따라 정리하세요. 반복되는 작업을 스킬로 만드세요. 모든 수정 사항은 한 번만 파일에 기록하세요.
Adam Faik, 2026년 8월 10일
내 제품 업무를 위한 클로드 코드 워크스페이스에는 코드가 거의 없는 폴더 하나뿐입니다. 이 폴더는 회사에 대한 모든 정보, 즉 제품, 사용자, 경쟁사, 내 선호하는 작업 방식을 담은 컨텍스트 폴더를 보유하고 있습니다. 프로젝트마다 전용 폴더가 있으며, 작업(task)과 결과물(deliverable)은 분리되어 있습니다. 또한 각각 하나의 반복적인 작업을 수행하는 스킬 세트가 있습니다. 상태 업데이트, PRD 검토, 인터뷰 요약 등이 여기에 해당합니다. 피드백을 한 번 주면, 그 이유와 함께 파일에 기록되어 두 번 다시 같은 피드백을 주지 않아도 됩니다.
내가 이 시스템을 설계한 것이 아닙니다. 처음에는 주로 실수를 하면서 이 방식에 도달했습니다. 실수를 겪으면서 이 기사 전체를 관통하는 교훈을 얻었습니다. 기본적인 부분을 넘어서면, 클로드 코드에서의 결과물은 프롬프트를 얼마나 잘 작성하는가에 따라 결정되는 것이 아니라, 파일을 얼마나 잘 정리하는가에 따라 결정됩니다. 좋은 프롬프트는 단 한 번의 세션을 개선하지만, 좋은 파일은 그 이후의 모든 세션을 개선합니다. 당신이 이미 읽었던 프롬프트 튜닝 조언은 파일 정리가 중요해지는 시점에서 더 이상 도움이 되지 않습니다.
그래서 나는 내 시스템을 설명하는 대신 패키지로 만들었습니다. 시작 워크스페이스는 GitHub에 공개되어 있습니다. 폴더, 컨텍스트 템플릿, 그리고 하나의 설정 인터뷰를 통해 개인화되는 5가지 PM 스킬이 포함되어 있습니다. 이 과정을 따르기 위해 기술적인 지식이 필요하지 않습니다. 도구 설치를 포함한 모든 단계가 명시되어 있습니다. 비록 내 예시는 제품 업무에 관한 것이지만, 동일한 구조는 컨텍스트가 많이 필요한 모든 작업에 적합합니다. 예를 들어 디자인 리더의 연구 라이브러리, 데이터 팀의 지표 정의, 창업자의 모든 것을 담은 폴더 등이 있습니다.
진행 방식은 다음과 같습니다.
전환. 채팅 모드와 Cowork가 당신에게 줄 수 없는 것과 제품 관리자에게 터미널이 가치 있는 이유를 보여드리겠습니다. 시작 워크스페이스. 이것을 다운로드하고, 하나의 설정 스킬을 실행한 뒤, 실제 작업을 하나 맡겨보세요. 화면에 표시되는 6단계로 구성되어 있습니다. 관행. 시스템이 누적 효과를 낼 수 있게 만드는 6가지 행동으로, 각각 정확히 무엇을 해야 하고 어떤 결과를 얻는지를 설명합니다. 리듬. 첫 번째 짧은 프롬프트부터 2분짜리 파일 정리 습관까지, 이 시스템 내에서 일어나는 평범한 근무일의 모습을 보여줍니다.
보상은 명확합니다. 한 번의 착석으로 모든 것을 실행할 수 있습니다. 도구를 설치하고, 워크스페이스를 다운로드하며, 설정 인터뷰에 답하고, 첫 번째 실제 작업을 넘겨주면 됩니다. 더 이상 매 세션마다 회사에 대해 재설명하지 않아도 되며, 당신이 하는 모든 수정 사항은 영구적으로 저장됩니다. 모든 단계는 아래에 설명되어 있습니다. 이제 파일 캐비닛을 열 시간입니다.
채팅 모드가 줄 수 없는 것
당신은 오늘 아마도 클로드의 채팅, 즉 브라우저 탭이나 데스크톱 앱, 혹은 에이전트 작업을 위한 Cowork를 통해 제품 업무를 수행할 것입니다. 이 방식은 작동하며, 그것이 바로 함정입니다. 모든 대화는 제로에서 시작합니다. 지난번에 업로드했던 전략 문서는 사라지고, 당신이 인내심을 갖고 설명했던 맥락은 다시는 찾을 수 없는 스레드 속에 갇히며, 마음에 들었던 결과물은 파일로 저장되는 대신 스크롤해야만 하는 메시지 속에 갇힙니다.
채팅은 생각하기에는 좋은 장소지만, 축적하기에는 끔찍한 장소입니다. 가끔 묻는 질문이라면 괜찮습니다. 하지만 매일 하는 제품 업무를 위해서라면, 매일 아침 동일한 설정 비용을 지불해야 함을 뜻합니다.
클로드 코드는 동일한 클로드 모델이지만 거주지가 다릅니다. 클로드가 읽고, 탐색하고, 쓸 수 있는 당신 컴퓨터의 폴더입니다. 맥락은 지속되는 파일 속에 존재합니다. 반복되는 작업은 명령 시 실행되는 스킬에 존재합니다. 결과물은 스크롤하기 위해 찾아야 하는 메시지가 아니라, 당신이 보관하는 문서로 도착합니다. 내 일상적인 사용 경험상, 채팅이나 Cowork에서 하던 모든 작업이 여기서는 더 잘 작동했습니다. 두 번 다시 설명할 필요가 없기 때문입니다. 이것은 법칙이 아니라 내 작업에서의 관찰 결과이지만, 수개월 동안 유지되어 왔습니다.
실제로 내 업무를 바꾼 부분은 그 아래에 있는 터미널입니다. 클로드 코드는 GitHub와 연결 없이 기본적으로 소통합니다. 회사 저장소를 가져와 Repository에 대한 질문에 답할 수 있고, 당신의 작업을 푸시할 수도 있습니다. 제품 뒤에 있는 리포지토리를 가져와 기능 플래그(feature flag)가 실제로 무엇을 하는지 설명해 달라고 요청하세요. 당신의 워크스페이스를 개인 저장소에 푸시하면 팀원이 이를 복제(Clone)하여 작업 환경과 맥락을 그대로 물려받을 수 있습니다.