클로드코드로 만들고 Aside로 다듬은 레시피북: 어느 쪽에서 이어 해도 되는 하네스 만들기
2026.10.06

소개
저는 평소 유튜브에 모아 둔 요리 영상을 다시 보며 요리하는 일이 영 불편했어요. 그래서 그 영상 900여 개로 폰에서 쓸 수 있는 레시피 앱을 만들었어요. 클로드코드로 설계하고 1차 배포한 다음, Aside로 넘어와 사이트를 옆에 띄워 놓고 다듬었어요.
어떤 입력창이건 한영을 잘 받아써 주는 Soniox로 말로 하니 정말 편리했어요.
이 과정에서 가장 크게 남은 건 두 가지예요.
평소 불편했던 일을 하루 만에 꽤 마음에 드는 앱으로 바꾼 것. 모아 두기만 하던 요리 영상을 다시 꺼내 쓰기 편해졌어요.
클로드코드와 Aside 중 어느 쪽에서 시작하든, 어느 쪽에서 이어 하든 상관없는 작업 흐름을 만든 것. 클로드코드가 Aside CLI를 손발로 쓰든, 클로드코드로 하던 설계와 코딩을 Aside에서 이어 하든 괜찮게 만들었어요.
이런 분들께 도움돼요
클로드코드를 주로 쓰는데 Aside를 어디에 붙여야 할지 고민인 분
맥 여러 대, 에이전트 여러 개를 오가다 맥락이 끊기는 분
개발자가 아닌데 나만 쓰는 앱을 직접 만들어 보고 싶은 분
물론 저보다 훨씬 고수인 분들도 많고, 제 문제에 더 나은 해결 방법을 갖고 계신 분들도 많으리라는 걸 알아요. 그런 방법이 있다면 댓글로 공유해 주세요. 제게 큰 도움이 될 것 같아요.
문제 상황
저는 클로드코드(VS Code)를 주 에이전트로 쓰고, 맥미니와 맥북에어 두 대를 오가며 일해요. 레시피 앱도 처음엔 클로드코드 아티팩트로 기획했는데, 아티팩트 안에서는 유튜브 영상이 재생되지 않았어요. 그래서 Vercel 웹앱으로 바꿨어요. 그다음 문제는 두 가지였어요.
클로드코드는 로그인이 필요한 유튜브 비공개 재생목록을 직접 읽기 어려웠어요.
터미널에서 코드를 고치고, 브라우저에서 결과를 보고, 다시 터미널로 돌아가는 왕복이 번거로웠어요.

