CMDSPACE Labs
실행 가이드 · 2026-09-17 강의 실황 순서

어제 한 것을
그대로 다시.

강의에서 실제로 진행한 순서 그대로입니다. 계획서가 아니라 그날 화면에서 일어난 일을 따라갑니다. 막혔던 지점도 숨기지 않고 적었습니다 — 여러분도 같은 자리에서 막히실 겁니다.
순서대로만 가시면 됩니다. 전부 하지 않으셔도 STEP 8까지면 그날 본 것의 핵심은 재현됩니다.

📦 실습 키트 받기 강의 자료 페이지 🧩 스킬 공유
먼저 세 가지를 솔직히 말씀드립니다.

하나. 무료 계정으로는 절반까지만 됩니다. 강의 당일 Claude 무료 계정은 폴더 열기가 막혀 있었습니다 — 정책이 그 사이 바뀐 것이라 저도 무대에서 알았습니다. 무료로 하시려면 ChatGPT(Codex) 쪽으로 가십시오.

둘. 무료 계정은 금방 한도에 걸립니다. 그날 2교시 중반에 대부분 멈추셨습니다. 한 달 20~30달러 정도는 쓰셔야 끝까지 갑니다. 연구에 쓰실 거라면 그 정도는 투자 가치가 있습니다.

셋. 지금 하십시오. 나중에 집에 가서 하겠다고 하면 대부분 안 하십니다. 20분이면 STEP 5까지 갑니다.

Step 1앱을 깝니다

Install

ChatGPT 데스크톱 앱 · Claude 데스크톱 앱

웹 브라우저 채팅이 아니라 데스크톱 앱이어야 합니다. 앱에만 내 컴퓨터 폴더를 직접 읽는 모드가 있습니다.

설치 후 로그인까지 마치십시오. OS에 맞는 버전은 자동으로 잡힙니다.

막히면 — Claude에서 코드 모드를 쓰시려면 컴퓨터에 Git이 깔려 있어야 합니다. 에러가 나면 Git 설치 후 다시 열어보십시오. 무료 계정이시면 이 단계에서 Claude는 접고 ChatGPT로 가시는 편이 빠릅니다.

Step 2작업 폴더를 만들고 연결합니다

Connect

이게 오늘의 전부입니다 — 폴더를 여는 것이 곧 맥락을 여는 것

내 문서나 다운로드에 내가 알아볼 이름으로 폴더를 하나 만듭니다. 예) 홍길동0917

  1. ChatGPT(Codex) — 왼쪽 프로젝트 선택 → 프로젝트 만들기 → 아래 추가 버튼으로 방금 만든 폴더 선택 → 만들기 → 폴더 신뢰하기
  2. Claude(Code) — 오른쪽 코드 아이콘 → 새 창 → Open Folder → 방금 만든 폴더 선택

오른쪽 아래에 내 폴더 이름이 떠 있으면 성공입니다.

가장 많이 나는 사고 — 어느 층위의 폴더를 여는지가 중요합니다. 폴더를 클릭해서 들어간 뒤 열든, 클릭한 상태에서 열든 같습니다. 그런데 그 안의 다른 폴더를 누르고 열면 엉뚱한 맥락이 열립니다. 항상 오른쪽 아래 폴더명을 확인하십시오.

Step 3연결됐는지 확인합니다

Verify

working directory 물어보기

채팅창에 그대로 치십시오.

wd 알려줘

지금 어느 폴더에서 일하고 있는지 주소를 알려줍니다. 내가 만든 폴더가 맞으면 다음으로 갑니다.

참고 — 처음에는 "파일 읽을까요?" "파일 만들까요?" 하고 매번 묻습니다. 왼쪽 아래 권한 설정에서 bypass permission으로 바꾸면 묻지 않고 진행합니다. 무슨 일이 일어나는지 아는 폴더에서만 쓰십시오.

Step 4내 연구 주제를 문서로 만듭니다

First Output

맥락을 주고 파일로 남기기

줄바꿈은 Shift + Enter입니다. 아래를 복사해 쓰시고 마지막에 본인 연구 주제를 붙이십시오.

STEP 4 — 연구 주제 문서화
내 연구 주제에 대한 이야기를 할 거야. 아래 내용 확인해서 문서 만들어 줘.
필요하면 필요한 파일들 각각 만들어 줘.
나중에 Obsidian에서 쓸 거야. 연결도 해줘.

