"마감 1분전" 수강신청 변경하고 다시보기로 스터디한 일지
2026.05.22

📚 지피터스 22기 1주차 스터디 일지
[!info] 스터디 정보
과정: 지피터스 22기 1주차
주제: 내 자동화에 '인터페이스'를 입히는 4주 — Claude Code로 텔레그램·API·MCP까지
학습일: 2026년 5월 22일 (금)
학습자: TAI BO
🎯 오늘의 학습 목표
"AI가 읽을 수 있는 노트 시스템([[VAULT]])" 만들기 — 그 첫 부품 익히기
4주 후 [[Claude]]가 직접 내 노트를 읽고 쓰는 시스템([[MCP]])을 구축하기 위한 1주차 토대 다지기.
📖 학습한 내용
1️⃣ 환경 설정 — 터미널 이슈 해결
문제 상황
Windows [[PowerShell]] 5.1에서
mkdir my-vault && cd my-vault실행 시 오류 발생'&&' 토큰은 이 버전에서 올바른 문 구분 기호가 아닙니다에러
원인 파악
&&연산자는 [[Bash]] 문법 → PowerShell 5.1은 미지원PowerShell 7 이상부터 지원됨
해결 과정
winget install Microsoft.PowerShell로 PowerShell 7 설치단, 기존 창은 여전히 5.1 →
pwsh입력으로 새 버전 진입 필요결론: 영상이 [[WSL]] 기반이므로 WSL 터미널 사용이 가장 매끄러움
[!tip] 교훈 환경(셸 종류)에 따라 같은 명령어도 다르게 동작한다. 영상의 환경을 먼저 확인하자.
2️⃣ 프론트매터(Front Matter) 개념
정의: 노트 맨 앞에 붙이는 "이름표/메타데이터"
핵심 8개 필드
구분 | 필드 | 역할 |
|---|---|---|
🔴 필수 | title, date, tags, related | 기본 식별 정보 |
🟡 권장 | type, status, source, aliases | 분류/상태 보조 |
핵심 원칙
"단서가 많을수록이 아니라 — 적절할수록 좋다" 자주 다른 값으로 채울 필드만 넣고, 항상 같은 값은 [[CLAUDE.md]] 디폴트로 처리
📎 관련 노트: [[프론트매터-가이드]] | [[YAML-기초]]
3️⃣ VAULT 구성 패턴 3가지
패턴 | 방식 | 장점 | 단점 |
|---|---|---|---|
A. 계층형 | 폴더 중첩 | 익숙함 | 분류 겹치면 곤란 |
B. [[제텔카스텐]] | 평면 + 태그/링크 | 자유로운 연결 | 길 잃기 쉬움 |
C. [[인덱스 위키]] ⭐ | 목차 노트 중심 | 균형 + LLM 친화적 | 목차 관리 필요 |
오늘의 선택: ➡️ C. 인덱스 위키 LLM이 출발점(목차 노트)에서 가지치기하며 읽기 좋은 구조
4️⃣ 핵심 통찰 — Andrej Karpathy의 한마디
[!quote] Andrej Karpathy "I want to write notes that LLMs can read." 나는 LLM이 읽을 수 있는 노트를 쓰고 싶다
시대의 전환
과거: 사람만 보는 노트 ✍️
현재: 사람과 LLM이 같은 파일을 읽는 시대 🤖
➡️ 노트를 쓸 때 두 질문을 동시에 던져야 함:
"6개월 뒤 내가 봐도 알아볼까?"
"AI한테 보여줘도 이해할까?"
📎 인물 노트: [[Andrej Karpathy]]
5️⃣ 오늘 만든 4가지 부품 = LLM WIKI
부품 | 역할 | 비유 |
|---|---|---|
[[폴더 구성]] | LLM의 컨텍스트 베이스 | 🏞️ 땅 |
[[마크다운]] | 사람+LLM 공용 포맷 | 🧱 벽돌 |
[[프론트매터]] 8필드 | 빠른 검색 키워드 | 🏷️ 문패 |
[[백링크]]·[[인덱스 노트]] | 관계 그래프 | 🛤️ 길 |
➡️ 4가지가 합쳐져 "AI가 살 집" 완성
6️⃣ CLAUDE.md — VAULT 사용 규칙
개념: Claude한테 주는 "이 폴더 사용 설명서"
markdown
# Vault Convention
## 노트 명명
- 일반: {date}-{slug}.md
- 인덱스: index-{키워드}.md
## 프론트매터 표준
필수: title, date, tags, related
권장: type, status, source, aliases[!important] 핵심 의의 vault 폴더에 들어오면 Claude가 이 파일을 먼저 읽음 → 매번 규칙 설명 불필요
📎 관련 노트: [[CLAUDE.md-템플릿]] | [[Vault-Convention-예시]]
7️⃣ Slash Command — 자주 쓰는 지시를 명령어로
저장 경로: .claude/commands/명령어이름.md
오늘 학습한 명령어 3종
명령어 | 기능 |
|---|---|
| CLAUDE.md 규칙대로 노트 자동 생성 |
| 키워드 10개 → 인덱스 노트 10개 일괄 생성 |
| 노트 간 |
[!success] 핵심 발견 "2주차에는 같은 명령을 텔레그램에서 호출 — 채널만 바뀜"
지금 만드는 명령어는 컴퓨터 → [[텔레그램]] → [[API]] → [[MCP]] 어디서든 재사용 가능 ♻️
📎 관련 노트: [[Slash-Command-모음]] | [[new-note-명령어]]
8️⃣ 실습 — VAULT 폴더 생성
bash
mkdir my-vault && cd my-vault조각 | 의미 |
|---|---|
| 폴더 생성 (make directory) |
| 폴더 이동 (change directory) |
| 앞 명령 성공 시 다음 실행 |
✅ WSL 터미널에서 정상 실행 확인
💡 오늘의 깨달음
노트 정리는 더 이상 개인 취향이 아니라 "AI 협업을 위한 인프라" 다.
[[CLAUDE.md]] + [[Slash Command]] 조합이 자동화의 핵심 — 규칙은 한 번만, 호출은 무한히.
"한 번 잘 만들면 어디서든 재사용" — 1주차 작업이 4주차까지 살아남는 자산이 됨.
환경 이슈(PowerShell vs WSL) 같은 사소한 부분에서 막힐 수 있으니 영상의 환경을 먼저 맞추자.
🚧 막혔던 부분 & 해결
[!warning] 이슈 정리
이슈
해결
PowerShell 5.1에서
&&미지원WSL 터미널 사용으로 우회
PowerShell 7 설치 후에도 안 됨
기존 창은 5.1 그대로 →
pwsh로 진입해야 함 인지
📅 다음 학습 계획
[[CLAUDE.md]] 실제로 작성하기
/new-note슬래시 명령어 만들어보기[[인덱스 노트]] 첫 버전 작성
2주차 예고: 같은 명령어를 [[텔레그램]]에서 호출하기 📱
🎯 한 줄 회고
[!quote] 오늘의 한 줄 "오늘 만든 건 작은 부품이지만, 4주 후 Claude가 입주할 집의 첫 벽돌이다." 🏠✨
🔗 연결된 노트
[[index-22기]] — 22기 전체 인덱스
[[index-claude-code]] — Claude Code 학습 모음
[[index-vault]] — VAULT 구축 관련 노트
[[2026-05-29-22기-2주차]] — 다음 주 일지 (예정)
📎 참고 자료
지피터스 22기 1주차 영상 (2026-05-20)
강사: [[GPTers]]
인용: [[Andrej Karpathy]] — "I want to write notes that LLMs can read"
#스터디 #22기 #1주차 #claude-code #vault #llm #자동화
