AI 생성 일러스트: 코딩과 결과 확인 사이를 오가던 불편을 표현했어요.
진행 방법
사용한 도구
클로드코드: 기획안, 앱 뼈대, 매일 06:30 수집 파이프라인, 1차 배포
Aside: 로그인된 브라우저로 유튜브 수집, 배포된 사이트를 보면서 수정·배포, 점검
Aside CLI(
aside repl): 클로드코드 파이프라인이 Aside 브라우저를 불러 쓰는 통로Obsidian 볼트: 레시피 노트(정본), 두 에이전트가 같이 쓰는 인계노트 폴더
Vercel: 앱 배포, 기록 저장소, 구글 로그인
Soniox: 말로 입력하기
1. 먼저 하네스부터: '꾸기'에게 바란 것
지아코모 님이 주신 온보딩 프롬프트로 Aside 에이전트를 세팅했어요. '꾸기'라는 이름을 붙이고 말투를 정하면서 SOUL.md와 AGENTS.md를 다듬다 보니 정이 붙더라고요. 이때 꾸기에게 바라는 걸 이렇게 말했어요.
너에게 기대하는 건 내가 여러 디바이스에서, 그리고 클코 vs code에서 하던 것들,
볼트에 쓰는 것들을 모두 알고 있으면 좋겠고, 너가 한 작업들을 걔들도 알면 좋겠음그래서 두 가지를 만들었어요.
클로드코드에 이미 있던 설정(전역 규칙)을 꾸기가 읽을 수 있게 연결했어요.
맥미니, 맥북에어, 클로드코드, Aside가 한 작업을 볼트의 인계노트 폴더 하나에 모으는 핸드오프 루틴을 만들었어요. 꾸기는 매일 22:30에 그날 작업을 인계노트로 남겨요.
권한은 대체로 추천 가이드를 따랐어요. 결제, 로그인, 외부 전송, 게시, 삭제는 제가 승인해야만 하도록 해 뒀어요.
2. 클로드코드가 Aside를 손발로 쓰다
클로드코드가 만든 수집 파이프라인은 Aside CLI로 제가 로그인해 둔 Aside 브라우저를 빌려 써요. 비공개 재생목록 15개와 각 영상의 설명란, 댓글을 가져오면 클로드코드 에이전트들이 나눠서 레시피를 뽑아요. OAuth를 따로 붙이지 않아도 됐어요.
# 클로드코드가 만든 collect.py 일부: Aside 브라우저를 CLI로 호출
def aside(code):
out = subprocess.run(['aside', 'repl', code], capture_output=True, text=True, timeout=600).stdout// Aside 안에서 실행되는 부분: 설명란과 댓글 수집
const [m, c] = await Promise.all([
youtube.getMetadata(id),
youtube.getComments(id, { limit: 8, lang: 'ko', region: 'KR' })
]);초기 수집에서는 재생목록 15개에서 영상 917개를 모았고, 그중 599개를 레시피로 정리했어요. 설명란이나 댓글에 레시피가 없는 308개는 "레시피 정리 전"으로 남겼어요.
볼트를 정본으로 둔 간단한 구조
데이터·백엔드·로직을 세 레이어로 나누는 구조도 생각해 볼 수 있겠지만, 일단은 간단하게 만들었어요. 레시피와 조리 기록의 정본을 볼트에 두고, 그 노트를 앱이 읽을 데이터로 바꿔 화면에 보여 주는 방식이에요. 별도의 레시피 데이터베이스를 먼저 만들기보다, 이미 쓰는 볼트를 중심으로 연결한 거죠.
다만 폰에서 볼트를 실시간으로 직접 읽고 쓰는 건 아니에요. 별도의 레시피 데이터베이스를 만들지 않은 대신, Vercel Blob을 앱과 볼트 사이의 서버 대기함으로 활용했어요. Blob은 파일을 보관하는 서비스이고, 그 자체가 임시 저장소인 건 아니에요. 여기서는 조리 기록과 레시피 변경 내용을 먼저 받아 두는 용도로 쓰는 거예요.
앱에서 남긴 기록은 Blob의 대기함에 먼저 쌓여요. 매일 아침 자동 작업이 그 내용을 볼트의 노트에 반영하고, 앱 데이터를 다시 만들어 배포해요. 로그인과 기록 저장에 필요한 작은 백엔드는 있는 구조예요.

비공개 재생목록과 좋아요에서 모인 요리 영상 → 매일 수집 → 레시피·재료·분류 정리 → 앱에서 조리 기록·가족 반응·v2·스티커 업데이트. 기록은 Vercel Blob을 거쳐 다음 아침 볼트와 앱에 반영돼요. 좋아요 영상은 선행 수집된 볼트의 요리 영상 노트에서 합쳐요.
3. 이번엔 Aside가 클로드코드 일을 이어받다
1차 배포까지 클로드코드로 한 다음, 저녁에는 Aside로 넘어왔어요. 배포된 사이트를 옆에 띄워 두고 Soniox로 말하면서 계속 고쳤어요. 한영을 섞어 말해도, 어느 입력창에든 받아써 주니 생각나는 걸 천천히 말하면서 수정하기가 정말 편했어요.
Aside로 옮기고 나니 확실히 편했어요. 배포된 사이트를 옆에 나란히 띄워 놓고 고치니까 클로드코드로 작업할 때보다 훨씬 수월했고, 아티팩트처럼 유튜브가 재생되지 않는 제약도 없었어요. 작업 중에 떠오른 요청을 줄 세워 두는 큐(대기열) 화면과 Usage(사용량) 현황 화면도 늘 쓰던 VS Code보다 깔끔해서 편했어요.
VS Code에서 클로드코드를 쓰면서 불편한 UI에 어느새 익숙해져 버린 저를 잠깐 돌아보게 됐어요. 새로운 도구도 계속 써 보고, 익숙한 작업 방식 속에서도 불편함을 발견해 더 나은 대안을 찾아가는 노력이 필요하다는 걸 느꼈어요.

배포된 앱을 왼쪽에 띄워 두고 오른쪽 Aside에서 고치는 화면. 아래쪽에 다음 요청 2개가 큐에 대기 중이고, 'Send now'로 바로 보내거나 고치고 지울 수 있어요. 2026-10-04 촬영.

큐 화면만 크게 본 모습. 레시피북이 아닌 다른 글쓰기 작업 중에 찍은 화면이에요. 에이전트가 일하는 동안 다음 요청을 미리 쌓아 두고 순서를 바꿀 수 있어요.

