도시아재
도시아재
🗡️ AI 레전드
🚀 SNS 챌린지 달성자
🏅 베스트오브베스트

동료 스터디에 앞서 공인중개사가 먼저 만들어 본 'Claude Cowork 5분 입문' 대시보드 ✨

부동산 스터디에 앞서 공인중개사가 먼저 직접 만들어 본 'Cowork 5분 입문' 대시보드 ✨

🌐 결과물 미리보기: https://sachol.github.io/cityuncle-cowork-intro-dashboard/
📦 코드 저장소: https://github.com/sachol/cityuncle-cowork-intro-dashboard

🌐 대시보드 개선/확장 사례글: https://github.com/sachol/cityuncle-cowork-intro-dashboard/blob/main/case-study-v2.md


소개

안녕하세요, 공인중개사님들과 AI 스터디하고 있는 도시아재입니다 🏢. 본업으로 공인중개사 업무를, 취미 또는 알바 느낌으로 같은 분야 공인중개사님 · 중개보조원분들을 대상으로 AI 활용 기초 강의를 하고 있습니다.

이번 22기("강사·교육자를 위한 Claude Code + Cowork로 강의 운영 자동화 시스템 만들기") 첫 주에, 본 사례(주소 → 매물 맞춤 리포트)와는 별개로 OT 전에 사례 게시판에 올릴 미니 사례 한 장을 따로 만들어 봤습니다.

만든 이유는 단순했습니다 — "같은 분야 대표님들이 5분 만에 따라할 수 있는 Claude Cowork 입문 가이드 한 장" 을 제가 먼저 직접 만들어 보고 싶었습니다. 동료분들의 스터디에서 알려드릴 패턴이 정말 5분 안에 작동하는 지를 시안으로 검증하고, 다른 강사·교육자분들도 "내 분야엔 어떻게 적용할까?" 떠올릴 수 있는 견본을 남기고 싶었습니다.

그리고 이 미니 사례를 만들면서 결과물 자체보다 더 크게 배운 점이 있었습니다. 게시판에 올리기 직전 한 번 더 검증을 거치면서 외부 도구 인용(Cowork Dispatch) · 가입 경로 · 플랜 등 5~6곳이 부정확했음을 발견했고, 그대로 게시되었다면 수강생분들이 첫 단계부터 막혔을 겁니다. 이 경험을 운영 규칙(CLAUDE.md)에 "기획의도 검증 게이트" 로 새겼고, 같이 공부하시는 분들과도 꼭 나누고 싶은 인사이트라 사례글에 별도 단계로 적어 두었습니다 (아래 7단계).

💡 공인중개사님 스터디에서 알려드릴 패턴을 강사 스스로 먼저 만들어 보면, 슬라이드보다 훨씬 강한 신뢰가 됩니다. "제가 직접 만들어 본 거예요!" 한 줄이 OT 자료의 기둥이 됩니다.

클로드 카우워크

진행 방법

전체 작업은 첫주 수업 후 바로 작업을 해봤습니다. 도구는 Claude Code + Cowork + Tailwind CDN 만 사용했고, 빌드 도구 없이 단일 정적 HTML 파일 1개로 만들었습니다.

1단계 — 메인·서브 프로젝트 구조 결정

매주 새 결과물을 만들 때 메인 프로젝트가 점점 뒤섞이는 것을 피하려고, 각 주차 사례를 subprojects/<name>/ 하위로 물리적으로 분리하기로 했습니다.

gpters22_edu/                       # 메인 — 강의 전체 계획·인프라
└── subprojects/
    └── cowork-intro-dashboard/     # 이번 미니 사례 (서브)
        ├── plan.md
        ├── AGENTS.md
        ├── content.md
        ├── index.html
        └── README.md

각 서브 프로젝트는 자기 plan · AGENTS · README를 가집니다. 다음 주차 결과물도 같은 패턴(subprojects/<name>/)으로 들어갑니다.

💡 이 구조를 첫 사례부터 정한 게 가장 중요한 결정이었습니다. 결과물끼리 충돌 없이 독립 운영되고, 사례글 작성도 서브 디렉터리 단위로 깔끔합니다.

2단계 — 6 섹션 정보 설계

대시보드는 한 장 페이지지만 다음 6 섹션으로 분명히 나눴습니다:

