본문으로 건너뛰기

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

SIMSON

2026.05.22

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

📚 지피터스 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 이상부터 지원됨

해결 과정

  1. winget install Microsoft.PowerShell 로 PowerShell 7 설치

  2. 단, 기존 창은 여전히 5.1 → pwsh 입력으로 새 버전 진입 필요

  3. 결론: 영상이 [[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종

명령어

기능

/new-note

CLAUDE.md 규칙대로 노트 자동 생성

/index-add

키워드 10개 → 인덱스 노트 10개 일괄 생성

/graph

노트 간 [[ ]] 연결을 그래프 시각화

[!success] 핵심 발견 "2주차에는 같은 명령을 텔레그램에서 호출 — 채널만 바뀜"

지금 만드는 명령어는 컴퓨터 → [[텔레그램]] → [[API]] → [[MCP]] 어디서든 재사용 가능 ♻️

📎 관련 노트: [[Slash-Command-모음]] | [[new-note-명령어]]


8️⃣ 실습 — VAULT 폴더 생성

bash

mkdir my-vault && cd my-vault

조각

의미

mkdir

폴더 생성 (make directory)

cd

폴더 이동 (change directory)

&&

앞 명령 성공 시 다음 실행

✅ WSL 터미널에서 정상 실행 확인


💡 오늘의 깨달음

  1. 노트 정리는 더 이상 개인 취향이 아니라 "AI 협업을 위한 인프라" 다.

  2. [[CLAUDE.md]] + [[Slash Command]] 조합이 자동화의 핵심 — 규칙은 한 번만, 호출은 무한히.

  3. "한 번 잘 만들면 어디서든 재사용" — 1주차 작업이 4주차까지 살아남는 자산이 됨.

  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 #자동화

한국어 텍스트가 있는 페이지의 스크린샷
한국어 앱 스크린샷
한국어 문자 메시지 스크린샷
한국어 텍스트가 있는 페이지의 스크린샷
한국어로 된 다양한 종류의 카드를 보여주는 표
한국사이트 스크린샷
한국어 페이지 스크린샷
한국어 텍스트가 포함된 페이지의 스크린샷
Claired Vault 페이지의 스크린샷
한국어 한국어 한국어 한국어 한국어 한국어 한국어 한국어
한국어가 종이에 표시되어 있어요
한국어와 중국어가 적힌 테이블

함께 이야기해요 0

로그인하고 댓글을 남겨 주세요

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기