01 / 시작 전 준비
Claude 앱으로 내 연구실을 만듭니다.
Basic은 앱에서 연구 폴더를 열고, 준비된 요청문을 복사해 AI 연구원에게 일을 맡기는 과정입니다.
01첫걸음은 작게.
연구 한 건을 함께할 팀부터 준비합니다.
이렇게 진행합니다
- Claude 앱과 Python을 준비합니다.
- 연구팀 설치 파일을 내려받고, 작업 폴더와 대시보드를 구성합니다.
- 예시 프로젝트로 실습한 뒤 본인의 연구를 시작합니다.
Windows 또는 Mac 컴퓨터와 Claude Code를 사용할 수 있는 계정을 준비하세요. 다음 단계에서 자세히 안내합니다.
02 / 사용할 AI
Claude로 연구실을 준비합니다.
이 안내는 Claude를 기준으로 진행합니다. 같은 화면과 순서를 따라 연구실을 준비해 보세요.
Claude App의 Code에서 작업합니다.
내 컴퓨터의 연구 폴더를 열고, Claude에 분석·집필 등의 작업을 요청합니다. 다음 단계에서 앱 설치와 계정 준비를 안내합니다.
Claude Code를 사용할 수 있는 계정과 이용 조건은 공식 안내에서 확인하세요.
04 / Python 준비
영상 보며 Python 설치하기
사용하는 컴퓨터를 선택하고 그대로 따라 해보세요. 설치 후에는 Claude 앱에서 실제로 실행되는지 확인합니다.
1. Windows에 설치하기
약 2분 11초 · 설치 대기 부분은 6배속입니다.
Python 공식 다운로드 열기 ↗- 공식 Python Install Manager를 내려받아 설치합니다.
- 새 PowerShell을 열고
python --version을 입력합니다. Python 본체 설치가 이어지면 완료될 때까지 기다립니다. python -c "print('PYTHON_OK')"를 입력하여 PYTHON_OK가 나오는지 확인합니다.python -m pip --version도 입력해 추가 분석 도구를 설치할 기능을 확인합니다.
1. Mac에 설치하기
약 1분 43초 · Spotlight 단축키는 Command(⌘) + Space입니다.
Python 공식 다운로드 열기 ↗- 정식 Python 3의 macOS installer(.pkg)를 내려받아 설치합니다.
- Command(⌘) + Space로 Spotlight를 열고 터미널을 검색합니다.
python3 --version과 python3 -c "print('PYTHON_OK')"를 각각 입력해 버전과 PYTHON_OK 출력을 확인합니다.python3 -m pip --version도 확인합니다.
영상 외 추가 안내 · 인터넷 연결용 인증서python.org에서 받은 Mac용 Python은 공식 안내에 따라 인증서를 추가로 준비합니다. Python이 인터넷에서 자료를 받을 때 사이트를 신뢰할 수 있는지 확인하는 데 쓰입니다. 기본 계산 실행 확인과는 별도입니다.
Finder → 응용 프로그램 → Python 3.x 폴더에서 Install Certificates.command를 두 번 클릭합니다. 다른 방식으로 설치한 Python에는 이 파일이 없을 수 있습니다.
2. Claude 앱에서도 확인하기
Claude 앱을 완전히 종료했다가 다시 열고 Code 화면에서 확인을 요청합니다.
연구팀 폴더가 아직 없다면 다음 단계에서 준비한 뒤 이 확인을 진행하세요. 영상은 research-team 폴더가 이미 선택된 예시입니다.
약 53초 · 이미 설치된 분석 도구는 사용자마다 다를 수 있습니다. 영상 속 Claude는 Python 3.12.2를 사용했다고 보고합니다.
역할 → 목표 → 참고 자료 → 수행할 일 → 보고 형식 → 완료 기준
분석 도구는 연구에 맞춰 준비합니다.
Python만 설치했다고 모든 분석 도구가 준비되는 것은 아닙니다. 이 페이지도 설치 상태를 자동으로 확인하지 않습니다.
설치가 안 되나요? 자세한 설명과 문제 해결 보기 →
05 / 연구팀 폴더
연구팀을 하나의 작업공간으로 준비합니다.
그림으로 이해하기이 연구실을 컴퓨터에서는
하나의 폴더로 준비합니다.문헌·설계·자료관리·통계·집필·검토·인용 검증·기록의 8가지 역할이 필요한 단계에서 참여합니다.
연구원에게 맡긴 일역할 지침
책상 위의 업무 순서작업 절차
책장에 쌓이는 보고서연구 결과와 기록
연구원의 역할과 일하는 방법, 연구 결과와 기록을 한 폴더에 모읍니다. 앱이 이 폴더를 읽으면 대화를 새로 열어도 지침과 지난 기록을 바탕으로 연구를 이어갈 수 있습니다.
1 설치 파일 다운로드 · 압축 해제2 앱에서 작업 폴더 설정
STEP 1
설치 파일 다운로드 · 압축 해제
AI 연구원들이 어떤 역할로, 어떤 자료를 참고하며 일할지 미리 구성해 두었습니다. 이 ZIP 안에 연구팀의 구성과 작업공간의 틀이 함께 들어 있습니다.
연구팀 설치 파일 내려받기 (.zip)research-team-0.5-preview.zip · 현재 미리보기 버전
영상으로 보는 다운로드와 압축 해제
설명 애니메이션 · 무음 · Windows와 Mac의 압축 해제 방법, 생성된 폴더의 구조와 사용법을 안내합니다.
본인이 사용하기 좋은 폴더에서 압축을 풀어주세요. 그 안에 생긴 research-team 폴더를 연구팀의 작업공간으로 사용합니다. 앞으로 연구 자료와 결과, 진행 기록을 이곳에 모으게 됩니다.
여기서 ‘설치’는 ZIP을 풀어 연구팀 폴더를 준비하는 과정입니다. Claude 앱과 Python은 앞 단계에서 별도로 준비합니다.
폴더가 한 겹 더 생겼다면 README.md와 START_HERE.md, team 폴더가 함께 있는 곳을 찾으세요.
압축을 풀면 이런 구조가 생깁니다
주요 구성입니다. 처음부터 파일을 하나씩 수정할 필요는 없습니다.
research-team /내 연구팀의 작업공간
- README.md · START_HERE.md
- 연구팀 소개와 시작 안내
- team /
- AI 연구원들의 역할과 함께 일하는 방식
- library /
- 문헌검색·연구설계·분석·집필 등에 활용할 연구 스킬과 참고 자료
- sample /
- 첫 프로젝트 준비에 사용할 연구계획서와 예시 데이터
- projects /
- 연구별 계획서·자료·결과·진행 기록을 모을 곳. 08 / 프로젝트 준비에서 예시 프로젝트를 만듭니다.
- guides / · tools /
- 사용 안내와 연구팀 설정·점검을 돕는 도구
- .claude / · .codex / · .agents /
CLAUDE.md · AGENTS.md - Claude·Codex가 연구팀 지침을 읽도록 연결하는 설정. 점으로 시작하는 폴더는 화면에 보이지 않을 수 있습니다.
- SOURCES.md · VERSION
- 참고한 자료의 출처와 설치 파일의 버전
이 폴더 전체가 하나의 연구팀입니다.
안의 파일을 따로 꺼내 쓰기보다 research-team 폴더를 통째로 유지하세요. 앱에서 이 폴더를 열면 AI가 지침과 지난 기록을 읽으며 작업합니다.
STEP 2
Claude Code에서 작업 폴더 설정
Claude 앱의 Code 화면에서 research-team 폴더를 선택하는 실제 예시입니다.
선택할 곳을 확대하고 한글 설명을 넣었습니다. 소리는 없습니다. 위 설치 파일을 내려받아 원하는 위치에 압축을 푼 뒤 따라 하세요. 폴더를 보관한 위치는 사용자마다 다를 수 있습니다.
앱에서 선택할 작업공간research-team /README.md · START_HERE.md · team / 이 함께 있는 폴더
Claude Code 앱에서 압축을 푼 research-team 폴더 전체를 작업 폴더로 선택합니다. 영상은 Claude 앱의 Code 화면 예시입니다.
앞으로 연구 자료와 결과, 진행 기록을 이 폴더에 모읍니다. 다음에 연구를 이어갈 때도 같은 폴더를 여세요.
ZIP을 대화창에 첨부하거나 문서 하나만 여는 것이 아니라, 압축을 푼 폴더를 선택합니다. 사용 중인 작업공간을 새 설치 파일로 덮어쓰지 마세요.
구성 출처: MedSci · Harness · clinical-research-harness · CoVe. 다음 06 단계에서 연구팀 구성을 자세히 알아봅니다.
이 웹페이지는 컴퓨터의 폴더나 앱 준비 상태를 자동으로 확인하지 않습니다.
06 / 연구팀 구성 이해하기
내 연구실은 이렇게 일합니다.
폴더에는 연구원들의 역할, 일하는 방법과 지난 기록이 들어 있습니다. AI Agent는 맡은 역할에 따라 일하는 AI 연구원입니다. 사용자는 팀장과 대화하고, 팀장은 요청한 작업에 필요한 연구원을 활용합니다.
어느 폴더에서 대화하느냐에 따라 맡는 일이 달라집니다
research-team 폴더에서 연 대화 = 총괄팀장
연구실을 준비하고, 프로젝트별 기록을 읽어 전체 현황을 정리합니다.
projects/project01 폴더에서 연 대화 = 해당 연구팀의 팀장
그 연구의 계획서·자료·결과를 바탕으로 작업을 진행합니다. 다른 연구는 다른 프로젝트 폴더에서 대화합니다.
대화끼리 기억이 자동으로 공유되지는 않습니다. 각 팀이 진행 기록을 남기고, 총괄은 그 기록을 읽어 상태를 파악합니다.
누가 함께하나요?
역할은 8가지, 결정은 연구책임자가.
연구책임자 — 나 / 팀장 — 지금 대화하는 AI나는 연구 방향과 중요한 결정을 맡습니다. 팀장은 필요한 연구원에게 일을 나누고, 결과와 검토 내용을 모아 설명합니다. 창을 8개 열 필요는 없습니다.
01 / 근거문헌 연구원
검색식과 근거표를 만들고, 확인한 논문을 모읍니다.
02 / 계획연구설계 연구원
질문·변수·분석계획과 연구계획서 초안을 준비합니다.
03 / 자료자료관리 연구원
익명화 여부를 한 번 확인하고, 변수사전과 자료 품질을 살핍니다.
04 / 분석통계 연구원
계획에 맞는 분석 방법과 코드, 효과크기·95% CI를 다룹니다.
05 / 원고집필 연구원
실제 결과와 근거를 연결해 원고를 작성합니다.
06 / 품질검토 연구원
설계·수치·해석·보고지침의 문제를 별도로 살핍니다.
07 / 인용인용 검증 연구원
논문의 서지정보와 주장을 뒷받침하는지를 구분해 확인합니다.
08 / 이어가기기록 연구원
결정과 미해결 문제, 다음 할 일을 정리합니다.
역할별 AI 호출은 사용하는 앱에서 확인해야 합니다. 호출이 불가능하면 초안과 자기검토는 가능하지만, 별도 검토를 완료했다고 표시하지 않습니다.
어떤 일을 맡길 수 있나요?
원하는 작업부터 시작하고, 필요하면 돌아갑니다.
- 질문·문헌무엇을 알고 싶은가?
어떤 근거가 있는가? - 설계·계획변수와 분석계획
연구책임자 확인 - 자료 준비익명화 여부 확인
자료 정리·분석 준비 - 분석필요한 분석 선택
실행 근거와 결과 - 집필·검토원고·수치·보고지침
CoVe 인용 검증 - 기록·재개결정과 다음 할 일
새 대화에서 복원
위 항목은 필수 순서가 아닙니다. 연구 유형과 현재 가진 자료에 따라 필요한 작업만 선택합니다. 그림의 ‘Clinical Trial’은 예시 이름이며 관찰연구·체계적 문헌고찰도 각 유형에 맞게 구성합니다.
공개 프로젝트를 바탕으로 구성했습니다: Harness · 황민호 (역할 구성), MedSci Skills · 남유진 (연구 스킬), Clinical Research Harness (연구 기록 원칙), CoVe (인용 검증) · 전기현. 출처별 이용 조건은 배포 폴더에 포함되어 있습니다.
연구팀이 지켜야 할 약속
- 없는 결과와 참고문헌을 만들어내지 않습니다.
- 연구는 원하는 지점에서 시작하고, 변경 이유와 실제 수행한 내용을 기록합니다.
- 작성과 별도 검토를 구분하고, 확인하지 못한 것은 그대로 표시합니다.
- “환자 개인정보가 익명화되어 있나요?” 한 번 확인한 뒤 자료 작업을 진행합니다.
같은 자료에는 반복 질문하거나 익명화 증빙을 요구하지 않습니다. 이전 단계 완료나 계획 잠금을 시작 조건으로 요구하지 않습니다.
다음 날에도 같은 연구를 이어가려면
작업을 마칠 때 “오늘 한 일과 결정, 다음 할 일을 기록해줘”라고 요청하세요. 다음에는 같은 프로젝트 폴더를 열고 “지난 기록을 읽고 이어가자”라고 말하면 됩니다.
여러 연구를 한다고 반드시 Advanced로 바꿀 필요는 없습니다. Basic과 Advanced는 사용하는 방법의 차이입니다.
07 / 대시보드 구성하기
내 연구실을 눈으로 확인합니다.
앞에서 준비한 연구팀 폴더를 바탕으로, 연구팀과 연구원·연구 파이프라인을 한눈에 보는 대시보드를 만듭니다.
이런 모습의 내 연구실이 만들어집니다. 사진은 예시 프로젝트를 준비한 뒤의 화면입니다. 처음 생성할 때는 등록된 연구가 없습니다. 사진을 누르면 크게 볼 수 있습니다.1. 앱에 대시보드 생성을 요청하세요
research-team 폴더를 선택해 둔 앱의 같은 대화창에 아래 문장을 보내세요. 연구원 역할과 현재 연구 상태를 한눈에 보는 화면이 만들어집니다. 처음에는 등록된 연구가 없는 상태로 시작합니다.
복사해서 앱에 붙여 넣기역할 → 목표 → 참고 자료 → 수행할 일 → 보고 형식 → 완료 기준
예시 프로젝트 준비 후 대시보드 미리 보기 ↗
내 컴퓨터의 dashboard.html로 만들어집니다. 화면을 열지 못하면 앱이 알려준 파일을 두 번 클릭하세요. 실제 활동을 감시하는 화면이 아니라 마지막 진행 기록을 보여줍니다.
2. 내 연구실에 맞게 화면을 설정하세요
대시보드 오른쪽 위의 작은 화면 설정 버튼을 누르세요. 연구실 이름, 내 사진, Light/Dark, 글자 크기와 화면 간격을 바꿀 수 있습니다.
3. 준비된 연구실을 확인하세요
처음에는 연구팀이 미배정이고 파이프라인이 비어 있는 것이 정상입니다. 다음 단계에서 프로젝트를 준비하면 해당 연구가 대시보드에 나타납니다.
이 단계에서는 대시보드만 만듭니다. 실제 연구 작업은 프로젝트를 준비한 뒤 시작합니다.
08 / 프로젝트 준비
내 컴퓨터에 연구 한 건의 작업공간을 만듭니다.
이제 웹페이지가 아니라 본인 컴퓨터의 폴더에서 작업합니다. Windows는 파일 탐색기, Mac은 Finder를 열고 압축을 풀어 둔 research-team 폴더로 이동하세요.
영상 따라 project01 준비하기
실제 Mac 녹화 · 약 49초 · 무음 · 선택 부분 확대와 한글 자막. Windows에서도 같은 폴더 구조로 준비합니다.
- 1
projects 안에 project01 폴더 만들기
research-team → projects를 열고 새 폴더를 만듭니다. 이번 예시 이름은 project01입니다.
- 2
sample 폴더의 파일 두 개를 project01에 넣기
sample 폴더에 있는 GLP1_AMI_RCT_protocol.docx(계획서)와 GLP1_AMI_RCT_data.xlsx(자료)를 복사해서 project01 안에 붙여 넣으세요.
- 3
Claude 앱에 이 폴더의 팀 준비를 요청하기
research-team 폴더를 열어 둔 Claude 앱의 대화창에 아래 문장을 보내세요. 기존 폴더와 파일은 그대로 사용하고, 공통 연구팀에 연결하는 지침과 기록을 준비합니다. 준비 완료 보고를 받을 때까지 이 대화에서 진행한 뒤, 다음 실습 단계에서 project01의 새 대화를 엽니다.
복사해서 앱에 붙여 넣기역할 → 목표 → 참고 자료 → 수행할 일 → 보고 형식 → 완료 기준
연구 한 건의 폴더가 곧 그 팀의 작업공간입니다.본인 연구도 같은 방법입니다. projects 아래에 새 폴더를 만들고 그 연구의 계획서·자료·참고 문헌 등 관련 파일을 모으세요. 연구가 늘어나면 project02, project03처럼 별도 폴더로 나눕니다. 이름은 본인이 알아보기 쉽게 정해도 됩니다.
폴더에 파일을 넣는 순간 AI가 저절로 연구를 시작하는 것은 아닙니다. 앱에서 그 폴더를 열고 작업을 요청하면, 그 대화창이 해당 연구팀을 맡게 됩니다.
선택한 준비 환경
- 사용 경로
- 연구실
- 프로젝트
프로젝트 준비가 끝나면
앱이 알려준 projects/project01 폴더와 갱신된 대시보드를 확인하세요. 여기까지는 작업공간을 준비하는 과정입니다. 다음 09 / 실습에서 project01 폴더로 새 대화를 열어 연구를 시작합니다.
09 / 실습
project01에서 논문 작성을 시작합니다.
준비한 연구계획서와 데이터를 바탕으로, AI 연구팀과 논문을 작성해 봅니다. 먼저 작업 계획을 보고받고, 승인한 뒤 실제 연구를 진행합니다.
영상으로 보는 프로젝트 실습
실제 Claude 앱 녹화 · 약 1분 24초 · 주요 부분 확대와 한글 자막 · 대기 구간은 배속 편집했습니다. 실습용 합성·모의 자료를 사용한 예시입니다.
- 1
Claude 앱에서 새 대화 열기
Claude 앱의 Code에서 새 대화를 만들고, 작업공간으로 research-team / projects / project01 폴더를 선택하세요.
이번에 선택할 작업공간research-team / projects / project01 /GLP1_AMI_RCT_protocol.docx(계획서) · GLP1_AMI_RCT_data.xlsx(자료)가 있는 폴더
연구실 전체를 준비하던 대화와 구분해, 이 새 대화에서 project01 연구를 진행합니다. 이 대화창이 해당 연구팀의 팀장 역할을 맡습니다.
- 2
계획서와 데이터를 확인하고 논문 작성 계획 요청하기
08 단계의 research-team 대화에서 프로젝트 준비가 완료되었다는 보고를 받은 뒤 시작하세요. 사용자가 START_HERE.md를 직접 만들거나 옮길 필요는 없습니다. 아래 요청을 project01의 새 대화창에 보내고, 익명화 여부를 물으면 본인의 자료에 맞게 답하세요.
복사해서 앱에 붙여 넣기역할 → 목표 → 참고 자료 → 수행할 일 → 보고 형식 → 완료 기준
- 3
계획을 검토하고 승인하기
연구 질문과 분석 방법, 작성할 표·그림이 적절한지 확인하세요. 수정할 내용이 있으면 먼저 알려주고, 준비되면 “이 계획으로 진행해줘”라고 답하세요.
- 4
분석 결과와 논문 초안 확인하기
앱이 알려준 위치에서 표·그림과 논문 초안을 열어보세요. 결과 해석과 인용 근거를 검토하며 필요한 수정을 요청합니다. 초안은 연구자가 검토하고 다듬어 완성합니다.
다음에 이어서 작업할 때도 project01 폴더를 선택하세요. 기록을 바탕으로 연구를 이어갈 수 있습니다.
10 / 본인의 프로젝트 만들기
이제 본인의 연구를 시작하세요.
질문 하나만 있어도, 이미 계획서와 데이터가 있어도 시작할 수 있습니다. 아래 다섯 가지 중 지금 본인의 상황에 맞는 항목을 골라 요청하세요. 1번부터 모두 거칠 필요는 없습니다.
먼저, 본인 연구의 폴더를 준비하세요
내 컴퓨터의 research-team / projects 아래에 project02 또는 알아보기 쉬운 연구 이름으로 새 폴더를 만드세요. 가지고 있는 계획서·데이터·변수 설명·참고 문헌을 그 안에 모읍니다. 질문만 있다면 빈 폴더로 시작해도 됩니다.
먼저 research-team 폴더를 열어 둔 Claude 앱의 대화에서 아래 프로젝트 준비 요청을 보내세요. 기존 자료를 보존하면서 공통 연구팀 연결과 프로젝트 지침·기록을 준비합니다. 준비 완료 보고를 받은 뒤 Claude 앱의 Code에서 새 대화를 열고 해당 프로젝트 폴더를 작업공간으로 선택하세요. 그 새 대화에서 아래 다섯 가지 연구 요청 중 필요한 것을 골라 보냅니다.
역할 → 목표 → 참고 자료 → 수행할 일 → 보고 형식 → 완료 기준
아래 심장재활 예시는 사용 방법을 보여주기 위한 것입니다. 질환·대상·중재 또는 노출·결과를 본인 연구에 맞게 바꾸세요.
1. 연구질문을 던지세요
막연한 궁금증도 출발점이 됩니다. 임상에서 관찰한 현상과 알고 싶은 점을 말하면, 답을 구할 수 있는 연구질문으로 구체화합니다.
본인 연구에 맞게 바꿔 앱에 붙여 넣기역할 → 목표 → 참고 자료 → 수행할 일 → 보고 형식 → 완료 기준
2. 연구가설을 알려주세요
이미 예상하는 관계가 있다면 그 가설을 제시하세요. 검정 가능한 형태로 다듬고, 측정할 변수와 고려할 교란요인을 함께 정리할 수 있습니다.
본인 연구에 맞게 바꿔 앱에 붙여 넣기역할 → 목표 → 참고 자료 → 수행할 일 → 보고 형식 → 완료 기준
3. 연구 프로토콜을 함께 만드세요
질문과 가설이 정리되면 연구계획서로 발전시킵니다. 대상자 선정, 변수 정의, 표본수 검토와 분석계획을 포함하도록 요청하세요.
본인 연구에 맞게 바꿔 앱에 붙여 넣기역할 → 목표 → 참고 자료 → 수행할 일 → 보고 형식 → 완료 기준
4. 데이터를 주시면 분석을 시작할 수 있습니다
프로젝트 폴더에 연구데이터와 변수 설명을 넣으세요. 먼저 자료 구조와 결측치 등을 확인하고, 연구질문에 맞는 분석계획을 검토한 뒤 분석합니다.
본인 연구에 맞게 바꿔 앱에 붙여 넣기역할 → 목표 → 참고 자료 → 수행할 일 → 보고 형식 → 완료 기준
5. 데이터와 연구계획서가 있다면 논문을 작성해 보세요
계획서와 데이터가 준비되어 있다면 09 실습처럼 논문 작성까지 이어갈 수 있습니다. 기존 분석 결과가 있으면 함께 넣어, 확인한 결과부터 활용하도록 요청하세요.
본인 연구에 맞게 바꿔 앱에 붙여 넣기역할 → 목표 → 참고 자료 → 수행할 일 → 보고 형식 → 완료 기준
한 번의 요청으로 끝내지 않아도 됩니다.AI가 보고한 계획과 결과를 검토하고, “이 변수도 고려해줘”, “이 해석의 근거를 확인해줘”, “이 부분을 다시 써줘”처럼 대화를 이어가세요. 중요한 결정과 결과를 프로젝트 기록에 남기게 하면 다음 대화에서도 이어갈 수 있습니다.