[여기에 본인 연구 주제를 몇 줄 적으십시오]

맥락이 없으면 일반론이 나옵니다. 내가 어디까지 연구했는지, 무엇이 리젝됐는지, 우리 부서가 무엇을 보는지를 줄수록 결과가 내 것이 됩니다.

모델 선택 — 대부분의 작업은 중간 등급(Claude는 Opus 5 Medium 정도)으로 충분합니다. 중요한 판단에만 상위 모델을 쓰십시오. 추론 강도는 High 이상을 권합니다.

Step 5옵시디언으로 열어 봅니다

See It

내 연구가 연결된 그림으로

  1. obsidian.md 에서 옵시디언 설치 (보라색 아이콘)
  2. 첫 화면에서 Open folder as vault → STEP 2에서 만든 폴더 선택
  3. 이미 켜져 있다면 왼쪽 아래 볼트 이름 클릭 → Manage Vault → 열기
  4. Ctrl + G (Mac은 Cmd + G) — 그래프 뷰

내 연구 주제와 이야기가 연결된 노트로 나옵니다. 여기서부터가 지식 베이스입니다.

Step 6실습 키트를 엽니다

Practice Kit

압축을 반드시 푸십시오

실습 키트 ZIP 받기 → 압축 해제 → Practice Kit 폴더가 나옵니다. 압축 상태로는 진행되지 않습니다.

Practice Kit/ ├── CLAUDE.md ← AI를 위한 규칙 (하네스) ├── readme.md ← 사람을 위한 설명 ├── data/ ← 밸리데이션 데이터 121행 + codebook ├── prompts/ ← v1 / v2 / v3 └── notes/ ← 분석 로그 서식

앱에서 새 창을 열고 이 Practice Kit 폴더를 엽니다 (STEP 2와 같은 방법). 오른쪽 아래에 Practice Kit이 떠야 맞습니다.

확인 질문 — 열고 나서 이렇게 물어보십시오. 이거 뭐하는 폴더야? 규제과학 실습 키트라고 답하면 제대로 열린 것입니다.

Step 7하네스 파일을 봅니다

Harness

readme.md는 사람용, CLAUDE.md는 AI용

CLAUDE.md를 메모장으로 열어 보십시오. 이 폴더에서 AI가 묻지 않고 지켜야 할 규칙이 적혀 있습니다.

이것이 그 폴더의 헌법입니다. 여러분 부서의 업무 규약을 여기 적어 두면 AI가 그 규약대로 일합니다.

ChatGPT를 쓰신다면 이 한 줄이면 호환됩니다.

STEP 7 — 하네스 변환
CLAUDE.md를 읽어서 네가 쓸 AGENTS.md로 변환해줘.

Step 8한 줄로 분석을 돌립니다 ★

The Point

여기가 강의의 핵심이었습니다

STEP 8 — v3 실행
v3 프롬프트로 진행해서 실제로 어떻게 돌아가는지 보자.

이 한 줄로 일어나는 일을 보십시오.

  1. 데이터에 일부러 심어 둔 표기 오류를 스스로 찾아 보고합니다 (대소문자 불일치·공백 문자열·카테고리 오기)
  2. 원본은 건드리지 않고 clean/ 폴더에 정제본을 새로 만듭니다
  3. figures/에 그림을, notes/에 분석 로그를 남깁니다
  4. 요약 3줄 → 품질 점검 → 상세 분석 → 이 데이터로는 답할 수 없는 것까지 보고합니다

지시한 것은 한 줄뿐인데 이 모든 것이 지켜지는 이유는 STEP 7의 규칙이 파일에 먼저 적혀 있었기 때문입니다. 이것이 프롬프트와 하네스의 차이입니다.

그날 일어난 일 — v1을 먼저 돌리라고 했더니 AI가 거절했습니다. "이 폴더는 v3 기준으로 설계돼 있어 v1은 적절하지 않다"면서요. 규칙이 잘못된 프롬프트를 막아선 것입니다. 여러분도 v1 먼저 해볼게 진행해줘를 시켜 보시고 뭐라고 하는지 보십시오.

Step 9예전 AI에서 내 맥락을 가져옵니다

Migrate

그동안 쌓인 대화가 자산입니다

chatgpt.com 웹사이트에서 (앱이 아니라 웹입니다) 이렇게 물어보십시오.