섹션

의도

HERO

한 줄 슬로건 + "5분 안에 따라하기" 진입

WHAT · 뭡니까?

Cowork이 뭔지 어려운 IT 용어 없이 3 카드 설명

HOW · 시작하기

진짜 3단계 (가입 · 내 사무소 설정 · 매물 1건 분석)

APPLY · 적용

내 업무 4 진입점 (분석 · 광고 · 응대 · 보고서) + 시간 절약 칩

CASES · 사례

펼치는 BEFORE/AFTER 카드 3개 + Dispatch 시연 (베타)

NEXT · 다음 단계

오늘 안에 해볼 일 3개 체크리스트 + 강의 안내

수강생인 부동산업 종사자들께서 한 화면씩 스크롤하며 내려갈 수 있게 구성했습니다.

한국어 웹사이트 스크린샷

3단계 — Claude Cowork System Instructions (강의에서 그대로 보여줄 패턴)

본문 Step 2에 넣은 System Instructions 예시를 그대로 코드블록으로 게시했습니다. AI에 익숙하지 않은 공인중개사님들이 강의 전에 한번 따라해 볼 수 있게:

나는 서울 ○○구 공인중개사입니다.
매물 분석·광고·고객 응대 작업을 자주 합니다.
답변은 카톡으로 그대로 복사할 수 있는 자연스러운 한국어로 해주세요.

위 한 줄이 "내 부동산 사무소" Workspace에 입력되면, 이후 모든 질문이 자기 사무소 컨텍스트에서 답변되도록 정의됩니다.

4단계 — Dispatch (베타) 시연 — 📱 폰 → 💻 사무소 → 📲 폰

CASE 04 자리에 Claude Cowork의 Dispatch (베타, 2026-03-17 출시) 시연을 넣었습니다. 외근·임장이 많은 공인중개사 업무에 가장 강력한 기능이라고 판단해 꼭 포함하고 싶었던 부분입니다.

Dispatch의 흐름은 공식 문구 한 줄로 정리됩니다:

"Message from your phone. Claude works on your computer. You get the result."
— Anthropic 공식 (claude.com/product/cowork)

즉 1) 📱 외근·임장 중에 폰의 Claude 앱에서 한 줄 보내고, 2) 💻 사무소 Claude Desktop이 파일·이메일·도구에 접근해 자동 처리하고, 3) 📲 완성된 결과가 폰으로 도착하는 흐름입니다.

페이지에서는 폰에서 보내는 입력 예시 한 줄과, 사무소 데스크탑이 한 번에 만들어내는 4개 산출물(시세 분석 · 광고 카피 · 카톡 응대 · 보고서)을 카드로 시연했습니다.

광화문 한일아파트 84㎡, 매매 18억 매물.
오후 임장 예정, 고객은 30대 신혼부부.
시세 분석·광고 카피·임장 직전 카톡 안내·임장 후 보고서 템플릿
4가지 한 번에 만들어서 준비해 둬.

💡 임장 가는 차 안에서 폰으로 한 줄 → 도착하기 전에 4가지 자료가 준비된 상태. 결과 받으러 사무소에 돌아갈 필요가 없다는 게 임장·외근이 많은 공인중개사 업무에 가장 큰 가치입니다.

⚠️ Dispatch는 베타(research preview)이고 사무소 컴퓨터가 켜져 있고 Claude Desktop이 실행 중이어야 작동합니다. 파일 데이터 추출·메일 요약·보고서 작성은 안정적이고, 일부 서드파티 앱 조작은 아직 불안정합니다.

한국 웹사이트의 홈페이지

5단계 — 네오브루탈 디자인 시스템 + 라이트/다크 토글

스타일은 굵은 3px 검정 보더 + 6/8px 검정 그림자 네오브루탈로 통일했습니다. 컬러 토큰(--ink / --paper / --yellow / --pink / --mint / --purple)을 CSS 변수로 정의한 뒤, 다크 모드는 [data-theme="dark"] 셀렉터로 변수만 오버라이드해서 +80줄 추가만으로 다크 토글을 붙였습니다.

