연구자를 위한 기초 클로드코드 가이드북
Claude Code & Cowork 완전 가이드 — 코딩 없이 시작하기
이 가이드북은 코딩 경험이 없는 연구자도 Claude Code를 활용해 논문 분석, 데이터 전처리, 문서 자동화 등 연구 생산성을 높일 수 있도록 설계된 워크숍 자료입니다. 설치부터 실전 활용까지, 단계별로 따라할 수 있습니다.
💡 1. 바이브코딩(Vibe Coding)이란?
1.1 바이브코딩 정의
2025년 Andrej Karpathy(전 Tesla AI 디렉터)가 만든 용어로, 코드를 직접 작성하지 않고 자연어로 AI에게 의도를 전달하여 소프트웨어를 만드는 방식입니다. 이를 실천하는 사람을 바이브코더라고 부릅니다. 비개발자가 코드를 쓰지 않고도 반복 업무를 자동화할 수 있다는 점이 핵심입니다.
1.2 기존 방식 vs 바이브코딩
| 기존 방식 | 바이브코딩 |
|---|---|
| 1. 프로그래밍 언어 학습 (수개월) | 1. "이런 도구 만들어줘" (자연어) |
| 2. 개발 환경 설정 | 2. AI가 코드 작성 & 실행 |
| 3. 코드 작성 및 디버깅 | 3. "이 부분 수정해줘" (피드백) |
| 4. 반복적 수정 → 완성 | 4. 반복 개선 → 완성 |
1.3 왜 연구자에게 중요한가?
정책 분석, 문헌 조사, 데이터 정리 같은 반복적 연구 작업을 자동화할 수 있습니다. "최근 5년간 한국 AI 정책 동향을 정리해서 Word 보고서로 만들어줘"라고 말하면, Claude가 웹 검색 → 데이터 수집 → 분석 → 보고서 작성까지 수행합니다.
🌐 2. Anthropic 제품 생태계
| 제품 | 설명 | 기본 모델 | 플랫폼 |
|---|---|---|---|
| Claude.ai | 웹/앱 채팅, 일회성 대화·Q&A | Sonnet 4.6 | Web, iOS, Android |
| Claude Code | 터미널 기반 개발·연구 자동화 에이전트 | Opus 4.6 (Max/Team/Enterprise) | macOS, Linux, Windows |
| Cowork ⭐ | 파일 기반 지식업무·연구 자동화 (GUI) | Opus 4.6 | macOS, Windows x64 |
| Dispatch | 모바일→데스크톱 지시 표면 (외출 중 지시, 데스크톱 실행) | — | iOS, Android |
| Claude in Chrome | 브라우저 보조, 웹 작업 자동화 | — | Chrome 확장 |
| Claude in Excel | 스프레드시트 에이전트, 데이터 분석 | — | Microsoft Excel |
| Claude in PowerPoint | 슬라이드 에이전트, 프레젠테이션 자동화 | — | Microsoft PowerPoint |
비개발자 추천 경로: Cowork로 시작 → 한계를 느끼면 Claude Code로 확장
신규 기능: Cowork Computer Use (2026.3.23 research preview)
- Cowork에서 마우스·키보드를 직접 제어 가능
- MCP 커넥터가 없는 앱도 화면을 보고 자동화 가능
- 전용 샌드박스 + 사람 감독 전제 권장
- 주의: 민감 데이터(개인정보, 연구 원데이터)가 있는 환경에서는 사용 자제
Dispatch — 모바일에서 데스크톱 지시
스마트폰에서 짧은 지시만 입력하면 집/연구실 Mac에서 Claude가 실행됩니다. Computer Use와 결합 시 진가 발휘 — 외출 중 지시를 넣으면 데스크톱이 자동 실행. "완전한 모바일 작업면"이 아니라 "지휘석" 역할.
Claude Code vs Cowork 비교
| 비교 항목 | Claude Code | Cowork |
|---|---|---|
| 인터페이스 | 터미널 (검은 화면) | 데스크톱 앱 GUI (채팅) |
| 설치 | curl/npm 설치 필요 | Claude Desktop 앱만 |
| 파일 접근 | 프로젝트 폴더 전체 | 지정한 폴더만 (격리 VM) |
| 안전성 | 개발자 수준 판단 필요 | 격리된 가상머신 실행 |
| 플랫폼 | macOS, Linux, Windows | macOS, Windows x64 |
| 대상 | 개발자, 터미널 익숙한 사용자 | 비개발자, 지식 노동자 |
🧩 3. 핵심 개념과 해부도
3.1 에이전트(Agent) 정의와 루프
단순히 질문에 답하는 챗봇이 아니라, 스스로 계획을 세우고, 파일을 읽고 쓰고, 명령을 실행하고, 웹을 검색하는 자율적 AI입니다. Agent는 영어로 '대리인'을 뜻하며, 사람의 역할을 대신하는 AI라고 생각하면 됩니다.
Claude 웹과 에이전트의 가장 큰 차이:
• Claude 웹: 사람이 매번 창을 열고 지시해야 돌아감
• 에이전트: 내 도구들을 하나로 연결하고, 내 기준이 코드에 내장되어, 스케줄로 알아서 돌아감
연구 트렌드 모니터링 예시
| Claude 웹 방식 | 에이전트 방식 |
|---|---|
| 매주 직접 arXiv 검색 | 매주 월요일 자동 수집 → 기존 DB와 비교 → 새 논문만 필터 → "이번 주 새 논문 7편" 알림 |
| 지난 DB와 직접 비교 | |
| 새 논문 수동 정리 |
AI 에이전트 진화 3단계
23~24년: AI 그 자체 등장
↓
~25년: (특화) 에이전트 등장
AI가 도구를 사용해 자율적으로 작업 수행
↓
26년~: 에이전트 오케스트레이션
여러 전문 에이전트 협업 구조 만들기
에이전트 루프: AI가 일하는 방식
여러분의 지시
↓
1. 상황 파악 — 파일 읽기, 현재 상태 파악
↓
2. 행동 — 파일 수정, 웹 검색, 명령어 실행
↓
3. 결과 확인 — 오류 확인, 빠진 내용 보완
↓
작업 완료 (또는 1로 돌아가서 반복)
일반 Chat vs 에이전트 비교
| 일반 Chat | 에이전트 (Cowork/Code) |
|---|---|
| 나: "경비 보고서 만들어줘" | 나: "이 영수증들로 경비 보고서 만들어줘" |
| AI: "만드시려면 먼저 Excel을 열고..." | AI: 영수증 읽기→추출→분류→Excel 생성 |
| → 방법만 알려줌 | → 실제 파일 생성! ✓ |
3.2 🔬 Claude Code 구조 해부도 — 글로벌 아이덴티티 × 프로젝트 두뇌 NEW
이 다이어그램은 "왜 Claude가 프로젝트마다 다르게 행동하는가?"를 한 장으로 설명합니다. 내 컴퓨터 안에 하나의 글로벌 아이덴티티와 여러 개의 분리된 프로젝트 두뇌가 공존하는 구조입니다.
내 컴퓨터
│
├── ~/.claude/ [글로벌 아이덴티티 — 어디서든 로드]
│ ├── CLAUDE.md 내가 누구인지 — 세션 메모리, 스타일, 톤, 규칙
│ ├── settings.json Claude가 내 컴퓨터에서 건드릴 수 있는 것/없는 것
│ └── .claude.json MCP 연결 — Gmail · Notion · Drive · Calendar …
│
├── ~/projects/project-A/ [프로젝트 두뇌 A — 이 폴더 안에서만 로드]
│ ├── CLAUDE.md 프로젝트 규칙, 파일 경로, 작동 방식
│ └── .claude/
│ ├── commands/ 내가 타이핑하는 단축키 (예: /review, /draft)
│ ├── rules/ Claude가 조용히 따르는 상시 적용 표준
│ ├── agents/ Claude가 전문가 역할로 변신 (서브에이전트)
│ ├── skills/ 요청 시 Claude가 실행하는 단계별 SOP
│ └── hooks/ 특정 순간에 자동 실행 (PreToolUse 등)
│
└── ~/projects/project-B/ [프로젝트 두뇌 B — 분리된 두뇌]
├── CLAUDE.md 다른 주제 · 다른 규칙 · 다른 스타일
└── .claude/
├── commands/
├── rules/
├── agents/
├── skills/
└── hooks/
참고: 경로 표기의 ~/는 사용자 홈 디렉토리를 의미합니다. macOS/Linux는 ~/projects/..., Windows는 C:\Users\내이름\projects\... 형태로 읽으면 됩니다. 클라우드 동기화 폴더(iCloud Drive, Google Drive, OneDrive, Dropbox 등)는 파일 잠금·충돌 위험 때문에 권장하지 않습니다. 로컬 폴더에 두고 Git 등으로 버전 관리하는 것이 안전합니다.
세 가지 설계 원칙:
- 글로벌 = 내가 누구인지. 연구자 프로파일, 언어 선호, 톤 같은 "어디서든 일관되게 유지될 것"은
~/.claude/에만 둔다. - 프로젝트 = 내가 일하는 방식. 각 프로젝트의 규칙·단축키·에이전트는 해당 폴더 안에만 존재합니다.
- 분리된 프로젝트는 서로 섞이지 않는다.
project-A의.claude/는project-B에 영향을 주지 않는다.
연구자에게 주는 함의: 연구자 한 명은 보통 여러 프로젝트를 병행합니다. 예컨대 박사논문 폴더(학술 톤·APA 7th), 정부 수탁과제 폴더(정책 보고서 톤·개조식 양식), 강의자료 폴더(교육용 톤·쉬운 설명), 공동연구 폴더(협력자와 합의된 스타일)를 각각 독립된 프로젝트 두뇌로 운영하면, 같은 Claude가 폴더에 따라 완전히 다른 전문가로 변신합니다. 하나의 Claude가 논문 투고용 엄격한 문체와 발표용 친근한 설명을 혼동하는 일을 구조적으로 차단할 수 있습니다.
3.3 🧩 Agent Development Kit — 5계층 아키텍처 NEW
Brij Kishore Pandey의 화이트보드를 재해석한 것으로, "CLAUDE.md + Skills + Hooks + Subagents + Plugins = Agent Development Kit" 공식을 구조화합니다. 본 가이드북 2~4장은 이 5계층을 각각 상세히 설명합니다.
┌──────────────────────────────────────────────────────────────┐
│ Layer 1: CLAUDE.md — The Memory Layer │
│ 항상 로드, 항상 활성. 에이전트의 "헌법(constitution)". │
│ - architecture rules, naming conventions │
│ - test expectations, repo map │
│ - Global: ~/.claude/CLAUDE.md / Project: .claude/CLAUDE.md │
├──────────────────────────────────────────────────────────────┤
│ Layer 2: SKILLS — The Knowledge Layer │
│ On-demand, not always-on. 모듈식 컨텍스트 청크. │
│ - description matching → auto-invoked → task-specific │
│ - SKILL.md + reference docs + scripts + templates │
│ - Key: 서브에이전트 안에서 고립 실행 가능 │
├──────────────────────────────────────────────────────────────┤
│ Layer 3: HOOKS — The Guardrail Layer │
│ 결정론적(Not AI). 에이전트 버전의 Git hooks. │
│ - PreToolUse / PostToolUse / SessionStart / Stop / │
│ SubagentStop │
│ - 예: Write 시 auto-lint → rm -rf 차단 → Stop 시 Slack 알림│
├──────────────────────────────────────────────────────────────┤
│ Layer 4: SUBAGENTS — The Delegation Layer │
│ 메인 컨텍스트를 깨끗하게 유지. 무한 재귀 방지 │
│ (서브에이전트는 서브에이전트를 못 만듦). │
│ - code-reviewer / test-runner / explorer │
│ - 각자 own context window + custom model + tools + perms │
│ - delegate only → results only 패턴 │
├──────────────────────────────────────────────────────────────┤
│ Layer 5: PLUGINS — The Distribution Layer │
│ skills/ + agents/ + hooks/ + commands/ 를 한 묶음으로. │
│ - 마켓플레이스를 통해 팀 전체에 설치 │
│ - "에이전트 능력의 npm 패키지" │
└──────────────────────────────────────────────────────────────┘
↕ ↕
┌────────────┐ ┌────────────┐
│ MCP Servers│ │ Agent Teams│
│ • external │ │ • 병렬실행 │
│ tools │ │ • 메시지 │
│ • GitHub │ │ 패싱 │
│ • DBs │ │ • 오케스트 │
│ • APIs │ │ 레이션 │
│ • custom │ │ • 권한공유 │
└────────────┘ └────────────┘
핵심 공식:
CLAUDE.md sets rules
→ Skills provide expertise
→ Hooks enforce quality
→ Subagents delegate work
→ Plugins distribute to team
3.4 🧠 CLAUDE.md (메모리 파일)
Claude가 매 세션 시작 시 자동으로 읽는 마크다운 파일. "우리 연구실 매뉴얼"과 같은 역할입니다.
3.5 🤖 Skill (에이전트 스킬)
특정 작업에 대한 재사용 가능한 플레이북. 요리사에게 레시피 카드를 건네주는 것과 같습니다.
- 1단계 - 탐색: Claude가 Skill 목록(이름+설명) 확인
- 2단계 - 로드: 관련 작업 인식 시 SKILL.md 전문 읽기
- 3단계 - 실행: 지침에 따라 작업 수행
3.6 🔌 MCP (Model Context Protocol)
AI를 외부 도구/서비스(Google Drive, Notion, Slack 등)와 연결하는 표준 프로토콜. 월 1억 건+ 다운로드, 3,000+ 서버 등록.
3.7 🤖 Subagent (하위 에이전트)
복잡한 작업을 여러 전문 AI에게 분업시키는 구조. 병렬 실행으로 속도 대폭 향상.
3.8 🤖 Agent Teams (N:N 협업)
Subagent가 메인→서브의 1:1 위임이라면, Agent Teams는 에이전트들이 서로 결과를 검토·합의하는 N:N 협업입니다.
| 구분 | Subagent | Agent Teams |
|---|---|---|
| 관계 | 1:1 (팀장→팀원) | N:N (팀원들이 서로 소통) |
| 소통 | 메인 세션이 일방적 위임 | 에이전트들이 결과를 서로 검토·합의 |
| 활용 | 독립적 탐색/요약 작업 | 서로 다른 관점에서 상호 검증이 필요한 작업 |
Research Gap 찾기 — Agent Teams 예시
고검색 에이전트: "서비스업 논문도 있을 것 같은데, 내가 놓쳤을 수 있어"
엄정리 에이전트: "진분석이 말한 B2C 편향, 정리표에도 반영할게"
진분석 에이전트: "유갭 말 듣고 보니 혼합연구 0편이랑 방법론 Gap이 연결되네"
유갭 에이전트: "다들 동의하면 심각도 ★★☆ → ★★★ 상향하자" → 합의 완료
3.9 🪝 Hook (자동 실행 규칙)
Claude가 특정 행동을 할 때 자동으로 실행되는 셸 명령. 비개발자도 Claude에게 만들어달라고 요청 가능.
🧠 4. CLAUDE.md 설계하기
4.1 왜 CLAUDE.md인가
Claude Code는 세션마다 기억을 잃습니다. 매번 "나는 정책 연구자이고 한국어로 답하고 APA 인용을 써"라고 말하는 대신, 프로젝트 루트에 CLAUDE.md를 두면 Claude가 세션 시작 시 자동으로 읽습니다.
- 규칙 — 무엇을 해야 하고 하지 말아야 하는지 (예: "모든 주장에 출처 명시")
- 구조 — 파일·폴더 레이아웃 (예:
/raw-data /analysis /reports) - 스타일 — 출력 톤·형식 (예: "Word 문서, APA 7판, 한국어")
공식 가이드라인은 200~500줄 이내로 유지할 것을 권장합니다. 더 긴 워크플로우 지시는 Skill로 빼서 토큰을 절약하세요.
4.2 연구자를 위한 템플릿
# 연구 프로젝트 컨텍스트
## 나는 누구인가
- 정책연구자
- 주요 관심 분야: [내 연구 분야 기입]
- 선호 언어: 한국어 (영문 출처는 원문 유지)
## 작업 규칙
- 모든 주장에는 반드시 출처(저자, 연도, 제목)를 명시할 것
- 학술 논문, 정부 보고서, 공신력 있는 기관 자료를 우선 참조
- 분석 프레임워크: 정책 목표 → 수단 → 효과 → 시사점
## 출력 형식
- 보고서: Word(.docx) 형식, 목차 포함, APA 스타일 참고문헌
- 데이터: Excel(.xlsx) 형식, 시트별 분류
## 프로젝트 구조
- /raw-data, /analysis, /reports, /references
4.3 바로 붙여넣기: CLAUDE.md 자동 생성
이 폴더는 [연구 주제]에 대한 연구 프로젝트야.
나는 [직업/전공] 연구자이고, 한국어로 결과물을 작성해.
아래 규칙을 반영한 CLAUDE.md 파일을 만들어줘:
- 모든 주장에 출처(저자, 연도, 제목) 반드시 명시
- 학술 논문과 정부 보고서를 우선 참조
- 보고서는 Word(.docx), 데이터는 Excel(.xlsx) 형식
- APA 7판 참고문헌 스타일
- 학술적이고 객관적인 톤 유지
- 폴더 구조도 함께 제안해줘
[연구 주제]를 자신의 연구 주제로, [직업/전공]을 자신의 전공으로 바꾸면 됩니다.
4.4 작성 핵심 원칙
"이 줄을 지우면 Claude가 실수할까?" — "예"인 것만 남기세요.
| ✓ 포함할 것 | ✗ 빼야 할 것 |
|---|---|
| Claude가 추측 불가한 프로젝트 규칙 | Claude가 이미 아는 상식 |
| 파일 구조와 네이밍 컨벤션 | 표준 언어 관행 |
| 출력물 형식과 품질 기준 | 자주 바뀌는 정보 |
🧬 4+. 내 연구 방식을 에이전트에 이식하기
CLAUDE.md 템플릿을 만드는 것과 "나만의 에이전트"를 만드는 것은 다릅니다. 진짜 개인화는 당신의 연구 DNA를 4가지 질문으로 먼저 정의하는 것에서 시작합니다.
Step 1 — 나의 연구 DNA 정의하기 (4가지 질문)
| # | 질문 | 예시 답변 |
|---|---|---|
| 1 | 나의 연구 방법론은? | 혼합연구(설문 + 심층면담), APA 7th 인용 |
| 2 | 주요 출력물 형식은? | 국문 정책보고서 25p, 발표자료 PPT, 투고용 논문 |
| 3 | 나의 품질 기준은? | 모든 수치 출처 필수, SCIE Q1 논문만 인용, 결론에 정책 제언 포함 |
| 4 | 절대 하면 안 되는 것은? | 미검증 통계 직접 인용, 저자명 추측, 영문 본문 혼용 |
Step 2 — CLAUDE.md 개인화 비교
| ✗ 평균 연구자 CLAUDE.md | ✓ 나만의 연구 DNA CLAUDE.md |
|---|---|
나는 연구자야. 논문 분석해줘. 한국어로 써줘. | # 연구자 프로파일 - 분야: 보건정책 / 노인 돌봄 서비스 - 소속: 한국보건사회연구원 - 방법론: 혼합연구 (설문+FGI) - 인용 스타일: APA 7th # 나의 품질 기준 - 모든 수치/통계에 출처 명시 필수 - SCIE 또는 KCI 등재 논문만 인용 - 결론은 반드시 정책 제언 포함 # 절대 금지 - 저자명·출판년도 추측 금지 - 미검증 통계 직접 인용 금지 - 영문 본문 혼용 금지 # 출력 규칙 - 보고서: 국문 Word, 25p 내외 - 참고문헌: APA 7th (본문+목록) - 데이터 표: Excel, 통계청 스타일 |
Step 3 — 에이전트의 3계층 기억 구조
에이전트가 "나의 연구 방식"을 기억하는 메커니즘은 3계층으로 구성됩니다.
| 계층 | 역할 | 지속성 | 해당 파일 |
|---|---|---|---|
| 🏛️ Layer 1 장기 기억 | 내가 누구인지, 프로젝트 규칙 | 영구 (매 세션 자동 로드) | CLAUDE.md |
| 📋 Layer 2 절차 기억 | 특정 작업의 실행 레시피 | 영구 (작업별 호출) | SKILL.md |
| 💬 Layer 3 단기 기억 | 현재 세션의 대화 맥락 | 세션 종료 시 소멸 | 대화 컨텍스트 |
Step 4 — 학습 루프: 에이전트를 점점 나에게 맞게
① 작업 실행
→ Claude가 내 기준에 맞지 않는 결과 생성
② 피드백
→ "이 부분은 항상 APA 스타일로 써줘"
→ "결론에는 반드시 정책 제언이 들어가야 해"
③ 기억 업데이트
→ "방금 내가 말한 규칙을 CLAUDE.md에 추가해줘"
→ Claude가 직접 CLAUDE.md를 수정
④ 다음 세션부터 자동 반영
→ 같은 피드백 반복 불필요
방금 내가 요청한 내용 — [구체적 수정 사항] —
이것을 CLAUDE.md의 [섹션 이름] 항목에 규칙으로 추가해줘.
앞으로 모든 작업에 자동 적용되도록.
연구 분야별 CLAUDE.md 핵심 커스터마이징
| 연구 분야 | 반드시 명시할 것 |
|---|---|
| 사회과학·정책 | 인용 스타일(APA/NRF), 정부 보고서 우선 순위, 정책 제언 포함 여부 |
| 의학·보건 | CONSORT/PRISMA 준수, PubMed 논문 우선, Vancouver 스타일 |
| 공학·CS | IEEE 스타일, GitHub 코드 연동, 재현 가능성 기준 |
| 인문학 | 1차 자료 우선, Chicago 스타일, 번역 방침(원문 병기 여부) |
| 경제·경영 | 데이터 출처 명시, 계량 방법론 표기, 영문 논문 투고 대응 |
✨ 5. Skill 만들기
5.1 ✨ Skill이란 무엇인가
Skill은 "특정 작업에 대한 재사용 가능한 플레이북"입니다. Anthropic 공식 문서의 정의:
"Skills teach Claude how to complete specific tasks in a repeatable way, whether that's creating documents with your company's brand guidelines, analyzing data using your organization's specific workflows, or automating personal tasks."
Skill 3단계 로딩 구조 (Progressive Disclosure):
- 탐색 단계(Level 1, ~100단어): Claude가 모든 Skill의
name+description만 시스템 프롬프트에 항상 보유 - 로드 단계(Level 2): 관련 작업 인식 시 해당
SKILL.md전문을 읽음 - 실행 단계(Level 3): 필요 시 번들된
scripts/·references/·assets/를 추가로 로드
이 3단계 구조 덕분에 수십 개의 Skill을 설치해도 컨텍스트가 폭발하지 않습니다.
5.2 ✨ Skill 파일 구조 (공식 규격)
my-research-skill/
├── SKILL.md ← 필수: 핵심 지침
├── scripts/ ← 선택: 자동화 스크립트
├── references/ ← 선택: 참조 문서
└── agents/ ← 선택: 전문 서브에이전트
5.3 ✨ Skill description 작성법 — "Pushy하게 쓰기" NEW
공식 skill-creator SKILL.md에서 명시한 핵심 팁:
"Make the skill descriptions a little bit 'pushy'. Instead of 'How to build a simple fast dashboard', write 'How to build a simple fast dashboard. Make sure to use this skill whenever the user mentions dashboards, data visualization, internal metrics, or wants to display any kind of company data, even if they don't explicitly ask for a "dashboard."'"
이유: description은 Claude가 "이 Skill을 불러올지 말지"를 판단하는 유일한 근거입니다. 너무 소극적으로 쓰면 언더트리거링(필요할 때 안 불러와짐)이 발생합니다.
예시 — 연구자용:
| 약한 description (❌) | 강한 description (✓) |
|---|---|
description: 논문 IF 필터링 | description: 논문 검색 결과를 Impact Factor 기준으로 필터링합니다. 사용자가 "논문 검색", "문헌 리뷰", "저널 선택", "인용할 논문", "Q1/Q2 논문", 또는 특정 저널의 격(格)을 언급할 때 반드시 이 스킬을 사용하세요. SCIE·SSCI·KCI 등재 여부와 분야별 IF를 고려합니다. |
5.4 ✨ Skill 만드는 3가지 방법 NEW
방법 A — 바이브코딩으로 즉석 생성 (초보자 추천)
나는 사회과학 연구자야. 문헌 리뷰 표를 반복적으로 작성하는데,
매번 같은 구조와 품질 기준을 유지하고 싶어.
다음 요구사항으로 Skill을 만들어줘:
- 이름: literature-review-table
- 위치: .claude/skills/literature-review-table/SKILL.md
- description은 "pushy"하게 써줘 ("문헌 리뷰", "선행연구 정리",
"논문 비교표", "문헌고찰" 등의 키워드에 반드시 반응)
- 각 논문에서 추출할 컬럼: 저자·연도·RQ·방법론·표본·주요발견·한계
- 출력: Excel(.xlsx) 1시트 + Markdown 요약
- 모든 인용은 APA 7th
Claude Code가 폴더 생성, frontmatter 작성, 본문 작성, 필요 시 scripts/·references/ 구성을 모두 수행합니다.
방법 B — 공식 skill-creator 사용 (권장)
Anthropic이 배포하는 skill-creator Skill을 설치하면, Skill 제작 자체를 Claude에게 맡길 수 있습니다. skill-creator는 평가 쿼리 생성·description 최적화·패키징을 자동으로 수행합니다.
# 방법 1: 공식 마켓플레이스(자동 등록)에서 설치
/plugin install skill-creator@claude-plugins-official
# 방법 2: GitHub에서 직접
/plugin marketplace add anthropics/skills
/plugin install skill-creator@skills
사용:
"문헌 리뷰 표 자동 생성 Skill을 만들고 싶어. skill-creator 사용해서 진행해줘."
방법 C — 손으로 작성 (고급)
mkdir -p ~/my-project/.claude/skills/my-skill
touch ~/my-project/.claude/skills/my-skill/SKILL.md
# SKILL.md에 frontmatter + 본문 작성
# 필요 시 scripts/, references/, assets/ 추가
5.5 나의 노하우를 Skill로 — if-journal-filter 예시
Skill의 핵심 가치는 "내가 매번 하던 판단 기준을 파일로 외부화"하는 것입니다. 예를 들어 "이 저널은 인용할 만한가?"라는 판단을 매번 직접 하는 대신, Impact Factor 기반 필터링 기준을 SKILL.md에 내장하면 에이전트가 논문 검색마다 자동으로 내 기준을 적용합니다.
파일 위치: .claude/skills/if-journal-filter/SKILL.md
---
name: if-journal-filter
description: |
논문 검색 결과를 Impact Factor(IF) 기준으로 필터링합니다.
분야별 High-IF 저널 레퍼런스를 내장하고 있습니다.
---
# IF Journal Filter Skill
## Tier 기준
- Tier 1 (Q1): IF ≥ 5.0 → 🥇 최우선
- Tier 2 (Q2): 2.0 ≤ IF < 5.0 → 🥈 우선
- Tier 3 (Q3): 1.0 ≤ IF < 2.0 → 🥉 보충
- Tier 4: IF < 1.0 또는 미등재 → ❌ 기본 제외
## 선정 로직
1. Tier 1~2에서 목표 편수의 80% 이상 확보
2. 부족 시 Tier 3에서 보충
3. Tier 4는 최후 수단
## 내장 저널 리스트 (예시: 경영/기술경영)
MISQ, ISR, JMIS, Research Policy, TFSC,
Technovation, JBR, IJIM, GIQ, TIS
5.6 ✨ GitHub 연동 — Skill·프로젝트 공유와 재사용 (2026.04 기준) NEW
Claude Code에는 2025년 10월 공개 베타 이후 플러그인·마켓플레이스 시스템이 정식 기능으로 자리잡았습니다. Skill은 이제 npm 패키지처럼 배포·설치되고, 내가 만든 프로젝트 전체도 GitHub에 올려 팀원·다른 연구자와 공유할 수 있습니다.
이 섹션은 다섯 가지를 순서대로 다룹니다.
- 3.5.1 남이 만든 Skill 가져오기 (공식 마켓플레이스)
- 3.5.2 남이 만든 Skill 가져오기 (GitHub 직접)
- 3.5.3 내가 작업한 프로젝트를 GitHub에 올리기
- 3.5.4 내가 올린 프로젝트(또는 남의 프로젝트)를 클론해서 쓰기
- 3.5.5 관리 명령
3.5.1 Anthropic 공식 마켓플레이스 (기본 설치됨)
Claude Code를 처음 설치하면 claude-plugins-official이 자동 등록됩니다.
# 브라우저에서 카탈로그 탐색
# → claude.com/plugins
# 터미널에서 탐색 및 설치
/plugin # Discover 탭에서 브라우징
/plugin install <n>@claude-plugins-official
예시:
/plugin install github-ops@claude-plugins-official
3.5.2 GitHub 레포지토리에서 직접 마켓플레이스 추가
가장 많이 쓰이는 패턴입니다. 다른 사람(또는 본인)이 만든 Skill 컬렉션을 GitHub에서 바로 설치합니다.
# 형식: owner/repo (GitHub username/repository)
/plugin marketplace add anthropics/skills
# 또는 Git URL (GitLab, Bitbucket, self-hosted 지원)
/plugin marketplace add https://github.com/daymade/claude-code-skills
# 로컬 경로도 가능
/plugin marketplace add /Users/myname/my-skills-marketplace
주의: /plugin marketplace add는 카탈로그를 등록만 합니다. 실제 설치는 별도로 수행해야 합니다. 앱스토어를 추가하는 것과 앱을 다운받는 것이 다른 단계인 것과 같은 개념입니다.
# 등록된 마켓플레이스에서 특정 skill 설치
/plugin install skill-creator@skills
/plugin install literature-review@daymade-skills
연구자가 꼭 살펴볼 GitHub 마켓플레이스:
| 레포 | 특징 | 설치 명령 |
|---|---|---|
anthropics/skills | Anthropic 공식 Skill 저장소. docx/pdf/pptx/xlsx 등 핵심 Skill 포함 | /plugin marketplace add anthropics/skills |
daymade/claude-code-skills | 공식 skill-creator 포크 + 연구·문서 Skill 다수 | /plugin marketplace add daymade/claude-code-skills |
alirezarezvani/claude-skills | 232+ Skill (엔지니어링·마케팅·PM·C-level) | /plugin marketplace add alirezarezvani/claude-skills |
obra/superpowers-marketplace | Jesse Vincent의 Superpowers — /brainstorm, /write-plan, /execute-plan | /plugin marketplace add obra/superpowers-marketplace |
travisvn/awesome-claude-skills | 큐레이션된 Skill 링크 모음 (설치는 각 레포에서) | 참고용 |
3.5.3 내가 작업한 프로젝트를 GitHub에 올리기
Claude Code로 만든 Skill·에이전트·CLAUDE.md를 GitHub에 올리는 가장 쉬운 방법은 Claude Code에게 시키는 것입니다. Git 명령을 외울 필요가 없습니다.
사전 준비 (최초 1회만)
- GitHub 계정 생성 —
github.com에서 가입 - Git 설치 확인 — 터미널에서
git --version실행. 없으면 Claude Code에게 "Git 설치해줘" - GitHub CLI 설치 (선택이지만 강력 추천) —
gh명령어로 레포 생성·인증을 자동화할 수 있음. 설치 역시 "GitHub CLI 설치하고 로그인까지 해줘" 한 줄이면 Claude Code가 알아서 처리
업로드 방법 — 3가지 중 골라 쓰기
방법 A: 모두 맡기기 (가장 쉬움)
이 프로젝트 폴더를 GitHub에 새 레포로 올려줘.
레포 이름: my-research-agent
공개 범위: public (또는 private)
설명: "문헌 리뷰 자동화 에이전트 MVP"
업로드 전에 다음을 꼭 확인해줘:
1. .gitignore 만들기 (데이터·API 키·캐시 제외)
2. README.md 자동 생성 (CLAUDE.md 요약 + 사용법)
3. .env나 개인 데이터 파일이 포함되지 않는지 점검
Claude Code가 git init → gh repo create → git add → git commit → git push까지 한 번에 실행합니다.
방법 B: 기존 레포에 푸시 (이미 레포가 있을 때)
이 폴더의 최근 변경사항을 GitHub에 올려줘.
커밋 메시지는 내가 뭘 고쳤는지 요약해서 영문으로 작성.
방법 C: 수동으로 직접 (원리를 이해하고 싶을 때)
# 1. 폴더 안에서 git 초기화
cd ~/projects/my-research-agent
git init
# 2. .gitignore 파일 생성 (아래 권장 내용 참고)
cat > .gitignore <<EOF
# 데이터·개인정보
data/raw/
*.csv
*.xlsx
# API 키·환경변수
.env
.env.local
# 캐시·로그
__pycache__/
*.pyc
.DS_Store
node_modules/
.cache/
EOF
# 3. 변경사항 추가·커밋
git add .
git commit -m "Initial commit: research agent MVP"
# 4. GitHub에 새 레포 만들기 (gh CLI 필요)
gh repo create my-research-agent --public --source=. --push
# 또는 GitHub 웹에서 레포를 먼저 만든 뒤:
git remote add origin https://github.com/내이름/my-research-agent.git
git branch -M main
git push -u origin main
업로드 전 반드시 점검할 3가지
Git은 한 번 푸시하면 이력에 남습니다. 실수를 되돌리기 매우 번거로우니, 최초 업로드 전에 점검하세요.
| 점검 항목 | Claude Code에게 시킬 프롬프트 |
|---|---|
| API 키·비밀번호 누출 | "이 폴더에 API 키나 비밀번호가 하드코딩된 파일이 있는지 전수 검사해줘" |
| IRB·개인정보 데이터 | "raw data 폴더를 .gitignore에 넣고, 이미 커밋된 게 없는지 확인해줘" |
| 저작권 있는 논문 PDF | ".pdf 파일을 .gitignore에 넣어줘. 논문 원문은 공유하면 안 돼" |
보안 사고 대응: 만약 실수로 API 키를 푸시했다면 즉시 키를 폐기(revoke)하세요. Git 히스토리를 뒤늦게 지워도 이미 공개된 키는 유효합니다.
레포 보안 체크 (남의 레포 쓸 때도 동일)
새 레포를 공개하거나 남의 레포를 참고할 때 아래 3가지를 확인합니다.
- 스타(⭐) 수 — 최소 100개 이상이면 어느 정도 검증됨. 10개 미만은 신중히
- 최근 업데이트 — 6개월 이내 커밋이 없으면 방치된 프로젝트일 가능성
- 신뢰할 만한 기관 —
anthropics/,google/,microsoft/등 공식 조직 계정 여부
3.5.4 GitHub 프로젝트를 클론해서 쓰기
클론(clone)은 GitHub에 있는 레포를 내 컴퓨터로 통째로 복사하는 작업입니다. Skill 마켓플레이스 설치와 달리, 프로젝트 전체 폴더(코드·CLAUDE.md·스크립트·문서)를 가져옵니다.
상황별 선택
| 내가 원하는 것 | 쓸 명령 |
|---|---|
| Skill만 골라서 내 Claude Code에 붙이기 | /plugin install <n>@<market> (3.5.1~2 참조) |
| 프로젝트 폴더 전체를 내 컴퓨터로 복사해서 직접 실행·수정 | git clone <URL> |
경로 복사해서 클론하기 — 기본 흐름
- GitHub 레포 페이지 접속 → 초록색
Code버튼 클릭 - HTTPS URL 복사 (예:
https://github.com/anthropics/skills.git) - 터미널에서 클론:
# 내가 프로젝트를 두는 폴더로 이동
cd ~/projects
# 복사한 URL로 클론
git clone https://github.com/anthropics/skills.git
# 클론 완료 후 폴더로 진입
cd skills
Claude Code에게 한 줄로 맡기기 (권장)
이 GitHub 주소를 ~/projects/ 폴더에 클론해줘:
https://github.com/anthropics/skills
클론 후에는:
1. README.md를 요약해서 설명
2. 설치에 필요한 패키지가 뭔지 확인 (requirements.txt, package.json 등)
3. 이 레포가 내 연구에 어떻게 쓸 수 있을지 제안
자주 쓰는 변형
특정 브랜치만 클론:
git clone -b develop https://github.com/user/repo.git
가벼운 클론 (히스토리 생략, 용량 절감):
git clone --depth=1 https://github.com/user/repo.git
내가 수정할 목적이면 "포크(fork)" 먼저: GitHub 페이지 우측 상단의 Fork 버튼 → 내 계정으로 복제 → 내 계정의 URL로 클론. 남의 레포에는 직접 push할 수 없기 때문입니다.
클론 후 첫 실행 체크리스트
| 단계 | Claude Code에게 시킬 프롬프트 |
|---|---|
| 1. 의존성 설치 | "이 레포의 의존성(requirements.txt 또는 package.json)을 확인하고 설치해줘" |
| 2. 환경변수 설정 | ".env.example 있으면 .env로 복사하고, 내가 채울 API 키 자리를 표시해줘" |
| 3. 실행 테스트 | "README 읽고 예제를 하나 돌려봐. 에러 나면 해결해줘" |
| 4. 내 것으로 각색 | "이 레포의 CLAUDE.md를 내 연구 분야(예: 교육학 · APA 7th)에 맞게 고쳐줘" |
3.5.5 관리 명령
/plugin marketplace list # 등록된 마켓플레이스 목록
/plugin marketplace update <n> # 특정 마켓플레이스 갱신
/plugin marketplace remove <n> # 제거 (설치된 plugin도 제거됨)
/reload-plugins # 플러그인 갱신 후 재로드
auto-update: Anthropic 공식 마켓플레이스는 기본 auto-update가 켜져 있습니다. 커뮤니티 마켓플레이스는 개별 설정 필요.
5.7 ✨ Skill 만들기 전 체크리스트 NEW
- 이 작업을 3회 이상 반복했는가? (1~2회는 Skill로 만들 가치 없음)
- 매번 동일한 구조/품질 기준을 유지하고 싶은가?
- 이 작업에 내가 매번 하는 판단(어떤 저널을 고를지, 어떤 출처를 우선할지)이 있는가?
description에 구체적 트리거 키워드를 5개 이상 넣을 수 있는가?
4개 모두 "예"라면 Skill로 만들 가치가 있습니다.
5.8 ✨ Skill vs Command vs Subagent 결정 트리 NEW
| 상황 | 권장 |
|---|---|
| 특정 작업에 필요한 지식·템플릿을 Claude가 자동으로 불러와 쓰길 원함 | Skill |
| 내가 타이핑하는 단축키로 명시적으로 호출 | Command (.claude/commands/) 또는 name을 단축키로 쓰는 Skill |
| 독립된 컨텍스트 윈도우·권한으로 분리 실행 | Subagent |
| 위 셋 + hooks를 한 묶음으로 팀에 배포 | Plugin |
2026.04 업데이트: Anthropic 공식 Docs는 "Custom commands have been merged into skills..claude/commands/deploy.md와.claude/skills/deploy/SKILL.md둘 다/deploy단축키를 만들고 동일하게 작동합니다. Skill이 권장되며, 기존 command 파일도 계속 동작합니다."
5.9 ✨ SkillsMP — 오픈소스 Skill 마켓플레이스
커뮤니티가 만든 Skill을 탐색할 수 있습니다: skillsmp.com
팩트체킹, 문헌 고찰, 코드 리뷰 등 다양한 분야의 Skill 검색 가능.
"학술 논문 IF 필터링 관련 오픈소스 스킬 있어?"
⌨️ 6. 실전 사용법: 연구자를 위한 핵심 팁
6.1 📌 @ 기호로 파일/폴더 직접 지정하기
| 프롬프트 예시 | Claude가 하는 일 |
|---|---|
@논문.pdf 핵심 내용 3줄로 요약해줘 | PDF를 읽고 핵심 내용 3줄 요약 |
@데이터.csv 분석해서 인사이트 3개 뽑아줘 | CSV 파싱 → 통계 분석 |
@reports/ 이 폴더 문서 모두 읽고 목차 만들어줘 | 폴더 순회 → 목차 생성 |
@보고서A.pdf @보고서B.pdf 비교 분석해줘 | 두 파일 동시 읽기 → 비교표 |
6.2 📐 Plan Mode — 계획 먼저 확인
# Plan Mode 켜기 (Shift+Tab 두 번 또는)
> /plan
# 계획 수립 요청 예시
> "이 폴더의 논문 50편을 분석해서 체계적 문헌 리뷰를
작성하려고 해. 어떤 순서로 진행할지 계획만 먼저 보여줘"
6.3 세션 & 컨텍스트 관리
| 명령어 | 기능 | 언제? |
|---|---|---|
/compact | 대화 압축 (컨텍스트 절약) | 긴 작업 중간중간 |
/clear | 대화 완전 초기화 | 다른 주제로 넘어갈 때 |
/context | 컨텍스트 사용량 확인 | 느려질 때 |
claude -c | 마지막 세션 이어서 | 어제 작업 계속 |
6.4 신규 명령어 (2026 업데이트)
/voice — 음성 입력 (2026.3.3 추가)
| 기능 | 스페이스바 push-to-talk 음성 입력 (전사 토큰 무료) |
|---|---|
| 활용 | 긴 연구 배경 설명, 복잡한 분석 지시, 떠오르는 아이디어를 빠르게 입력 |
스페이스바 누르고:
"지난 5년 AI 거버넌스 논문에서 규제 프레임워크를 다룬 것들만
골라서 방법론 비교표 만들어줘"
/loop — 반복 실행 (v2.1.71 추가)
지정 간격마다 같은 작업을 자동 반복합니다. 세션이 열려 있는 동안만 동작합니다.
# 매시간 신규 논문 모니터링
/loop 1h "Semantic Scholar에서 AI governance 신규 논문 확인하고 요약해줘"
# 매 6시간 파일 인덱스 업데이트
/loop 6h "내 reports/ 폴더에 새 파일 생겼는지 확인하고 인덱스 업데이트해줘"
# 매일 arXiv 논문 피드
/loop 24h "arXiv cs.AI 오늘 등록된 논문 중 policy, regulation, safety 키워드 관련 것 뽑아줘"
/effort — 추론 강도 설정
낮음/중간/높음 3단계로 추론 강도를 조절합니다. 단순 요약은 낮음, 방법론 검토는 높음으로 설정해 토큰을 절약하세요.
ultrathink 키워드를 포함하면 최대 추론 모드가 활성화됩니다."이 연구의 측정 모델 validity를 ultrathink로 검토해줘""이 정책 분석의 논리적 허점을 ultrathink로 찾아줘"주의: 토큰 비용 큼. 단순 요약/정리 작업에는 불필요.
/btw — 사이드 질문
현재 작업 진행 중에 끼어들어 짧은 질문을 삽입합니다.
/btw "방금 찾은 논문 중 2024년 이후 것만 몇 편이야?"
/batch — 다중 파일 일괄 처리 (v2.1.63 추가)
/batch "papers/ 폴더의 논문 50편 각각에서
연구방법, 샘플크기, 주요결과 추출해서
comparison_table.xlsx로 만들어줘"
/plan [설명] — 설명과 함께 계획 수립
/plan "MIS Quarterly 스타일 논문 리뷰를 위한
체계적 문헌고찰 에이전트를 만들고 싶어"
6.5 컨텍스트 관리 업데이트
| 항목 | 내용 |
|---|---|
| 서버 자동 압축 | Sonnet 4.6부터 자동 압축 → 사실상 무한 대화 가능 |
| 1M 토큰 컨텍스트 | Opus 4.6 기준 Max/Team/Enterprise에서 지원. 논문 수십 편 + 데이터를 한 세션에 올려놓고 통합 분석 가능 |
| 주의 | 토큰 비용 큼. 단순 작업에 낭비하지 않도록 범위 지정 권장 |
6.6 핵심 명령어 빠른 참고
터미널: claude / claude -c / claude "질문"
신규: /voice /loop /effort /btw /batch /plan
기본: /compact /clear /cost /context /model /quit
키보드: Shift+Enter(줄바꿈) Shift+Tab(모드전환)
Ctrl+C(중단) Esc+Esc(되감기)
🔌 7. MCP & Subagent
7.1 🔌 MCP — 직관적 이해
API는 특정 가게에 직접 주문, MCP는 배달의민족
| 방식 | 비유 | 연구 예시 |
|---|---|---|
| API | 특정 가게에 직접 주문 | Semantic Scholar에 직접 연결해서 논문 데이터 받기 |
| MCP | 배달의민족 (여러 가게 한 화면) | arXiv + Semantic Scholar + PubMed + Zotero를 하나의 인터페이스로 묶어 자유롭게 선택 |
7.2 연구자용 주요 MCP
| MCP 서버 | 용도 | 연결 방법 |
|---|---|---|
| Google Drive | 연구 문서 읽기/쓰기 | Cowork 커넥터 |
| Notion | 연구 노트, DB 접근 | MCP 서버 설정 |
| Semantic Scholar | 학술 논문 검색 (2.1억+) | Deep Research MCP |
| Zotero | 개인 참고문헌 라이브러리 연동 | 커뮤니티 MCP |
| arXiv MCP | 프리프린트 최신 논문 검색 | npmjs 설치 |
| PubMed MCP | 생의학 논문 검색 | npmjs 설치 |
7.3 학술 논문 MCP의 현실적 한계
- 유료 저널 전문 접근 불가: Nature, Cell 등 페이월 논문 본문 접근 불가
- 한국어 논문 사각지대: RISS, KISS, KCI에 MCP 없음, API 비공개
- 환각(hallucination) 위험: LLM이 없는 논문을 인용할 수 있음 — 항상 교차 검증 필수
실용 권장 조합
| 목적 | 권장 조합 |
|---|---|
| 영문 최신 논문 | arXiv-mcp + semantic-scholar |
| 생의학 분야 | pubmed-mcp |
| 개인 라이브러리 관리 | zotero-mcp |
| 국내 논문 | RISS/DBpia 수동 다운 → zotero-mcp 연동 |
7.4 신규 MCP 기능
MCP Elicitation
작업 중 Claude가 구조화된 입력 폼을 요청할 수 있습니다. GUI 파라미터 입력 Skill 구성 가능 — 예: 논문 검색 조건을 폼으로 입력.
Channels (research preview)
Discord/Telegram/Slack으로 Claude Code를 제어합니다.
"지금 AI policy 논문 5편 검색해줘" → Claude Code가 자동 실행조건: Claude Code v2.1.80 이상, Team/Enterprise에서 명시적 enable 필요
7.5 👥 Subagent — AI 분업 구조
메인 에이전트 (연구 총괄)
├── 웹 검색 에이전트 → EU AI Act 동향
├── 웹 검색 에이전트 → 미국 AI 규제
├── 웹 검색 에이전트 → 한국 AI 기본법
├── 데이터 분석 에이전트 → 비교 분석
└── 문서 작성 에이전트 → Word 보고서
주요국의 AI 반도체 수출규제 정책을 조사해줘.
- EU, 미국, 일본, 한국을 각각 별도로 검색해줘
- 각 국가별로: 규제 명칭, 시행일, 주요 내용, 대상 품목
- 4개국 결과를 비교표로 종합
- 한국에 대한 시사점 3가지 도출
- 모든 정보에 출처(기관명, URL) 포함
- 최종 보고서를 Word로 저장해줘
7.6 🪝 Hooks — 가드레일 층 NEW
Hook은 특정 이벤트가 발생했을 때 자동 실행되는 셸 명령입니다. "Git hooks for your agent"라고 생각하면 됩니다. AI 판단이 아니라 결정론적 실행이라는 점이 핵심입니다.
이벤트 종류:
| 이벤트 | 시점 |
|---|---|
PreToolUse | 도구 실행 직전 |
PostToolUse | 도구 실행 직후 |
SessionStart | 세션 시작 |
Stop | 세션 종료 |
SubagentStop | 서브에이전트 종료 |
연구자 활용 예:
- Write 이벤트 발생 시 → auto-lint 실행
- Bash 이벤트에 'rm -rf' 감지 시 → 차단
- Stop 이벤트 시 → 결과를 Slack 채널로 알림
- SessionStart 시 → 오늘의 todo list 로드
비개발자도 Claude에게 만들어달라고 요청 가능:
"내가 실수로 /raw-data/ 폴더를 지우지 못하도록 hook을 만들어줘.
rm 명령이 raw-data를 포함하면 자동 차단되게."
7.7 🧱 Plugins — 배포의 층 NEW
Plugin은 skills/ + agents/ + hooks/ + commands/를 한 묶음으로 배포하는 단위입니다. "에이전트 능력의 npm 패키지"로 이해하면 됩니다.
Plugin 디렉토리 구조 (Anthropic 공식):
plugin-name/
├── .claude-plugin/
│ └── plugin.json # Plugin 메타데이터 (필수)
├── .mcp.json # MCP 서버 설정 (선택)
├── commands/ # 슬래시 커맨드 (선택)
├── agents/ # 에이전트 정의 (선택)
├── skills/ # Skill 정의 (선택)
└── README.md # 문서
마켓플레이스 배포 (본인 Skill 남에게 공유):
my-marketplace/
├── .claude-plugin/
│ └── marketplace.json # 마켓플레이스 메타데이터
├── plugins/
│ ├── plugin-a/
│ └── plugin-b/
└── README.md
GitHub에 push하면 /plugin marketplace add <your-username>/<your-repo>로 누구나 설치 가능.
🚀 8. 에이전트 기획 & 실전 구축
8.1 에이전트 기획 6단계 (Claude 웹 → Claude Code)
Claude Code로 바로 뛰어들기보다, Claude 웹으로 기획을 먼저 확정하는 것이 훨씬 효율적입니다. 한 번 잘못 방향을 잡으면 처음부터 다시 짜야 합니다.
1단계: 상세 설명 작성 (Claude 웹에서)
내 연구 분야의 특성과 노하우를 듬뿍 담아 만들고 싶은 서비스를 설명합니다. 나눠 쓰지 말고, 한 번에 다 쓰세요.
나는 IS(정보시스템) 분야 박사과정이고, 주로 SME의 AI 도입을 연구한다.
매번 MIS Quarterly, ISR, JMIS 같은 탑 저널 논문을 수동으로 검색해서
8가지 항목으로 정리하는데, 이게 너무 오래 걸린다.
키워드 3개를 입력하면 최근 5년 논문을 자동으로 수집·정리·분석하고
Research Gap 보고서까지 만들어주는 에이전트를 원한다.
2단계: Workflow 차트 + Subagent 구조 요청
"위 내용을 바탕으로 워크플로 차트와 서브에이전트 구조를 짜줘.
각 에이전트의 역할, 입출력, 순서를 명확히 해줘."
3단계: 기획서를 .md 파일로 저장
"이 기획서를 Claude Code에 가져가서 만들 거야.
정리가 다 되면 research-agent-spec.md 파일로 만들어줘."
4단계: MVP로 범위 축소
"컨셉이 작동하는 최소한의 MVP로 먼저 만들자.
일단 논문 검색 + 표 정리 2단계만 구현하는 걸로 범위를 좁혀줘."
5단계: 방향 확정 (Claude가 객관식으로 제시)
Claude가 "다음 중 어떤 방식으로 진행할까요? (A)... (B)... (C)..." 형태로 선택지를 제시하면 방향을 정합니다.
6단계: Claude Code로 이동 + Plan Mode 실행
# 1. 기획서(.md)를 프로젝트 폴더에 복사
# 2. Plan Mode로 방향 재점검
/plan "research-agent-spec.md 읽고 구현 계획 검토해줘"
# 3. 승인 후 구현 시작
8.2 실전 워크숍 실습 — 일반 연구 사례 Step-by-Step
- 아무 폴더에서
claude실행 →"이 폴더에 뭐가 있는지 분석하고 정리해줘" - PDF가 있다면 →
"@파일이름.pdf 이 문서 핵심 내용 3줄로 요약해줘" - 바로 결과물 →
"AI 정책 최신 동향을 웹에서 검색하고, 핵심 5가지를 마크다운으로 정리해줘"
Step 1: 프로젝트 폴더 준비
Cowork: 바탕화면에 "AI-policy-research" 폴더 생성 → Cowork에서 지정
Claude Code: mkdir ~/AI-policy-research && cd ~/AI-policy-research && claude
Step 2: CLAUDE.md 생성
"이 프로젝트는 AI 정책 동향을 분석하는 연구 프로젝트야.
나는 정책연구자이고, 한국어로 보고서를 작성해.
학술적이고 객관적인 톤, 모든 주장에 출처를 달아야 해.
이 프로젝트에 맞는 CLAUDE.md 파일을 만들어줘."
Step 3: 핵심 Skill 3개 생성
아래 요구사항에 맞는 Skill을 만들어줘:
- 이름: trend-scanner
- 기능: 사용자가 국가와 정책 분야를 지정하면 웹 검색으로 최근 6개월 동향 수집
- 출처: 정부 공식 문서, 연구기관 보고서 우선
- 출력: 마크다운 파일 (날짜순 정렬)
- 각 항목에 제목, 날짜, 출처 URL, 요약(3문장) 포함
- .claude/skills/ 폴더에 저장해줘
아래 요구사항에 맞는 Skill을 만들어줘:
- 이름: policy-comparator
- 기능: 국가별 정책을 비교 분석하여 Word 보고서 생성
- 비교 항목: 정책 목표, 주요 수단, 대상, 예산 규모, 시행 시기
- 출력 구조: 요약→비교표→국가별 상세→시사점
- APA 스타일 참고문헌 포함
- .claude/skills/ 폴더에 저장해줘
아래 요구사항에 맞는 Skill을 만들어줘:
- 이름: literature-reviewer
- 기능: PDF 논문을 읽고 체계적으로 리뷰
- 각 논문에서 추출: 연구목적, 방법론, 주요발견, 한계, 시사점
- 출력: Excel 파일 (논문별 한 행) + 종합 요약 마크다운
- .claude/skills/ 폴더에 저장해줘
Step 4: 테스트
한국의 AI 규제 동향을 스캔해줘
결과가 나오면: "출처 표기에 URL과 접근 날짜도 포함해줘. Skill 업데이트해줘"
활용 예시: Before vs After
| Before (수작업) | After (에이전트) |
|---|---|
| 1일차: 자료 수집 (4h) + 논문 읽기 (4h) | 프롬프트 작성 (10분) |
| 2일차: 정책 요약 (6h) + 비교표 (2h) | AI 병렬 검색+분석 (15분) |
| 3일차: 보고서 작성 (6h) + 참고문헌 (2h) | 검토+수정+최종본 (35분) |
| 총 24시간 (3일) | 총 1시간 10분 |
8.3 🤖 Research Agent 4단계 파이프라인 (검색 → 정리 → 분석 → Gap) NEW
키워드 하나 입력하면 High-IF 저널 논문을 자동으로 검색 → 정리 → 분석 → Gap 도출하는 완전 자동 연구 에이전트 구조입니다.
프로젝트 폴더 구조
finding_paper/
├── .claude/
│ ├── agents/
│ │ ├── paper-search-agent.md ← [1/4] 논문 검색
│ │ ├── paper-organizer-agent.md ← [2/4] 논문 정리표
│ │ ├── trend-analyzer-agent.md ← [3/4] 동향 분석
│ │ └── gap-finder-agent.md ← [4/4] Research Gap
│ ├── skills/
│ │ ├── gap-analysis/SKILL.md ← 5유형 Gap 분류 규칙
│ │ ├── if-journal-filter/SKILL.md ← IF 기반 저널 필터링
│ │ └── literature-review/SKILL.md ← 체계적 문헌고찰 규칙
│ ├── settings.json
│ └── settings.local.json
├── templates/
│ ├── paper_table_template.md
│ ├── trend_report_template.md
│ └── gap_report_template.md
├── output/
│ ├── 01_search_results.md
│ ├── 02_paper_table.md
│ └── 03_trend_analysis.md
└── CLAUDE.md ← 메인 오케스트레이터
CLAUDE.md 핵심 구조 (오케스트레이터)
# Research Agent
## 프로젝트 개요
키워드 하나 입력하면 High-IF 저널 논문을 자동으로
검색 → 정리 → 분석 → Gap 도출하는 완전 자동 연구 에이전트
## 자동 실행 파이프라인
사용자가 키워드와 조건을 입력하면, 다음 4단계를 자동으로 순차 실행:
1. Paper Search Agent → 메인 키워드 필수 + 보조 가중치로 검색 + IF 필터링
2. Paper Organizer → Abstract 우선 분석 + 8컬럼 표 자동 작성
3. Trend Analyzer → 키워드 네트워크 + 방법론 클러스터링 + 연도별 추이
4. Gap Finder → 5유형 Gap 매트릭스 + 심각도 평가 + 후속 RQ 생성
각 단계 완료 시 output/에 저장하고 즉시 다음 단계로 자동 진행.
사용자 승인을 기다리지 않는다.
Paper Search Agent 핵심 로직
| Step | 내용 |
|---|---|
| 1. 키워드 파싱 | 메인(필수) + 보조1(가중치) + 보조2(가중치) 3개 분리 |
| 2. 영문 쿼리 생성 | 동의어·관련어 확장 → 3개 쿼리 세트 자동 생성 |
| 3. 4개 소스 검색 | Semantic Scholar, arXiv, PubMed, Google Scholar 병렬 검색 |
| 4. IF 필터링 | if-journal-filter Skill 호출 → Tier 기준 선별 |
| 출력 | output/01_search_results.md (제목·저자·연도·저널·IF·인용수·DOI) |
Gap Finder Agent — 5유형 Research Gap 분류
| 유형 | 정의 | 심각도 |
|---|---|---|
| 1. 개념적 Gap | 아직 정의/검증되지 않은 개념이나 이론 | ★★★ 즉시 추진 ★★☆ 보조 RQ ★☆☆ 참고 수준 |
| 2. 맥락적 Gap | 특정 산업/국가/문화/시기에만 적용된 연구 | |
| 3. 방법론적 Gap | 측정 방식, 분석 방법의 한계나 부재 | |
| 4. 혼합/통합 Gap | 여러 이론/변수를 통합 연구하지 않은 부분 | |
| 5. 실용적 Gap | 학문적 발견이 실무에 어떻게 적용되는지 연구 부재 |
사용 방법 (4단계)
# 1. Claude 웹에서 기획 (Ch.8 기획 워크플로우 참고)
"AI 거버넌스, 규제정책, 기술표준을 키워드로 최근 5년 논문 20편을
리뷰하는 Research Agent를 만들고 싶어.
서브에이전트 구조와 워크플로 차트를 짜줘."
# 2. 기획서를 .md로 저장 → Claude Code 폴더에 복사
# 3. Claude Code에서 구현
"위 기획서 바탕으로 MVP 에이전트 만들어줘"
# 4. 실행
"AI governance, regulatory policy, technology standards 키워드로
2020-2026년 논문 20편 리뷰해줘"
8.4 🆚 Before vs After — 연구 주제 문헌 분석 사례
| Before (수작업) | After (에이전트) |
|---|---|
| 1일차: 자료 수집 4h + 논문 읽기 4h | 프롬프트 작성 10분 |
| 2일차: 내용 요약 6h + 비교표 2h | 병렬 검색·분석 15분 |
| 3일차: 보고서 6h + 참고문헌 2h | 검토·수정·최종 35분 |
| 총 24시간 (3일) | 총 1시간 10분 |
전 단계 에이전트 로드맵
아이디어 발굴부터 피어리뷰 대응까지 — 연구의 전 단계에서 에이전트를 어떻게 활용하는지 한눈에 봅니다. 각 단계에서 이 가이드북의 어떤 도구·챕터를 써야 하는지를 매핑합니다.
연구 8단계 × 에이전트 활용 맵
| 단계 | 핵심 작업 | Claude 도구 | 바로 쓸 수 있는 프롬프트 |
|---|---|---|---|
| 1. 아이디어 발굴 | 연구 공백 탐색, RQ 생성, 선행연구 지도 | Gap Finder (Ch.8b), ultrathink | "[분야] 최근 5년 연구 동향에서 아직 안 다뤄진 갭 3가지 찾아줘" |
| 2. 문헌 검토 | 논문 수집, 체계적 리뷰, 8컬럼 표 작성 | Paper Search → Organizer (Ch.8b), Zotero MCP | "@papers/ 폴더 논문들 PRISMA 체계로 문헌 리뷰 표 만들어줘" |
| 3. 연구 설계 | 방법론 선택, 연구 도구 설계, 타당도 검토 | /plan, ultrathink, 에이전트 기획 워크플로우 (Ch.8plan) | "내 RQ에 맞는 연구 방법론 3가지를 ultrathink로 비교해줘" |
| 4. 데이터 수집 | 설문 설계, 인터뷰 가이드, 코딩 매뉴얼 | survey-analyzer Skill, Skill 직접 제작 (Ch.5) | "이 연구 목적에 맞는 설문 문항 15개 초안 만들어줘. 리커트 5점 척도" |
| 5. 데이터 분석 | 통계 처리, 질적 코딩, 시각화 | /batch, @데이터.csv, Python MCP | "/batch @results/ 각 CSV 파일 기술통계 + 상관분석 후 요약표 만들어줘" |
| 6. 논문 작성 | 섹션별 초안, 논리 흐름 검토, 영문 초록 | literature-review Skill, CLAUDE.md 작성 규칙 | "방법론 섹션 초안 작성해줘. 내 CLAUDE.md 기준대로 APA 7th 적용" |
| 7. 투고 준비 | 저널 선택, Author Guideline 포매팅, IF 확인 | if-journal-filter Skill, Journal Scout (Ch.부록C) | "이 논문을 if-journal-filter로 Q1 저널 5개 추천해줘" |
| 8. 피어리뷰 대응 | 심사의견 분석, 수정 답변서 작성, 재투고 | peer-review-helper Skill, ultrathink | "@reviews.pdf Reviewer 2 의견 분석하고 각 항목별 답변 초안 작성해줘" |
단계별 핵심 에이전트 조합
| 목적 | 에이전트 조합 | 참고 챕터 |
|---|---|---|
| 처음 시작하는 연구 | CLAUDE.md 설계 → Gap Finder → 문헌 검토 에이전트 | Ch.4 → Ch.8b → Ch.8 |
| 진행 중인 연구에 AI 투입 | @기존 파일들 분석 → Skill 3개 생성 → 자동화 | Ch.6.1 → Ch.5 → Ch.8 |
| 투고 직전 논문 마무리 | if-journal-filter → Formatter → 윤리 체크리스트 | Ch.5.3 → 부록C → Ch.10 |
| 팀 연구 공유 환경 구축 | 공유 CLAUDE.md → 팀 Skill 카탈로그 → /batch 일괄 처리 | Ch.4 → Ch.5.4 → Ch.6 |
"나는 지금 6단계(논문 작성)에 있고, 서론 구조가 잘 안 잡혀. CLAUDE.md 보고 나한테 맞는 방식으로 도와줘"
09. 하네스 엔지니어링 (Harness Engineering) — 2026 프런티어
이전 판의 "Agentic Research Engineering"을 이 장으로 대체합니다. 2026년 Anthropic 공식 블로그(anthropic.com/engineering/harness-design-long-running-apps,anthropic.com/engineering/managed-agents)에서 이 용어가 프런티어 개념으로 자리잡았습니다.
9.1 하네스(Harness)란 무엇인가
공식 정의 (Anthropic Engineering Blog):"Harness design is key to performance at the frontier of agentic coding. A common thread across this work is that harnesses encode assumptions about what Claude can't do on its own."
비유: 하네스는 말(Claude)을 마차에 매는 장구입니다. 말의 힘(모델 지능)만으로는 복잡한 여정을 제대로 수행할 수 없고, 고삐·멍에·바퀴(하네스)가 함께 있어야 목적지까지 갑니다.
하네스의 3대 역할:
- 컨텍스트 관리 — 무엇을 기억하고 무엇을 버릴지 결정
- 도구 오케스트레이션 — 언제 어떤 도구를 부를지 구조화
- 가드레일 — 잘못된 행동을 사전 차단하고 자체 평가 루프 구축
9.2 진화의 3세대 → 4세대
| 세대 | 시기 | 이름 | 핵심 |
|---|---|---|---|
| 1세대 | 2023~2024 | 프롬프트 엔지니어링 | 단일 LLM에 잘 물어보기 |
| 2세대 | 2025 | 에이전트 코딩 | AI가 도구를 자율적으로 호출 |
| 3세대 | 2026 초 | 에이전트 오케스트레이션 | 여러 전문 에이전트 협업 설계 |
| 4세대 | 2026~ | 하네스 엔지니어링 | 에이전트의 실행 환경·피드백 루프·핸드오프 자체를 공학적으로 설계 |
9.3 하네스가 풀어야 할 3대 문제 (Anthropic 공식)
(1) Context Anxiety (컨텍스트 불안)
Claude Sonnet 4.5가 컨텍스트 한계가 다가온다고 "감지"할 때 작업을 성급히 마무리하는 현상.
해결: 하네스 레벨의 context reset — 단순 압축(compaction)이 아니라, 깨끗한 상태로 다음 에이전트에게 핸드오프 아티팩트를 넘김.
[Agent 1] 작업 수행 → handoff.md 작성 → 세션 종료
[Agent 2] handoff.md 로드 → 깨끗한 컨텍스트에서 이어 작업
(2) Self-Evaluation 편향
"에이전트가 자신의 작업을 평가하라고 하면 확신에 찬 자화자찬을 합니다 — 명백히 평범한 결과물에 대해서도."
해결: Generator ↔ Evaluator 분리 (GAN 스타일)
- Generator: 결과물을 생성하는 에이전트
- Evaluator: 회의적(skeptical) 태도로 평가하도록 튜닝된 별도 에이전트
- Playwright MCP 같은 외부 도구로 실제 렌더링·실행 결과를 검증
실험 결과 (Anthropic 공식):
- 2D 레트로 게임 메이커 제작 태스크
- 단일 에이전트: 20분 / $9 / 간신히 동작하는 프로토타입
- 하네스 기반 멀티에이전트: 6시간 / $200 / 풍부하고 완성도 높은 애플리케이션
- 2배 개선이 아니라 phase change (질적 도약)
(3) Context Handoff 손실
긴 작업을 여러 세션에 나눠 할 때, 중간 손실을 최소화하는 것이 핵심.
해결: 세션 이벤트 로그를 컨텍스트 윈도우 바깥에 지속 저장하는 구조. Claude Code는 이를 claude-progress.txt 같은 파일 기반 체크포인트로 구현.
9.4 9대 하네스 설계 패턴 (7+2)
| 패턴 | 설명 | 연구 예시 |
|---|---|---|
| ReAct | 추론과 행동 번갈아 | 검색→분석→추가검색 |
| Reflection | 자기 출력 검토·개선 | 초안→자체검토→수정 |
| Tool Use | 외부 도구 자율 호출 | 학술DB, 통계 분석 |
| Planning | 단계별 계획 분해 | 연구 로드맵 수립 |
| Multi-Agent | 전문 에이전트 협업 | 검색팀+분석팀+작성팀 |
| Sequential | 순차 파이프라인 | 수집→정제→분석→보고 |
| Human-in-Loop | 핵심 지점 사람 개입 | 계획 승인, 결과 검증 |
| Scheduled/Recurring 🆕 | /loop 기반 정기 반복 | 논문 피드, DB 모니터링 |
| Auto Mode 🆕 | 안전 분류기 기반 자동 승인 | 루틴 파일 작업 자동화 |
9.5 연구자를 위한 실전 하네스 아키텍처
┌─────────────────────────────────────────────┐
│ 연구자 (자연어 요청 + Human-in-Loop) │
├─────────────────────────────────────────────┤
│ Generator (메인 오케스트레이터) │
│ ─ 계획 수립 · 분업 · 결과 종합 │
├─────────┬─────────┬─────────┬───────────────┤
│ 웹검색 │ 학술DB │ 데이터 │ 문서작성 │
│ Subagent│ Subagent│ Subagent│ Subagent │
├─────────┴─────────┴─────────┴───────────────┤
│ Evaluator (별도 에이전트, 회의적 톤) │
│ ─ 출처 진위·통계 정합성·논리 검증 │
├─────────────────────────────────────────────┤
│ MCP 레이어: Scholar, Drive, Zotero, Stata │
└─────────────────────────────────────────────┘
↕ ↕
Hooks Context Handoff
(PreToolUse 등) (handoff.md 파일)
9.6 신뢰성 5대 원칙 (연구 적용)
| 원칙 | 내용 |
|---|---|
| 검증 가능성 | 모든 주장에 DOI, PubMed ID 등 식별자. 감사 로그 유지 |
| Human-in-Loop | 계획 수립, 출처 선택, 최종 결론에 사람 개입 |
| 최소 권한 | 꼭 필요한 도구·권한만 부여 (NIST AC-6) |
| 품질 필터링 | 동료심사 여부, 저널 등급, 최신성 기준 자동 적용 |
| 환각 감지 | 복수 출처 교차 확인 워크플로우 내장 |
9.7 🎚️ ▸ Auto Mode (2026.3.24 추가)
안전 분류기 기반으로 위험도가 낮은 작업은 자동 승인, 위험 작업은 차단합니다.
| 자동 승인 (안전) | 사람 확인 필요 (위험) |
|---|---|
| 파일 읽기, 요약 생성, 폴더 정리, 검색 | 외부 API 호출, 파일 삭제, 외부 발송 |
🍯 10. 꿀팁 & 주의사항
10.1 바이브코딩 꿀팁 Best 5
| # | 팁 | ✗ 나쁜 예 | ✓ 좋은 예 |
|---|---|---|---|
| 1 | 구체적으로 | "좋은 보고서 만들어줘" | "EU AI Act 3페이지 Word로" |
| 2 | 예시 보여주기 | "형식 맞춰줘" | "이 파일과 같은 형식으로" |
| 3 | 계획 먼저 | 바로 실행→불만족 | "계획만 먼저 보여줘" |
| 4 | 작게 시작 | 한번에 대형 시스템 | Skill 1개→테스트→확장 |
| 5 | 피드백 반영 | 매번 같은 수정 반복 | "Skill에 반영해줘" |
10.2 주의사항
10.3 고급 꿀팁 NEW
| 팁 | 방법 | 설명 |
|---|---|---|
| /color | /color [색상명] | 터미널 테마 색상 변경. 여러 세션을 동시에 열 때 세션마다 다른 색상으로 구분 (예: 빨간색=위험한 작업, 파란색=리서치) |
| ultrathink | 프롬프트에 ultrathink 포함 | 최대 추론 모드(Extended Thinking) 활성화. 복잡한 설계·분석·수학 문제에 사용. 토큰 소모 큼 |
| Auto Mode | 설정에서 Auto 활성화 | 승인 없이 자동 실행. 반복 작업·야간 배치에 적합. 단, 민감한 파일 폴더는 사전에 제외 설정 필수 |
이 연구 설계의 구조적 약점을 ultrathink 모드로 분석해줘.
대안 방법론 3가지와 각각의 장단점을 포함해서.
/color blue, /color green, /color red 명령으로 즉시 변경.
10.4 토큰 경제학 — 공식 가이드 + 실전 팁 NEW
출처 명시: 이 장의 "공식" 항목은 Anthropic 공식 문서(code.claude.com/docs/en/costs,platform.claude.com/docs/en/build-with-claude/context-windows,support.claude.com)에서 확인된 내용입니다. "실전 팁"은 커뮤니티(MindStudio, ClaudeFast, Aslam Doctor 등)와 저자 경험을 정리했습니다.
왜 토큰이 중요한가 — 두 가지 이유
- 비용: 긴 컨텍스트는 직접 비용(API 과금) 또는 간접 비용(구독 한도 소진)을 일으킵니다.
- 정확도: Context Rot (컨텍스트 부패) — 토큰이 많아질수록 정확도·recall이 저하되는 현상(Anthropic 공식 용어). 더 많은 컨텍스트 ≠ 더 좋은 답.
공식 Anthropic 권장사항 (요약)
A. 세션 관리
| 명령 | 용도 | 언제 |
|---|---|---|
/clear | 대화 전체 삭제. 클린 슬레이트 | 다른 작업으로 전환할 때 (가장 효과적인 단일 레버) |
/compact | 대화 요약 후 짧은 리캡으로 재시작 | 같은 작업을 계속 이어갈 때 |
/cost | 현재 세션 토큰 사용량 확인 | 주기적으로 |
/context | 컨텍스트 사용률 확인 | 느려지거나 누락 징후 시 |
공식 철칙 (Claude Help Center):"Rule of thumb: use
/clearwhen starting a new task, and/compactwhen continuing a long one. Almost every 'I burned through my limit by lunchtime' report traces back to confusing these two."
B. 모델 선택 (/model)
| 상황 | 모델 |
|---|---|
| 80%의 일반 작업 | Sonnet (기본값, 빠르고 저렴) |
| 복잡한 아키텍처·리팩터·어려운 디버깅 | Opus (더 깊은 추론, 비용 큼) |
| 계획 + 실행 분리 | /model opusplan — 계획은 Opus, 실행은 Sonnet (자동 전환) |
공식 팁: "Plan with Opus, execute with Sonnet. 플랜은 수백 토큰이지만 잘못된 400줄 diff는 수천 토큰, 두 번씩."
C. CLAUDE.md 관리
공식 권장: "Aim to keep CLAUDE.md under 200 lines by including only essentials. Specialized instructions go into skills (on-demand loading)."
- CLAUDE.md는 항상 로드되므로 무관한 워크플로우 지시가 매번 토큰을 잡아먹음
- PR 리뷰·DB 마이그레이션 같은 특수 워크플로우는 Skill로 이전
D. Extended Thinking / Ultrathink 제어
- Extended thinking 토큰은 output 토큰으로 과금되며, 기본 예산이 수만 토큰
- 단순 작업에는
/effort낮춤 또는/config에서 thinking 비활성화 - 환경변수
MAX_THINKING_TOKENS=8000로 상한 지정
E. Prompt Caching (자동)
Claude Code는 기본적으로 prompt caching을 사용해 반복되는 컨텍스트 비용을 절감합니다. 별도 설정 불필요. 디버깅 시에만 DISABLE_PROMPT_CACHING=1로 끌 수 있습니다.
F. Server-Side Compaction (2026 공식 beta)
Claude Opus 4.7 / Opus 4.6 / Sonnet 4.6에서 서버 측 자동 압축이 beta로 제공됩니다. 긴 대화에서 이전 부분을 자동 요약해 컨텍스트 한도 너머까지 대화 지속 가능. /compact의 서버 버전입니다.
G. Team TPM/RPM
조직 단위로 TPM(Token Per Minute)과 RPM(Request Per Minute) 한도를 설정 가능. 200명 조직 기준 사용자당 ~20k TPM, 총 4M TPM 권장.
우회 전략 — "읽기·생각·반복을 다른 곳에서 끝내라"
토큰 절약의 가장 강력한 레버는 Claude Code가 읽을 필요를 줄이는 것입니다. Claude Code는 대화 전체·관련 파일·도구 호출 결과를 매번 다시 읽기 때문에, 입력이 길수록 비용이 기하급수적으로 늘어납니다. 아래는 공식 문서와 커뮤니티에서 검증된 "우회(bypass) 전략" 9가지입니다. 앞선 6.2(공식)는 *"어떻게 줄일까"에 초점을 맞췄다면, 이 섹션은 "애초에 왜 읽게 만들지 말아야 하나"*에 초점을 맞춥니다.
전략 1: 웹에서 기획 → 코드에서 실행
문제: Claude Code는 실행 권한이 있기 때문에 토큰 비용이 비쌉니다. 기획 단계에서 방향을 잘못 잡으면 수천~수만 토큰이 "폐기"됩니다.
우회: 기획·브레인스토밍·구조 설계는 Claude 웹(claude.ai)에서 수행하고, 확정된 사양(.md 파일)만 Claude Code에게 넘깁니다. 공식 블로그도 *"same principle: plan in Chat before spinning up agents or artifacts"*라고 명시합니다.
# 1단계: 웹 Claude에서
"문헌 리뷰 에이전트의 워크플로 차트와 서브에이전트 구조를 짜줘.
각 에이전트 역할·입출력·순서를 명확히, 최종 산출물은 agent-spec.md로."
# 2단계: Claude Code에서
"@agent-spec.md 읽고 이 구조대로 구현해줘. 계획부터 먼저."
왜 효과적인가: 웹 Claude는 저렴하고(구독료 내), 실패해도 부담이 적습니다. Claude Code는 "실행"에만 집중하므로 방향성 혼동으로 인한 토큰 낭비를 원천 차단할 수 있습니다.
전략 2: Opus Plan Mode — 비싼 추론과 저렴한 실행 분리
문제: 기본 Opus 모델은 reasoning·planning·code generation·review에 모두 Opus 토큰을 씁니다. 하지만 실제 코드 작성(60%)은 Sonnet으로 충분합니다.
우회: /model opusplan으로 전환하면 계획은 Opus, 실행은 Sonnet으로 자동 전환됩니다. 모델 전환은 대화 맥락을 지우지 않아 Sonnet도 Opus의 계획을 그대로 보고 실행합니다.
# Claude Code 안에서
/model opusplan
# 이후 요청
"내 Express 앱에 JWT 인증 추가. 기존 사용자 라우트는 있고 인증 미들웨어만 없어.
먼저 구현 계획부터 세우고 승인받은 뒤 실행해줘."
Anthropic 공식 blog post 인용: "Advisor strategy — Opus as senior adviser, Sonnet/Haiku as executor — cuts costs 11% while improving benchmark scores 2%." 즉 비용만 줄이는 게 아니라 품질도 올라갑니다.
전략 3: Subagent로 무거운 읽기 분리
문제: 100개 논문을 분석하거나 대형 코드베이스를 탐색하면 메인 대화 컨텍스트가 몇만 토큰으로 부풀고, 이후 모든 메시지의 비용이 올라갑니다.
우회: 무거운 읽기·탐색은 Subagent에게 맡깁니다. Subagent는 독립 컨텍스트에서 작업하고 결과만 메인에 리턴합니다.
우리 인증 시스템의 토큰 갱신 처리 방식과 재사용 가능한 OAuth 유틸리티가 있는지
subagent를 써서 조사해줘. 메인에는 요약만 리턴.
핵심: 메인 세션에는 subagent가 읽은 수천 줄 코드가 들어오지 않고, "조사 결과 요약 + 파일 경로"만 들어옵니다. 공식 문서가 권장하는 가장 효과적인 패턴입니다.
전략 4: .claudeignore로 아예 못 보게 차단
문제: "프로젝트 살펴봐"라고 하면 Claude가 node_modules, 원자료, 과거 버전, 캐시까지 훑어 수만 토큰을 씁니다.
우회: 프로젝트 루트에 .claudeignore 파일을 두면 Claude Code가 그 경로를 아예 인덱싱하지 않습니다. .gitignore와 같은 문법입니다.
# .claudeignore 예시
# 대용량 데이터
data/raw/
*.csv
*.xlsx
# 사이즈 큰 패키지
node_modules/
.venv/
__pycache__/
# 과거 버전 원고
archive/
drafts/old/
# 캐시
.cache/
.DS_Store
효과: 커뮤니티 측정으로 세션당 15,000 토큰 절감 사례. 설치 한 번으로 이후 모든 세션에 적용됩니다.
전략 5: Skill로 반복 작업을 외부화
문제: *"APA 7th 형식으로 참고문헌 정리해줘"*를 매번 설명하면, 매 세션마다 수백 토큰의 프롬프트가 반복됩니다.
우회: 3회 이상 반복된 작업은 Skill로 만들기. Skill은 on-demand 로딩이므로 기본 컨텍스트에 부담을 주지 않고, 필요할 때만 해당 절차가 자동 주입됩니다.
# Skill 생성
.claude/skills/apa-references/SKILL.md
# 사용
"방금 인용한 논문들을 /apa-references로 정리해줘"
전략 6: 파일은 @경로로 구체 지정 — "뒤져보게 하지 마라"
문제: "이 폴더 보고 분석해줘" → Claude가 여러 파일을 순차 읽으며 각 파일 전체 내용이 컨텍스트에 쌓임.
우회: 파일 경로가 정해져 있다면 @파일경로로 정확히 지정합니다. "찾는 비용"을 0으로 만듭니다.
# ❌ 비쌈
"이 프로젝트에서 인증 관련 코드 찾아서 리팩토링해줘"
# ✅ 저렴
"@src/auth/middleware.js 120~150줄 수정. 토큰 검증 부분만."
Anthropic 공식 문서: "Direct paths eliminate search operations. Search operations consume tokens. The math is simple."
전략 7: 로그·에러 붙여넣기 — 통째로 말고 "에러 전후 10줄"
문제: 디버깅 시 전체 로그를 복붙하면 200줄 × 수 토큰이 매번 컨텍스트에 누적됩니다.
우회: 에러 메시지 ± 전후 10줄만 붙여넣습니다. 스택 트레이스로 충분하며, 그 이전의 정상 출력은 거의 쓸모없습니다.
# ❌ 전체 로그 200줄 복붙
# ✅ 아래 형식
"터미널에서 에러 발생:
─────────
Error: Cannot read property 'x' of undefined
at processData (app.js:145)
at run (app.js:23)
─────────
어디가 문제인지 봐줘."
전략 8: 질문은 구체적으로 — *"다듬어줘"*의 저주를 피하라
문제: "이거 더 좋게 만들어줘" / "다듬어줘" 같은 막연한 프롬프트는 Claude가 전체 컨텍스트를 다시 읽고 무엇을 고칠지 추측하게 만듭니다. 한 번 요청에 수만 토큰이 날아갈 수 있습니다.
우회: 범위를 좁혀 구체적으로 지시.
# ❌ 막연함 → 토큰 폭발
"이 데이터 분석해"
"다듬어줘"
"더 좋게 만들어줘"
# ✅ 구체적 → 저렴
"3열 데이터만 보고, 평균 계산해줘. 코드만 줘, 설명은 필요 없어"
"app.js 145줄 에러 메시지 기반으로 고쳐줘"
"이 문단의 문장 3개만 학술적 어투로 교정. 구조는 유지"
Anthropic 공식 best practices: "Claude performs better when the most important constraint or goal is stated at the beginning of a prompt, not buried at the end."
전략 9: 배치 처리 — 한 번의 재전송에 여러 작업 묶기
문제: 같은 파일을 3번 따로 수정 요청하면, Claude는 매번 전체 컨텍스트를 재전송합니다.
우회: 세 가지 변경을 한 요청에 묶기.
# ❌ 3번 따로 — 컨텍스트 3배
"auth.js 에러 처리 고쳐줘" (→ 1회)
"user.js 타입 힌트 추가" (→ 2회)
"api.js 주석 정리" (→ 3회)
# ✅ 한 번에 묶어서
"auth.js 에러 처리 고치고, user.js 타입 힌트 추가하고, api.js 주석 정리해줘.
세 파일 변경사항을 한 커밋으로."
우회 전략 요약표
| 상황 | 고비용 접근 | 저비용 우회 |
|---|---|---|
| 새 프로젝트 구조 설계 | Claude Code에서 브레인스토밍 | 웹 Claude에서 기획 → Code로 .md 넘기기 |
| 복잡한 구현 | Opus 풀 모드 | /model opusplan — 계획 Opus, 실행 Sonnet |
| 대규모 탐색 | 메인 대화에서 수백 파일 읽기 | Subagent에게 위임, 요약만 받기 |
| 대용량 폴더 자동 훑기 | 매 세션마다 반복 로드 | .claudeignore로 영구 차단 |
| 반복되는 절차 | 매번 같은 프롬프트 타이핑 | Skill로 외부화 |
| 파일 탐색 | "이 프로젝트에서 찾아줘" | @파일경로로 직접 지정 |
| 디버깅 | 전체 로그 복붙 | 에러 전후 10줄만 |
| 편집 요청 | "다듬어줘" | 구체적 범위 + 제약 |
| 연속 수정 | 3번 따로 요청 | 한 요청에 배치 묶기 |
실전 팁 — 연구자 버전 18選
컨텍스트 관리 (가장 중요)
/clear주저 말고 — 새 논문 분석으로 넘어갈 때, 새 Skill 테스트 시작할 때 무조건 clear./compact커스텀 지시 —/compact 출처 URL과 저자명만 보존해줘처럼 초점 지정.- 한 세션 = 한 태스크 원칙 — Git 커밋처럼 생각. 여러 주제 섞지 않기.
- 주기적 리프레시 (60분+ 세션) — 30분마다
"방금까지 한 작업의 현재 상태를 한 문단으로 요약하고, 확정된 패턴과 남은 TODO를 리스트업해줘".
CLAUDE.md 다이어트
- 5,000 토큰 상한 — 5k 넘으면
docs/폴더로 이전. 예:docs/mk2_notes.md. - "이 줄 지우면 Claude가 실수할까?" 테스트 — "예"가 아니면 제거.
- 워크플로우 지시는 Skill로 — PR 리뷰 절차, 논문 투고 체크리스트 등은 CLAUDE.md가 아니라
.claude/skills/pr-review/SKILL.md.
파일·폴더 참조
@파일.pdf구체 지정 — "이 폴더 보고"보다 "@paper.pdf 섹션 3만 보고"가 훨씬 저렴..claudeignore설정 — 대용량 raw data, node_modules, 과거 버전 폴더는 인덱싱에서 제외.- Plan Mode 먼저 —
Shift+Tab두 번 또는/plan. 3개 이상 파일 건드릴 작업은 무조건 플랜 먼저.
출력 제어
- 설명 생략 지시 — "설명 없이 결과만", "최종 답만 줘" — Claude 기본값은 설명 동반.
- 로그 트리밍 — 전체 로그 말고 에러 전후 10줄만. 테스트 실패도 특정 테스트 + 에러만.
- 검색 범위 좁히기 —
find src/auth/+ 특정 확장자. 와일드카드로 전체 레포 훑지 않기.
Skill·서브에이전트 활용
- 무거운 컨텍스트는 Subagent로 — 100개 논문 전수 분석은 subagent 안에서. 메인은 지시·검토만.
- Skill로 반복 외부화 — 3회 이상 반복한 작업은 Skill로. CLAUDE.md는 "상시", Skill은 "필요시".
- context-mode / skill-activation hooks — 프롬프트 의도 분석해서 관련 Skill만 로드하는 패턴. 커뮤니티 패키지(ClaudeFast 등)로 15,000 토큰/세션 절감 사례 보고.
모니터링
/cost를 습관처럼 — 상태바에 상시 표시 설정. 또는claude-hud플러그인 설치.- 주간 리뷰 —
claude.ai/settings/usage에서 주간 총량 확인. 40~70% 절감이 일반적 개선폭.
한국 연구자를 위한 실전 팁 (워크숍 현장 경험 기반)
| 팁 | 설명 |
|---|---|
| "키워드 그룹"으로 CLAUDE.md 분리 | 한 프로젝트에 여러 연구 DNA가 섞이면 → CLAUDE.md (공통) + docs/slr_mode.md + docs/qualitative_mode.md로 분리하고, 세션 시작 시 해당 모드만 @docs/slr_mode.md로 로드 |
| HWP/HWPX는 MCP로 한 번에 변환 | kordoc MCP로 HWPX → Markdown 변환 후 작업. 반복 파싱 토큰 절감 |
| kordoc + Zotero MCP 조합 | 국내 논문은 RISS/DBpia 수동 다운 → Zotero로 통합. MCP가 로컬 PDF만 읽으므로 전문 접근 가능 |
| ultrathink 신중 사용 | 측정모델 validity 검토, 논리 허점 찾기처럼 진짜 고난도 작업에만. 단순 요약·정리에는 낭비 |
| Plan Mode로 돈 아끼기 | 복잡한 분석 전 /plan 먼저 — 잘못된 방향으로 10분 분석 돌린 후 폐기하는 것보다 훨씬 저렴 |
/loop는 세션 열려 있을 때만 | 24/7 운영이 필요하면 Cowork Scheduled Task 또는 서버 cron |
| KCI 논문은 직접 다운 → 로컬 폴더 | 유료 저널 MCP 접근 불가. 로컬 PDF 폴더 + Zotero MCP로 우회 |
토큰 절감 워크플로 체크리스트 (세션 시작 전)
- 이번 세션의 작업 1개가 명확한가?
- CLAUDE.md가 200~500줄을 넘기지 않는가?
- 이 작업에 맞는 Skill이 이미 있거나 만들 필요가 없는가?
.claudeignore에 대용량 폴더가 배제되어 있는가?- 내가 참조할 파일을
@파일명으로 구체 지정할 수 있는가? - 복잡한 작업이면
/plan또는/model opusplan으로 시작할 준비가 되었는가?
10.5 ⚖️ AI 연구 윤리 & 사용 공시
국내외 주요 학술지가 AI 도구 사용 공시를 의무화하고 있습니다. 투고 전 반드시 확인하세요.
| 출판사/저널 | AI 공시 정책 |
|---|---|
| Nature 계열 | Methods 섹션에 AI 사용 방법 기술 필수. AI는 저자 불가. |
| Elsevier | Author Statement에 AI 사용 명시 필수. 최종 책임은 저자. |
| Springer/Wiley | AI 생성 콘텐츠 공시 필수, 저자 자격 불인정. |
| 국내 KCI 등재지 | 학술지별 상이. 투고 전 해당 저널 정책 직접 확인 필수. |
During the preparation of this work, the author(s) used Claude (Anthropic)
to assist with literature organization and draft preparation.
After using this tool, the author(s) reviewed and edited the content as needed
and take(s) full responsibility for the content of the publication.
이 연구의 준비 과정에서 저자는 Claude (Anthropic)를 활용하여
문헌 정리 및 초안 작성에 보조적으로 사용하였습니다.
이 도구 사용 후 저자가 내용을 검토·수정하였으며,
출판 내용에 대한 최종 책임은 저자에게 있습니다.
투고 전 AI 윤리 체크리스트
| 항목 | 확인 |
|---|---|
| AI가 인용한 모든 논문을 원문에서 직접 확인했다 | ☐ |
| AI가 생성한 통계·수치를 원 데이터로 검증했다 | ☐ |
| 투고 저널의 AI 사용 정책을 확인했다 | ☐ |
| Author Contributions에 AI 사용 사실을 명시했다 | ☐ |
| AI 생성 텍스트를 그대로 제출하지 않고 직접 검토했다 | ☐ |
💬 11. 프롬프트 모음 — 복사해서 바로 사용
[대괄호] 안의 내용만 자신의 상황에 맞게 바꾸세요.
📚 문헌 분석
이 폴더의 PDF 논문들을 모두 읽고, 각 논문의
제목/저자/연도/연구목적/방법론/주요발견/한계를
정리한 문헌분석표를 Excel로 만들어줘.
시트 이름은 '문헌분석'으로 해줘.
웹에서 [AI 거버넌스] 관련 최신 학술 논문과 정책 보고서를
검색해줘. 2024년 이후 발표된 것만, 최소 10건 이상.
각각 제목, 저자, 발표 기관, 핵심 주장 1-2문장, 출처 URL을
표로 정리해줘.
@[논문파일명.pdf] 이 논문을 읽고 다음을 정리해줘:
1) 연구 질문과 가설
2) 방법론의 강점과 약점
3) 결론의 타당성 (근거가 충분한가?)
4) 이 연구의 한계 3가지
5) 후속 연구 제안 2가지
📊 데이터 분석
@[데이터파일.csv] 이 데이터를 분석해줘:
1) 기본 통계량 (평균, 중앙값, 표준편차)
2) [연도]별 추세 분석
3) [국가]별 비교
4) 주요 인사이트 3-5개
5) 결과를 차트로 저장하고, 보고서를 Word로 만들어줘
@[설문결과.xlsx] 이 설문 데이터를 분석해줘:
- 응답자 기본 통계 (성별, 연령대, 직군)
- 주요 문항별 빈도 분석과 교차 분석
- 리커트 척도 문항은 평균과 표준편차
- 핵심 발견 5가지 요약
- 분석 보고서를 Word로 만들어줘
📝 보고서 & 문서
[AI 반도체 수출규제 현황]을 주제로 정책 브리프를 작성해줘:
- 분량: 2-3페이지
- 구조: 배경→현황→주요국 동향(미국/EU/일본/한국)→시사점
- 모든 주장에 출처(저자, 연도, 기관명) 표기
- APA 스타일 참고문헌 목록 포함
- Word 파일로 저장
[미국, EU, 한국]의 [AI 안전 규제]를 비교해줘:
- 비교 항목: 규제 명칭, 시행 시기, 적용 대상, 주요 의무, 벌칙
- 비교표 포함, 각국 1문단씩 요약
- 한국에 대한 시사점 3가지 도출
- Word로 저장
🗂️ 자료 관리
이 폴더의 파일들을 분석해서:
1) 파일 유형별 현황 요약
2) 연도별/주제별로 하위 폴더를 만들어 분류
3) 전체 자료 목록 인덱스를 Excel로 생성
실행 전에 계획을 먼저 보여줘
@[회의녹취.txt] 이 회의 내용을 구조화된 회의록으로 만들어줘:
- 회의 일시/참석자 (텍스트에서 추론)
- 안건별 논의 내용 요약
- 결정사항 목록
- 액션아이템 (담당자, 기한 포함)
- Word 파일로 저장
🔬 연구 계획
[디지털 전환이 공공서비스 품질에 미치는 영향]을 주제로
연구 계획서 초안을 만들어줘:
- 연구 배경 및 필요성 (선행연구 포함)
- 연구 목적과 연구 질문 3개
- 연구 방법론 (데이터 수집, 분석 방법)
- 기대 효과
- 참고문헌 10건 이상 (실제 존재하는 논문만)
- Word로 저장
@[논문.pdf] 이 논문으로 30분 세미나를 준비해줘:
1) 3분 요약 (비전문가도 이해 가능하게)
2) 슬라이드 구성안 (10장 내외)
3) 각 슬라이드의 핵심 메시지 1문장
4) 청중에게 던질 토론 질문 5개
5) 비판적 논점 3개
"출처를 더 상세하게", "표 형식으로 바꿔줘", "분량을 절반으로", "더 비판적으로 분석해줘" 같은 후속 피드백으로 품질을 높이세요.
📂 워크숍 카탈로그
워크숍 참여자들이 직접 기획한 재사용 가능한 에이전트 설계서입니다. 각 카드에는 CLAUDE.md 폴더 구조와 핵심 Skill 명령어가 공개되어 있어, 연구 상황에 맞게 복제·각색할 수 있습니다.
💡 카드를 클릭하면 펼쳐져 상세를 볼 수 있습니다. 카테고리 필터와 검색은 함께 작동합니다.
설문 데이터 자동 분석기
프로젝트 목적
리커트 척도, 객관식, 주관식이 혼합된 설문 데이터를 자동 정리하고 기술통계, 교차분석, 시각화 리포트를 한 번에 생성합니다.
CLAUDE.md 구조
📁 survey-analyzer/
├── CLAUDE.md
├── 📁 data/
│ └── survey_raw.xlsx
├── 📁 output/
│ ├── descriptive_stats.xlsx
│ ├── crosstab_results.xlsx
│ └── charts/
└── 📁 skills/
├── clean-survey.md
└── analyze-survey.md
핵심 Skill
/clean— 결측치 처리, 역코딩, 척도 변환/stats— 기술통계 + 교차분석 수행/chart— 항목별 차트 자동 생성
인터뷰 데이터 코딩 어시스턴트
프로젝트 목적
NVivo 없이도 인터뷰 전사본에서 주제를 추출하고, 코드북을 생성하며, 인용문을 자동 정리합니다. 근거이론(Grounded Theory) 접근을 지원합니다.
CLAUDE.md 구조
📁 interview-coder/
├── CLAUDE.md
├── 📁 transcripts/
│ ├── interview_01.txt
│ ├── interview_02.txt
│ └── interview_03.txt
├── 📁 output/
│ ├── codebook.xlsx
│ ├── theme_matrix.xlsx
│ └── quotation_bank.md
└── 📁 skills/
├── open-coding.md
└── axial-coding.md
핵심 Skill
/open-code— 전사본에서 개방 코딩 수행/axial-code— 코드 간 관계를 범주화/quotes— 주제별 대표 인용문 추출
논문 초안 생성기
프로젝트 목적
분석 결과, 연구 노트, 참고문헌 목록을 입력하면 서론-방법-결과-논의 구조에 맞춰 논문 초안을 생성합니다. 학술 어투와 APA 스타일을 자동 적용합니다.
CLAUDE.md 구조
📁 paper-drafter/
├── CLAUDE.md
├── 📁 inputs/
│ ├── research_notes.md
│ ├── analysis_results.xlsx
│ └── references.bib
├── 📁 output/
│ └── draft_paper.docx
└── 📁 skills/
├── draft-section.md
└── format-apa.md
핵심 Skill
/draft— 지정 섹션(서론/방법/결과/논의) 초안 생성/apa— APA 7판 스타일 자동 포맷팅/refcheck— 본문 인용과 참고문헌 교차 검증
연구 카드뉴스 작성기
프로젝트 목적
복잡한 연구 결과를 8-10장의 카드뉴스로 변환합니다. 핵심 메시지 추출, 비유 생성, 시각적 구성까지 자동으로 처리하며, SNS 공유용 HTML 파일을 출력합니다.
CLAUDE.md 구조
📁 cardnews-maker/
├── CLAUDE.md
├── 📁 source/
│ └── 연구결과_요약.md
├── 📁 output/
│ ├── cardnews.html
│ └── cardnews_slides/
└── 📁 skills/
├── extract-key-message.md
└── generate-cards.md
핵심 Skill
/extract— 논문에서 핵심 메시지 8-10개 추출/cards— 메시지를 카드뉴스 HTML로 변환/simplify— 전문용어를 일반인 언어로 치환
체계적 문헌고찰 보조 도구
프로젝트 목적
수백 편의 검색 결과에서 포함/배제 기준을 적용해 1차 스크리닝을 자동화하고, 최종 선정 논문의 데이터 추출표를 생성합니다.
CLAUDE.md 구조
📁 systematic-review-helper/
├── CLAUDE.md
├── 📁 search_results/
│ ├── pubmed_export.csv
│ └── scopus_export.csv
├── 📁 papers/
│ └── (선정된 PDF들)
├── 📁 output/
│ ├── screening_log.xlsx
│ ├── extraction_table.xlsx
│ └── prisma_flow.md
└── 📁 skills/
├── screen.md
└── extract.md
핵심 Skill
/screen— 제목·초록 기반 포함/배제 판정/extract— 선정 논문에서 데이터 추출표 생성/prisma— PRISMA 흐름도 자동 생성
세미나 발표자료 생성기
프로젝트 목적
논문 PDF를 읽고 30분 세미나용 발표자료를 자동 설계합니다. 슬라이드별 핵심 메시지, 발표 스크립트, 청중 토론 질문을 함께 생성합니다.
CLAUDE.md 구조
📁 seminar-prep/
├── CLAUDE.md
├── 📁 papers/
│ └── target_paper.pdf
├── 📁 output/
│ ├── slide_outline.md
│ ├── speaker_notes.md
│ └── discussion_questions.md
└── 📁 skills/
├── summarize-paper.md
└── build-slides.md
핵심 Skill
/outline— 논문 기반 슬라이드 구성안 생성/script— 슬라이드별 발표 스크립트 작성/discuss— 비판적 토론 질문 5개 생성
선행연구 자동 분석기
프로젝트 목적
영문·국문 논문 PDF를 업로드하면 저자·연도·연구방법·변인·결과 등 21개 항목을 한국어로 추출해 엑셀 요약표로 만들고, 논문에 바로 붙여넣을 수 있는 문헌고찰 문단도 자동 생성합니다.
CLAUDE.md 구조
📁 research-analyzer/
├── CLAUDE.md
├── 📁 papers/
│ └── (분석할 PDF 논문들)
├── 📁 output/
│ ├── 선행연구요약표_YYYYMMDD.xlsx
│ └── 문헌고찰_문단.txt
└── 📁 agents/
├── analysis_agent.js
└── paragraph_agent.js
핵심 Skill
/analyze— PDF에서 21개 항목 JSON 추출/paragraph— JSON → 학술 문헌고찰 문단 생성/export— 전체 결과 xlsx + txt 파일 저장
논문 PPTX 자동 변환기
프로젝트 목적
PDF 논문 파일을 입력하면 메타데이터 추출 → 연구모델 이미지 자동 감지(Vision) → 사용자 확인(HITL) → PPTX 생성까지 자동 처리합니다. 논문 읽기 세미나나 저널 클럽 준비 시간을 대폭 단축합니다.
CLAUDE.md 구조
📁 paper-to-pptx/
├── CLAUDE.md
├── 📁 agents/
│ ├── orchestrator.py
│ ├── metadata_agent.py
│ ├── model_finder.py
│ └── pptx_builder.py
├── 📁 output/
│ └── output.pptx
└── requirements.txt
핵심 Skill
/extract— 논문 제목·저자·초록 메타데이터 추출/find-model— Vision으로 연구모델 이미지 페이지 자동 감지/build-pptx— 메타데이터 + 이미지 → .pptx 파일 생성
논문 다중 DB 검색·분석기
프로젝트 목적
PubMed·Semantic Scholar·arXiv를 동시에 검색해 중복 제거 후 상위 20편을 선별하고, 5줄 요약·연구방법론·주요 결과·APA 참고문헌을 담은 한국어 마크다운 보고서를 자동 생성합니다.
CLAUDE.md 구조
📁 literature-agent/
├── CLAUDE.md
├── 📁 agents/
│ ├── search_agent.py
│ ├── classify_agent.py
│ ├── summary_agent.py
│ └── reference_agent.py
├── 📁 output/
│ └── literature_report.md
└── requirements.txt
핵심 Skill
/search— 3개 DB 병렬 검색 + 중복 제거/summarize— 논문별 5줄 요약 + 연구방법론 구조화/references— APA 7판 참고문헌 자동 생성
연구갭 분석 에이전트
프로젝트 목적
연구질문을 자연어로 입력하면 3개 DB에서 유사 논문 20편을 수집하고, 방법론·연구대상·이론·실천적 측면에서 연구갭을 분석한 뒤 추천 연구방법론과 세부 연구질문(RQ) 3~5개를 Notion 페이지로 자동 저장합니다.
CLAUDE.md 구조
📁 research-gap-finder/
├── CLAUDE.md
├── 📁 agents/
│ ├── keyword_agent.py
│ ├── search/ (SS·arXiv·PubMed)
│ ├── gap_agent.py
│ └── notion_agent.py
├── 📁 prompts/
│ └── gap.txt
└── requirements.txt
핵심 Skill
/keywords— 연구질문 → DB별 최적화 검색어 추출/gap-analysis— 방법론·대상·이론·실천적 갭 4가지 분석/propose— 추천 방법론 + 세부 연구질문 RQ 생성
파일 자동 정렬 에이전트
프로젝트 목적
연구 폴더에 쌓인 PDF·데이터·코드·이미지 파일들을 Claude API가 파일명을 읽고 카테고리를 판단해 자동으로 분류합니다. 이동 계획을 미리 보여주고 사용자 승인 후 실행하며, 중복 파일은 _duplicates/에 격리합니다.
CLAUDE.md 구조
📁 file-organizer/
├── CLAUDE.md
├── 📁 agents/
│ ├── scanner.py
│ ├── classifier.py
│ ├── executor.py
│ └── reporter.py
├── 📁 output/
│ └── summary.md
└── requirements.txt
핵심 Skill
/scan— 폴더 탐색 + 파일 메타데이터 수집/classify— Claude API로 파일명 기반 카테고리 분류/organize— 계획 미리보기 → 승인 → 파일 이동 실행
학위논문 확장 플랜
프로젝트 목적
프로포절 DOCX/PDF와 참고 논문 폴더를 입력하면 섹션 구조 파악 → 참고문헌 목록 정리 → 섹션별 살 붙이기 → 전체 흐름 검토 → References 완성의 6단계 워크플로우로 학위논문을 완성합니다.
CLAUDE.md 구조
📁 thesis-writer/
├── CLAUDE.md
├── 📁 proposal/
│ └── proposal.pdf
├── 📁 papers/
│ └── (참고 논문 PDF들)
├── 📁 output/
│ └── thesis_final.md
└── 📁 skills/
├── analyze-proposal.md
└── expand-section.md
핵심 Skill
/analyze-proposal— 섹션 구조 파악 + 확장 방향 분석/expand-section— 선택 섹션 Literature 보강 + APA citation 삽입/references— 전체 APA 참고문헌 목록 최종 정리
SCIE 저널 투고 자동화 에이전트
프로젝트 목적
논문 분야·키워드를 자동 분석하고 Web of Science·Scimago 등에서 SCIE 저널 Top 5를 탐색합니다. 선택한 저널의 Author Guideline을 자동으로 파싱하고, 단어 수 제한·참고문헌 스타일·섹션 순서에 맞게 논문을 자동 포매팅합니다.
CLAUDE.md 구조
📁 paper-submission-agent/
├── CLAUDE.md
├── 📁 agents/
│ ├── analyzer.md
│ ├── journal_scout.md
│ ├── guideline_parser.md
│ └── formatter.md
├── 📁 input/
│ └── paper_draft.docx
└── 📁 output/
├── journal_recommendations.md
└── paper_formatted.docx
핵심 Skill
/scout— 분야·키워드 기반 SCIE 저널 Top 5 탐색 (IF·OA·APC)/parse-guideline— Author Guideline 자동 파싱 및 규칙 추출/format— 저널 규칙에 맞춰 논문 자동 포매팅 + diff 리포트
회의록 기반 문서 자동 갱신 에이전트
프로젝트 목적
회의 후 반복적인 수작업(회의 내용 정리 → 기존 자료 업데이트)을 자동화합니다. 회의록에서 요구사항·합의사항·키워드를 추출하고, 웹 리서치를 병행해 PPT·Word·Excel을 자동 업데이트합니다. 업데이트된 항목에는 [업데이트됨] 태그가 자동으로 붙습니다.
CLAUDE.md 구조
📁 meeting-updater/
├── CLAUDE.md
├── 📁 input/
│ ├── meeting_minutes.docx
│ └── existing_draft.pptx
├── 📁 output/
│ └── updated_draft.pptx
└── 📁 agents/
├── analyzer.py
├── researcher.py
└── draft_generator.py
핵심 Skill
/analyze— 회의록에서 요구사항·합의사항·키워드 JSON 추출/research— 키워드 기반 웹 검색 + 참고자료 요약 및 출처 정리/update-draft— 기존 파일에 합의사항 반영 + [업데이트됨] 태그 삽입
SEO 블로그 자동 생성기
프로젝트 목적
키워드를 입력하면 Tavily MCP로 최신 트렌드와 관련 검색어를 수집하고, 공개 이미지를 탐색해 출처를 자동 명시합니다. H2/H3 구조의 SEO 최적화 블로그 본문 1,000자를 작성하고 WordPress에 바로 붙여넣을 수 있는 HTML로 출력합니다.
CLAUDE.md 구조
📁 blog-agent/
├── CLAUDE.md
├── 📁 agents/
│ ├── keyword_agent.py
│ ├── image_agent.py
│ ├── writer_agent.py
│ └── formatter_agent.py
├── 📁 output/
│ └── [날짜_키워드].html
└── requirements.txt
핵심 Skill
/keywords— 관련 검색어 10개 + 최신 트렌드 3줄 요약 (Tavily MCP)/write— SEO 최적화 블로그 본문 생성 (키워드 density 2~3%)/format— Markdown → WordPress HTML 변환 + 이미지·출처 embed
문서 자동 채우기 에이전트
프로젝트 목적
사업계획서·신청서 등 반복적인 행정 문서의 빈 칸을 자동으로 채웁니다. company_profile.json에 기관 정보를 한 번 저장하면, 이후 어떤 문서든 정규식 패턴으로 빈 필드를 감지하고 자동 입력합니다. HWPX(한글) 파일도 지원합니다.
CLAUDE.md 구조
📁 auto-fill-agent/
├── CLAUDE.md
├── company_profile.json
├── 📁 agents/
│ ├── parser.py
│ ├── detector.py
│ ├── writer.py
│ └── validator.py
└── 📁 output/
└── 완성_문서.docx
핵심 Skill
/detect— 문서에서 빈 필드 자동 감지 (정규식 + Claude API)/fill— company_profile.json 기반 정보 자동 주입/report— 완성률 계산 + 미완성 항목 목록 출력
자동 채점 및 피드백 생성기
프로젝트 목적
./과제/ 폴더에 PDF·docx 파일을 넣고 rubric.csv에 채점 기준을 정의하면, Claude API가 항목별 점수와 근거를 자동 생성합니다. 검증 실패 시 자동 재채점(최대 2회)하고, 요약 시트와 파일별 상세 시트로 분리된 Excel 결과를 출력합니다.
CLAUDE.md 구조
📁 grading-agent/
├── CLAUDE.md
├── rubric.csv
├── grading_agent.py
├── 📁 과제/
│ ├── 홍길동_과제1.pdf
│ └── 김철수_과제1.docx
└── 채점결과.xlsx
핵심 Skill
/grade— 전체 과제 폴더 자동 채점 (항목별 점수 + 근거)/feedback— 고정 양식 4~5문장 한줄평 생성 (격식체)/export— 요약 시트 + 파일별 상세 시트 Excel 저장
하루 성찰 코칭 웹앱
프로젝트 목적
하루 일기를 입력하면 3개의 AI 에이전트가 순차적으로 분석합니다. Extractor가 감사 포인트 2~4개를 추출하고, Analyzer가 감정 키워드와 패턴을 분석하며, Coach가 따뜻한 성찰 질문 2개를 생성합니다. FastAPI 백엔드와 HTML/JS 프론트엔드로 1시간 안에 완성 가능합니다.
CLAUDE.md 구조
📁 gratitude-coach/
├── CLAUDE.md
├── main.py
├── 📁 agents/
│ ├── extractor.py
│ ├── analyzer.py
│ └── coach.py
├── 📁 journals/
│ └── 2026-03-17.md
└── 📁 static/
└── index.html
핵심 Skill
/extract— 일기에서 감사 포인트 2~4개 추출/analyze— 감정 키워드 + 행동-감정 패턴 분석/coach— 따뜻한 성찰 질문 2개 생성
다중 소속 프로젝트 관리 웹앱
프로젝트 목적
여러 소속의 업무를 한 곳에서 관리하는 개인용 웹앱입니다. 자유 텍스트나 카카오톡 회의록을 붙여넣으면 Claude API가 소속·프로젝트·마감일·우선순위를 자동 태깅합니다. 7일 타임라인을 상단에 항시 표시하고, 매일 아침 텔레그램으로 오늘 할 일 브리핑을 자동 발송합니다.
CLAUDE.md 구조
📁 pm-agent/
├── CLAUDE.md
├── 📁 agents/
│ ├── tagger.py
│ ├── timeline.py
│ └── telegram_bot.py
├── 📁 data/
│ └── tasks.db
└── 📁 web/
└── dashboard.html
핵심 Skill
/tag— 자연어·회의록에서 소속·프로젝트·마감일·우선순위 태깅/timeline— 7일 타임라인 대시보드 생성/brief— 오늘 할 일 텔레그램 데일리 브리핑 발송
자연어 일정 관리 AI 조교
프로젝트 목적
"내일 오후 2시 논문 세미나 추가해줘" 같은 자연어를 입력하면 Claude API가 날짜·시간·카테고리를 파싱해 JSON 파일에 저장합니다. node-cron이 5분마다 스캔하여 30분 전 터미널 알림과 이메일을 자동 발송하며, D-day 카운트다운도 확인할 수 있습니다.
CLAUDE.md 구조
📁 life-scheduler/
├── CLAUDE.md
├── main.js
├── 📁 agents/
│ ├── scheduler.js
│ ├── notifier.js
│ └── viewer.js
├── 📁 data/
│ └── schedules.json
└── .env
핵심 Skill
/add— 자연어 → 날짜·시간·카테고리 파싱 후 저장/view— 오늘·이번주·카테고리별 일정 조회 + D-day 표시/notify— 5분 간격 자동 스캔 + 마감 임박 이메일 알림
AI 리서치 보고서 자동 생성기
프로젝트 목적
연구 주제를 입력하면 AI가 세부 체크리스트로 분해하고 각 서브토픽을 병렬로 검색·분석합니다. "보스" 페르소나 에이전트가 빠진 부분을 지적해 추가 조사를 지시하는 피드백 루프를 돌리고, 서브토픽 보고서를 합쳐 최종 종합 보고서를 생성합니다.
CLAUDE.md 구조
📁 ai-researcher/
├── CLAUDE.md
├── 📁 agents/
│ ├── orchestrator.py
│ ├── researcher.py
│ ├── critic.py
│ └── writer.py
├── 📁 output/
│ └── final_report.md
└── .env
핵심 Skill
/decompose— 주제를 독립적 서브토픽 체크리스트로 분해/research— 서브토픽별 병렬 웹 검색 + 분석/synthesize— 비평 루프 거친 후 최종 종합 보고서 생성
논문 20개 DB 통합 검색기
프로젝트 목적
API 키 없이도 arXiv, PubMed, bioRxiv, Semantic Scholar, Google Scholar 등 20개 이상의 소스를 한 번에 검색합니다. 오픈액세스 논문은 PDF를 자동 다운로드하고, DOI 매칭과 제목 유사도로 중복을 제거하며 관련성·최신성·신뢰도 기준으로 랭킹합니다.
CLAUDE.md 구조
📁 paper-search/
├── CLAUDE.md
├── 📁 sources/
│ ├── arxiv_client.py
│ ├── pubmed_client.py
│ └── semantic_scholar.py
├── 📁 output/
│ ├── results.json
│ └── report.html
└── requirements.txt
핵심 Skill
/search— 20개 DB 병렬 검색 + DOI 기준 중복 제거/rank— 관련성·최신성·인용수 가중 랭킹/download— 오픈액세스 PDF 자동 다운로드
멀티에이전트 문헌 심사 자동화
프로젝트 목적
체계적 문헌고찰에서 가장 시간이 걸리는 스크리닝 단계를 자동화합니다. 기존 PRISMA 도구와 달리, 여러 에이전트가 병렬·순차 방식으로 다중 라운드 심사를 진행하고 각 결정에 대한 점수와 추론을 투명하게 제공합니다. Zotero RIS 파일과 호환됩니다.
CLAUDE.md 구조
📁 latte-review/
├── CLAUDE.md
├── 📁 reviewers/
│ ├── reviewer_1.py
│ ├── reviewer_2.py
│ └── adjudicator.py
├── 📁 input/
│ └── search_results.ris
└── 📁 output/
├── included.ris
└── screening_log.csv
핵심 Skill
/screen— 복수 에이전트 병렬 심사 + 불일치 시 조정자 중재/score— 포함/배제 점수 + 근거 투명 출력/export— 최종 선정 목록 RIS + 스크리닝 로그 CSV 저장
가상 동료심사 시뮬레이터
프로젝트 목적
실제 저널 투고 전 예상 리뷰를 미리 받아보는 도구입니다. 에디터(편집인) 관점, 방법론 전문가, 분야 전문가, 통계 검토자, '악마의 변호인' 역할 등 5개 페르소나가 각각 독립적인 리뷰를 작성하고, 최종 종합 의견과 수정 우선순위를 제시합니다.
CLAUDE.md 구조
📁 peer-review-sim/
├── CLAUDE.md
├── 📁 reviewers/
│ ├── editor.md
│ ├── methodologist.md
│ ├── domain_expert.md
│ ├── statistician.md
│ └── devils_advocate.md
└── 📁 output/
└── review_report.md
핵심 Skill
/review— 5개 페르소나 병렬 리뷰 생성/prioritize— 공통 지적 사항 수정 우선순위 정리/respond— 리뷰 코멘트에 대한 저자 답변 초안 생성
연구비 신청서 자동 생성기
프로젝트 목적
연구 주제와 기존 논문들을 입력하면 연구의 필요성·목표·방법론·기대효과 섹션을 자동으로 작성합니다. 실시간 문헌 검색으로 최신 선행연구를 근거로 활용하고, NRF·BK21·한국연구재단 등 주요 공모 양식에 맞게 포맷을 자동 조정합니다.
CLAUDE.md 구조
📁 grant-writer/
├── CLAUDE.md
├── 📁 templates/
│ ├── nrf_template.md
│ └── bk21_template.md
├── 📁 input/
│ └── research_summary.md
└── 📁 output/
└── grant_proposal.docx
핵심 Skill
/literature— 연구 주제 관련 최신 선행연구 자동 수집·요약/draft-section— 연구 필요성·목표·방법론·기대효과 각 섹션 작성/format— 선택한 공모 양식에 맞게 분량·구조 자동 조정
Obsidian 논문 지식베이스 자동화
프로젝트 목적
Zotero에서 논문을 가져와 핵심 주장·방법론·연구갭·인용 가능한 문장을 추출하고, Obsidian 노트로 자동 변환합니다. 각 논문 노트에 [[논문명]] 형식의 위키링크가 자동 생성되어 논문 간 개념 연결 지도가 만들어집니다.
CLAUDE.md 구조
📁 obsidian-scholar/
├── CLAUDE.md
├── 📁 agents/
│ ├── extractor.py
│ └── linker.py
├── 📁 vault/
│ ├── 논문A.md
│ └── 논문B.md
└── requirements.txt
핵심 Skill
/extract— 논문에서 핵심 주장·방법론·인용문 구조화 추출/note— Obsidian 마크다운 노트 자동 생성 (태그·위키링크 포함)/link— 논문 간 공통 개념 감지 → 자동 연결 관계 생성
서베이 논문 자동 생성기
프로젝트 목적
특정 주제의 서베이 논문(리뷰 논문)을 자동 생성합니다. frontier 논문 탐색 → 관련 논문 서베이 → 개별 논문 deep dive → 코드/실험 분석 → 결과 합성 → 최종 보고서 작성의 6단계를 순차적으로 처리합니다. BibTeX 참고문헌이 자동 생성됩니다.
CLAUDE.md 구조
📁 survey-writer/
├── CLAUDE.md
├── 📁 pipeline/
│ ├── frontier_search.py
│ ├── deep_dive.py
│ └── synthesizer.py
├── 📁 output/
│ ├── survey_draft.md
│ └── references.bib
└── requirements.txt
핵심 Skill
/survey— frontier 논문 탐색 + 관련 논문 수집 (6단계 파이프라인)/compare— 논문 간 방법론·결과 비교표 자동 생성/draft-survey— 서베이 논문 초안 + BibTeX 참고문헌 생성
자율 연구 개선 루프
프로젝트 목적
연구 목표와 초기 가설을 주면 Claude Code가 수정(Modify) → 검증(Verify) → 유지/폐기(Keep/Discard) → 반복(Repeat) 루프를 돌며 스스로 개선합니다. 잠자는 동안 연구가 자동으로 진행되고, 아침에 개선된 결과를 확인할 수 있습니다.
CLAUDE.md 구조
📁 autoresearch/
├── CLAUDE.md
├── goal.md
├── hypothesis.md
├── 📁 iterations/
│ ├── iter_001.md
│ └── iter_002.md
└── 📁 output/
└── best_result.md
핵심 Skill
/init— 연구 목표·가설·평가 기준 설정/loop— 수정→검증→유지/폐기 자율 반복 루프 실행/report— 최고 결과 및 반복 이력 보고서 생성
데이터 시각화 보고서 자동 생성기
프로젝트 목적
데이터 파일을 올리고 원하는 분석 주제를 입력하면 리드 에이전트가 분석·시각화·글쓰기 세 서브에이전트에게 역할을 분배합니다. 각 에이전트가 병렬로 작업하고 결과를 통합해 차트와 해석이 포함된 PDF 보고서를 자동 생성합니다.
CLAUDE.md 구조
📁 report-generator/
├── CLAUDE.md
├── 📁 agents/
│ ├── lead_agent.py
│ ├── data_analyst.py
│ ├── visualizer.py
│ └── writer.py
├── 📁 data/
│ └── input.csv
└── 📁 output/
├── charts/
└── report.pdf
핵심 Skill
/analyze— 데이터 패턴·이상치·주요 지표 자동 분석/visualize— 분석 결과 차트 자동 생성 (PNG)/report— 차트 + 해석 포함 최종 PDF 보고서 자동 생성
연구 트렌드 & 주제 발굴 에이전트
프로젝트 목적
연구 분야를 입력하면 최근 3년간 출판 트렌드·주요 키워드·방법론 변화를 분석합니다. 기존 연구들이 다루지 않은 빈 영역을 찾아내고, 실현 가능성·참신성·임팩트를 고려한 구체적인 연구 주제 5개를 제안합니다.
CLAUDE.md 구조
📁 topic-finder/
├── CLAUDE.md
├── 📁 agents/
│ ├── trend_analyzer.py
│ ├── gap_finder.py
│ └── topic_proposer.py
└── 📁 output/
└── research_topics.md
핵심 Skill
/trends— 최근 3년 출판 트렌드·키워드·방법론 변화 분석/gaps— 기존 연구가 다루지 않은 빈 영역 식별/propose— 실현 가능성·참신성·임팩트 기준 연구 주제 5개 제안
실험 데이터 이상치 탐지 에이전트
프로젝트 목적
실험 장비에서 수집된 대량의 수치 데이터에서 Z-score, IQR, DBSCAN 등 다양한 방법으로 이상치를 탐지하고, 제거·보간 권고안을 자동 생성합니다.
CLAUDE.md 구조
📁 outlier-detector/
├── CLAUDE.md
├── 📁 data/
│ └── experiment_raw.csv
├── 📁 output/
│ ├── outlier_report.html
│ └── cleaned_data.csv
└── 📁 skills/
└── detect-outliers.md
핵심 Skill
/detect— Z-score·IQR·DBSCAN 복합 이상치 탐지/report— 이상치 위치·비율·패턴 시각화 리포트/clean— 이상치 제거 또는 보간 처리
연구 데이터 메타데이터 자동 생성기
프로젝트 목적
연구데이터 공개 의무화에 대응하여 데이터셋의 변수명·데이터 타입·값 범위를 분석하고, FAIR 원칙에 맞는 메타데이터 파일과 README를 자동 생성합니다.
CLAUDE.md 구조
📁 metadata-gen/
├── CLAUDE.md
├── 📁 datasets/
│ └── study_data.csv
└── 📁 output/
├── metadata_datacite.json
├── codebook.md
└── README.md
핵심 Skill
/profile— 데이터셋 구조·변수·통계 자동 프로파일링/metadata— DataCite·Dublin Core 표준 메타데이터 생성/readme— 재사용 가능한 데이터 README 자동 작성
혼합연구 통합 분석 에이전트
프로젝트 목적
설문 통계 결과와 FGI·인터뷰 전사본을 함께 입력하면 수렴·발산·확장 패턴을 분석하고, 혼합연구 논문에 바로 쓸 수 있는 통합 결과 섹션 초안을 작성합니다.
CLAUDE.md 구조
📁 mixed-methods/
├── CLAUDE.md
├── 📁 quantitative/
│ └── stats_results.xlsx
├── 📁 qualitative/
│ └── interview_themes.md
└── 📁 output/
└── integration_report.md
핵심 Skill
/triangulate— 양·질적 결과 수렴·발산 패턴 분석/integrate— 통합 서사(joint display) 자동 생성/draft— 혼합연구 결과 섹션 논문 초안 작성
패널 데이터 분석 자동화 에이전트
프로젝트 목적
다년도 패널 데이터에서 Hausman 검정으로 고정/랜덤효과 모델을 선택하고, 자기상관·이분산성 검정 후 표준오차를 보정하며, 결과 테이블과 해석 문구를 자동 생성합니다.
CLAUDE.md 구조
📁 panel-analyzer/
├── CLAUDE.md
├── 📁 data/
│ └── panel_data.csv
└── 📁 output/
├── model_selection.md
└── regression_tables.xlsx
핵심 Skill
/hausman— 고정효과 vs 랜덤효과 자동 검정 및 선택/model— 패널 회귀 실행 + 강건 표준오차 보정/table— APA 형식 회귀 결과 테이블 자동 생성
텍스트 마이닝 감성 분석 에이전트
프로젝트 목적
온라인 리뷰나 설문 주관식 응답을 CSV로 입력하면 긍·부정 감성 분류, LDA 토픽 모델링, 키워드 공출현 네트워크를 분석하고 워드클라우드를 생성합니다.
CLAUDE.md 구조
📁 text-miner/
├── CLAUDE.md
├── 📁 data/
│ └── reviews.csv
└── 📁 output/
├── sentiment_results.csv
├── topics.md
└── wordcloud.png
핵심 Skill
/sentiment— 텍스트 긍·부정·중립 감성 분류/topics— LDA 토픽 모델링 및 주제 라벨링/network— 키워드 공출현 네트워크 시각화
연구 데이터 시각화 대시보드 자동 생성기
프로젝트 목적
Excel·CSV 연구 결과 데이터를 입력하면 Plotly/Chart.js 기반 인터랙티브 HTML 대시보드를 자동 생성합니다. 심사위원이나 청중이 직접 필터링하며 데이터를 탐색할 수 있습니다.
CLAUDE.md 구조
📁 viz-dashboard/
├── CLAUDE.md
├── 📁 data/
│ └── results.xlsx
└── 📁 output/
├── dashboard.html
└── charts/
핵심 Skill
/dashboard— 인터랙티브 HTML 대시보드 자동 생성/chart— 데이터 타입에 맞는 차트 유형 자동 선택/export— PNG/SVG 고해상도 차트 일괄 출력
논문 표·그림 자동 생성 에이전트
프로젝트 목적
통계 분석 결과를 붙여넣으면 저널 투고 기준(APA 7판, AMA, Vancouver)에 맞는 표 형식과 캡션을 자동 생성하고, 그래프는 300dpi 이상 고해상도 이미지로 출력합니다.
CLAUDE.md 구조
📁 figure-gen/
├── CLAUDE.md
├── 📁 data/
│ └── analysis_output.csv
└── 📁 output/
├── tables.docx
└── figures/
핵심 Skill
/table— APA·AMA 형식 논문 표 자동 생성/figure— 300dpi 고해상도 그래프 자동 생성/caption— 표·그림 캡션 학술 형식으로 자동 작성
논문 투고 커버레터 자동 작성 에이전트
프로젝트 목적
논문 초록, 핵심 기여, 저자 정보를 입력하면 목표 저널의 Aims & Scope에 맞춘 커버레터 초안을 자동 작성합니다. 한국어 논문은 영문 번역도 함께 제공합니다.
CLAUDE.md 구조
📁 cover-letter/
├── CLAUDE.md
├── 📁 input/
│ ├── abstract.md
│ └── journal_info.md
└── 📁 output/
└── cover_letter.docx
핵심 Skill
/analyze— 논문 vs 저널 범위 적합성 분석/draft— 맞춤형 커버레터 초안 자동 작성/translate— 한국어 → 영문 학술 번역
SNS 콘텐츠 멀티채널 자동 생성기
프로젝트 목적
원본 콘텐츠를 한 번 쓰면 각 플랫폼 알고리즘에 최적화된 형식(Instagram 캡션+해시태그, LinkedIn 아티클, X 스레드, 카카오채널 등)으로 자동 변환합니다.
CLAUDE.md 구조
📁 sns-repurposer/
├── CLAUDE.md
├── 📁 input/
│ └── source_content.md
└── 📁 output/
├── instagram.md
├── linkedin.md
└── twitter_thread.md
핵심 Skill
/instagram— 인스타 캡션 + 해시태그 30개 자동 생성/linkedin— 전문가 톤 링크드인 아티클 변환/thread— X 트위터 스레드 형식으로 분할 변환
강의 자료 자동 생성 에이전트
프로젝트 목적
강의 주제와 대상 학습자 수준을 입력하면 Bloom's Taxonomy 기반 학습목표, 슬라이드 아웃라인, 강의노트, 형성평가 문항을 자동 생성합니다.
CLAUDE.md 구조
📁 lecture-gen/
├── CLAUDE.md
├── 📁 input/
│ └── syllabus.md
└── 📁 output/
├── slides_outline.md
├── lecture_notes.md
└── quiz_bank.md
핵심 Skill
/outline— 슬라이드 구조 및 아웃라인 자동 생성/notes— 강의자 노트 및 발표 스크립트 작성/quiz— 객관식·주관식 형성평가 문항 자동 생성
연구실 뉴스레터 자동화 에이전트
프로젝트 목적
연구실 구성원들이 매달 업데이트 사항을 공유 문서에 입력하면 뉴스레터 초안을 자동 작성하고, 반응형 HTML 이메일 템플릿으로 변환해 발송 준비까지 완료합니다.
CLAUDE.md 구조
📁 newsletter-bot/
├── CLAUDE.md
├── 📁 updates/
│ └── march_2026.md
└── 📁 output/
├── newsletter_draft.md
└── newsletter.html
핵심 Skill
/collect— 업데이트 항목 수집·분류·정리/draft— 뉴스레터 섹션별 초안 자동 작성/html— 반응형 HTML 이메일 템플릿 변환
연구 성과 보도자료 자동 생성기
프로젝트 목적
전문 용어로 가득한 논문 초록을 입력하면 기자·일반 대중이 이해할 수 있는 보도자료와 연구실 블로그 포스트를 자동 작성합니다. 핵심 메시지와 사회적 임팩트를 강조합니다.
CLAUDE.md 구조
📁 press-release/
├── CLAUDE.md
├── 📁 input/
│ └── paper_abstract.md
└── 📁 output/
├── press_release.md
└── lab_news.md
핵심 Skill
/simplify— 전문 용어를 일반 언어로 자동 변환/press— AP 스타일 보도자료 형식으로 자동 작성/blog— 연구실 홈페이지용 소식 게시글 작성
유튜브 스크립트 & 썸네일 기획 에이전트
프로젝트 목적
연구 주제나 강의 내용을 유튜브 영상으로 제작할 때 후킹 오프닝, 구조화된 본문, 시청자 유지를 위한 패턴 인터럽트, 구독 유도 CTA를 포함한 스크립트를 자동 작성합니다.
CLAUDE.md 구조
📁 youtube-script/
├── CLAUDE.md
├── 📁 input/
│ └── topic_brief.md
└── 📁 output/
├── script.md
└── thumbnail_copy.md
핵심 Skill
/hook— 15초 후킹 오프닝 다섯 가지 버전 생성/script— 완성형 유튜브 스크립트 자동 작성/thumbnail— 클릭률 높은 썸네일 카피 & 구성안 제안
문헌 리뷰 자동 구조화 에이전트
프로젝트 목적
수집한 논문들의 초록이나 전문을 입력하면 시간순·주제별·방법론별로 분류하고 연구 흐름을 분석해 논문의 문헌고찰 섹션 초안을 자동 작성합니다.
CLAUDE.md 구조
📁 lit-review/
├── CLAUDE.md
├── 📁 papers/
│ └── abstracts.csv
└── 📁 output/
├── synthesis_map.md
└── lit_review_draft.md
핵심 Skill
/cluster— 논문을 주제·방법론별로 자동 클러스터링/timeline— 연구 흐름의 시간적 발전 과정 정리/draft— 문헌고찰 섹션 초안 자동 작성
참고문헌 스타일 자동 변환 에이전트
프로젝트 목적
투고 저널 변경 시 참고문헌 스타일을 수작업으로 바꾸는 번거로움을 제거합니다. APA·MLA·Vancouver·Chicago·NLM·IEEE 스타일 간 상호 변환과 형식 오류 자동 검출을 지원합니다.
CLAUDE.md 구조
📁 ref-converter/
├── CLAUDE.md
├── 📁 input/
│ └── references.txt
└── 📁 output/
├── converted_refs.txt
└── error_report.md
핵심 Skill
/convert— 지정 스타일로 참고문헌 일괄 변환/check— 누락 필드·형식 오류 자동 검출/doi— DOI/ISBN으로 완전한 참고문헌 자동 생성
DOI 기반 논문 메타데이터 자동 수집기
프로젝트 목적
논문 목록에서 DOI만 추출하면 Crossref API를 통해 제목·저자·저널·연도·초록 등 완전한 메타데이터를 자동 수집하고 RIS/BibTeX 파일로 저장합니다.
CLAUDE.md 구조
📁 doi-collector/
├── CLAUDE.md
├── 📁 input/
│ └── doi_list.txt
└── 📁 output/
├── references.ris
└── references.bib
핵심 Skill
/fetch— DOI 목록에서 Crossref 메타데이터 일괄 수집/export— RIS·BibTeX·CSV 형식으로 일괄 변환 저장/dedup— 중복 논문 자동 탐지 및 병합
논문 읽기 우선순위 추천 에이전트
프로젝트 목적
끝없이 쌓이는 미독 논문 목록을 관리합니다. 연구 주제와의 관련성, 피인용수, 최신성, 방법론 다양성을 종합해 이번 주 필독 논문 5편을 추천하고 이유를 설명합니다.
CLAUDE.md 구조
📁 reading-recommender/
├── CLAUDE.md
├── 📁 library/
│ └── unread_papers.csv
└── 📁 output/
└── weekly_picks.md
핵심 Skill
/score— 논문별 관련성·인용수·최신성 점수화/recommend— 주간 필독 논문 5편 추천 + 이유 설명/log— 읽은 논문 기록 및 독서 현황 대시보드
IRB 심의 서류 작성 자동화 에이전트
프로젝트 목적
연구 목적·방법·대상·위험성 정보를 입력하면 소속 기관 IRB 양식에 맞춘 심의 신청서, 연구대상자 설명문, 동의서 초안을 자동 작성합니다. 필수 항목 누락을 체크해 반려 위험을 줄입니다.
CLAUDE.md 구조
📁 irb-assistant/
├── CLAUDE.md
├── 📁 templates/
│ └── irb_template.docx
└── 📁 output/
├── application_draft.docx
└── consent_form.docx
핵심 Skill
/draft— IRB 신청서 각 섹션 자동 작성/consent— 연구대상자 설명문·동의서 자동 생성/check— 필수 항목 누락·모순 사항 자동 검토
학술 행사 일정 자동 관리 에이전트
프로젝트 목적
논문 투고·발표 기회를 놓치지 않도록 관심 분야 주요 학회의 CFP(논문 공모) 마감일, 사전 등록 기간, 카메라레디 제출 기한을 자동으로 수집하고 D-day 알림을 발송합니다.
CLAUDE.md 구조
📁 conf-tracker/
├── CLAUDE.md
├── 📁 watchlist/
│ └── target_conferences.md
└── 📁 output/
├── cfp_calendar.ics
└── upcoming_deadlines.md
핵심 Skill
/scan— 학회 홈페이지 CFP 정보 자동 수집/calendar— iCal 형식 학술 일정 캘린더 생성/alert— 마감 D-30·D-14·D-7 자동 알림 발송
연구비 지출 관리 자동화 에이전트
프로젝트 목적
연구비 집행 내역과 영수증을 입력하면 항목별(인건비·재료비·여비·학회참가비 등) 자동 분류, 예산 잔액 계산, 기관 정산 보고서 양식을 자동으로 채웁니다.
CLAUDE.md 구조
📁 budget-manager/
├── CLAUDE.md
├── 📁 receipts/
│ └── expenses.csv
└── 📁 output/
├── budget_summary.xlsx
└── settlement_report.docx
핵심 Skill
/classify— 지출 내역 연구비 항목별 자동 분류/balance— 항목별 예산 잔액 및 소진율 계산/report— 기관 정산 보고서 양식 자동 완성
연구 협력 이메일 자동 작성 에이전트
프로젝트 목적
상황(공동연구 제안·데이터 요청·저자 컨택·지도교수 보고 등)과 수신자 정보를 입력하면 영어 또는 한국어 학술 이메일을 자동 작성합니다. 톤·격식·길이를 자동 조절합니다.
CLAUDE.md 구조
📁 email-writer/
├── CLAUDE.md
├── 📁 templates/
│ └── email_scenarios.md
└── 📁 output/
└── draft_email.md
핵심 Skill
/collab— 공동 연구 제안 이메일 자동 작성/request— 데이터·자료 요청 이메일 작성/translate— 한국어 이메일 → 영문 학술 번역
개인 재무 자동 분석 에이전트
프로젝트 목적
카드사·은행 앱에서 CSV로 내역을 내려받으면 식비·교통비·구독료·쇼핑 등 카테고리별로 분류하고, 지난 3개월 대비 증감·과소비 패턴·절약 가능 항목을 분석합니다.
CLAUDE.md 구조
📁 finance-analyzer/
├── CLAUDE.md
├── 📁 data/
│ └── transactions.csv
└── 📁 output/
├── monthly_report.md
└── category_chart.html
핵심 Skill
/classify— 거래 내역 카테고리별 자동 분류/trend— 월별 지출 추이 및 증감률 분석/save— 절약 가능 항목·구독료 낭비 자동 탐지
채용 서류 스크리닝 자동화 에이전트
프로젝트 목적
연구실 인턴·RA 채용이나 일반 HR 업무에서 다수의 지원서를 빠르게 처리합니다. 직무 요건과 각 지원자의 역량을 비교해 적합도 점수와 강약점 요약, 면접 권고 여부를 자동 판단합니다.
CLAUDE.md 구조
📁 cv-screener/
├── CLAUDE.md
├── 📁 resumes/
│ └── applicants/
├── 📁 jd/
│ └── job_description.md
└── 📁 output/
└── screening_report.xlsx
핵심 Skill
/score— 지원자별 직무 적합도 점수 자동 산출/summary— 지원자 강약점 요약 및 면접 권고 여부/rank— 적합도 순 지원자 랭킹 리포트 생성
계약서·약관 자동 검토 에이전트
프로젝트 목적
연구용역 계약서, 공동연구 협약서, SaaS 이용약관 등을 입력하면 불리한 조항(일방적 해지권·면책 범위·지재권 귀속 등)을 탐지하고, 협상 권고 포인트와 수정 제안을 제공합니다.
CLAUDE.md 구조
📁 contract-reviewer/
├── CLAUDE.md
├── 📁 contracts/
│ └── agreement.pdf
└── 📁 output/
├── risk_report.md
└── negotiation_points.md
핵심 Skill
/review— 계약서 조항별 리스크 자동 탐지/compare— 표준 계약서와 비교·차이점 강조/suggest— 불리한 조항 수정 문구 자동 제안
회의록 자동 작성·요약 에이전트
프로젝트 목적
지도교수 면담, 랩 미팅, 프로젝트 회의의 녹취·메모를 입력하면 주요 논의 사항, 결정 사항, 담당자별 액션아이템, 다음 회의 아젠다를 자동 추출해 공유 가능한 회의록을 생성합니다.
CLAUDE.md 구조
📁 meeting-scribe/
├── CLAUDE.md
├── 📁 notes/
│ └── meeting_transcript.txt
└── 📁 output/
├── minutes.md
└── action_items.md
핵심 Skill
/minutes— 회의 내용 구조화 회의록 자동 생성/actions— 담당자·기한 포함 액션아이템 추출/agenda— 다음 회의 아젠다 초안 자동 작성
포트폴리오·자기소개서 자동 작성 에이전트
프로젝트 목적
연구 경력, 프로젝트, 논문, 수상 내역을 한 번 정리하면 지원하는 직무(연구소·기업·대학 강사 등)에 맞춰 포트폴리오 구성 순서와 자기소개서 초안을 자동 맞춤 생성합니다.
CLAUDE.md 구조
📁 portfolio-gen/
├── CLAUDE.md
├── 📁 profile/
│ └── career_history.md
└── 📁 output/
├── portfolio.md
└── cover_letter.md
핵심 Skill
/tailor— 직무 요건에 맞춘 경력 강조 포인트 선별/portfolio— 맞춤형 포트폴리오 구성·순서 자동 생성/letter— 직무·기관별 자기소개서 초안 자동 작성
연구노트 자동 정리 에이전트
프로젝트 목적
흩어진 실험 메모, 측정값, 관찰 기록을 GLP(우수실험실관행) 기준의 표준 연구노트 형식으로 자동 정리합니다. 실험 조건 변화와 재현성 이슈를 자동으로 탐지해 알림을 보냅니다.
CLAUDE.md 구조
📁 lab-notebook/
├── CLAUDE.md
├── 📁 entries/
│ └── daily_log.md
└── 📁 output/
├── formatted_notebook.md
└── reproducibility_alerts.md
핵심 Skill
/format— 실험 메모를 표준 연구노트 형식으로 변환/pattern— 실험 조건 변화·이상 패턴 자동 탐지/reproduce— 재현성 이슈·조건 불일치 자동 플래그
논문 인용 네트워크 시각화 에이전트
프로젝트 목적
연구 분야의 인용 관계를 네트워크 그래프로 시각화합니다. 허브 논문(많이 인용된 핵심 논문), 연구 클러스터, 분야 간 브리지 논문을 자동 탐지해 연구 지형도를 파악합니다.
CLAUDE.md 구조
📁 citation-network/
├── CLAUDE.md
├── 📁 data/
│ └── paper_list.csv
└── 📁 output/
├── network.html
└── hub_papers.md
핵심 Skill
/build— 논문 인용 관계 네트워크 자동 구축/visualize— 인터랙티브 인용 네트워크 그래프 생성/hubs— 핵심 허브 논문·브리지 논문 자동 탐지
학술 발표 Q&A 준비 에이전트
프로젝트 목적
학위논문 심사, 학술대회 발표, 연구비 보고 발표를 앞두고 심사위원·청중이 제기할 예상 질문을 자동 생성하고, 각 질문에 대한 답변 초안과 보완 포인트를 제공합니다.
CLAUDE.md 구조
📁 qa-prep/
├── CLAUDE.md
├── 📁 input/
│ └── presentation.md
└── 📁 output/
├── expected_questions.md
└── answer_drafts.md
핵심 Skill
/questions— 발표 내용 기반 예상 질문 30개 자동 생성/answers— 각 질문에 대한 모범 답변 초안 작성/weak— 논리적 취약점·보완 필요 포인트 자동 탐지
학술 문서 전문 번역 에이전트
프로젝트 목적
학술 문서 번역에서 핵심 과제인 전문 용어 일관성을 해결합니다. 첫 번역 시 용어집을 생성하고, 이후 문서에 일괄 적용하여 전체 논문에서 동일 용어가 동일하게 번역됩니다.
CLAUDE.md 구조
📁 academic-translator/
├── CLAUDE.md
├── 📁 glossary/
│ └── term_dictionary.csv
└── 📁 output/
├── translated.md
└── updated_glossary.csv
핵심 Skill
/translate— 용어집 기반 학술 문서 한↔영 번역/glossary— 분야별 전문 용어집 자동 생성·업데이트/review— 번역 일관성·학술 표현 자동 검토
이하는 2026.04 개정에서 새로 추가된 연구자 공감 아이디어 10선입니다. AX-260313 / 260315 / 260317 워크숍 제출물 중 연구자 대다수가 공감할 수 있는 범용적 주제만 우선 선별했습니다.
학회 추천 에이전트
프로젝트 목적
연구자가 학회를 고를 때 반복적으로 하는 판단(초록 마감·참석자 규모·예산·직항·주제 적합성)을 자동화합니다. 연구 분야 키워드와 예산 상한을 입력하면, 마감이 열린 학회만 필터링하고 항공+숙박+식비까지 추정해 랭킹된 카드 형태로 추천합니다.
CLAUDE.md 구조
📁 conference-scout/
├── CLAUDE.md
├── 📁 inputs/
│ └── preferences.json (예산, 지역, 기간 상한)
├── 📁 output/
│ └── conference_ranking.md
└── 📁 agents/
├── search_agent.py 학회 탐색
├── filter_agent.py 조건 통과 검사
├── travel_cost_agent.py 항공+숙박+식비 추정
└── output_agent.py 랭킹 카드 생성
핵심 Skill
/scout-conference— 분야별 국제 학회 탐색 + 초록 마감·참석자 규모 확인/estimate-budget— 등록비 + 항공 + 숙박 + 식비 기간 기반 추정/rank-conference— 마감 임박·예산 적합성·주제 부합도 종합 점수
Research Digest 뉴스레터
프로젝트 목적
"매주 월요일 아침, 내 연구 주제와 관련된 최신 논문 10편을 정리된 형태로 받아보고 싶다"는 니즈를 자동화합니다. OpenAlex·Semantic Scholar·arXiv에서 병렬 수집하고, 중복 제거·관련도 점수화·TL;DR 생성·추천 이유까지 덧붙여 HTML/Markdown 뉴스레터로 발송합니다.
CLAUDE.md 구조
📁 research-digest/
├── CLAUDE.md
├── 📁 config/
│ └── keywords.yaml (3~5개 키워드 + 동의어)
├── 📁 output/
│ └── digest_YYYY-WW.html
└── 📁 agents/
├── collector.py 3개 DB 병렬 수집
├── dedupe.py DOI · 제목 기반 중복 제거
├── scorer.py 관련도 + 최신성 + 인용수
├── curator.py TL;DR + 추천 이유 생성
└── mailer.py Gmail MCP 발송
핵심 Skill
/weekly-digest— 지정 주기로 3개 DB 수집 + 필터링 + 뉴스레터 생성/keyword-expand— 한국어 ↔ 영어 동의어 확장으로 검색 recall 향상/rank-novelty— 기존 구독자 DB와 비교해 "새로 등장한 주제"만 하이라이트
해외 Postdoc 지원 에이전트
프로젝트 목적
박사과정 후반부 연구자가 가장 부담스러워하는 "수십 개 Lab 개별 리서치 + 맞춤형 컨택 메일 작성"의 반복 노동을 자동화합니다. CV에서 강점을 추출하고, 희망 분야 Lab들의 최근 논문을 읽어 내 연구와의 접점을 구체적으로 명시한 250~350단어 영문 메일 초안까지 생성합니다.
CLAUDE.md 구조
📁 postdoc-agent/
├── CLAUDE.md
├── 📁 inputs/
│ ├── cv.pdf
│ └── target_keywords.txt
├── 📁 output/
│ ├── lab_ranking.md 연관성 점수 기반 Lab 리스트
│ └── email_drafts/ Lab별 컨택 메일
└── 📁 agents/
├── cv_parser.py
├── profile_builder.py 연구 강점 프로파일
├── lab_discovery.py Google Scholar + 기관 홈페이지
├── relevance_analyzer.py
├── contact_finder.py PI 이메일·지원 절차
└── email_composer.py
핵심 Skill
/parse-cv— PDF/DOCX CV에서 논문·기술·키워드 구조화 추출/find-lab— 희망 분야 키워드 기반 Lab + PI 프로파일 수집/compose-postdoc-email— PI의 최근 논문 1~2편 언급 + 내 연구와의 접점 포함 맞춤 메일 생성
스코핑 리뷰 미니 에이전트
프로젝트 목적
본격 SLR을 돌리기 전, "이 주제가 연구 가치가 있는지" 2시간 안에 가늠해보는 탐색형 리뷰입니다. OpenAlex 무료 API로 최근 N개월 논문을 수집하고, 스크리닝과 별점을 1회 API 호출로 통합해 비용을 최소화합니다. 분야 불문 공통 수요.
CLAUDE.md 구조
📁 scoping-review/
├── CLAUDE.md
├── scoping_review_mvp.py (단일 파일 실행)
├── config.py MAX_RESULTS, MIN_STARS 등
└── 📁 output/
└── scoping_YYYYMMDD.xlsx
├── 시트1: 선정 논문 (★3 이상)
├── 시트2: 제외 논문 + 사유
└── 시트3: 검색 통계 요약
핵심 Skill
/scope-search— 키워드 1~3개로 OpenAlex 최근 N개월 논문 수집/screen-and-rate— pass/exclude 결정 + ★1~5 별점 + 이유를 1회 API 호출로 통합/export-scoping— 연도 내림차순 정렬 + 3시트 Excel 저장
멀티 역할 라이프 스케줄러
프로젝트 목적
대학원생·교수·연구원은 연구/강의/행정/가족이라는 여러 역할을 동시에 수행합니다. 자연어로 "내일 오후 2시 지도교수 미팅 추가해줘"만 입력하면 카테고리 자동 분류, 시간 충돌 경고, 30분 전 알림까지 수행합니다. 역할별 일정을 한 화면에 시각화하는 것이 핵심 가치.
CLAUDE.md 구조
📁 life-scheduler/
├── CLAUDE.md
├── main.js 자연어 입력 처리
├── schedules.json 일정 DB (카테고리 + 시간 필드)
└── 📁 agents/
├── intent_classifier.js add / view / delete
├── scheduler.js 날짜·시간·카테고리 파싱
├── conflict_detector.js 시간 블록 충돌 탐지
└── notifier.js Gmail MCP 알림
핵심 Skill
/add-schedule— 자연어 → 날짜·시간·카테고리 구조화/view-by-role— 역할별(연구/교육/가족/개인) 필터 조회/remind-soon— 30분 전 터미널 + 이메일 알림
연구제안서 초안 에이전트
프로젝트 목적
NRF 신진연구자부터 정부 수탁 공고까지, 공고문 해독 + 양식 맞추기 + 초안 작성은 모든 연구자의 반복 작업입니다. 공고문에서 섹션 구조·분량·평가기준을 JSON으로 추출하고, 연구 자료에서 핵심 아이디어를 뽑아 섹션별 초안 + 관련 참고문헌 + 추천 figure 위치까지 HTML 대시보드로 출력합니다.
CLAUDE.md 구조
📁 proposal-writer/
├── CLAUDE.md
├── 📁 inputs/
│ ├── research_materials.pdf (연구 배경·방법론)
│ └── rfp_announcement.pdf (공고문)
├── 📁 output/
│ └── dashboard.html 3탭: 초안 / 참고문헌 / figure
└── 📁 agents/
├── announcement_analyzer.py 공고 → 섹션 구조 JSON
├── research_extractor.py 자료 → 핵심 아이디어
├── literature_scout.py
├── draft_writer.py 섹션별 초안 + 인라인 인용
└── integrator.py
핵심 Skill
/parse-rfp— 공고문에서 섹션·분량·평가기준·특이사항 JSON 추출/draft-section— 공고 양식에 맞춰 섹션별 초안 + APA 인용 삽입/align-to-criteria— 평가기준별 대응 문구 배치 점검
회의록 분석 에이전트
프로젝트 목적
연구실 랩미팅·공동연구 회의·자문회의·심사 회의 — 연구자 대부분이 주 1회 이상 수행하는 작업입니다. "사람이 듣고 정리"에 들이는 시간을 자동화합니다. 텍스트 노이즈 제거, 안건 단위 분할, 결정사항·보류·동의 분류, 담당자·기한 포함 액션아이템까지 Word로 출력.
CLAUDE.md 구조
📁 meeting-analyzer/
├── CLAUDE.md
├── 📁 inputs/
│ └── transcript.txt (녹취 · 카톡 · 메모)
├── 📁 output/
│ └── minutes_YYYYMMDD.docx
└── 📁 agents/
├── cleaner.py 호칭·중복·노이즈 제거
├── segmenter.py 안건 단위 분할
├── decision_extractor.py 결정 · 동의 · 보류 분류
├── action_generator.py 담당자 + 기한 추출
└── formatter.py
핵심 Skill
/minutes— 녹취/메모 → 구조화된 회의록 (일시·참석자·안건별 요약)/extract-actions— 액션아이템 (담당자·기한) 목록 생성/assign-followup— 팔로업 이메일 초안 자동 작성
공기어(共起語) 담론 분석 툴
프로젝트 목적
미디어·언어학·사회학·정책 연구자가 공통으로 쓰는 공기어 분석을 코딩 없이 반복 가능하게 만듭니다. URL 목록(Excel)과 타겟 키워드를 입력하면 본문 수집 → 문장 분리 → 패턴 매칭 → 품사 필터 → Excel 저장까지 자동. 키워드만 바꾸면 전혀 다른 주제에도 즉시 재활용 가능.
CLAUDE.md 구조
📁 cooccurrence-analyzer/
├── CLAUDE.md
├── 📁 inputs/
│ ├── urls.xlsx (A열에 URL 30개 단위)
│ └── target_patterns.txt ("신어", "신조어" 등)
├── 📁 output/
│ └── cooccur_result.xlsx
└── 📁 agents/
├── fetcher.py BeautifulSoup 본문 수집
├── sentence_splitter.py
├── pattern_matcher.py 따옴표·꺾쇠·"~라는" 패턴
├── pos_filter.py KoNLPy 품사 필터
└── exporter.py
핵심 Skill
/cooccur-scan— URL 리스트 + 키워드 → 공기어 후보 추출/frame-track— 시간축 기반 프레임 변화 추적/export-corpus— 키워드/문장/헤드라인/언론사/날짜 Excel 저장
감사일기 · 성찰 코치 웹앱
프로젝트 목적
장기 연구자의 소진(burnout) 예방 · 자기돌봄 도구로 활용합니다. 동시에 워크숍에서 1시간 안에 멀티 에이전트 구조를 체감할 수 있는 첫 작품 후보로도 탁월합니다. FastAPI 백엔드 + HTML/JS 프론트엔드로 작동하며, 3개 서브에이전트의 역할 분담을 눈으로 확인할 수 있습니다.
CLAUDE.md 구조
📁 gratitude-coach/
├── CLAUDE.md
├── main.py FastAPI 앱
├── 📁 agents/
│ ├── extractor.py 감사 포인트 2~4개
│ ├── analyzer.py 감정 키워드 + 패턴
│ └── coach.py 성찰 질문 2개
├── 📁 journals/ 샘플 일기
└── 📁 static/
└── index.html
핵심 Skill
/extract-gratitude— 일기에서 감사 포인트 2~4개 추출/reflect-pattern— 감정 키워드 + 행동-감정 패턴 한 줄/coach-gently— 따뜻한 성찰 질문 2개 생성 (clinical 톤 금지)
카테고리 기반 폴더 자동 정리
_duplicates/로 격리프로젝트 목적
"다운로드 폴더가 카오스다", "연구 자료 폴더를 연도별/주제별로 분류하고 싶다"는 것은 모든 연구자의 연례 작업입니다. Scanner → Duplicate Detector → Classifier → Executor 파이프라인을 거치고, dry-run 미리보기로 이동 계획을 사용자 승인받은 뒤 실행하므로 안전합니다.
CLAUDE.md 구조
📁 file-organizer/
├── CLAUDE.md
├── main.py typer CLI 진입점
├── orchestrator.py
├── 📁 agents/
│ ├── scanner.py pathlib.rglob 재귀 탐색
│ ├── duplicate.py 파일명 + 크기 비교
│ ├── classifier.py Claude API 카테고리 분류
│ ├── namer.py 한국어_영어 폴더명
│ ├── executor.py shutil.move (dry-run 지원)
│ └── reporter.py summary.md 생성
└── 📁 output/
└── summary.md
핵심 Skill
/scan-folder— 폴더 재귀 탐색 + 파일 메타데이터 수집/preview-moves— Claude 분류 결과 기반 이동 계획 테이블 출력/execute-organize— 사용자 Y/N 승인 후 파일 이동 + 중복 격리
아래부터는 심화·특화 에이전트 30개입니다. 3회차 워크숍(AX-260313 / 260315 / 260317)에 제출된 168개 기획서 중 분야 범용성·완성도·기존 60+10개와의 비중복성을 기준으로 엄선했습니다. 기관명·특정 법령·특정 질병 등 지나치게 개별적인 맥락은 일반화해 어느 분야 연구자든 각색 가능하도록 정리했습니다.
특허 IPC·CPC 코드 자동 조회기
프로젝트 목적
특허 데이터를 다루는 연구자가 KIPRIS나 Google Patents를 수작업으로 방문해 분류 코드를 복사하는 반복 작업을 자동화합니다. 특허 번호 리스트를 입력하면 Open API를 1차로 시도하고 실패 시 웹 파싱으로 폴백해 Excel 파일과 콘솔 대시보드를 즉시 생성합니다.
CLAUDE.md 구조
📁 patent-scanner/
├── CLAUDE.md
├── 📁 input/
│ └── patent_numbers.txt
├── 📁 agents/
│ ├── parser.py
│ ├── api_client.py
│ └── scraper_fallback.py
└── 📁 output/
└── patent_codes.xlsx
핵심 Skill
/normalize— 특허 번호 다양한 포맷 통일/fetch-codes— KIPRIS/Google Patents에서 IPC·CPC 자동 조회/export-xlsx— 구조화된 Excel + 대시보드 출력
학위논문 제안서 자동 기획 에이전트
프로젝트 목적
박사·석사 제안서 작성에서 가장 시간이 드는 구조 잡기를 자동화합니다. 주제 한 줄로 선행연구 수집 → 연구 배경 작성 → RQ·가설 도출 → 방법론 매칭 → 연구 일정까지 섹션별로 이어지는 파이프라인을 돌려 초안을 완성합니다.
CLAUDE.md 구조
📁 thesis-proposal/
├── CLAUDE.md
├── 📁 input/
│ └── topic_seed.md
├── 📁 agents/
│ ├── background_writer.py
│ ├── rq_generator.py
│ └── timeline_planner.py
└── 📁 output/
└── proposal_draft.docx
핵심 Skill
/background— 선행연구 기반 연구 배경·필요성 작성/rq— 연구 질문과 가설 도출/timeline— 월 단위 연구 일정표 자동 생성
인용 참고문헌 관리 + 노션 자동 정리
프로젝트 목적
Zotero·EndNote 대신 Notion을 참고문헌 관리 도구로 쓰고 싶은 연구자를 위한 에이전트입니다. 논문 PDF를 입력하면 Notion DB에 페이지를 자동 생성하고, 메타데이터·TLDR·핵심 인용문·태그까지 자동 채워넣습니다. Notion의 view·filter 기능으로 주제별 검색이 바로 가능합니다.
CLAUDE.md 구조
📁 notion-reference-manager/
├── CLAUDE.md
├── 📁 papers/
│ └── (PDF 입력)
├── 📁 agents/
│ ├── pdf_parser.py
│ ├── metadata_extractor.py
│ └── notion_uploader.py
└── .env
핵심 Skill
/extract— PDF에서 메타데이터·초록·인용 가능 문장 추출/push— Notion DB에 구조화 페이지 자동 업로드/tag— 주제 키워드 자동 태깅 + 관련 논문 링크
글로벌 도시·지역 동향 모니터링 에이전트
프로젝트 목적
도시·지역·정책 연구자가 주요 이슈(주거 가격, 도시 양극화, 인구 감소, 재생, 거버넌스 등)의 글로벌 동향을 체계적으로 추적하도록 지원합니다. 4-에이전트 파이프라인(수집→국가 분류→키워드 태깅→인사이트 작성)이 증분 업데이트 방식으로 기존 데이터를 보존하며 돌아갑니다.
CLAUDE.md 구조
📁 urban-intel/
├── CLAUDE.md
├── 📁 config/
│ └── keywords.yaml
├── 📁 agents/
│ ├── collector.py
│ ├── classifier.py
│ ├── tagger.py
│ └── writer.py
└── 📁 output/
└── intel_YYYYMMDD.md
핵심 Skill
/collect— 키워드별 뉴스 자동 수집 + 증분 업데이트/classify— 국가·지역별 자동 분류 + 중복 제거/insight— 국가별 2줄 인사이트 + Markdown 리포트
연구 정책 키워드 온톨로지 빌더
프로젝트 목적
대량의 정책 보고서·연구 제안서에서 자주 등장하는 개념을 추출하고, 상위-하위 관계를 자동으로 매핑해 온톨로지를 구축합니다. 연구 분야의 지형을 빠르게 파악하거나 정책 용어집을 체계적으로 관리할 때 유용합니다.
CLAUDE.md 구조
📁 keyword-ontology/
├── CLAUDE.md
├── 📁 inputs/
│ └── documents/
├── 📁 agents/
│ ├── extractor.py
│ ├── relation_finder.py
│ └── visualizer.py
└── 📁 output/
├── ontology.json
└── hierarchy.html
핵심 Skill
/extract-terms— 문서 집합에서 핵심 키워드 추출/relate— 상위-하위·연관 개념 관계 도출/visualize— 계층 구조 트리 + HTML 시각화
임상·보건 연구 데이터 자동 분석 에이전트
프로젝트 목적
임상 시험·코호트 연구 데이터를 입력하면 기술통계, 집단 간 비교(t-test·chi-square), 생존 분석(Kaplan-Meier, Cox regression)을 자동으로 수행하고, CONSORT 가이드라인에 맞춘 결과표와 flow chart를 출력합니다.
CLAUDE.md 구조
📁 clinical-analyzer/
├── CLAUDE.md
├── 📁 data/
│ └── trial_data.csv
├── 📁 agents/
│ ├── descriptive.py
│ ├── comparison.py
│ └── survival.py
└── 📁 output/
├── tables/
└── consort_flow.svg
핵심 Skill
/describe— 기준선 특성표 + 기술통계 자동 생성/compare— 집단 간 유의차 검정 (파라미터 자동 선택)/survival— KM 곡선 + Cox 회귀 + 위험비 포맷팅
네트워크 메타 분석 서비스
프로젝트 목적
체계적 문헌고찰 이후 진행하는 네트워크 메타 분석의 진입 장벽을 낮춥니다. 각 연구의 효과 크기·표본 수를 입력하면 Frequentist/Bayesian NMA를 자동 수행하고, 네트워크 그래프·forest plot·SUCRA 순위까지 결과를 정리합니다.
CLAUDE.md 구조
📁 nma-service/
├── CLAUDE.md
├── 📁 data/
│ └── study_results.csv
├── 📁 agents/
│ ├── network_builder.py
│ ├── nma_executor.py
│ └── plot_generator.py
└── 📁 output/
├── network.png
├── forest.png
└── sucra_ranking.md
핵심 Skill
/network— 연구·치료법 연결 네트워크 구축 + 일관성 검정/nma— NMA 실행 + 효과 크기·95% CI 계산/rank— SUCRA 기반 치료법 순위 테이블 생성
이공계 경력 인터뷰 분석 에이전트
프로젝트 목적
대규모 심층 인터뷰 자료를 체계적으로 분석합니다. 9개 주제 영역별 응답을 추출해 % 분포·군집·교차분석을 수행하고, 경력 전환 패턴·세대별 차이·산업군별 특수성을 자동으로 유형화합니다. 인터뷰 자료를 활용하는 모든 분야에 적용 가능합니다.
CLAUDE.md 구조
📁 career-interview-analyzer/
├── CLAUDE.md
├── 📁 transcripts/
│ └── interview_*.txt
├── 📁 frameworks/
│ └── 9_topics.yaml
├── 📁 agents/
│ ├── extractor.py
│ └── cluster_analyzer.py
└── 📁 output/
└── career_patterns_report.md
핵심 Skill
/extract-by-topic— 9개 주제 영역별 응답 자동 추출/cluster— 응답 패턴 군집화 + 유형 라벨링/cross-analyze— 세대·산업군 교차분석 + 보고서
머신러닝 하이퍼파라미터 튜닝 에이전트
프로젝트 목적
모델·데이터·탐색 범위를 지정하면 Optuna 기반 베이지안 최적화 또는 그리드 서치를 백그라운드에서 실행하고, 최적 파라미터·학습 곡선·중요도 분석을 리포트로 정리합니다. 연구자는 실험 조건만 정의하면 됩니다.
CLAUDE.md 구조
📁 hyperparam-tuner/
├── CLAUDE.md
├── config.yaml
├── 📁 agents/
│ ├── search_space.py
│ ├── optuna_runner.py
│ └── curve_plotter.py
└── 📁 output/
├── best_params.json
└── report.html
핵심 Skill
/search— 베이지안 최적화 또는 그리드 서치 실행/analyze— 파라미터 중요도·상호작용 분석/report— 학습 곡선 + 최적 조건 HTML 리포트
미디어 인텔리전스 블루프린트
프로젝트 목적
특정 이슈나 브랜드·정책에 대한 미디어 보도를 실시간으로 추적합니다. 감성 분석, 프레임 분류, 주요 인물·기관 언급 빈도, 담론 변화 추적까지 자동화해 대시보드로 제공합니다. 언론학·홍보학·정책학 연구에 활용 가능합니다.
CLAUDE.md 구조
📁 media-intel/
├── CLAUDE.md
├── 📁 config/
│ └── targets.yaml
├── 📁 agents/
│ ├── collector.py
│ ├── sentiment.py
│ ├── frame_classifier.py
│ └── dashboard.py
└── 📁 output/
└── dashboard.html
핵심 Skill
/track— 지정 이슈·키워드 실시간 수집/frame— 프레임 자동 분류 (예: 갈등/공공이익/개인이익)/trend— 주간 담론 변화 HTML 대시보드 생성
평형 패널 데이터 전처리 워크플로
프로젝트 목적
종단 데이터 분석에서 가장 까다로운 전처리 단계를 체계화합니다. 시간별·대상별 결측 패턴 분석 → 대체 전략 선택(LOCF/interpolation/multiple imputation) → 평형 패널 변환 → 검증 → 리포트의 5단계를 표준화합니다.
CLAUDE.md 구조
📁 panel-preprocessor/
├── CLAUDE.md
├── 📁 data/
│ └── raw_panel.csv
├── 📁 agents/
│ ├── missing_analyzer.py
│ ├── imputer.py
│ └── validator.py
└── 📁 output/
├── balanced_panel.csv
└── preprocessing_report.md
핵심 Skill
/diagnose— 결측 패턴 시각화 (MCAR/MAR/MNAR 판별)/impute— 상황별 최적 대체 방법 선택·실행/validate— 대체 전후 분포 비교 + 편향 점검
지방 통계 데이터 서비스 플랫폼
프로젝트 목적
KOSIS·지자체 공식 데이터 포털에서 각기 다른 포맷으로 제공되는 통계를 수집해 표준 스키마로 정규화합니다. 지역·지표별 비교 대시보드를 자동 생성해 지역 연구·도시 연구·정책 평가 연구에 활용할 수 있습니다.
CLAUDE.md 구조
📁 regional-stats/
├── CLAUDE.md
├── 📁 config/
│ └── indicators.yaml
├── 📁 agents/
│ ├── scraper.py
│ ├── normalizer.py
│ └── dashboard_builder.py
└── 📁 output/
└── dashboard.html
핵심 Skill
/scrape— 지자체별 통계 사이트 자동 수집/normalize— 다양한 포맷을 표준 스키마로 정규화/compare— 지역·지표 비교 대시보드 생성
강의 커리큘럼 자동 설계 에이전트
프로젝트 목적
신규 강의 개설 시 커리큘럼을 체계적으로 설계합니다. 주제·대상 학습자·총 주차 수·평가 방식을 입력하면 Bloom's Taxonomy 기반 학습 목표, 주차별 세부 계획, 필독 논문 자동 검색, 과제·시험 배치까지 강의계획서(syllabus)를 완성합니다.
CLAUDE.md 구조
📁 curriculum-designer/
├── CLAUDE.md
├── 📁 input/
│ └── course_brief.md
├── 📁 agents/
│ ├── objective_builder.py
│ ├── weekly_planner.py
│ └── reading_scout.py
└── 📁 output/
└── syllabus.docx
핵심 Skill
/objectives— Bloom's Taxonomy 기반 학습 목표 체계화/weekly— 주차별 주제·활동·읽기 자료 자동 배치/assess— 과제·시험·프로젝트 평가 방식 설계
수업 패키지 자동 생성 에이전트
프로젝트 목적
교사·강사가 한 차시 수업을 준비할 때 필요한 모든 자료를 한 번에 생성합니다. 주제와 학년을 입력하면 도입-전개-정리 구조의 50분 수업 계획, 학습지 PDF, 형성평가 문항, 수업 중 사용할 질문 리스트까지 패키지로 제공합니다.
CLAUDE.md 구조
📁 lesson-package/
├── CLAUDE.md
├── 📁 input/
│ └── lesson_topic.md
├── 📁 agents/
│ ├── plan_writer.py
│ ├── worksheet_gen.py
│ └── quiz_gen.py
└── 📁 output/
├── lesson_plan.docx
├── worksheet.pdf
└── quiz.pdf
핵심 Skill
/plan— 도입·전개·정리 50분 수업 계획 작성/worksheet— 학생용 학습지 PDF 자동 생성/quiz— 형성평가 문항 5~10개 생성
세포·실험실 재고 관리 에이전트
프로젝트 목적
생물학·화학 연구실의 재고 관리를 자동화합니다. 사용 시 간단히 기록하면 AI가 소진 속도를 학습해 최소 재고 도달 시 주문 알림을 보내고, 유효기간 임박 시약·세포주 passage 관리를 안내합니다. 구매 담당자용 월별 구매 리스트도 자동 생성합니다.
CLAUDE.md 구조
📁 lab-inventory/
├── CLAUDE.md
├── 📁 data/
│ └── inventory.db
├── 📁 agents/
│ ├── tracker.py
│ ├── forecaster.py
│ └── notifier.py
└── 📁 output/
└── monthly_order.xlsx
핵심 Skill
/log— 재고 사용·입고 자연어 기록/forecast— 소진 속도 예측 + 재주문 시점 알림/order— 월별 구매 목록 자동 생성
강의 녹화 영상 자동 분석 에이전트
프로젝트 목적
녹화된 수업 영상을 학생 복습용 자료로 변환합니다. Whisper 기반 전사 → 주제별 타임스탬프 분할 → 차시 요약 → 핵심 개념 정리 → 복습 퀴즈 생성까지 한 번에 처리합니다. Flipped classroom 운영 교수진에게 특히 유용합니다.
CLAUDE.md 구조
📁 lecture-video/
├── CLAUDE.md
├── 📁 input/
│ └── lecture_video.mp4
├── 📁 agents/
│ ├── transcriber.py
│ ├── summarizer.py
│ └── quiz_maker.py
└── 📁 output/
├── transcript.md
├── summary.md
└── review_quiz.pdf
핵심 Skill
/transcribe— Whisper 기반 자동 전사 + 타임스탬프/summarize— 주제별 요약 + 핵심 개념 추출/quiz— 복습용 객관식·단답형 문항 생성
임상 시험 프로토콜 자동 생성기
프로젝트 목적
임상 시험 프로토콜 작성의 표준 구조를 자동화합니다. 연구 목적·대상·중재·비교·결과(PICO)를 입력하면 ICH-E6 GCP 가이드라인에 따라 배경·방법·표본 크기 계산·윤리적 고려사항·통계 분석 계획을 포함한 완성도 높은 초안을 생성합니다.
CLAUDE.md 구조
📁 clinical-protocol/
├── CLAUDE.md
├── 📁 input/
│ └── pico.md
├── 📁 agents/
│ ├── background_writer.py
│ ├── methods_builder.py
│ └── ethics_checker.py
└── 📁 output/
└── protocol_draft.docx
핵심 Skill
/pico-expand— PICO → 배경·연구 질문·가설 서술/sample-size— 효과 크기 기반 표본 크기 자동 계산/ethics— 윤리적 고려사항·이해 상충 체크리스트
국제개발협력(ODA) 사업 분석 에이전트
프로젝트 목적
국제개발협력 연구자가 OECD DAC·KOICA·World Bank 등의 ODA 사업 데이터를 분석할 때 반복 사용하는 분류·집계·비교 작업을 자동화합니다. 섹터(교육·보건·인프라)·수원국·시기별 추세와 성과 달성률을 종합 리포트로 정리합니다.
CLAUDE.md 구조
📁 oda-analyzer/
├── CLAUDE.md
├── 📁 data/
│ └── oda_projects.csv
├── 📁 agents/
│ ├── classifier.py
│ ├── trend_analyzer.py
│ └── report_writer.py
└── 📁 output/
└── oda_report.docx
핵심 Skill
/classify— DAC 섹터 코드 기반 자동 분류/trend— 수원국·시기별 지원 추세 시각화/implication— 한국 ODA 정책 시사점 도출
논문 아카이브·태깅 자동화 에이전트
프로젝트 목적
다운로드만 해두고 방치되는 수백~수천 편의 논문 PDF를 정리합니다. 메타데이터 자동 추출·주제 태깅·PDF 전문 검색 인덱스 구축으로 "내가 이 논문 읽었나?" "이 주제로 갖고 있는 논문이 뭐지?"에 즉답합니다.
CLAUDE.md 구조
📁 paper-archive/
├── CLAUDE.md
├── 📁 archive/
│ └── (PDF 입력)
├── 📁 agents/
│ ├── meta_extractor.py
│ ├── topic_tagger.py
│ └── search_indexer.py
└── 📁 output/
├── catalog.xlsx
└── search_index.db
핵심 Skill
/tag-all— 전체 PDF 메타데이터·주제 태그 자동 추출/search— 제목·초록·본문 전문 검색/unread— 읽지 않은 논문 목록 + 우선순위 추천
논문 그래프·표 자동 추출 에이전트
프로젝트 목적
논문에 보고된 결과 그래프나 표를 재분석하거나 메타분석에 포함할 때 수작업으로 데이터를 재추출하는 부담을 줄입니다. PDF 내 그림·표 영역을 자동 감지하고 Claude Vision으로 데이터 값과 구조를 인식해 Excel·SVG로 출력합니다.
CLAUDE.md 구조
📁 paper-graph-extractor/
├── CLAUDE.md
├── 📁 papers/
│ └── (PDF 입력)
├── 📁 agents/
│ ├── region_detector.py
│ ├── vision_parser.py
│ └── exporter.py
└── 📁 output/
├── extracted_tables.xlsx
└── charts/
핵심 Skill
/detect— PDF에서 그림·표 영역 자동 탐지/parse-vision— Vision으로 수치·라벨·구조 인식/export— Excel 표 + SVG 재작성 그래프 저장
논문 재현성 자동 검증 에이전트
프로젝트 목적
연구자 본인의 논문 재현성 점검이나 인용 전 선행연구 검증에 활용합니다. GitHub·Zenodo 링크를 입력하면 환경 설정 → 실행 → 결과 비교 → 일치도 측정까지 자동으로 수행하고, 실패 원인(의존성·데이터·난수 seed 등)을 분류해 보고합니다.
CLAUDE.md 구조
📁 reproduce-checker/
├── CLAUDE.md
├── 📁 input/
│ └── paper_meta.yaml
├── 📁 agents/
│ ├── env_setup.py
│ ├── runner.py
│ └── compare.py
└── 📁 output/
└── reproduce_report.md
핵심 Skill
/setup— requirements·Dockerfile 기반 환경 자동 구성/run— 코드 실행 + 결과물 수집/diff— 논문 보고 값 vs 재현 값 비교 + 원인 분류
특허 출원 지원 자동화 에이전트
프로젝트 목적
연구실 성과를 특허로 출원할 때 기술성·신규성·진보성 판단과 명세서 초안 작성을 지원합니다. 키워드·기술 설명을 입력하면 국내외 선행 특허를 검색해 유사도 평가, 청구항 초안, 발명의 설명 구조를 제안합니다. 최종 출원서는 변리사가 마무리합니다.
CLAUDE.md 구조
📁 patent-drafter/
├── CLAUDE.md
├── 📁 input/
│ └── invention.md
├── 📁 agents/
│ ├── prior_art.py
│ ├── claim_drafter.py
│ └── spec_builder.py
└── 📁 output/
└── patent_draft.docx
핵심 Skill
/prior-art— 유사 선행 특허 검색 + 차별점 분석/claims— 독립항·종속항 구조 초안/spec— 발명의 설명·도면·효과 섹션 초안
논문 방향성 추천 에이전트
프로젝트 목적
박사과정 후반부나 신진 연구자가 "다음에 뭘 쓸지"를 결정할 때 도움을 주는 에이전트입니다. 본인의 출판 이력·강점·관심사를 CLAUDE.md에 정리해두면, 최신 동향을 스캔해 자연스러운 다음 단계 주제를 제안하고 각 주제의 기대 임팩트·투고 가능 저널까지 매핑합니다.
CLAUDE.md 구조
📁 next-paper-advisor/
├── CLAUDE.md
├── 📁 my-papers/
│ └── publications.bib
├── 📁 agents/
│ ├── profile_builder.py
│ ├── trend_matcher.py
│ └── ranker.py
└── 📁 output/
└── next_topics.md
핵심 Skill
/profile— 기존 논문 기반 연구자 강점 프로파일/match— 내 강점 × 최신 동향 접점 주제 도출/rank— 실현성·참신성·경력 기여도 종합 랭킹
창의성 연구 데이터 분석 에이전트
프로젝트 목적
창의성·디자인 사고 연구에서 반복적으로 수행하는 지표 채점(유창성·융통성·독창성·정교성)을 자동화합니다. 참여자들의 아이디어 목록이나 창작물 텍스트를 입력하면 기존 응답 풀과 비교해 통계적 드문 정도·카테고리 다양성을 계산합니다.
CLAUDE.md 구조
📁 creativity-analyzer/
├── CLAUDE.md
├── 📁 data/
│ └── participant_ideas.csv
├── 📁 agents/
│ ├── categorizer.py
│ ├── rarity_calculator.py
│ └── scorer.py
└── 📁 output/
└── creativity_scores.xlsx
핵심 Skill
/categorize— 아이디어 자동 범주화/rarity— 통계적 드문 정도 기반 독창성 점수/score— 4대 창의성 지표 종합 채점
논문 자동 분류 시스템
프로젝트 목적
분야 전체 scoping review나 연구 트렌드 논문을 쓸 때 필요한 대규모 분류 작업을 자동화합니다. 논문 목록을 입력하면 학제·방법론·주제 다중 분류를 자동 수행하고, 논문 수·분야별 성장률·공동 출현 분석 등 체계적 지도를 생성합니다.
CLAUDE.md 구조
📁 paper-classifier/
├── CLAUDE.md
├── 📁 data/
│ └── papers.csv
├── 📁 agents/
│ ├── multi_labeler.py
│ ├── statistics.py
│ └── mapper.py
└── 📁 output/
└── literature_map.html
핵심 Skill
/label— 학제·방법론·주제 다중 라벨 자동 부여/stats— 분야·시기별 분포·성장률 계산/map— 논문 간 공동 출현 네트워크 지도
공중보건 정책 코파일럿
프로젝트 목적
공중보건 정책 연구에서 반복되는 현황 진단·시나리오 분석·정책 옵션 비교를 자동화합니다. 지역·시기별 데이터를 입력하면 위험도 점수를 계산하고, WHO·CDC 가이드라인과 교차해 대응 옵션을 비교 표로 제시합니다.
CLAUDE.md 구조
📁 public-health-copilot/
├── CLAUDE.md
├── 📁 data/
│ └── indicators.csv
├── 📁 agents/
│ ├── risk_scorer.py
│ ├── scenario_builder.py
│ └── policy_compare.py
└── 📁 output/
└── ph_report.docx
핵심 Skill
/risk— 다차원 지표 기반 위험도 점수 산출/scenario— 낙관·중립·비관 시나리오 시뮬레이션/policy— 대응 옵션 비용·효과·형평성 비교표
정책 연구 에이전트 팀
프로젝트 목적
정책·사회과학 연구자의 상시 업무인 정책 보고서 작성을 자동화합니다. 주제 하나를 입력하면 배경 리서처·현황 분석가·국제 비교 분석가·시사점 작성자 4개 서브 에이전트가 병렬로 작업하고, 오케스트레이터가 결과를 통합해 25~30페이지 보고서를 완성합니다.
CLAUDE.md 구조
📁 policy-research-team/
├── CLAUDE.md
├── 📁 agents/
│ ├── background_agent.py
│ ├── status_agent.py
│ ├── comparative_agent.py
│ └── implication_agent.py
├── 📁 output/
│ └── policy_report.docx
└── requirements.txt
핵심 Skill
/background— 주제 배경·선행연구·용어 정의/status— 국내 현황·통계·이해관계자 지도/compare— 주요국 정책 비교 + 시사점 도출
주간 연구 리포트 자동 발행
프로젝트 목적
내가 매주 들여다봐야 하는 정보원(학술 DB·뉴스·정부 사이트)을 자동으로 순회하고, 이번 주에 주목할 항목만 간결하게 요약해 월요일 아침에 받아봅니다. 한 주 중 가장 바쁜 순간 연구 감각을 놓치지 않게 도와주는 개인 비서 에이전트입니다.
CLAUDE.md 구조
📁 weekly-research/
├── CLAUDE.md
├── 📁 config/
│ └── sources.yaml
├── 📁 agents/
│ ├── scanner.py
│ ├── summarizer.py
│ └── publisher.py
└── 📁 output/
└── weekly_YYYY-WW.md
핵심 Skill
/scan-weekly— 지정된 정보원 주간 새 항목 수집/highlight— 관심도 기반 상위 10~15건 선별/publish— 요약 + 출처 링크 원페이지 리포트
논문 자동 연결·지식 그래프 에이전트
프로젝트 목적
흩어져 보이는 논문들 사이의 숨은 개념·주장 연결을 지식 그래프로 드러냅니다. 논문 집합을 입력하면 개념 엔티티를 추출하고 주장 수준의 관계(지지·반박·확장)를 간선으로 연결해, 인터랙티브 그래프로 탐색할 수 있게 만듭니다. 체계적 문헌고찰의 시각적 보조 도구로 강력합니다.
CLAUDE.md 구조
📁 paper-kg/
├── CLAUDE.md
├── 📁 papers/
│ └── (PDF 입력)
├── 📁 agents/
│ ├── entity_extractor.py
│ ├── relation_extractor.py
│ └── graph_renderer.py
└── 📁 output/
└── knowledge_graph.html
핵심 Skill
/entities— 논문에서 핵심 개념 엔티티 추출/relations— 지지·반박·확장 관계 자동 판별/graph— 인터랙티브 지식 그래프 HTML 생성
논문 주제 추천 + 연구동향 스캐너
프로젝트 목적
연구 공백과 유행 흐름을 결합해 "지금 쓰면 잘 팔릴 주제"를 찾아줍니다. 분야 키워드를 입력하면 최근 3년 동향 분석 → 공백 탐지 → 경쟁 연구자 매핑 → 주제별 난이도·투고 가능 저널·예상 독자 규모를 종합 리포트로 제공합니다.
CLAUDE.md 구조
📁 topic-scout/
├── CLAUDE.md
├── 📁 input/
│ └── field_keywords.md
├── 📁 agents/
│ ├── trend_scan.py
│ ├── gap_detect.py
│ └── competitor_map.py
└── 📁 output/
└── topic_report.md
핵심 Skill
/scan-trend— 분야 최근 3년 출판·인용 동향/detect-gap— 공백·저탐색 하위주제 탐지/map-competitors— 핵심 연구자·랩 매핑
카탈로그 활용법
연구 단계별로 이 100개 아이디어를 조합하면 연구자 개인의 에이전트 생태계가 만들어집니다. 원본 60개(기초 필수)와 신규 40개(심화·특화)를 단계·목적에 맞춰 섞어 쓰세요.
| 연구 단계 | 조합 예시 |
|---|---|
| 주제 탐색기 | Research Digest + 스코핑 리뷰 — 매주 자동 논문 수집 → 가치 있는 주제 조기 판별 |
| 본격 리뷰 | 스코핑 리뷰 + 기존 카탈로그의 "체계적 문헌고찰 보조 도구" |
| 제안서 작성 | 연구제안서 초안 + 기존의 "연구갭 분석 에이전트" |
| 학회·커리어 | 학회 추천 + 해외 Postdoc 지원 |
| 일상 지원 | 라이프 스케줄러 + 회의록 분석 + 폴더 자동 정리 + 감사일기 코치 |
| 텍스트 연구 | 공기어 담론 분석 + 기존의 "인터뷰 데이터 코딩 어시스턴트" |
각 카드는 "어떤 서브에이전트로 쪼갤지"에 대한 설계 힌트가 포함되어 있으므로, 본 가이드북 4장(Subagents)과 7.1(에이전트 기획 6단계)을 함께 참조해 본인의 버전으로 각색하세요.
이하는 2026.04 개정에서 워크숍 참여자 제출물 중 범용성 높은 아이디어 22선입니다. 연구용뿐 아니라 생활·업무 자동화까지 포괄해, 어떤 분야 연구자든 바로 참고 가능한 수준으로 일반화했습니다.
PDF 논문 12단계 요약 에이전트
프로젝트 목적
학술 문헌 리뷰의 표준 질문 12개(Citation·Purpose·Selection·Quality·Organization·Scope·Definitions·Integration·Summary·Data·Analysis·Evaluation)를 기준으로 PDF 논문을 일괄 분석·저장합니다. Zotero·Mendeley에서 수집한 PDF 폴더를 그대로 입력으로 사용할 수 있습니다.
CLAUDE.md 구조
📁 pdf-summary/
├── CLAUDE.md
├── guideline.txt # 12단계 질문 템플릿
├── agent/
│ ├── extractor.py # PDF 텍스트 추출
│ ├── summarizer.py # Claude API 호출
│ └── parser.py # XML 태그 → MD
├── outputs/
│ └── *.md # 논문별 12섹션 요약
└── dashboard/
└── index.html # 사이드바 검색 + 섹션 네비
핵심 Skill
/summarize— 단일 PDF를 12섹션 구조로 요약/batch— 폴더 전체 일괄 처리/dashboard— 검색·섹션 네비 가능한 뷰어 생성
논문 인용 팩트체크 에이전트
프로젝트 목적
초고에서 인용한 모든 문장의 근거를 자동으로 원문과 대조합니다. Google Scholar·Unpaywall API로 오픈액세스 PDF를 찾고, 유료 논문은 수동 업로드를 지시합니다. 리뷰어 지적 최소화가 목표.
CLAUDE.md 구조
📁 citation-factcheck/
├── CLAUDE.md
├── agents/
│ ├── doc_parser.py # docx 인용 문장 추출
│ ├── scholar_search.py # Google Scholar 검색
│ ├── pdf_fetcher.py # Unpaywall → OA PDF
│ ├── pdf_reader.py # 관련 문단 추출
│ └── fact_checker.py # Claude 판정
├── data/pdfs/ # 수동 업로드 PDF
└── output/results.md # ✅/⚠️/❌ 표
핵심 Skill
/verify— 단일 문장 또는 docx 전체 팩트체크/find-source— 인용의 원문 PDF 자동 탐색/report— 전체 인용 지지도 표 생성
한국어 텍스트 수준 분석·변환 에이전트
프로젝트 목적
국립국어원 공식 어휘 10,635개·문법 336개 등급표를 기준으로 텍스트의 한국어 수준(CEFR A1~C2 매핑)을 자동 판정합니다. 목표 등급 지정 시 허용 어휘·문법 범위 안에서 의미를 보존하며 재작성합니다.
CLAUDE.md 구조
📁 korean-level/
├── CLAUDE.md
├── data/korean_levels.xlsx # 국립국어원 기준 데이터
├── analyzer.py # 수준 분석
├── rewriter.py # Claude API 재작성
├── morpheme.py # kiwipiepy 형태소
└── dashboard.py # rich 터미널 대시보드
핵심 Skill
/analyze— 텍스트 등급 자동 판정 + 어휘·문법 분포/rewrite— 목표 등급으로 재작성/verify— 변환된 텍스트 등급 재검증
과제 PDF 일괄 채점 에이전트
프로젝트 목적
학생들이 R/Python 코드 output 캡처 + 해석을 함께 담아 제출한 PDF 묶음을 ZIP 하나로 업로드하면, 교수자가 작성한 rubric.json 기준으로 문항별 채점·감점 사유 생성까지 자동화합니다.
CLAUDE.md 구조
📁 auto-grader/
├── CLAUDE.md
├── rubric/rubric.json # 문항별 배점·기준
├── agents/
│ ├── file_parser.py # ZIP 해제 + 학번 파싱
│ ├── pdf_extractor.py # 텍스트 + 이미지
│ ├── ai_grader.py # Claude Vision 채점
│ └── result_writer.py # Excel + MD 리포트
├── input/submissions.zip
└── output/grading_results.xlsx
핵심 Skill
/grade— 단일 PDF 채점/batch— ZIP 전체 자동 채점/summary— 반별 통계 + 취약 영역 리포트
논문 라이브러리 자동 정리 에이전트
프로젝트 목적
다운로드만 해둔 논문 PDF가 쌓여 있는 폴더를 한 번에 정리합니다. 1단계 파일명 표준화, 2단계 10개 필드 요약 Excel, 3단계 세부 주제별 분류된 선행연구 Word 문서까지 자동 생성합니다.
CLAUDE.md 구조
📁 paper-library/
├── CLAUDE.md
├── agents/
│ ├── renamer.py # Phase 1: 파일명 변경
│ ├── summarizer.py # Phase 2: 요약 Excel
│ └── report_writer.py # Phase 3: 계층 Word
├── outputs/
│ ├── paper_summary.xlsx
│ └── prior_research.docx
핵심 Skill
/rename— 파일명 표준화 (저자 연도 제목)/summarize— 10개 컬럼 Excel 생성/report— 세부 주제별 계층(■ ● □) Word 작성
연구 동향 & 리서치 갭 대시보드
프로젝트 목적
Semantic Scholar·OpenAlex·PubMed에서 IF 티어 기반 고품질 논문을 자동 수집하고, 각 논문을 AI가 구조화 요약한 뒤 선행연구의 공백(Research Gap)과 후속 연구질문(RQ) 후보까지 생성합니다.
CLAUDE.md 구조
📁 research-intel/
├── CLAUDE.md
├── agents/
│ ├── search.py # 다중 API 병렬 검색
│ ├── ranking.py # IF·인용 복합 스코어
│ ├── summarizer.py # 구조화 요약
│ ├── gap_finder.py # Research Gap 도출
│ └── rq_generator.py # 연구질문 제안
└── output/dashboard.html
핵심 Skill
/search— 복합 스코어 기반 Top-N 논문 수집/trend— 연도별·방법론별 트렌드 차트/gap— 연구 공백 + RQ 후보 3~5개 제안
소감문·인터뷰 키워드 네트워크 분석 에이전트
프로젝트 목적
수업 후 소감, FGI 녹취, 개방형 설문 응답 등 텍스트 데이터에서 주요 키워드의 연결 구조를 시각화합니다. 어떤 개념이 중심인지(degree), 어떤 개념이 서로 다른 주제를 연결하는 브릿지인지(betweenness) 자동 분석합니다.
CLAUDE.md 구조
📁 keyword-network/
├── CLAUDE.md
├── config.py # 불용어·윈도우 크기
├── data/stopwords_ko.txt
├── agents/
│ ├── preprocessor.py # KoNLPy 형태소
│ ├── network_builder.py # NetworkX 그래프
│ ├── analyzer.py # 중심성 계산
│ └── dashboard.py # Plotly 3-패널
└── output/dashboard.html
핵심 Skill
/extract— 명사 추출 + 불용어 제거/network— 공동출현 네트워크 생성/centrality— 연결·매개 중심성 Top 10
녹음 전사 + 화자 분리 에이전트
프로젝트 목적
Whisper API로 전사하고 AssemblyAI로 화자를 자동 분리해 상담사1: / 참여자2: 형식의 구조화된 축어록을 생성합니다. 비언어 표기([침묵 4초], [웃음])와 위기 발화 자동 태깅도 지원합니다.
CLAUDE.md 구조
📁 transcribe/
├── CLAUDE.md
├── agents/
│ ├── stt.py # Whisper API
│ ├── diarization.py # 화자 분리
│ └── formatter.py # 타임스탬프 포맷
├── input/audio/ # MP3/WAV/M4A
└── output/transcripts/ # 축어록 txt
핵심 Skill
/transcribe— 음성 → 텍스트 전사/diarize— 화자별 자동 라벨링/export— 연구용 표준 양식 변환
점심 추천 에이전트
프로젝트 목적
매일 "뭐 먹지?" 고민을 데이터로 해결합니다. 구글 캘린더로 점심 가용 시간을 파악하고, 현재 날씨와 개인 선호·비선호·최근 먹은 음식 이력을 교차 분석해 상황에 맞는 메뉴와 주변 식당을 매칭합니다.
CLAUDE.md 구조
📁 lunch-agent/
├── CLAUDE.md
├── agents/
│ ├── calendar_agent.py # Google Calendar
│ ├── weather_agent.py # 날씨 API
│ ├── profile_agent.py # 선호도 저장소
│ └── location_agent.py # Google Places
├── engine/recommender.py # Claude 추천 엔진
└── data/user_profile.json
핵심 Skill
/lunch— 오늘의 추천 카드 3장 생성/feedback— 선택 결과 프로필 학습/history— 최근 7일 먹은 음식 기록
식당 탐색 에이전트
프로젝트 목적
회의·출장·약속 장소 근처에서 "지금 열려 있고 가까운 식당"을 빠르게 찾습니다. Google Maps Platform 3개 API(Geocoding·Places·Distance Matrix)를 병렬 호출해 영업 중 판별·도보 계산·정렬까지 자동화합니다.
CLAUDE.md 구조
📁 restaurant-agent/
├── CLAUDE.md
├── agents/
│ ├── geocoding.py # 주소 → 좌표
│ ├── places_search.py # 반경 내 식당
│ ├── hours_filter.py # 영업중 필터
│ ├── walking_distance.py # 도보 시간
│ └── formatter.py # Excel 출력
└── output/restaurant_result.xlsx
핵심 Skill
/find— 주소·시간·반경 기반 식당 탐색/open-now— 현재 시각 기준 영업 중만/sort-walk— 도보 소요시간 오름차순 정렬
여행지 숏폼 영상 자동 생성 에이전트
프로젝트 목적
destination과 video_count만 지정하면 관련 이미지를 테마별로 수집하고 저작권 free BGM·자막을 입혀 9:16 세로 숏폼 영상을 원하는 수만큼 자동으로 만듭니다. 유튜브 쇼츠·인스타 릴스 대량 제작용.
CLAUDE.md 구조
📁 travel-shorts/
├── CLAUDE.md
├── agents/
│ ├── research.py # Tavily 웹 검색
│ ├── media.py # Unsplash 이미지
│ ├── music.py # 저작권 free BGM
│ ├── script.py # 자막·타임라인
│ └── renderer.py # FFmpeg MP4
└── output/*.mp4
핵심 Skill
/make— 도시명 입력 → N개 영상 자동 생성/theme— 테마별(음식·야경·거리) 필터링/batch— 30개 이상 대량 생산
기업 공시(DART) 자동 추출 대시보드
프로젝트 목적
DART OpenAPI를 통해 다수 기업의 사업보고서 "II. 사업의 내용" 섹션에서 사업부문 수·제품별 매출·주요 설비 등 정의한 변수만 자동 추출합니다. 기업×연도 격자의 비교 연구·ESG 분석에 활용.
CLAUDE.md 구조
📁 dart-extractor/
├── CLAUDE.md
├── config/
│ ├── schema.yaml # 추출 변수 정의
│ └── companies.yaml # 대상 기업 목록
├── agents/
│ ├── discovery.py # rcept_no 조회
│ ├── fetcher.py # XML 원문 다운로드
│ ├── extractor.py # 섹션 로케이터 + LLM
│ └── normalizer.py # 타입·단위 통일
└── outputs/extracted.xlsx
핵심 Skill
/scan— 대상 기업 × 연도 사업보고서 자동 수집/extract— YAML 스키마 기준 변수 구조화 추출/compare— 기업 간 변수 피벗 테이블 생성
세무·회계 1차 자문 에이전트
프로젝트 목적
"이 비용 처리 돼?" "이번 달 부가세 언제까지야?" "창업감면 요건은?" 같은 실무 질문에 국세청 법령·예규 RAG 기반으로 답변합니다. 고위험 판단은 세무사 상담을 권고하고, 신고 마감일은 캘린더에 자동 등록.
CLAUDE.md 구조
📁 tax-agent/
├── CLAUDE.md
├── agents/
│ ├── orchestrator.py
│ └── subagents/
│ ├── tax_saving.py # 절세전략
│ ├── evidence.py # 증빙·비용
│ ├── filing.py # 신고·납부
│ ├── payroll.py # 급여·원천세
│ └── policy.py # R&D·고용 지원금
└── data/law_rag/ # 국세청 법령 ChromaDB
핵심 Skill
/ask— 세무 질의에 구조화 답변 + 법령 인용/schedule— 신고 마감일 Google Calendar 등록/checklist— 연간 세무 체크리스트 자동 생성
신입 온보딩 학습 도우미
프로젝트 목적
비전공 경력 입사자가 회사 파이프라인·전문 용어·고유 프로세스(예: SAP·GTN·COGS)를 자기 페이스로 학습합니다. 제품 클릭 → Claude가 비전공자 눈높이 설명, 용어 입력 → 비유+업무 맥락으로 즉시 해설.
CLAUDE.md 구조
📁 onboarding/
├── CLAUDE.md
├── data/
│ └── company_products.json # 제품·파이프라인 DB
├── agents/
│ ├── product_explainer.py # 제품 비전공자 설명
│ ├── terminology.py # 용어 번역기
│ └── process_guide.py # 프로세스 가이드
└── dashboard/index.html
핵심 Skill
/learn— 제품 선택 → 150단어 비유 설명/translate— 전문 용어 비전공자 언어로 변환/quiz— 학습 내용 자가 평가
채용공고 자동 탐색·랭킹 에이전트
프로젝트 목적
매일 공고를 손으로 뒤지는 시간을 자동화합니다. 전공 적합도(LLM 판정) + 경력 인정도 + 고용안정성(공공/연구/준정부 분류) + 마감 긴급도를 종합 점수화해 Top N개를 카드로 정렬. 매일 8시 cron으로 신규 공고만 알림.
CLAUDE.md 구조
📁 job-match/
├── CLAUDE.md
├── config/user_profile.json
├── agents/
│ ├── search_agent.py # 사람인·워크넷·김박사넷
│ ├── filter_agent.py # LLM 적합도 0~100
│ ├── stability_agent.py # S/A/B/C 기관 분류
│ └── ranking_agent.py # 가중치 종합 점수
└── dashboard/index.html
핵심 Skill
/scan— 복수 사이트 공고 자동 수집/rank— 적합도·안정성·긴급도 복합 점수화/alert— 매일 신규 Top 5 이메일 전송
통계 결과 → 논문 문장 자동 변환 에이전트
프로젝트 목적
"OR 1.43 (95% CI 1.21-1.68), p<0.001" 같은 통계 결과를 학술지 스타일 문장으로 변환합니다. Bayesian·Spatial·ML 방법별 해석 규칙을 내장해 금지 표현(예: INLA에서 p-value 사용)을 자동 차단합니다.
CLAUDE.md 구조
📁 stat-to-text/
├── CLAUDE.md
├── agents/
│ ├── parser.md # R output → JSON
│ ├── reviewer.md # 통계 해석 검증
│ ├── writer.md # 문장 생성
│ └── qa.md # 숫자 일치 최종 검증
├── skills/
│ ├── inla_rules/ # Bayesian 규칙
│ └── journal_style/ # 저널별 스타일
핵심 Skill
/convert— 통계 output → Results 문장/verify— 해석 오류·숫자 일치 검증/translate— EN → KO 병기 출력
의심 메시지 위험도 자동 탐지 에이전트
프로젝트 목적
급전·알바 광고로 위장한 대포통장 모집, 투자 권유 피싱, 로맨스 스캠 등을 6개 시그널 카테고리로 분석합니다. 금전 유인·계좌 관련 단어·익명 경로 요구 등을 가중치 합산해 0~100점 위험도 + 근거 문장 제시.
CLAUDE.md 구조
📁 fraud-detector/
├── CLAUDE.md
├── rules/
│ ├── financial_incentive.yaml
│ ├── account_rental.yaml
│ └── ... # 6개 카테고리
├── agents/
│ ├── signal_extractor.py # 시그널 추출
│ ├── context_classifier.py # 의도 분류
│ └── risk_scorer.py # 0~100 점수화
└── dashboard/index.html
핵심 Skill
/check— 메시지 텍스트 위험도 판정/explain— 위험 근거 구절 하이라이트/report— 의심 사례 제보 양식 자동 작성
실험·현미경 이미지 자동 리포트 + PPT
프로젝트 목적
그룹·세트·배율별 이미지 분류, 색상 채널별 마커 매핑, 스케일바 OCR로 저/고배율 구분, 대표 이미지 AI 선정까지 자동화합니다. 최종 산출물은 바로 발표 가능한 PPT + 마커 테이블 + 해석 문장.
CLAUDE.md 구조
📁 lab-image-report/
├── CLAUDE.md
├── agents/
│ ├── image_analyzer.js # 채널 → 마커 매핑
│ ├── scale_bar_agent.js # OCR 배율
│ ├── classifier_agent.js # 그룹·세트 분류
│ ├── representative_selector # AI Vision 선정
│ └── ppt_builder.js # pptxgenjs PPT
├── inputs/ # 이미지 폴더
└── outputs/*.pptx
핵심 Skill
/classify— 그룹·세트·배율 자동 분류/represent— 그룹별 대표 이미지 선정/pptx— 분석 결과 PPT 자동 생성
논문 주기 수집 → Notion DB 자동 구축
프로젝트 목적
내 관심 분야에서 어제 오늘 새로 나온 논문을 놓치지 않습니다. 자격 요건(키워드 + 연도 + 저자)을 만족하는 논문을 자동 수집하고, Claude가 요약한 8개 필드를 Notion DB에 자동 적재. 주간 다이제스트 이메일도 옵션.
CLAUDE.md 구조
📁 paper-tracker/
├── CLAUDE.md
├── config/keywords.yaml
├── pipelines/
│ ├── daily_search.py # PubMed/Europe PMC
│ ├── abstract_parser.py # Claude 필드 추출
│ ├── dedup_check.py
│ └── notion_writer.py # Notion API
└── scheduler/cron_runner.py
핵심 Skill
/watch— 키워드 등록 → 매일 자동 수집/digest— 주간 신규 논문 다이제스트/deep— 특정 논문 PDF 업로드 시 심층 분석
학술 번역 + 도메인 용어집 누적 에이전트
프로젝트 목적
학술 번역의 품질을 회차마다 개선합니다. 번역 과정에서 만난 전문 용어를 terms.yaml에 자동 추가하고, 다음 번역부터는 일관된 용어를 재사용합니다. 표·그림 캡션·각주의 위치와 서식도 그대로 유지.
CLAUDE.md 구조
📁 academic-translator/
├── CLAUDE.md
├── terms.yaml # 도메인 용어집 (누적)
├── agents/
│ ├── pdf_parser.py # PDF 구조 유지
│ ├── translator.py # Claude + 용어집
│ ├── glossary_updater.py # 신규 용어 추가
│ └── formatter.py # docx/pdf 출력
└── output/translated/
핵심 Skill
/translate— PDF 영→한 서식 보존 번역/glossary— 도메인 용어집 자동 갱신/consistency— 전체 문서 용어 일관성 검수
개인 논문 관찰 리스트 에이전트
프로젝트 목적
박사과정·포닥이 쫓아가야 하는 "내 분야 핵심 연구자"들의 최신 논문을 빠짐없이 추적합니다. 저자 이름만 등록하면 PubMed Author search 기반으로 매주 토요일 자동 수집 + PDF 업로드 시 한국어 구조화 요약까지.
CLAUDE.md 구조
📁 paper-watchlist/
├── CLAUDE.md
├── config.yaml # Tier1/2/3 연구자 목록
├── agents/
│ ├── collector.py # PubMed·bioRxiv
│ ├── classifier.py # Tier 태깅
│ ├── db.py # SQLite 누적
│ ├── pdf_ingestor.py # PDF 업로드 수신
│ └── summarizer.py # 한국어 구조화 요약
└── dashboard/app.py # FastAPI + 웹
핵심 Skill
/watch— 저자·주제 등록 → 주간 자동 수집/digest— 금주 신규 논문 요약 이메일/review— 논문 PDF 업로드 시 심층 분석
가격·시장 통합 조회 대시보드
프로젝트 목적
같은 상품·작품·자산의 서로 다른 시장 가격을 한 화면에서 비교합니다. 예: 미술품의 갤러리(1차) 가격 vs 경매(2차) 낙찰가, 중고차 경매 vs 리테일, 부동산 실거래가 vs 호가. 시장 간 가격 차이와 시계열 트렌드 자동 산출.
CLAUDE.md 구조
📁 price-intel/
├── CLAUDE.md
├── db/models.py # SQLite/Postgres 스키마
├── scrapers/ # 소스별 스크래퍼
│ ├── source_a.py # 1차 시장
│ ├── source_b.py # 2차 시장
│ └── base.py # robots.txt·rate limit
├── utils/
│ ├── fingerprint.py # 상품 매칭 해시
│ └── fx.py # 통화 정규화
└── app.py # Streamlit 대시보드
핵심 Skill
/ingest— 복수 소스 가격 자동 수집/match— 동일 상품 fingerprint 매칭/compare— 시장 간 가격·트렌드 비교 차트
부록 A. 학술논문 MCP 서버 현황
2026년 3월 12일 기준
주요 학술 MCP 서버 비교표
| MCP 서버 | 데이터 소스 | 논문 수 | 전문접근 | 한국어 | 추천도 |
|---|---|---|---|---|---|
| arxiv-mcp | arXiv | 240만+ | O (OA) | X | ★★★ |
| semantic-scholar | Semantic Scholar | 2.1억+ | X | 극히 제한 | ★★★ |
| pubmed-mcp | PubMed | 3,600만+ | △ PMC만 | X | ★★★ |
| openalex-mcp | OpenAlex | 2.4억+ | △ Jina | 극히 제한 | ★★☆ |
| zotero-mcp | 개인 라이브러리 | 보유분 | △ 로컬 | O 수동 | ★★★ |
| dbpia-mcp | DBpia | 350만+ | △ 구독시 | O | ★★☆ |
O=가능, △=조건부, X=불가
한국어 논문 — MCP 현황
추천 워크플로우: RISS 검색 → PDF 다운로드 → Zotero 라이브러리 추가 → Zotero MCP로 Claude Code에서 분석
필수 검증: AI가 인용한 모든 논문은 DOI 또는 RISS/DBpia에서 직접 확인 후 사용하세요.
부록 B. 연구자를 위한 Skill 카탈로그
바로 설치 가능한 연구용 Skill
| 프로젝트 | 주요 기능 | GitHub |
|---|---|---|
| academic-research-skills | 13+12+5 에이전트 파이프라인. PRISMA 체계적 리뷰 | Imbad0202 |
| agent-research-skills | 31개 Skill 논문 라이프사이클 전체 | lingzhi227 |
| Deep-Research-skills | 2단계 구조화 리서치 + Human-in-Loop | Weizhena |
| claude-scientific-skills | 170+ 과학 Skill. 문헌리뷰, 가설생성, 인용관리 | K-Dense-AI |
| claude-scientific-writer | 20개 학술 글쓰기 Skill 플러그인 | K-Dense-AI |
| DAAF | 데이터 분석 5-10배 가속 프레임워크 | DAAF-Community |
| claudeblattman | 비개발자 학자 종합 워크플로우 | chrisblattman |
| gptaku_plugins | 한국어 8개 플러그인 (리서치·Git·분석) | fivetaku |
직접 만들면 좋을 Skill 아이디어
| Skill 이름 | 기능 | 생성 프롬프트 |
|---|---|---|
| policy-brief-writer | 2-3p 정책 브리프 자동 작성 | "정책 브리프 Skill 만들어줘" |
| korean-lit-reviewer | 한국어 논문 PDF 구조화 리뷰 | "한국어 논문 리뷰 Skill" |
| survey-analyzer | 설문 CSV/Excel 자동 분석 | "설문 분석 Skill 만들어줘" |
| grant-proposal-kr | 한국 NRF 양식 연구비 제안서 | "한국 연구비 제안서 Skill" |
| seminar-prep | 논문→세미나 발표 준비 자료 | "세미나 준비 Skill" |
| peer-review-helper | 구조화된 피어리뷰 초안 작성 | "피어리뷰 보조 Skill" |
| if-journal-filter 🆕 | 논문 검색 결과를 Impact Factor 기준(Q1~Q4 Tier)으로 자동 필터링 | "IF 필터 Skill 만들어줘" |
| literature-review 🆕 | 논문 목록 → 체계적 문헌 리뷰 초안 자동 생성 (PRISMA 구조) | "문헌 리뷰 자동화 Skill" |
| gap-analysis 🆕 | 5유형 연구 갭 매트릭스 자동 분석 → 후속 연구 질문(RQ) 생성 | "연구 갭 분석 Skill" |
부록 C. AI-Researcher 오픈소스 레퍼런스 🆕
학술 연구를 위한 AI 에이전트 오픈소스 프로젝트 레퍼런스. Claude Code에서 직접 활용하거나 설계 참고용으로 사용.
HKUDS/AI-Researcher
| 항목 | 내용 |
|---|---|
| GitHub | github.com/HKUDS/AI-Researcher |
| 핵심 기능 | 자동 문헌 조사 → 연구 갭 발견 → 가설 생성 → 실험 설계 → 논문 초안 작성 |
| 에이전트 구성 | Idea Agent / Survey Agent / Experiment Agent / Writing Agent |
| 지원 형식 | arXiv 논문, PDF, LaTeX 출력 |
| 주요 도구 | Semantic Scholar API, arXiv API, Python 코드 실행 환경 |
Claude Code에서 활용하는 법
AI-Researcher 전체를 그대로 사용하기보다, 파이프라인 구조를 참고해 자신의 연구 분야에 맞는 에이전트를 설계하는 것이 현실적입니다.
| AI-Researcher 구성요소 | Claude Code 대응 |
|---|---|
| Survey Agent | Ch.8b의 Paper Search Agent + Paper Organizer |
| Idea/Gap Agent | Ch.8b의 Gap Finder (5유형 갭 매트릭스) |
| Writing Agent | literature-review Skill + 논문 초안 작성 프롬프트 |
| Experiment Agent | Claude Code + Python MCP 직접 실행 환경 |
관련 오픈소스 프로젝트
| 프로젝트 | 특징 | 링크 |
|---|---|---|
| AI Scientist (Sakana AI) | 자동 과학 발견 → 논문 작성 → NeurIPS 제출까지 | SakanaAI/AI-Scientist |
| ResearchAgent | 인터리빙 방식 아이디어 확장 + 지식 그래프 | JinheonBaek/ResearchAgent |
| AutoSurvey | 키워드 입력 → 서베이 논문 자동 생성 | AutoSurveys/AutoSurvey |
D. 자주 묻는 질문 (FAQ)
3회 워크숍(AX-260313/315/317) 현장에서 반복적으로 등장한 질문을 주제별로 정리합니다. 본문 01~10장에서 이미 상세히 다룬 주제(CLAUDE.md vs Skill, MCP vs API, 토큰 절약법, 하네스 엔지니어링 등)는 여기서 제외하고, 현장에서 "어? 이건 어떻게 하지?" 순간에 필요한 실전 Q&A만 담았습니다.
D.1 실행 · 출력 관련
Q1. 에이전트를 만들었다는데, 이거 어떻게 실행해요?
가장 쉬운 방법은 "실행해줘"라고 말하는 것입니다. Claude Code가 설치 필요 여부·API 키 필요 여부를 안내해줍니다. 에러가 나면 에러 메시지를 복사해서 "이거 해결해줘"라고 전달하면 됩니다.
Q2. Skill을 깔았는데, 그럼 에이전트 실행은 어떻게 하나요?
따로 실행하는 게 아닙니다. Skill은 서랍에 넣어둔 업무 매뉴얼이고, Claude가 "이 일에 이 매뉴얼이 필요하구나"라고 판단하면 알아서 꺼내 씁니다. 당신이 할 일은 그냥 평소처럼 대화하는 것뿐입니다.
예: "AI 교육 관련 논문 리뷰해줘"라고 하면 → Skill 자동 인식 → 관련 에이전트들이 순서대로 가동 → 검색·분석·초안·검증·완성본까지 한 번에.
명시적으로 호출하고 싶다면 슬래시 명령어를 쓰세요: /academic-research AI 교육처럼 입력하면 해당 Skill의 전체 파이프라인이 시작됩니다.
Q3. 뭔가 만들어진 것 같은데, 저는 왜 다른 분들처럼 웹페이지가 안 보이죠?
Output은 웹페이지만이 아닙니다. Skill에 어떻게 지시했느냐에 따라 결과물이 달라집니다.
| 지시 | 결과물 |
|---|---|
| "웹으로 시각화해줘" | HTML 대시보드 |
| "논문 형식으로 써줘" | LaTeX / PDF |
| "요약 리포트만" | Markdown |
| "데이터 정리해줘" | Excel / CSV |
즉, 같은 Skill이라도 "어떻게 출력해(output 형식을 뭘로 할지)"가 결과를 바꿉니다. 웹페이지를 원했다면 명시적으로 *"웹으로 시각화"*를 요청해보세요.
D.2 환경 · 설치 관련
Q4. Claude Code랑 Claude 웹(claude.ai)은 뭐가 달라요?
| 항목 | Claude 웹 | Claude Code |
|---|---|---|
| 실행 위치 | 브라우저 안 | 내 컴퓨터에서 실행 |
| 파일 접근 | 파일을 하나하나 업로드해야 함 | 폴더 경로만 알려주면 수백 개 파일 자동 읽음 |
| 기억 | 대화 끝나면 잊음 | CLAUDE.md 규칙을 계속 기억 |
| 외부 서비스 연결 | 제한적 | Notion · Google Drive · 논문 DB 등 MCP로 연결 |
| 파일 영속성 | 세션 종료 시 소멸 | 실제 로컬 파일에서 작업 → 영구 |
| 적합한 용도 | 단발성 질문 · 간단한 파일 작업 | 지속 프로젝트 · 대규모 리팩토링 · 로컬 도구 연동 |
Q5. 꼭 설치해야 하는 게 뭔가요? (Claude Code 기본 셋팅)
- Node.js — Claude Code 설치의 필수 요건 (
nodejs.org) - Python — 많은 Skill이 Python 스크립트로 동작 (
python.org) - 유료 플랜 또는 API 키
설치가 귀찮다면 Claude Code에게 "환경 세팅해줘" 라고 말하세요. 뭐가 없는지 확인하고, 설치 명령어를 생성해서 실행까지 자동으로 해줍니다.
Q6. 왜 폴더 위치가 중요한가요? iCloud에 프로젝트 만들면 왜 에러가 나요?
Claude Code는 지정된 폴더 안의 파일만 읽고 수정할 수 있습니다. 잘못된 폴더에서 실행하면 파일을 못 찾거나 에러가 납니다.
클라우드 동기화 폴더는 피하세요:
- iCloud Drive · Google Drive · OneDrive · Dropbox 등
- 동기화 중 파일 잠금 · 충돌 · 복제 · 손상 위험
- Windows + iCloud 조합은 공식적으로 비권장
권장 경로:
- macOS / Linux:
~/Documents/projects/또는~/projects/(iCloud 동기화 해제 확인) - Windows:
C:\Users\내이름\projects\
핵심은 로컬 폴더 + 클라우드 동기화 제외입니다.
Q7. Claude Code만 돼요? Codex나 안티그래비티는?
아닙니다. 터미널 기반 코딩 에이전트는 여러 종류가 있습니다.
| 도구 | 제작사 | 특징 |
|---|---|---|
| Claude Code | Anthropic | 현재 코딩 벤치마크 최상위권, MCP 생태계 가장 풍부 |
| OpenAI Codex CLI | OpenAI | Rust 기반 오픈소스, ChatGPT Plus/Pro/Team 구독에 포함 |
| Antigravity | Google DeepMind | VS Code 포크 + Gemini 3, 멀티 에이전트 병렬 + 브라우저 검증 |
| Cursor | Anysphere | IDE 통합형, Cursor Rules로 프로젝트 규칙 관리 |
Skill과 MCP는 Claude Code가 먼저 도입했지만, 현재는 오픈 표준으로 다른 도구들도 비슷한 개념을 채택하고 있습니다.
Q7-1. .env 파일이 뭐고, API 키는 어떻게 저장하나요?
.env는 API 키·비밀번호 등 민감 정보를 저장하는 텍스트 파일입니다. 프로젝트 루트에 두고, 코드와 분리해서 관리합니다.
파일 내용 예시 (.env):
ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...
GOOGLE_MAPS_API_KEY=AIza...
왜 쓰나:
- GitHub 실수 방지 — 코드에 API 키를 직접 쓰면 커밋 시 공개됨 → 봇이 30초 안에 수집해서 악용
- 환경 분리 — 개발/배포마다 다른 키 사용 가능
- 표준 관행 — Python·Node.js·거의 모든 프로젝트에서 공통 사용
반드시 할 것:
.gitignore에.env한 줄 추가 (Git이 절대 추적하지 않음)- 팀 공유는
.env.example로만 (키 값은 빈칸, 어떤 변수가 필요한지만 알려줌) - 실수로 커밋했다면 즉시 키를 폐기(rotate)하고 새로 발급
Claude Code에서 쓰는 법:
프로젝트 루트에 .env를 두면 python-dotenv(Python)·dotenv(Node.js) 같은 라이브러리로 자동 로드됩니다. Claude Code에게 "API 키를 .env에서 읽어 쓰게 코드 수정해줘"라고만 하면 알아서 변환합니다.
.env를 커밋한 뒤 GitHub 공개 저장소에 올리는 것. 봇이 실시간으로 키를 수집해 악용합니다. Anthropic API 기준 수십만 원 단위 과금 피해 사례 다수.
D.3 용어 정리 — 헷갈리는 기본 개념
Q8. IDE, CLI, GUI, 터미널이 다 뭐에요?
| 용어 | 정체 | 예시 |
|---|---|---|
| GUI (Graphical User Interface) | 마우스·클릭으로 조작하는 그래픽 인터페이스 | Finder, 탐색기, VS Code 화면 |
| CLI (Command Line Interface) | 텍스트 명령어로 컴퓨터를 직접 제어하는 방식 | git commit, npm install |
| 터미널 (Terminal / Shell) | CLI 명령어를 입력하는 창(프로그램) | Terminal.app, iTerm2, PowerShell, Git Bash |
| IDE (통합 개발 환경) | 코드 작성·실행·디버깅을 한 곳에서 하는 프로그램 | VS Code, Cursor |
요약: 터미널(창)에서 CLI(방식)로 명령어를 입력. GUI는 그 반대, 마우스로 조작하는 그래픽 화면. Claude Code는 터미널에서 CLI 방식으로 동작합니다.
Q9. 토큰(Token)이 정확히 뭐고, 왜 중요하죠?
한마디로: AI가 글을 읽는 단위. 사람은 글자 단위로 읽지만, AI는 토큰 단위로 읽습니다.
- 영어 1단어 ≈ 1토큰
- 한글 1글자 ≈ 2~3토큰 (한국어는 토큰을 더 많이 씁니다)
왜 중요한가:
- 요금 기준 — API는 토큰 수로 과금. 많이 쓸수록 비용 증가
- 기억력 한계 — AI가 한 번에 기억하는 양 = 컨텍스트 윈도우 (토큰 단위)
- 응답 품질 — 대화가 길어지면 앞부분을 "잊어버림" → 새 세션 시작 필요
비유하자면 택시 미터기입니다. 질문이 길수록(거리가 멀수록) 비용이 올라갑니다. 자세한 절약법은 본문 6장 참조.
Q10. 컨텍스트 윈도우는 뭐고, 왜 관리해야 하나요?
Claude가 한 번에 참고할 수 있는 정보량의 한계입니다.
- 기본: 약 200K 토큰
- Max 플랜: 1M 토큰까지 확장
대화가 길어질수록 시스템 프롬프트·도구 호출 결과·이전 히스토리가 쌓여 성능이 점차 저하됩니다. 관리법은 간단합니다:
/clear로 주기적 초기화- 하나의 세션에서 너무 많은 주제를 다루지 않기
- 큰 작업은 여러 세션으로 분할
- CLAUDE.md에 프로젝트 맥락 기록 → 매 세션 자동 로드
Claude의 응답 품질이 눈에 띄게 떨어지면 새 세션을 시작하세요. 이게 가장 확실한 신호입니다.
D.4 비용 · 플랜 관련
Q11. 구독료 말고 비용이 또 드나요?
세 가지를 구분해야 합니다.
| 구분 | 비용 | 언제 발생하나 |
|---|---|---|
| Claude 구독료 | 월 $20 ~ $200 | Claude Code 기본 사용료. 이것만으로 웬만한 건 다 됨 |
| API 사용료 | 토큰 기반 종량제 | Claude API를 외부에서 호출할 때만. 구독료와 완전 별개. 소규모 테스트는 $5 이내로 충분 |
| MCP | 통로 자체는 무료 | MCP 프로토콜은 무료. 대상 서비스가 유료면 그 비용만 별도 |
Q12. Pro 구독으로 내가 만든 앱/웹서비스를 돌릴 수 있나요?
2026.4.4부터 차단되었습니다. Anthropic이 서드파티 도구(Cline, Cursor 등)의 Pro 구독 인증 공유 사용을 공식 차단했습니다. 이유: "구독은 서드파티의 사용 패턴용이 아니며, 자사 제품 우선."
| 가능 | 불가능 |
|---|---|
| Claude Code 터미널, Claude.ai 웹/앱 | 내가 만든 웹앱/자동화 봇에 Pro 구독 연결 |
| Cowork | 다른 사람이 쓰게 하는 서비스 |
claude -p 스크립트 (Pro 할당량 사용) | 프로그래밍 방식 API 호출 |
결론: Pro $20은 본인이 Anthropic 제품 안에서 쓰는 용도에 한정. 외부 서비스 구축은 API 키 + 종량제 필요.
Q13. Rate Limit — 왜 이렇게 빨리 한도가 차요?
Rate Limit은 "일정 시간 안에 쓸 수 있는 양의 한계" — 뷔페의 2시간 음식 총량 제한과 같습니다.
- 5시간 롤링 윈도우: Pro 약 10~40 프롬프트, Max 20x 약 200~800 프롬프트
- 주간 한도 (2025.8~): 1주 단위 총량. 어느 한쪽이라도 도달 시 차단
빨리 도달하는 전형적 상황:
- 대규모 코드베이스 장시간 세션 (500개 파일 → 요청당 50만+ 토큰)
- Plan 모드 대규모 리팩토링 — 프롬프트 3개에 4시간치 소진 사례 있음
- 피크 시간대 (한국 기준 밤 9시~새벽 3시)
- "다듬어줘" 반복 — 매번 전체 컨텍스트 재전송으로 기하급수적 증가
실전 대응:
- 세션 분할 — 작업 단위별 새 세션 +
/clear - 모델 전환 — 탐색은 Sonnet, 핵심 분석만 Opus
- 구체적 지시 — "프로젝트 살펴봐" ❌ → "model.R 120~150줄 수정" ✓
- 배치 처리 — 3번 따로 ❌ → "세 가지를 한 번에 수정" ✓
/compact·/stats로 모니터링
D.5 협업 구조 · 고급 기능
Q14. Subagent랑 Agent Teams는 뭐가 다른가요? 3단계 협업 구조가 있다던데?
Claude Code 협업은 3단계로 나뉩니다.
1단계 — Subagent (팀장 + 팀원)
- 팀원끼리 대화 불가, 팀장(메인)에게만 보고
- 95%의 작업에 이 단계면 충분
2단계 — Agent Teams (팀원끼리 직접 소통)
- 공유 작업 목록(Task List) 기반
- 대형 공동 연구 프로젝트에 적합
- 실험적 기능: 터미널에서
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 - Max 플랜 이상 필요
3단계 — 외부 오케스트레이터 (팀 자체를 여러 개)
- Gas Town, Multiclaude 등
- 팀 A: 수집, 팀 B: 분석 식으로 분업
- 실험적이고 비용이 높음
멀티 에이전트는 95%의 작업에 불필요하고 비용도 큽니다. 대부분의 연구 작업은 1단계(Subagent)면 충분합니다. 대형 공동 연구 프로젝트일 때만 2단계를 고려하세요.
Q15. Skill과 Subagent, 뭐가 다른가요? (혼동 주의)
| 구분 | Skill | Subagent |
|---|---|---|
| 비유 | 매뉴얼 (무엇을 할지 알려주는 지침서) | 부하 직원 (독립적으로 일하는 분신) |
| 실행 | 현재 대화 안에서 실행 | 별도의 AI가 따로 생성되어 자기 대화에서 작업 |
| 예시 | "/논문검색" 치면 검색 절차·포맷·출처 규칙이 자동 로드 | "파일 100개 분석해줘" → Subagent가 백그라운드에서 처리, 본체는 다른 일 계속 |
| 한 줄 | "이렇게 해"라는 지침 | "네가 가서 해와"라는 위임 |
Q16. Hook을 구체적으로 어떻게 써요?
Hook = *"이 일이 끝나면 자동으로 저것도 해줘"*라는 자동 실행 규칙입니다. 설정 파일에 "언제" + "무엇을 실행할지"만 적으면 끝 — 코딩 지식 불필요.
실생활 연구자 시나리오:
- 분석이 끝나면 → 결과를 자동으로 결과 파일에 기록 (매번 직접 저장 불필요)
- 위험한 파일 삭제 명령 직전 → 자동 차단 (실수로 raw-data 날리는 사고 방지)
- Claude 작업 완료 → 컴퓨터 알림음 + 팝업 (자리 비워도 완료 확인)
비개발자도 *"Hook 만들어줘"*라고 자연어로 요청 가능합니다. 상세는 본문 4.1 참조.
Q17. API는 언제 꼭 필요한가요? 그냥 Pro 구독으로 다 안 되나요?
대부분의 연구자는 API 없이도 충분합니다. claude -p (headless 모드)로 쉘 스크립트 수준 자동화까지 가능하거든요.
Pro 구독으로 가능한 것:
# 데이터 분석 자동화
cat data.csv | claude -p "전처리 후 기술통계 R로 분석해줘"
# 논문 배치 처리
for f in papers/*.pdf; do
claude -p "이 논문의 방법론·결과 요약해줘" < "$f"
done
이 선을 넘으면 API 종량제 필요:
- 웹 서비스로 만들어 다른 사람이 쓰게 할 때
- 프로그래밍 방식으로 API를 직접 호출할 때
- 타사 도구(Cursor, Cline 등)에 연결할 때
D.6 데이터 보안 · 연구 윤리
Q18. IRB 데이터나 민감한 연구 데이터를 Claude Code에 넣어도 되나요?
주의가 필요합니다. Claude Code는 로컬 실행이지만, 대화 내용과 코드는 Anthropic API를 통해 전송됩니다.
| 데이터 유형 | 사용 |
|---|---|
| 공개 데이터셋 · 비식별화 데이터 | 사용 가능 |
| IRB 보호 데이터 · FERPA · 개인정보 | 소속 기관 AI 도구 사용 정책 반드시 확인. IRB 승인 필요할 수 있음 |
| HIPAA 규제 대상 | Enterprise 플랜의 HIPAA 준비 버전 사용 권장 |
원칙: 의심스러우면 비식별화 후 사용하고, 기관 정책을 항상 우선하세요. 투고 시 AI 사용 공시도 잊지 마세요 (본문 9.4 참조).
D.7 실용 팁
Q19. Google Scholar API는 없나요? 논문 검색은 어떻게 하는 게 좋아요?
Google Scholar는 공식 API가 없습니다. 스크래핑도 적극 차단됩니다 (CAPTCHA·IP 차단·rate limiting). scholarly 같은 비공식 라이브러리는 대량 쿼리에 불안정합니다.
실질적 대안 (공식 API 학술 DB):
| DB | 특징 | 추천도 |
|---|---|---|
| OpenAlex | 완전 무료, REST API, 2.5억+ 논문, 저자·기관·개념 그래프 | ★★★ 현재 가장 실용적 |
| Semantic Scholar (S2) | Allen AI 운영, 무료 API, 초록·인용 그래프·TLDR 제공 | ★★★ |
| CrossRef | DOI 기반 메타데이터 API, 출판사 정보·인용 관계 | ★★ |
| PubMed (Entrez API) | 생의학 분야 특화, NCBI 공식 API | ★★ (해당 분야만) |
Q20. Desktop Commander가 뭐고 왜 쓰나요?
Desktop Commander는 Claude에게 "손"을 달아주는 MCP입니다.
할 수 있는 일:
- 내 컴퓨터의 파일을 읽고, 쓰고, 검색
- 터미널 명령어를 직접 실행 (프로그램 설치, 코드 실행 등)
- 코드 파일을 찾아서 원하는 부분만 수정 (전체 덮어쓰기 ❌)
비개발자에게 특히 유용한 시나리오:
- "이 폴더에서 2024년 이후 PDF만 찾아줘" → 바로 실행
- "이 엑셀 파일 읽어서 분석해줘" → 바로 실행
- "스크린샷 파일 정리해줘" → 폴더 만들고 분류까지 자동
설치: Claude Desktop → 설정 → MCP → Desktop Commander 추가. 무료 오픈소스, Node.js만 설치되어 있으면 됩니다.
Q21. Cowork는 뭐고, Claude Code랑 뭐가 달라요?
Cowork는 Claude 데스크톱 앱의 에이전트 도구입니다. 터미널 없이 GUI 환경에서 로컬 파일 작업이 가능하고, 격리된 VM에서 실행되며, MCP 통합을 지원합니다.
역할 분담 (연구자 관점):
| 도구 | 비유 | 적합 작업 |
|---|---|---|
| Claude Code | 작업장 | 코드 실행, 분석 스크립트, 문서 컴파일, git 관리 |
| Cowork | 사무실 | PDF 정리, 스프레드시트 가공, 초고 정리, 핸드아웃 제작 |
판단 기준:
- 결과가 코드 실행·분석이면 → Claude Code
- 결과가 파일 정리/변환/배포면 → Cowork
본 자료의 저작권은 리나몬드(한국AI미래연구소)에 있습니다. 무단 배포 및 상업적 사용을 금지합니다. | 저작권 제C-2026-016802호
E. 치트시트 & 레퍼런스
E.1 핵심 명령어 치트시트
터미널 진입: claude / claude -c (이어서) / claude "질문"
세션 관리: /clear 대화 전체 삭제 (작업 전환 시)
/compact 요약 후 재시작 (같은 작업 계속)
/cost 비용 확인
/context 컨텍스트 사용률
/rename 세션 이름 변경 (나중에 찾기 쉽게)
/resume 이름으로 되돌아오기
계획·실행: /plan Plan Mode (Shift+Tab 두 번)
/model 모델 전환 (sonnet/opus/opusplan)
/effort 추론 강도 (낮음/중간/높음)
ultrathink 최대 추론 모드 (프롬프트에 포함)
반복·자동: /loop 1h "..." 주기 반복 (세션 열려 있을 때만)
/batch "..." 다중 파일 일괄 처리
/btw "..." 사이드 질문 삽입
입력: /voice 음성 입력 (스페이스바 push-to-talk)
멀티세션: /color blue/red/green 터미널 테마로 세션 구분
플러그인: /plugin Discover/관리 UI
/plugin marketplace add owner/repo
/plugin install name@marketplace
/plugin marketplace list
/plugin marketplace update <name>
/reload-plugins
키보드: Shift+Enter 줄바꿈
Shift+Tab 모드 전환
Ctrl+C 중단
Esc+Esc 되감기
E.2 환경 변수 (고급)
# 비용 절감
export DISABLE_NON_ESSENTIAL_MODEL_CALLS=1 # 배경 모델 호출 억제
export DISABLE_COST_WARNINGS=1 # 비용 경고 억제
export MAX_THINKING_TOKENS=8000 # extended thinking 상한
# 디버깅 시에만 (평소에는 켜둘 것)
export DISABLE_PROMPT_CACHING=1
# 추가 디렉토리의 CLAUDE.md 로드
export CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1
E.3 공식 레퍼런스 (2026.04 현재)
Anthropic 공식:
- Claude Code Docs:
https://code.claude.com/docs/en/ - Claude API Docs:
https://platform.claude.com/docs/en/ - Engineering Blog:
https://www.anthropic.com/engineering/ - 하네스 디자인:
/harness-design-long-running-apps - 매니지드 에이전트:
/managed-agents - Skill 엔지니어링:
/equipping-agents-for-the-real-world-with-agent-skills - Help Center:
https://support.claude.com/en/ - 공식 Skill 레포:
https://github.com/anthropics/skills - 공식 플러그인 마켓플레이스:
https://github.com/anthropics/claude-plugins-official - 플러그인 카탈로그:
https://claude.com/plugins
커뮤니티 (큐레이션):
- Skill 목록:
https://github.com/travisvn/awesome-claude-skills - SkillsMP (오픈소스 스킬 마켓플레이스):
https://skillsmp.com
참고 자료
공식 문서
- Claude Code 공식: code.claude.com/docs/en/overview
- Cowork 가이드: support.claude.com/en/articles/13345190
- Agent Skills: platform.claude.com/docs/agents-and-tools/agent-skills
- Anthropic Skills: github.com/anthropics/skills
- CC101 한국어 가이드: cc101.axwith.com/ko
학술 자료
- Korinek, A. (2025). AI Agents for Economic Research. NBER WP 34202.
- CEUR Workshop (2025). Deep Research in the Era of Agentic AI.
- Deloitte (2025). Agentic AI Strategy. Tech Trends 2026.
커뮤니티
2026년 3월 기준 작성. Claude Code와 Cowork는 빠르게 업데이트 중이므로 공식 문서를 참조하세요.