STEP 9-1 — 웹에서 추출
지금까지의 나와의 대화를 바탕으로 나의 연구 주제, 관심사,
후속 연구 방향 등을 정리한 [본인 이름] 연구 페르소나를 정리해줘.

한 번 더 물어 개인적인 것도 받으십시오 — 연구 외에도 나에 대한 주요 정보들 있으면 정리해줘

그 결과를 복사해서 내 로컬 폴더 세션에 붙여넣습니다.

STEP 9-2 — 로컬로 이관
아래 내용을 참고해서 나에 대해 정리해줘.
이 문서들을 Obsidian에서 볼 거야. 노트의 연결과 메타 정보를 엄밀하게 작성해줘.

[여기에 위에서 받은 내용을 붙여넣으십시오]
왜 이걸 하나 — 결과의 질은 내가 준 맥락의 양으로 결정됩니다. 그동안 웹 채팅에 쌓인 것을 로컬로 옮기면 그때부터 데이터 주인이 나입니다.

Step 10스킬을 만듭니다

Skill

한 번 잘한 일은 다시 시킬 수 있습니다

좋은 프롬프트를 한 번 쓰고 잊어버리는 문제를 해결합니다. 반드시 local을 명시하십시오 — 이게 그날 제가 낸 사고입니다.

STEP 10 — 스킬 만들기
내가 추가로 정보를 던지고 명령하면 Obsidian에서 볼 수 있게
노트를 연결하고 메타정보를 작성하고 기존 노트들과의 연결도
구성해주는 스킬 만들어줘. local 프로젝트에서 돌아가게 해줘.

만들어진 스킬은 / 를 치면 자동완성으로 뜹니다. 탭으로 선택하고 한 줄만 던지면 발동됩니다.

제가 낸 사고 — local을 빼먹으면 글로벌 스킬로 만들어집니다. 글로벌은 어느 폴더에서나 되지만 폴더를 압축해 가져갈 때 따라오지 않습니다. 이미 글로벌에 만드셨다면 사용자 폴더의 .claude(또는 .agents) → skills 에서 해당 폴더를 복사해 프로젝트 안으로 옮기면 됩니다. 남이 만든 스킬을 받아 쓰는 방법도 똑같습니다.

수업에서 만든 스킬 두 개의 전문과 만드는 법은 스킬 공유 페이지에 정리해 두었습니다.

Step 11학술 DB를 붙입니다

Research DB

AI 인용 기능을 그대로 믿으면 안 되는 이유

요즘 AI의 자동 인용 기능은 대부분 오픈액세스 저널에 한정됩니다. SCI·SSCI급이 빠집니다. 그래서 실제로 쓰는 DB를 직접 붙여야 합니다.

DB접근
PubMed · Crossref무료, 가입 없이 바로
KCI연구자 ID로 신청 → 담당자 승인
Web of Science · Scopus기관 구독 또는 출신 학교 도서관 계정

옵시디언에서 바로 검색하시려면 강의에서 설치한 플러그인을 쓰십시오.

  1. 옵시디언 설정(톱니바퀴) → 커뮤니티 플러그인 → 제한 모드 해제
  2. Browse → CMDS 검색 → CMDS Achmage → Install → Enable
  3. 설정 → CMDS Achmage → OpenAI Plan Connect → 웹에서 로그인
  4. 옵시디언을 완전히 껐다 켜십시오 → 다시 Connect → Connected 확인
  5. 두 번째 Research 탭 → 맨 아래 PubMed 토글 ON
  6. 연구 노트를 열고 Ctrl + P → CMDS open → 채팅창
인증이 계속 돌면 — 알려진 버그입니다. 옵시디언을 완전히 종료했다 다시 켜고 Connect를 한 번 더 누르면 붙습니다. 수정 예정입니다.

검색이 일부 실패하면 — 무료키는 동시 쿼리 제한이 있습니다. 강의 때도 일부만 성공했습니다. 질의를 줄여서 다시 하십시오.

키 발급 절차는 인증키 발급 가이드에 정리돼 있습니다.

Step 12챙겨 갑니다

Take It

폴더 하나가 곧 작업 환경입니다

만든 폴더를 압축해서 메일로 보내 두십시오. 다른 컴퓨터에서 압축을 풀고 그 폴더를 열면 규칙·데이터·스킬·산출물이 그대로 살아납니다.