Usage(사용량) 화면. 입력창 오른쪽 아래 동그라미 아이콘에 마우스를 올리면 지금 대화가 얼마나 찼는지(78%, 213K/272K 토큰)와 5시간·주간 한도가 얼마나 남았는지(74%·81%)가 한 번에 보여요.
이거 몇가지 수정하면 좋겠는데. 너 버셀에 있는 이 앱 디자인 수정할 수 있어?꾸기는 볼트에서 앱 소스와 빌드 스크립트를 찾아 구조를 설명하고, "배포는 게시에 해당하니까 하기 전에 한 번 물어볼게"라고 했어요. 그날 밤 4시간 정도, 요청 약 28개로 이런 것들이 들어갔어요.
조리 중에도 살아 있는 영상 컨트롤러, 이전/다음을 눌러도 영상이 끊기지 않게
폰에서 바로 남기는 조리 기록, 재료를 바꿔 v2 레시피 만들기, 인분 추정
서버 저장(Vercel Blob)과 구글 로그인(가족만 허용)
링크 칩, 쇼츠 넘김 애니메이션, 아이폰 화면 확대 버그 수정, 앱 아이콘, 정렬 개선
내 요리 사진·영상 올리기, 조리 중 화면 꺼짐 방지, 알러지용 '계란 없음' 필터
레시피를 삭제하면 다음 날 아침 유튜브 재생목록과 노트까지 정리
실제 앱 화면
🔗 레시피북 직접 체험하기 →
누구나 접속할 수 있는 공개 체험용 사본 앱이에요.
1~2주 후 만료 예정이니, 열려 있을 때 한번 써 보세요.

모바일 보기 · 밝은 테마. 데스크톱 브라우저에서 앱의 520px 모바일 보기 영역을 촬영한 화면으로, 실제 아이폰 촬영본은 아니에요. 2026-10-06 촬영.

PC 보기 · 어두운 테마. 같은 레시피를 넓은 화면에서 보면 영상과 조리 순서·조리 로그가 나란히 보여요. 2026-10-06 촬영.

