🥔 potato-kit

Claude Code를 연구용 작업대로 바꿔주는 설치형 킷

논문 찾기 · 데이터 수집 · 분석 · 방법론 감사 · 보고서까지
연구 한 사이클을 슬래시 명령 몇 개로 돌린다

설치 · 처음이라면 · 첫 실행 · 전공 팩 · 스킬 · 사용법 가이드 · 완주 예제

---

이게 뭔가요

Claude Code는 강력하지만 범용 도구입니다. 연구자가 쓰려면 매번 같은 걸 설명해야 하죠 — "데이터 누수 조심해", "결과는 재현 가능한 스크립트로 남겨줘", "논문 좀 찾아줘"…

potato-kit은 그 반복을 없앱니다. 한 번 설치하면:

🔬 연구 절차가 내장됩니다 문헌조사 → 데이터 발굴 → 탐색 → 실험 → 감사 → 보고 여섯 단계가 슬래시 명령으로 들어 있습니다	🧪 전공별로 갈아 끼웁니다 의료·금융·해양·문헌정보·산업공학… /potato-add-pack 한 줄로 그 분야 데이터베이스가 붙습니다
🛡️ 틀린 결과를 잡아냅니다 데이터 누수, 검증 설계 오류, 통계 오용을 전담 에이전트가 분야별 체크리스트로 감사합니다	💸 Pro 구독이면 충분합니다 모든 모델이 Sonnet으로 고정돼 있어 한도가 오래갑니다. Windows에서도 그대로 동작합니다

---

🚀 설치 (5분)

Windows (PowerShell · VS Code 터미널 · Anaconda Prompt — 아무거나)

git clone https://github.com/MyStraw/potato-kit.git
cd potato-kit
powershell -ExecutionPolicy Bypass -File .\install.ps1

conda 를 못 찾는다는 오류가 나면 스크립트가 해결 방법을 알려줍니다. 미리 보려면 터미널 여는 법 절을 참고하세요.

macOS / Linux

git clone https://github.com/MyStraw/potato-kit.git
cd potato-kit
bash install.sh

Codex CLI 를 쓴다면 (ChatGPT 구독)

bash install-codex.sh                                          # macOS/Linux
powershell -ExecutionPolicy Bypass -File .\install-codex.ps1    # Windows

Codex 는 구조가 달라 일부만 그대로 옮겨집니다. 아래 표를 먼저 보세요.

	Claude Code	Codex CLI
운영 규칙	CLAUDE.md ✅	AGENTS.md ✅ 자동 생성
MCP 서버	✅	✅ codex mcp add
슬래시 명령 (/potato-research 등)	✅ 14종	❌ → 말로 요청하면 AGENTS.md 가 해당 스킬 파일로 라우팅
서브에이전트 4종	✅ 자동 위임	❌ → 역할 파일을 읽고 직접 수행

절차 자체는 같습니다. Codex 도 파일을 읽을 수 있으므로, "이 데이터 EDA 해줘" 라고 하면 AGENTS.md 가 .claude/skills/potato-eda/SKILL.md 를 읽으라고 지시하고 같은 절차를 따릅니다.

💡 감사는 새 Codex 세션에서 돌리세요. 서브에이전트가 없어 같은 대화에서 자기 코드를 감사하게 되는데, 그러면 확증 편향이 생깁니다.

준비물

필요한 것	확인	없으면
Claude Code	claude --version	설치 안내
Claude 구독	claude → /login	Pro면 충분합니다
Python (Anaconda/Miniconda)	conda --version	설치 스크립트가 안내합니다
Node.js (선택)	node --version	일부 MCP에만 필요

설치 스크립트가 하는 일

1. conda 확인 → 없으면 Miniconda 설치 안내
2. potato 라는 conda 환경 생성 (Python 3.11)
3. 분석 라이브러리 + MCP 서버 패키지 설치
4. 공통 코어 MCP 2종을 Claude Code에 등록
5. 스킬·에이전트·팩을 설정 디렉토리로 복사
6. 기본 모델을 Sonnet으로 지정 (이미 지정돼 있으면 건드리지 않음)
7. 화면 아래 상태줄 등록 — 계정·모델·컨텍스트·구독 사용량 (기존 상태줄이 있으면 유지)