:root  { --ink: #0A0A0A; --paper: #FFFCEF; --card: #FFFFFF; ... }
[data-theme="dark"] {
  --ink: #F2F0E5; --paper: #14121A; --card: #20202A; ...
}

테마는 localStorage에 저장되고 시스템 prefers-color-scheme을 자동 감지합니다. FOUC 방지용 inline script를 <head>에 넣어 새로고침 깜빡임도 막았습니다.

클로드 동료

6단계 — 직접 클릭해보며 다듬기

미리보기를 켜놓고 직접 클릭해보면서 세 가지 어색한 점을 발견해 즉시 다듬었습니다:

  1. 워커 카드가 너무 흐림 — opacity 0.15(첫 진입 시 카드가 거의 안 보임) → 0.65 + 살짝 축소 + 채도 85% 로 보강. Dispatch 시작 시 1.0으로 또렷해지는 인터랙션은 유지.

  2. 💡 포인트 박스가 묻힘rgba(255,214,0,0.15) 흐릿한 노랑 → 노랑 채움 + 검정 글씨 + 검정 6px 그림자로 "강조 토스트"화.

  3. HERO 카피 "사무소 일"이 막연 → "공인중개사 업무"로 구체화 (도메인 어휘를 정직하게 쓰는 게 톤이 더 잘 살아남).

이런 다듬기를 Claude Code에서 한 줄씩 지시하면 5~10초 내 반영되어, "보고 → 다듬고 → 새로고침" 사이클이 5분 안에 5바퀴는 돌 수 있었습니다.

💡 라이트 모드에서 잘 보이는 시안이 다크 모드에서는 묻힐 수 있습니다. 두 모드 모두 만든 직후 한 번씩 직접 클릭해보는 것이 결과물 신뢰의 핵심입니다.

7단계 — 게시 직전 "기획의도 검증 게이트" 실행 (가장 중요한 단계)

결과물이 거의 완성된 시점, 게시판에 올리기 직전에 작은 한 줄 질문이 던져졌습니다 — "이 Dispatch가 정확히 뭘 말한 거니?" 그 한 줄로 게시 전에 4가지를 다시 확인하는 단계가 새로 생겼습니다.

검증 4개 항목 (이번 일을 계기로 CLAUDE.md에 새겨 둠):

  1. 기획 의도 일치도 — 결과물 각 섹션이 원래 의도(공인중개사가 사무실에서 따라하며 학습)와 일치하는가

  2. 사실 정확성 — 외부 도구·기능·플랜·접근 경로 등을 추측·기억이 아닌 공식 1차 출처(Anthropic 공식·도움말)로 확인했는가

  3. 청자 가치 — 청자(공인중개사·동료 강사)가 실제 따라할 수 있는가

  4. 본질 흐림 여부 — 작업 중 일반 메타포·관습으로 옮겨가서 본 의도가 약해지지 않았는가

이번 검증에서 발견된 정정 사항 — 그대로 게시되었다면 첫 단계부터 막혔을 5~6곳:

항목

정정 전 (잘못된 묘사)

정정 후 (공식 사실)

Cowork Dispatch

"4 워커 fan-out" 메타포

📱 폰 → 💻 데스크탑 → 📲 폰 원격 실행

(2026-03-17 베타)

가입 경로

claude.ai 웹 가입

Claude Desktop 앱 (macOS/Windows)

요금 플랜

"무료부터 시작 가능"

Pro $20/월 이상 필요

Instructions 길이

짧은 한 줄

5~8줄 이내 짧게 공식 권장

첫 작업 진입

"빈 채팅창에 붙여넣기"

Project 안에서 새 작업

공식 1차 출처(claude.com/product/cowork, Anthropic 도움말의 Cowork 시작·Dispatch 안내)를 모두 확인한 뒤 페이지·사례글·README·content·AGENTS를 한 번에 정정해 다시 배포했습니다.

💡 게이트는 작은 한 줄 질문에서 시작했습니다. "이게 정말 우리가 의도한 거 맞아?" — 이 한 줄이 라이브 페이지의 5~6곳 오류를 막았습니다. 외부 도구·기능을 인용한 결과물일수록 이 단계가 필수입니다. 같이 공부하시는 분들도 본인 결과물 게시 직전에 이 4개 항목 한 번씩 점검해 보시기를 권합니다.

한국 전자상거래 사이트 전후


결과와 배운 점

배운 점

  1. 🚨 검증 게이트가 이번 사례의 가장 큰 배움입니다. 결과물이 거의 완성된 시점에도 "의도와 맞나? 사실은 정확한가?" 한 번 더 묻는 단계만으로 5~6곳의 외부 사실 오류가 잡혔습니다. 그대로 게시되었다면 수강생분들이 따라할 수 없는 자료가 됐을 텐데, 한 줄 질문이 결과물의 신뢰성을 통째로 구했습니다.

    이 경험을 운영 규칙(CLAUDE.md)에 "기획의도 검증 게이트" 로 새겨, W2~W4 다음 결과물에도 자동 실행됩니다. 같이 공부하시는 분들도 본인 결과물 게시 직전에 4개 항목(의도 일치 / 사실 정확성 / 청자 가치 / 본질 흐림) 한 번씩 점검해 보시기를 권합니다. AI로 빠르게 만들수록 이 단계가 더 중요해집니다.

  2. 🧩 첫 사례부터 메인·서브 구조로 분리한 게 가장 잘한 결정이었습니다. 결과물 디렉터리·문서·사례글이 한 폴더 안에서 깔끔하게 묶입니다.

  3. 강사가 먼저 직접 적용해 검증한 결과물 한 장은 슬라이드보다 강한 신뢰가 됩니다. "직접 만들어 본 거예요"가 OT 자료의 기둥이 됩니다.

  4. 🌗 다크 모드는 CSS 변수 + [data-theme="dark"] 오버라이드만으로 +80줄입니다. 디자인 시스템을 토큰화하면 추가 비용이 거의 없습니다.

  5. 🎨 네오브루탈 톤은 굵은 검정 보더·그림자가 핵심이라 라이트/다크 양쪽에서 잘 어울립니다. 같은 톤을 다음 결과물에 그대로 재사용할 수 있는 자산이 됐습니다.

  6. 🔁 "📱 폰 → 💻 데스크탑 → 📲 폰" 흐름(Cowork Dispatch 베타)을 한 번 정확히 시연해두면, 외근·임장 중 활용이라는 핵심 가치가 즉시 전달됩니다. W4 크롬 확장 단계에서도 이 컨셉을 그대로 확장할 수 있습니다.

시행착오

  • 다크 모드에서 워커 카드 가독성: 첫 진입 시 opacity 0.15 → 0.65로 올리고 채도·스케일로 인터랙션 차별화. 라이트 모드 검증만으로는 발견 못 했습니다.

  • 💡 강조 박스가 묻힘: rgba 흐릿한 톤 → 노랑 채움 강조 토스트로 변경. "강조하고 싶다면 명도 차이가 분명해야 한다"는 단순한 원칙을 다시 확인했습니다.

  • HERO 카피의 추상성: "사무소 일"이 막연 → "공인중개사 업무"로 구체화. 도메인 어휘를 그대로 쓰는 게 공감대를 더 만들었습니다.

  • 외부 기능명을 임의로 명명한 큰 실수 (가장 중요): 초안 단계에서 "Dispatch"를 fan-out 메타포로 잘못 명명했고, 가입 경로·플랜 등도 추측으로 채워둔 상태였습니다. 게시 직전에 한 번 더 검증을 거치며 공식 문서를 확인했더니 5~6곳이 사실과 달랐고 모두 정정했습니다. 구체적 정정 표·발견 과정·운영 규칙화는 위 진행 방법 7단계에 자세히 정리해 두었습니다 — 이 사건이 검증 게이트 도입의 계기였습니다.

앞으로의 계획

이 미니 사례는 22기 4주 마일스톤의 첫 주에 만든 "주차별 본 사례 옆에 두는 1장 견본" 입니다. 다음 회차들에서는 본 사례·강의자료·대시보드 결과물이 차례로 이어질 예정이고, 그때마다 사례글로 따로 공유해 보고자 합니다. (시간이 되는 한....)

가까이는, 이 작은 사례를 다음 회차에 강의자료 1차시로 변환해보면서 — 한 장 페이지가 어떻게 슬라이드·워크북·퀴즈 1세트로 자연스럽게 풀리는 지를 확인할 계획도 있습니다.


도움 받은 글 (옵션)

5
6개의 답글
밀어주고 끌어주는

온·오프라인 AI 스터디

AI로 어디까지 할 수 있는지
직접 확인하실 분만 신청하세요.