AI 생성 일러스트: 같은 정본을 읽고 쓰며 일을 주고받는 두 에이전트의 관계예요.
4. 다음 날 아침, 다시 클로드코드로
다음 날 아침에 확인을 부탁했어요.
간밤에 유투브 몇개 새로 추가해놨는데 레시피북에 잘 들어왔나 체크해봐꾸기는 새 영상 11개가 06:30 자동 수집으로 다 들어온 걸 확인했어요. 레시피 노트가 없는 영상에 남긴 조리 기록 3건이 대기 중이라는 것도 찾아냈어요. 그래서 물었어요.
근데 왜 너가 직접 못해?꾸기의 답은 "할 수 있어. 그런데 이 파이프라인은 클로드코드가 만들었고 매일 자동 배포와 연결돼 있어서, 내가 몰래 고치면 꼬일 수 있어"였어요. 그래서 인계노트를 남겼고, 클로드코드가 그 노트를 받아 같은 날 처리했어요.
사용한 프롬프트 전문
실제로 보낸 요청 중 공개해도 되는 것만 모았어요.
[수정 요청 묶음: 폰에서 써 보고 한 번에 말함]
폰에서 웹뷰라서 불편한게 몇가지 있어.
1. 더블 탭 했을 때 확대되는 거.
2. 초기 화면에서 폰을 가로로 90도 회전했을 때 가로 뷰가 나오는데, 영상 볼 때는 왜 목록에서도 굳이 가로 뷰로 나오는지 더 불편한 것 같아.
3. 바탕화면에 추가 앱처럼(웹앱처럼) 실행할 수 있도록 해놨는데, 혹시 모바일에서 아이콘 같은 걸 이미지로 넣을 수 있나? 앱 아이콘처럼 작동하게.
4. 최신순이 어떤 순으로 되어있어? 내가 재생목록에 추가하거나 좋아요 한 순이 기본이고, 조리기록을 다시 남기면 최신값이 업데이트 되면 좋을 것 같아.
5. facet 분류 선택 UI를 개선했으면 해. 한번 더 탭하면 해제되서 전체가 활성화되게 한다거나. 그리고 중복이 불가능한 조합은 disabled 한다거나.
6. 상세 영상이나 레시피를 보다가, 더이상 재생이 불가한 영상 등은 삭제할 수 있으면 좋겠어.
7. '유투브에서 OO 채널 보기' 버튼 같은게 있으면 좋겠어. 누르면 유투브 앱 실행되게끔. 물론 pc에서는 유투브 링크가 새 탭으로 실행되게.
[설계에 질문하기]
컨트롤러 말인데, 유튜브 컨트롤러를 그대로 쓰면 안 돼? 왜 굳이 별도 UI로 만들어야 돼?
[비개발자로서 다시 설명 요청]
뭐야? ABC가 뭔지 모르겠고, 키 전달 방법도 비개발자가 알기 쉽게 다시 한 번 차근차근 설명해 줘.결과와 배운 점
확인된 결과
Before: 아티팩트로 기획한 앱은 영상이 재생되지 않았고, 조리 기록은 "채팅으로 알려 주기"뿐이었어요. After: 로그인이 걸린 폰 웹앱에서 영상을 보며 요리하고, 기록, 사진, 레시피 v2까지 바로 남겨요. (근거: Aside 세션 10/4~10/5)
초기 수집: 재생목록 15개, 영상 917개, 레시피 정리 599개. 매일 06:30 클로드코드 파이프라인이 Aside CLI로 자동 수집해요. 10월 6일 현재 앱에는 영상 919개, 정리된 레시피 608개가 보여요. (근거: 레시피북 기획안, 파이프라인 코드, 현재 앱 화면)
이어받기: 10/5 아침 새 영상 11개 자동 반영 확인, 남은 문제는 인계노트로 넘김, 같은 날 클로드코드가 처리했어요. (근거: Aside 세션, 10/5 인계노트)
시행착오
아티팩트의 한계: 클로드코드 아티팩트 안에서는 유튜브 임베드가 안 됐어요. 그래서 Vercel로 바꿨어요.
배포 사고: 꾸기가 안내 문구를 고치다 따옴표가 꼬인 채로 배포돼서 1분 정도 앱이 안 열렸어요. 그 뒤로 문법 오류가 있으면 빌드 단계에서 배포를 멈추는 장치를 넣었고, 매일 아침 자동 배포에도 똑같이 적용했어요.
유튜브 기본 컨트롤 vs 직접 만든 버튼: 꾸기는 직접 만든 큰 버튼을 추천했는데, 저는 둘 다 켜 두기로 했어요.
너무 압축된 설명: 선택지를 A/B/C로만 물어봐서 이해가 안 됐어요. 비개발자 눈높이로 다시 설명해 달라고 했고, 이후로는 그렇게 설명하도록 꾸기의 사용자 정보에 반영됐어요.
비밀키 전달 실패: 앱 기록 저장용 키를 폰에 붙여 넣는 방식이 클립보드 문제로 막혔어요. 결국 키를 없애고 구글 로그인으로 바꿨어요.
아직 남은 작은 번거로움
어느 쪽에서든 이어 할 수 있게 됐지만, 그 연결은 여전히 인계노트를 써 두면 각 에이전트가 읽고 쓰는 방식이에요. 아침·저녁 루틴에서 자동으로 돌게 해 두었는데도, 에이전트끼리 실시간으로 바로 주고받는 것과는 거리가 있어서 살짝 불편해요. 기술이 더 발전하면 이 작은 번거로움도 없어지지 않을까 기대하고 있어요.