💡 유저 스코프로 설치되므로 어느 폴더에서든 동작합니다. 킷 폴더 안에서만 쓸 수 있는 게 아닙니다.

확인

claude mcp list     # paper-search 가 보이면 성공

그다음 Claude Code를 껐다 켜고 /potato-add-pack list 를 쳐보세요.

---

👋 Claude Code를 한 번도 안 써봤다면

여기부터 읽으세요. 5분이면 됩니다. 이미 써봤다면 다음 절로 넘어가세요.

1. Claude Code가 뭔가요

터미널에서 대화하는 AI 조수입니다. ChatGPT처럼 대화하는데, 차이가 있어요:

• 내 컴퓨터의 파일을 직접 읽고 씁니다
• 파이썬 코드를 짜고 실제로 실행합니다
• 논문을 찾고, 데이터를 받고, 그림을 그려서 저장합니다

즉 "코드 알려주세요" → 복붙 → 에러 → 다시 물어보기… 이 과정이 없습니다. 그냥 시키면 자기가 짜고, 돌리고, 에러 나면 고칩니다.

2. 터미널 여는 법

아무 터미널이나 됩니다. 편한 걸 쓰세요.

	여는 법
VS Code (추천)	VS Code 실행 → 폴더 열기 → `Ctrl + `` (백틱)
Windows PowerShell	시작 버튼 → PowerShell 검색
Anaconda Prompt	시작 버튼 → Anaconda Prompt 검색
macOS	Cmd + Space → 터미널

커서가 깜빡이면 성공입니다. 여기에 명령을 타이핑하고 엔터를 칩니다.

⚠️ 먼저 이것부터 확인하세요

conda --version

conda 25.x.x 처럼 버전이 나오면 그대로 진행하면 됩니다.

'conda'은(는) 내부 또는 외부 명령... 이 아닙니다 라고 나오면 — conda가 이 터미널에 등록되지 않은 것뿐입니다. 한 번만 아래를 하면 이후로는 계속 됩니다.

Windows에서 conda 를 못 찾을 때 (펼치기)

1단계 — PowerShell을 관리자 권한으로 열고 한 번 실행:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

PowerShell이 시작 스크립트를 읽도록 허용하는 설정입니다. Y 를 눌러 확인하세요. (이걸 안 하면 다음 단계를 해도 conda가 계속 안 잡힙니다 — 가장 흔한 원인입니다)

2단계 — 시작 버튼 → Anaconda Prompt 를 열고:

conda init powershell

3단계 — 터미널을 완전히 닫았다가 다시 엽니다. VS Code를 쓴다면 VS Code 자체를 껐다 켜세요.

이제 PowerShell·VS Code 터미널 어디서든 conda --version 이 됩니다.

그래도 안 되면 그냥 Anaconda Prompt 에서 작업하세요. 기능은 똑같습니다. (Anaconda Prompt = conda가 미리 켜져 있는 명령 프롬프트)

3. 슬래시 명령(스킬)이 뭔가요

Claude Code 안에서 /로 시작하는 명령입니다. 미리 짜둔 작업 절차를 부르는 단축키예요.

예를 들어 /potato-eda data/train.csv 라고 치면 — "이 데이터의 행·열·결측·분포를 조사하고 HTML 리포트로 만들어줘. 아, 그리고 개인정보는 화면에 띄우지 말고, 결과는 파일로 저장해줘…" 를 매번 설명할 필요 없이 한 줄로 끝납니다.

	이렇게 하면
그냥 말하기	이 데이터 좀 살펴봐줘 ← 이것도 됩니다
슬래시 명령	/potato-eda data/train.csv ← 더 정확하고 빠릅니다

/potato- 까지만 치면 목록이 뜹니다. 14개 중에 골라 쓰면 돼요.

4. 진짜 첫 세션 — 이대로 따라 하세요

설치를 마쳤다면, 터미널에서:

mkdir 내연구            # 작업할 폴더 만들기
cd 내연구               # 그 폴더로 들어가기
claude                 # Claude Code 켜기

Claude Code가 켜지면 아래를 순서대로 칩니다. 각각 엔터 치고 답이 올 때까지 기다리세요.

1️⃣  /login

브라우저가 열리면 Claude 계정으로 로그인합니다. 한 번만 하면 됩니다. (처음 켜면 로그인 화면이 알아서 뜨기도 합니다. 그러면 이 단계는 건너뛰세요.)

2️⃣  /potato-add-pack list

내 전공에 맞는 팩이 뭐가 있는지 봅니다.

3️⃣  /potato-add-pack medical

자기 전공 팩을 켭니다 (의료면 medical, 금융이면 finance…). 한 번만 켜면 계속 유지됩니다. 설치가 끝나면 Claude Code를 껐다 켜세요 (/exit 또는 Ctrl+C 두 번 → 다시 claude). MCP는 켤 때 연결되거든요.

4️⃣  /potato-start 내 연구 주제

폴더를 정리하고, 연구 성격(해커톤인지 논문인지)과 데이터 반출 제한이 있는지를 물어봅니다. 답만 하면 됩니다.

5️⃣  /potato-research

이제 시작입니다. 상황을 물어보고 알아서 이끌어줍니다.

5. 처음에 헷갈리는 것들

Q. 팩은 매번 켜야 하나요? 아니요. 한 번만 켜면 계속 유지됩니다. /potato-find-data medical 폐암데이터 처럼 명령 뒤에 팩 이름을 붙이는 게 아닙니다.

✗  /potato-find-data medical 폐암 데이터
✓  /potato-add-pack medical        ← 처음 한 번만
✓  /potato-find-data 폐암 환자 생존 데이터

Q. 뭘 쳐야 할지 모르겠어요 /potato-research 만 치세요. 뭘 하려는지 물어봐 줍니다.

Q. 슬래시 명령을 꼭 써야 하나요? 아니요. "이 데이터 좀 봐줘" 처럼 그냥 말해도 알아듣습니다. 슬래시 명령은 더 정확한 결과가 나오는 지름길일 뿐이에요.

Q. 답이 이상하거나 엉뚱한 걸 해요 Esc 를 눌러 중단하고 다시 말하면 됩니다. 되돌릴 수 없는 작업(파일 삭제 등)은 실행 전에 물어보게 돼 있습니다.

Q. 대화가 길어져서 느려요 /clear 로 새 대화를 시작하세요. 작업 내용은 plan.md에 남아 있어서 /potato-research 이어서 라고 하면 이어집니다.

Q. 한도(사용량)가 다 됐다고 나와요 Claude Pro는 일정 시간마다 한도가 회복됩니다. 그때까지는 /potato-research 같은 무거운 작업 대신 /potato-report 같은 정리 작업을 하세요.

---

🎯 첫 실행 — 나는 어디서 시작하나

설치했는데 뭘 쳐야 할지 모르겠다면, /potato-research 하나만 기억하세요. 상황을 물어보고 거기에 맞는 경로로 데려갑니다.

cd ~/내연구폴더
claude

/potato-research

/potato-research가 가장 먼저 묻는 것 — "어떤 상황인가요?"

A. 논문이 먼저 있다 — "교수님이 이 논문 읽고 우리 데이터에 적용해보래" (랩 연구 · 아이디어 확장)

/potato-lit-review    선행·후속 지형 파악
     ↓
/potato-study-paper   (옵션) 논문 한 편을 처음부터 정독
     ↓                 — 번역·해설·수식이 브라우저 HTML로 쌓인다
/potato-reproduce     저자 코드 재현 → 원 논문 수치와 대조
     ↓
데이터 차이 분석       내 데이터 vs 논문 데이터
     ↓
/potato-experiment    원 방법 vs 내 아이디어 (ablation)
     ↓
/potato-report

핵심: 재현 수치가 안 맞으면 원인부터 규명합니다. 안 그러면 "내 아이디어가 좋아서 오른 건지" 알 수 없어요.

B. 데이터가 이미 있다 — "이 데이터로 뭘 예측/분류하고 싶다" (해커톤 · 캐글 · 데이콘 · 과제)

/potato-eda         성격 파악 + HTML 리포트
     ↓        └ "이 데이터로 풀 수 있는 문제 3가지" 제안
문제 확정     무엇을 예측할지 고른다
     ↓
/potato-experiment  베이스라인 → 모델 비교 → 감사
     ↓        └ 누수·검증오류 나오면 여기서 멈춤
/potato-report  (경진대회면 /potato-submit 도)

핵심: 감사를 건너뛰지 마세요. 누수 하나로 리더보드 1등이 실격됩니다.

C. 주제만 있다 — "청년 정주여건 개선하래… 데이터도 문제도 내가 정해야 해" (지자체 과제 · 기관 프로젝트 · 자유주제)

문제 쪼개기   데이터로 답할 질문 3~5개로
     ↓
/potato-find-data   소스 탐색 → 실현가능성 확인 → 수집 스크립트
     ↓        └ 못 구하면 질문을 바꿉니다. 정상이에요
/potato-eda         받은 게 쓸만한지
     ↓
/potato-experiment  또는 기술통계 (예측 모델이 필요 없을 때도 많음)
     ↓
/potato-report

핵심: 수집을 스크립트로 남깁니다. 보고서의 "데이터 출처" 절이 저절로 채워져요.

D. 결정을 내려야 한다 — "근무표를 짜야 해" "창구 몇 개면 될까" (산업공학 · 운영 개선)

정식화       결정변수·목적함수·제약을 말로 먼저
     ↓
용량 회계     애초에 가능한 문제인가 (30초 산수)
     ↓
/potato-optimize    작은 예제 → 실제 규모
     ↓
민감도 분석   입력이 흔들리면 답이 얼마나 바뀌나
     ↓
/potato-report

핵심: 최적화의 실패는 푸는 단계가 아니라 세우는 단계에서 일어납니다.

반자동입니다 — 매 단계 물어봅니다

/potato-research는 알아서 끝까지 달리지 않습니다. 각 단계가 끝나면 이렇게 멈춥니다:

## [2/5] 데이터 수집 완료

한 일   : KOSIS·국토부에서 3개 데이터셋 수집
결과    : 실거래가 184,332건, 연령별 인구 4,120행
막힌 것 : 청년 전월세 부담률은 직접 제공하는 통계가 없음
          → 실거래가 + 소득으로 계산해야 함

다음은 [3/5] 탐색(/potato-eda)입니다.
  1. 계속 진행    2. 방향을 바꾸고 싶다    3. 여기서 멈춘다

"막힌 것"을 반드시 보고합니다. 숨기고 넘어가면 다음 단계에서 더 크게 터지니까요.

💡 스킬을 직접 부르는 것도 당연히 됩니다. 뭘 할지 이미 안다면 /potato-eda data/train.csv 처럼 바로 쓰세요. /potato-research는 길잡이일 뿐 필수가 아닙니다.

세션이 끊겼다면

/potato-research 이어서

plan.md의 진행 기록을 읽고 다음 단계부터 재개합니다.

---

📚 기본으로 붙는 것

paper-search 하나로 20개 이상 학술 플랫폼을 검색합니다.

arXiv · PubMed · PMC · Europe PMC · OpenAlex · Crossref · Semantic Scholar
bioRxiv · medRxiv · DOAJ · CORE · SSRN · Zenodo · DBLP · HAL · …

여기에 jupyter MCP가 붙어 노트북에서 코드를 실행합니다. (bash start-jupyter.sh / .ps1 로 주피터를 먼저 띄우세요)

🖥 상태줄 — 화면 아래 계기판

설치하면 Claude Code 화면 맨 아래에 이런 줄이 자동으로 생깁니다:

🥔 potato@gmail.com | 📁 my-project (main) | Sonnet | 컨텍스트 34% | 사용량 5h 24% · 7d 41% | +156/-23

항목	뜻
potato@gmail.com	지금 로그인된 계정
📁 my-project (main)	현재 폴더와 git 브랜치
Sonnet	지금 쓰는 모델
컨텍스트 34%	대화가 얼마나 찼나 — 80% 넘으면 새 세션을 여세요
사용량 5h · 7d	Pro 구독 한도를 몇 % 썼나 (5시간 / 7일) — 한도 관리는 이걸 보세요
+156/-23	이 세션에서 고친 코드 줄 수

색이 초록 → 노랑 → 빨강으로 변하면 한도가 가까워진 겁니다. 설치 직후엔 안 보이고 Claude Code를 껐다 켜면 나타납니다. 안 나오거나 바꾸고 싶으면 → /potato-statusline

---

🧩 전공 팩 끼우기

/potato-add-pack list          # 목록 보기
/potato-add-pack medical       # 켜기 — 한 번만 하면 계속 유지됩니다
/potato-add-pack status        # 지금 뭐가 켜져 있나
/potato-add-pack remove ocean  # 끄기
/potato-add-pack new 재료공학   # 목록에 없으면 새로 만들기

⚠️ 팩은 "설정"이지 "명령 인자"가 아닙니다. 다른 명령 뒤에 붙이지 마세요.

✗  /potato-find-data medical 폐암 데이터
✓  /potato-add-pack medical          ← 처음 한 번만
✓  /potato-find-data 폐암 환자 생존 데이터

팩을 켜면 그 분야 데이터베이스(MCP)가 붙고 감사 체크리스트가 활성화됩니다. 켠 뒤에는 Claude Code를 껐다 켜세요 (Ctrl+C 두 번 → claude).

팩	무엇이 붙나	누구에게
🏥 medical	PubMed · 임상시험 · 유전자변이 · OpenFDA · ClinVar	의료 · 약학 · 바이오
💊 medical-plus	화합물(PubChem) · 생물활성(ChEMBL) · 단백질(UniProt)	약물 설계 · 화학정보학
📈 finance	주가 · 재무제표 · 거시경제 시계열	금융 · 시계열
📖 libsci	서지 메타데이터 · 인용 네트워크	문헌정보 · 계량서지학
🌊 ocean	조위 · 해류 · 부이 관측 · 기상 · 수문	해양 · 환경
⚙️ industrial	OR-Tools · SimPy · NetworkX	산업공학 · 물류
🇰🇷 korea	KOSIS · 공공데이터포털 · 실거래가 · ECOS · KHOA	지역 · 정책 과제

팩마다 그 분야의 방법론 함정 체크리스트가 함께 들어옵니다. 예를 들어 finance를 켜면 룩어헤드 편향·생존 편향·거래비용 누락을 감사합니다.

목록에 없는 전공이라면

.claude/packs/ 에 파일 하나만 추가하면 됩니다. 형식은 packs/README.md에 있고, Claude에게 "재료공학 팩 만들어줘" 라고 시켜도 됩니다 — 그 분야 공개 DB를 조사해서 팩 파일을 만들어줍니다.

---

⚡ 스킬 14종

스킬	하는 일
/potato-research	연구 한 사이클 반자동 진행 — 뭘 할지 모르면 여기서 시작
/potato-start	현재 폴더를 연구 프로젝트로 초기화
/potato-lit-review <주제>	논문·근거 조사 → 정리 노트
/potato-study-paper <논문 PDF>	논문 한 편 정독 → 번역·해설·수식이 쌓이는 HTML 학습 노트
/potato-find-data <주제>	공개 데이터 발굴 → 수집 스크립트 → data/ 적재
/potato-eda <파일>	탐색적 분석 + HTML 리포트
/potato-experiment	전처리 → 모델 비교 → 방법론 감사 → 결과 종합
/potato-reproduce <논문>	논문 + 저자 코드 재현 → 내 데이터에 적용
/potato-optimize	최적화·시뮬레이션 정식화 → 해 구하기 → 민감도 분석
/potato-report	결과를 마크다운 보고서로 (PDF·PPTX는 물어본 뒤)
/potato-slides	발표용 PPTX (요청했을 때만)
/potato-submit	경진대회 제출 파일 + 개선 루프
/potato-add-pack	전공 팩 켜기 / 끄기 / 만들기
/potato-statusline	화면 아래 상태줄 설치 / 해제 / 커스텀

기본 흐름은 이렇습니다:

          ┌─────────────── /potato-research (반자동 · 매 단계 확인) ───────────────┐
          │                                                              │
/potato-start ──→ /potato-lit-review ─→ /potato-find-data ─→ /potato-eda ─→ /potato-experiment ─→ /potato-report
  ↑         논문부터        데이터부터            ↓
프로젝트                                   감사가 여기서 돈다
 초기화                                    (methods-reviewer)

/potato-start 부터 시작하세요. 스킬은 어디서든 동작하지만 운영 규칙은 폴더에 CLAUDE.md 가 있어야 적용됩니다. /potato-start 가 그걸 놓아줍니다.

각 스킬은 혼자서도, 이어서도 동작합니다.

논문 관련 작업은 목적에 따라 셋 중 골라 쓰세요: 여러 편을 넓게 훑으려면 /potato-lit-review, 한 편을 처음부터 끝까지 정독하려면 /potato-study-paper, 코드로 재현하려면 /potato-reproduce. 순서대로 이어서 써도 됩니다.

---

🛡️ 이 킷의 핵심 — 감사 에이전트

성능을 올리는 것보다 틀린 결과를 내지 않는 것이 먼저입니다. methods-reviewer는 결과를 의심하는 것이 임무입니다.

공통	데이터 누수 · 교차검증 설계 · 다중비교 · 지표 적합성
🏥 의료	표본 선택 편향 · 결측 메커니즘 · 불멸 시간 편향 · 임상적 유의성
📈 시계열	룩어헤드 편향 · 생존 편향 · 워크포워드 검증 · 거래비용
🌊 공간	공간 자기상관 · 계절성 · 센서 교체 불연속
📖 서지	DB 커버리지 편향 · 인용 지연 · 저자명 명확화
⚙️ 최적화	모델링 타당성 · 제약 누락 · 해의 취약성 · 시뮬레이션 검증

실화: 이 킷을 만들면서 시운전으로 돌린 실험이 이 에이전트에게 fail 판정을 받았습니다. 감사 에이전트가 직접 재현 스크립트를 짜서 돌린 결과, GroupKFold가 층화를 하지 않는다는 걸 잡아내 누수를 약 1.4배 과대평가했다는 사실이 드러났습니다. 그 과정이 projects/_example/에 남아 있습니다.

---

📂 프로젝트 시작하기

어느 폴더에서든 Claude Code를 열고:

/potato-start 내 연구 주제

폴더 구조·CLAUDE.md·plan.md를 만들어주고, 프로젝트 성격(해커톤/논문/기관)과 데이터 반출 제한을 물어본 뒤 그에 맞는 규칙을 넣어줍니다.

⚠️ /potato-start 를 건너뛰면 운영 규칙이 적용되지 않습니다. 스킬 자체는 동작하지만, 데이터 보호·산출물 규칙 같은 상시 규칙은 폴더의 CLAUDE.md 에서 나옵니다.

킷 안에서 시작하고 싶다면 템플릿을 복사해도 됩니다:

cp -r projects/_template projects/my-project

projects/<이름>/CLAUDE.md에 프로젝트 성격을 적어두면 그 폴더에서만 규칙이 바뀝니다:

🏃 해커톤 속도 우선 검증은 제출 직전 한 번

🎓 논문·랩 엄밀성 우선 단계마다 감사

🏛️ 기관 과제 설명 가능성 우선 비전공자도 읽히게

---

🗂 구조

potato-kit/
├── README.md                 지금 이 문서
├── GUIDE.md                  ★ 페르소나별 사용법 — 먼저 읽으세요
├── CLAUDE.md                 연구 운영 규칙 (프로젝트에 상속)
├── install.sh / install.ps1  설치 (Claude Code)
├── install-codex.sh / .ps1   설치 (Codex CLI 용)
├── start-jupyter.sh / .ps1   주피터 + MCP 연결
├── LICENSE                   MIT
├── .claude/
│   ├── agents/    literature-scout · data-analyst · methods-reviewer · report-writer
│   ├── skills/    슬래시 명령 14종
│   ├── statusline/ 상태줄 스크립트 (py·ps1)
│   └── packs/     전공 팩 7종 (+ 새 팩 만드는 법)
└── projects/
    ├── _template/ 새 프로젝트 템플릿
    └── _example/  완주 예제 (Titanic 워크플로 한 바퀴)

---

🆘 자주 막히는 곳

/potato-add-pack 이 안 먹혀요

Claude Code를 껐다 켜세요. 스킬은 시작할 때 읽힙니다.

상태줄이 안 보여요 / 이상해요

• 설치 직후엔 안 보입니다 — Claude Code를 껐다 켜세요.
• 🥔 만 나오는 건 정상 폴백입니다(세션 정보를 아직 못 받은 것). 계속 그러면 /potato-statusline 으로 재설치하세요.
• 사용량(5h·7d)은 첫 응답이 온 뒤부터 표시됩니다.
• 끄고 싶으면: /potato-statusline off

claude mcp list 에 아무것도 없어요

설치 스크립트를 다시 돌리고, -s user 스코프로 등록됐는지 확인하세요. CLAUDE_CONFIG_DIR 환경변수를 쓰고 있다면 스크립트가 그쪽에 설치합니다 (실행 중 어디에 설치하는지 출력합니다).

jupyter MCP가 연결이 안 돼요

주피터 서버를 먼저 띄워야 합니다: bash start-jupyter.sh (Windows: .\start-jupyter.ps1)

그림에서 한글이 깨져요

matplotlib 폰트를 지정하세요. 스킬에 코드가 들어 있습니다. Windows는 Malgun Gothic, macOS는 AppleGothic, Linux는 NanumGothic. 그림 안에 이모지는 쓰지 마세요 — 한글 폰트에 이모지 글리프가 없어 두부(□)로 깨집니다.

사용량 한도가 빨리 닳아요

• 큰 파일을 통째로 읽지 말고 pandas로 요약만 보세요
• 병렬 서브에이전트를 줄이세요 (/potato-experiment에 "순차로 돌려줘")
• 주제가 바뀌면 /clear 로 새 세션을 여세요
• 한도가 임박하면: 결과 생성 > 정리 > 탐색 순으로

자세한 건 CLAUDE.md의 "사용량 아끼기" 절에 있습니다.

Windows에서 conda 명령을 못 찾아요 (VS Code·PowerShell)

conda 설치 시 PATH 등록을 안 했거나, PowerShell 프로필이 차단된 경우입니다. 한 번만 아래를 하면 이후 계속 됩니다.

# 1) 관리자 PowerShell 에서 (이걸 빼먹으면 2번을 해도 안 됩니다)
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

# 2) Anaconda Prompt 에서
conda init powershell

# 3) 터미널 완전히 닫았다 다시 열기 (VS Code 는 VS Code 재시작)

그래도 안 되면 Anaconda Prompt 에서 작업하세요. 기능은 똑같습니다.

Codex 에서 스킬이 안 먹혀요

Codex 에는 슬래시 명령이 없습니다. "이 데이터 EDA 해줘" 처럼 말로 요청하면 ~/.codex/AGENTS.md 가 해당 스킬 파일을 읽으라고 라우팅합니다. AGENTS.md 가 없다면 bash install-codex.sh 를 돌리세요.

macOS에서 LightGBM이 안 돌아가요

conda install -c conda-forge llvm-openmp macOS에는 OpenMP 런타임이 기본 탑재돼 있지 않습니다. Windows·Linux는 무관합니다.

---

🤝 기여

버그를 만나거나 팩을 새로 만들었다면 이슈나 PR로 보내주세요. 특히 Windows에서 겪은 문제가 가장 도움이 됩니다.

새 전공 팩은 .claude/packs/README.md 형식만 맞추면 됩니다.

---

감자들을 위해 만들었습니다 🥔🥔🥔

사용법 가이드 →