실습실 PC를 쓰셨다면 폴더를 지우고 휴지통까지 비우십시오. 글로벌로 만든 스킬이 있다면 사용자 폴더의 .claude/.agents → skills 에서 따로 지우셔야 합니다.

Homework수업에서 못 한 것 — 직접 해보시면 좋습니다

시간과 토큰에 밀려 넘어간 실습입니다. 키트만 있으면 혼자 하실 수 있고, 사실 이게 가장 규제과학다운 부분입니다.

Scoring

함정 5종 채점 — AI가 몇 개를 스스로 잡는가

실습 데이터에는 오류가 다섯 가지 심어져 있습니다. v2(컨텍스트만)와 v3(하네스)로 각각 돌려 몇 개를 스스로 보고하는지 세어 보십시오.

#함정놓치면
①단위 혼입 (농도 일부가 ppm 표기)농도 구간 결론이 뒤집힘
②표기 불일치 (매트릭스·전처리 대소문자·공백)그룹 수가 부풀려짐
③결측 (반응변수 공란 + 중복 행)조용히 빠지면 특정 조건 과대평가
④교락 — 분석자와 장비가 분리되지 않음"전처리 B가 우수"가 실은 장비 효과
⑤이상치 (note 컬럼에 원인 단서)근거 없이 삭제하면 안 됨

④가 핵심입니다. 여기서 잡아낸 교락이 그대로 논문의 Methods 교란 통제와 Limitations가 됩니다. 대체로 v2는 2~3개, v3는 4~5개를 잡습니다.

채점 프롬프트
이 데이터의 품질 문제를 전수 점검해서 표로 보고해줘.
분석자·장비·분석일이 결과와 교락되어 있는지 반드시 확인하고,
교락이 있으면 그 사실을 먼저 보고해줘.
발견한 문제는 임의로 삭제하지 말고 처리 방침을 근거와 함께 제시해줘.

That Day그날 막혔던 것들

숨기지 않고 적습니다. 도구는 실패합니다. 중요한 것은 실패가 화면에 보이느냐입니다.

무엇이어떻게 했나
Claude 무료 계정이 폴더를 못 엶벤더 정책이 그 사이 바뀐 것. 전원 ChatGPT/Codex로 이동
2교시 중반 토큰 한도 도달시연 중심으로 전환. 그래서 이 가이드를 올립니다
플러그인 인증이 계속 로딩옵시디언 완전 종료 후 재시작 → 해결. 수정 예정
PubMed 일부 검색 실패무료키 동시 쿼리 제한. 질의를 줄이면 됩니다
Mermaid 지시를 어기고 이미지 생성다시 명령해 받고, 잘못 나온 이미지도 예시로 활용

One Line이 네 시간을 한 문장으로

오늘 하나만 가져가신다면 — 마크다운.

AI가 답변에 ##과 **를 넣는 이유는 그것이 AI가 쓰는 문법이기 때문입니다. 미국 사람과 대화하려면 영어를 배우듯, AI와 일하려면 AI가 쓰는 말을 알아야 합니다.

그리고 그 위에 규칙을 얹으면 하네스가 됩니다. 프롬프트를 외울 필요가 없습니다. 본인 업무 폴더에 규칙 파일 한 장을 쓰는 것, 그것이 오늘 이후 하실 일의 전부입니다.

Upcoming다가오는 행사

요즘 제가 진행하는 세미나와 컨퍼런스입니다. 궁금하시면 오세요.

CMDS Bootcamp 1기 · 온·오프라인 · 구요한 단독 강의
CMDS Bootcamp 1기
기록에서 지식으로, 지식에서 실행으로. 입문자와 고도화 두 갈래로, 각자의 필요에 맞게 필요한 과정만 단독 수강하실 수 있습니다.
① Obsidian 101 기록하고 연결하기 · ② PKM for AI Agent 지식 설계부터 Claude Code까지 · ③ LLM Wiki 내 자료로 만드는 AI 지식베이스 · ④ AI Agent Workflow 내 지식으로 반복 업무 설계하기
자세히 알아보기 →
구요한 · 커맨드스페이스 대표 · johnfkoo951@gmail.com · bio.cmdspace.work
질문은 언제나 환영입니다. 제가 아는 것은 알려드리고, 모르는 것은 공부해서 알려드립니다.