본문으로 건너뛰기

[Claude Code 마스터하기 #1] 핵심 기능 총정리: 이것만 알면 시작할 수 있다

· 약 7분
Nam Young Kim
Data Fullstack Engineer

이 글은 Claude Code 시리즈의 첫 번째 편입니다. 기본 기능부터 차근차근 다루며, 실제 개발 시나리오에서 어떻게 활용하는지 보여드립니다.


TL;DR

  • Claude Code는 터미널에서 동작하는 AI 코딩 어시스턴트
  • 파일 읽기/수정, 명령 실행, Git 작업까지 직접 수행
  • CLAUDE.md로 프로젝트 컨텍스트를 주면 더 똑똑해짐
  • 슬래시 커맨드(/help, /init, /compact)로 효율적 작업

[Claude Code 마스터하기 #2] Hooks & Headless Mode: 반복 작업을 자동화하는 법

· 약 12분
Nam Young Kim
Data Fullstack Engineer

이 글은 Claude Code 시리즈의 두 번째 편입니다. Part 1에서 기본 기능을 익혔다면, 이제 자동화로 넘어갑니다.


TL;DR

  • Hooks: 특정 이벤트 발생 시 자동으로 스크립트 실행
  • Headless Mode: 대화 없이 명령 실행 후 결과만 받기
  • 조합하면 CI/CD, pre-commit, 자동 포맷팅 등 무한 자동화 가능

[Claude Code 마스터하기 #3] Subagents, Skills, Agent SDK: 확장의 모든 것

· 약 12분
Nam Young Kim
Data Fullstack Engineer

이 글은 Claude Code 시리즈의 세 번째 편입니다. Part 1-2에서 기본과 자동화를 다뤘다면, 이제 진정한 확장으로 넘어갑니다.


TL;DR

  • Subagents: 독립 컨텍스트에서 작업하는 전문가 에이전트 (토큰 절약)
  • Skills: Claude가 자동으로 판단해서 사용하는 능력 (vs 슬래시 커맨드)
  • Agent SDK: Claude Code 엔진을 코드로 제어 (Python/TypeScript)
  • 셋을 조합하면 복잡한 멀티 에이전트 시스템 구축 가능

나만의 Python 프로젝트 표준 만들기: Claude Skills로 자동화하기

· 약 5분
Nam Young Kim
Data Fullstack Engineer

Python 프로젝트를 시작할 때마다 매번 같은 설정을 반복하고 있지 않나요? pyproject.toml 작성, 린터 설정, 디렉토리 구조 만들기... 이번 글에서는 2025년 기준 최신 Python 도구 스택을 정리하고, Claude Skills로 이 과정을 자동화하는 방법을 공유합니다.

AI 에이전트 확장 도구 이해하기 (1/3): Skills, MCP, Subagents 비교

· 약 5분
Nam Young Kim
Data Fullstack Engineer

이 글은 3부작 시리즈의 첫 번째 글입니다.

AI에게 "이번 주말 친구들 생일파티 준비해줘"라고 말한다고 상상해보세요. AI가 이 일을 잘 해내려면 연결(친구들 연락처), 노하우(초대장 작성법), 분업(케이크와 장식 동시 준비)이 필요합니다. 바로 이 세 가지 문제를 해결하기 위해 Skills, MCP, Subagents 같은 도구들이 등장했습니다.

AI 에이전트 확장 도구 이해하기 (2/3): Agent Skills 딥다이브

· 약 7분
Nam Young Kim
Data Fullstack Engineer

이 글은 3부작 시리즈의 두 번째 글입니다. 1편을 먼저 읽어보세요.

1편에서 AI를 돕는 4가지 도구(MCP, Skills, Subagents, Commands)를 알아봤어요. 이번 편에서는 Skills를 더 깊이 파봅니다. 왜 Skills가 MCP보다 토큰 효율적인지, 좋은 Skills는 어떻게 만드는지, 그리고 한 번 만든 Skills를 여러 도구에서 쓸 수 있는지 알아볼게요.

AI 에이전트 확장 도구 이해하기 (3/3): MCP vs Skills의 전략적 선택

· 약 7분
Nam Young Kim
Data Fullstack Engineer

이 글은 3부작 시리즈의 마지막 글입니다. 1편, 2편을 먼저 읽어보세요.

1편에서는 AI를 돕는 4가지 도구를 알아봤고, 2편에서는 Skills를 깊이 파봤어요. 오늘은 좀 더 큰 그림을 볼 거예요: MCP의 토큰 문제가 얼마나 심각한지, Anthropic은 왜 MCP를 Linux Foundation에 기부했는지, 그리고 우리는 뭘 배워야 할지 알아봅니다.

분포 거리 측정 (Part 1) - 정보이론 기초와 KL Divergence

· 약 7분
Nam Young Kim
Data Fullstack Engineer

KL Divergence를 정보이론 기초부터 이해하기. Self-Information, Entropy, Cross-Entropy의 관계를 통해 KL Divergence가 왜 이런 형태인지 직관적으로 설명합니다.

들어가며

머신러닝을 하다 보면 "두 확률 분포가 얼마나 다른가?"를 측정해야 하는 상황을 자주 만납니다. 모델이 예측한 분포와 실제 데이터 분포의 차이, VAE에서 latent space의 분포와 prior의 차이, 또는 시간에 따른 데이터 분포의 변화(drift) 감지까지. 이 모든 상황에서 KL Divergence라는 개념이 등장합니다.

이번 글에서는 KL Divergence가 "무엇"인지보다 "왜" 이런 형태를 갖게 되었는지에 초점을 맞춥니다. 정보이론의 기초 개념부터 차근차근 쌓아올려 보겠습니다.

분포 거리 측정 (Part 2) - Forward vs Reverse KL, 그리고 VAE

· 약 9분
Nam Young Kim
Data Fullstack Engineer

Forward KL과 Reverse KL의 차이, Mode-covering과 Mode-seeking 행동의 이해. VAE의 Reparameterization Trick까지 상세 설명.

들어가며

Part 1에서 KL Divergence의 정의와 정보이론적 의미를 살펴봤습니다. 그런데 한 가지 의문이 남습니다. KL Divergence가 비대칭적이라면, DKL(PQ)D_{KL}(P \| Q)DKL(QP)D_{KL}(Q \| P) 중 어떤 것을 사용해야 할까요?

이 선택은 단순한 수학적 문제가 아닙니다. ML 모델의 학습 행동을 근본적으로 바꿉니다. 이번 글에서는 Forward KL과 Reverse KL의 차이를 깊이 이해하고, VAE에서 Reparameterization Trick이 왜 필요한지 알아보겠습니다.

분포 거리 측정 (Part 3) - JSD와 Wasserstein Distance

· 약 8분
Nam Young Kim
Data Fullstack Engineer

GAN 학습이 어려운 이유와 해결책. JSD의 gradient vanishing 문제부터 Wasserstein Distance, WGAN까지의 발전 과정.

들어가며

Part 1에서 KL Divergence의 정보이론적 의미를 살펴봤습니다. 하지만 KL Divergence에는 실용적인 한계가 있습니다. 비대칭적이고, 특정 상황에서 무한대로 발산합니다. 이번 글에서는 이러한 한계를 극복하기 위해 등장한 **Jensen-Shannon Divergence(JSD)**와, GAN 학습에서 JSD의 치명적인 문제를 해결한 Wasserstein Distance를 다룹니다.

이 여정을 따라가다 보면 GAN이 왜 학습하기 어려운지, 그리고 WGAN이 어떻게 이를 해결했는지 깊이 이해할 수 있습니다.

분포 거리 측정 (Part 4) - 실무 적용과 Detection 시스템

· 약 11분
Nam Young Kim
Data Fullstack Engineer

KL, JSD, Wasserstein을 실제 시스템에 적용하는 방법. Drift Detection, Anomaly Detection, Model Monitoring 구현 패턴과 실무 체크리스트.

들어가며

지난 세 편에서 KL Divergence, JSD, Wasserstein Distance의 이론적 배경을 살펴봤습니다. 이제 가장 중요한 질문이 남았습니다. "실제로 어떻게 쓰는가?"

이번 글에서는 분포 비교 기법을 실제 시스템에 적용하는 구체적인 패턴들을 다룹니다. Feature drift detection, anomaly detection, model monitoring 등 바로 활용할 수 있는 내용에 집중합니다.

llms.txt란? AI를 위한 웹사이트 목차 표준

· 약 3분
Nam Young Kim
Data Fullstack Engineer

robots.txt가 검색 엔진을 위한 것이라면, llms.txt는 AI를 위한 것입니다.

🎯 들어가며

웹사이트에 robots.txt가 있듯이, 이제 llms.txt도 등장했습니다. 2024년 9월 Jeremy Howard가 제안한 이 표준은 LLM(Large Language Model)이 웹사이트 콘텐츠를 쉽게 이해할 수 있도록 돕는 파일입니다.