AI 생성 일러스트: 서로 다른 에이전트를 공통 작업 흐름으로 묶은 하네스의 비유예요.
꿀팁
정본은 한 곳에: 레시피 노트도, 인계노트도 볼트에 두니 어느 에이전트든 같은 자료를 읽어요.
역할보다 통로를 먼저: CLI(클로드코드에서 Aside로)와 인계노트(Aside에서 클로드코드로), 두 통로를 열어 두면 누가 어떤 일을 맡든 상관없어져요.
"왜 직접 안 해?"를 물어보세요: 에이전트가 일을 넘기는 이유를 들으면 담당 구분과 위험 지점이 보여요.
배포 전에 묻게 하기: 게시·배포·로그인·결제는 승인을 받게 해 두면 말로 막 시켜도 불안하지 않아요.
@로 다른 탭 부르기: 입력창에 '@'와 탭 이름을 입력하면 다른 탭을 쉽게 멘션할 수 있어요.
다른 업무에 적용한다면
로그인된 브라우저가 필요한 수집은 클로드코드가 Aside CLI로 맡기고, 결과 화면 다듬기는 Aside에서 하는 식으로 응용할 수 있을 것 같아요.
기본 브라우저를 Aside로 바꾼 지 1주쯤 됐는데, 어느새 꽤 많은 일을 Aside와 함께 하고 있더라고요. 특히 MCP가 없어 손으로 입력하던 귀찮은 조각들을 Aside가 채워 줘서 마음에 들어요.
네이버 예약 내역을 구글 캘린더에 알아서 등록하는 루틴을 만들었어요.
정보를 찾아보다 배운 내용을 바로 블로그 글로 정리해요. 너무 편해서 네이버 블로그를 시작해 볼까 하는 생각까지 들 정도예요. ㅎㅎ
앞으로의 계획
레시피 정리 전 영상 308개를 자막, 음성인식, 화면 글자로 레시피화하는 계획을 실행하고 있어요.
익숙해지면 결제와 인증을 포함한 권한을 대부분 꾸기에게 넘길 생각이에요. 물론 일정 금액 이상 결제는 막아 둘 거예요.
인계노트 없이 에이전트끼리 바로 이어지는 방법이 나오면 가장 먼저 붙여 보고 싶어요.
토스증권 같은 증권사 화면에서 자산 현황을 스냅샷으로 모아 자산 관리 대시보드를 만들어 볼 생각이에요. 그다음에는 자동 투자에도 도전해 보려고요.
도움 받은 글 (옵션)
지피터스 24기 에이전트하네스 스터디(지아코모 님) 온보딩 자료와 사례글 작성 스킬
닿님의 write-post (https://github.com/daht-mad/write-post), 사례글 작성 절차의 원 출처
김진형 멀티에이전트 스터디장님이 공유해 주신 Soniox로 말로 코딩하기 팁도 큰 도움이 됐어요.




라면님, 모아 두기만 하던 요리 영상 900여 개를 영상을 보면서 요리하고, 바꾼 재료와 가족 반응까지 남기는 레시피북으로 옮기셨네요. 화면 꺼짐 방지나 조리 중에도 이어지는 영상 컨트롤러까지 다듬은 부분에서, 실제로 써 보며 불편한 곳을 고친 과정이 보여요.
클로드코드가 Aside의 로그인된 브라우저를 빌려 수집하고, Aside에서는 배포된 화면을 보며 앱을 다듬은 흐름도 흥미롭게 읽었어요. 레시피와 인계노트의 정본을 볼트에 두셔서 도구를 바꿔도 이어받을 자료가 남고요. 꾸기에게 '근데 왜 너가 직접 못해?'라고 물었을 때, 기존 자동 배포와 연결된 파이프라인을 함부로 고치지 않으려는 이유를 확인하신 대목도 좋았어요.
남겨 주신 인계노트의 번거로움은 CLI로 바로 요청을 넘기는 방법을 붙여 볼 수 있어요. 이미 쓰고 계신 클로드코드 → `aside repl`의 반대 방향으로, 꾸기가 터미널에서 `claude -p`를 실행해 클로드코드에 요청하고 결과를 받는 방식이에요. 이런 직접 호출에는 별도의 ACP 설정이 필요하지 않아요.
제 환경에서 Aside에게 코덱스와 클로드코드를 직접 호출하도록 시켜 봤어요. 코덱스는 `codex exec`로 작은 테스트 파일을 읽고 요청한 JSON을 정확히 돌려주는 데까지 확인했어요. 클로드코드는 `claude -p`가 실행되어 로그인 필요 오류를 반환하는 것까지 확인했고, 당시 구독이 일시적으로 만료된 상태여서 정상 답변은 받지 못했어요. 따라서 클로드코드는 호출 통로까지만 확인된 상태이고, 기존 작업 이어받기나 두 맥 사이 연결까지 검증한 것은 아니에요.
처음에는 같은 맥에서 CLI의 실제 실행 파일 경로와 프로젝트 폴더를 확인한 뒤, 작업 목표와 인계노트 경로를 전달해 조회만 시켜 보면 좋겠어요. Aside 대화나 VS Code의 작업 맥락이 자동으로 전달되는 것은 아니어서, 무엇을 이어 할지 명시해 줘야 해요. 클로드코드의 기존 CLI 대화를 이어갈 때는 `--resume`에 정확한 세션 ID를 지정하는 기능도 있어요. 이 부분은 [클로드코드 공식 문서](https://code.claude.com/docs/en/headless)에 안내되어 있지만 이번에는 직접 시험하지 못했어요. 인계노트는 없애기보다, 바로 넘긴 요청의 결과와 남은 일을 남기는 용도로 유지하면 좋겠어요.
결제와 자동 투자로 넓히실 때는 금액 상한과 별개로, 조회 권한과 실제 결제·주문 권한도 나눠 두시면 좋겠어요. 자산 현황을 모으는 대시보드는 조회 전용으로 시작하고, 실제 결제나 주문의 최종 승인은 따로 남겨 두는 쪽을 권합니다.
배포 사고 뒤에 문법 오류가 있으면 배포를 멈추는 장치를 넣고, 매일 아침 자동 배포에도 적용하신 수리가 특히 반가웠어요. 폰에서 직접 쓰며 앱을 고친 과정에 재발 방지까지 담겨서, 앱을 만들고 운영해 보려는 분들이 함께 참고할 수 있겠어요.