Why에서 How까지: Claude Code 완전 학습 경로

대부분의 Claude Code 리소스는 두 가지 함정 중 하나에 빠진다. MCP가 무엇인지, Hooks가 왜 존재하는지, 컨텍스트 윈도우가 어떻게 작동하는지 처음부터 설명하면서 막상 실제로 실행할 수 있는 명령어 하나 보여주지 않거나. 또는 슬래시 명령어와 설정 코드 목록만 던져주고 왜 써야 하는지 설명이 없거나.

둘 다 틀린 건 아니다. 하지만 Zapier, Make, Notion 같은 노코드 도구에서 넘어온 경우, 두 가지가 모두 필요하다. "왜"를 이해하기 전까지는 "어떻게"가 납득되지 않는다. 그리고 왜를 이해하고 나면, 어떻게가 바로 손 닿는 곳에 있어야 한다.

claude-study와 Claude Code Catalog가 함께 채우려는 것이 바로 이 간극이다.

claude-study(github.com/minjikim89/claude-study)는 노코드 배경을 가진 사람들을 위해 쓰인 17챕터 학습 레포지토리다. 모든 챕터는 익숙한 도구 — Zapier, Notion, Chrome 확장 — 에서 시작해서 대응하는 Claude Code 개념으로 연결하는 구조를 취한다. 한국어 우선, 개념 우선이며, 의도적으로 복사-붙여넣기 지름길을 피한다.

Claude Code Catalog(이 사이트)는 실전 레퍼런스 레이어다. 검색 가능한 Skills, Plugins, MCP 서버, Hooks, Patterns, Guides — 설치 명령어, 터미널 데모, 난이도 등급과 함께. 이미 원하는 것을 알고 있고 빠르게 찾는 방법이 필요한 사람을 위해 설계됐다.

의도한 흐름:

``` claude-study → Claude Code Catalog ───────────────────────────────────────────────── "MCP가 뭔가요?" → MCP 서버 탐색 "Hooks는 어떻게?" → Hook 설정 복사 "Channels가 뭔가요?" → Telegram 플러그인 설치 ```

두 리소스가 각 학습 단계에서 어떻게 대응하는지 정리했다.

Stage 1 — Basics (claude-study ch. 01–03)
  → How Claude Code works, memory, Skills
  → Catalog: Skills section (61 skills across 8 categories)

Stage 2 — Agents (claude-study ch. 04–06)
  → Subagents, Agent Teams, vs agentic frameworks
  → Catalog: Patterns section (agent-teams, parallel-tasks)

Stage 3 — Integrations (claude-study ch. 07–10)
  → MCP, Hooks, context management, real workflows
  → Catalog: MCP Servers (11 servers), Hooks (11 hooks)

Stage 4 — Advanced (claude-study ch. 11–16)
  → MCP+API hybrid, Skill vs Rule, Plugins, Scheduled Tasks,
    Remote Control, Channels
  → Catalog: Plugins section (Telegram/Discord channel plugins)

Claude Code를 처음 시작하고 노코드 배경이 있다면, 추천하는 진입 순서는 다음과 같다:

1. claude-study 1–3챕터를 읽어서 Claude Code가 어떻게 생각하는지 이해하자 — 메모리 계층, CLAUDE.md, 프롬프트 주입으로서의 Skills. 2. 이 카탈로그로 돌아와서 Skills 섹션을 탐색한다. 관심 있는 카테고리에서 스킬 하나를 골라 CLAUDE.md에 복사해서 써보자. 3. MCP와 Hooks를 위해 claude-study 7–8챕터를 읽는다. 4. 카탈로그로 돌아와서 MCP 서버와 Hooks를 탐색한다. 이미 쓰는 도구와 연결되는 것 하나를 설치한다. 5. 반복한다.

핵심은 사용하기 전에 모든 것을 읽을 필요가 없다는 것이다. 목표는 카탈로그 항목이 처음 읽어도 이해되는 수준의 멘탈 모델을 빠르게 갖추는 것이다.

Claude Code Channels(리서치 프리뷰)는 두 리소스가 서로 어떻게 보완하는지 잘 보여주는 예시다.

claude-study 16챕터는 핵심 멘탈 모델을 설명한다: Channels는 MCP의 반대다. 일반 MCP는 pull — Claude가 필요할 때 서비스를 조회한다. Channels는 push — 외부 시스템(Telegram 봇, Discord DM, CI 웹훅)이 실행 중인 세션에 이벤트를 전달하고, Claude가 같은 채널로 응답한다. 챕터는 ASCII 다이어그램과 Remote Control, Scheduled Tasks와의 나란한 비교를 통해 이 이해를 쌓아간다.

이것이 납득되고 나면, 카탈로그의 Telegram Channel과 Discord Channel 플러그인 항목이 바로 유용해진다 — 정확한 설치 명령어, 토큰 설정, 전체 설정 흐름의 터미널 데모를 보여준다. study에서 얻은 개념이 몇 분 안에 실제 작동하는 연동으로 바뀐다.

Claude Code를 팀에 도입하거나 워크샵을 운영한다면, 두 리소스 구조가 커리큘럼으로 잘 작동한다:

- claude-study를 사전 독서 또는 세션 교재로 활용한다. 노코드 비교가 비개발자 팀원의 온보딩을 빠르게 한다. - Claude Code Catalog를 세션 중·후 실습 레퍼런스로 활용한다. 검색과 필터로 맥락에 맞는 예시를 빠르게 찾을 수 있다.

두 레포지토리 모두 오픈 소스다. claude-study 문서는 한국어(기본), 영어, 일본어로 제공된다. 카탈로그는 세 언어를 모두 지원한다.

두 리소스 모두 Claude Code 신기능 출시와 함께 업데이트된다. 가장 최근 추가된 내용은 Channels 리서치 프리뷰다 — 폰에서 실행 중인 로컬 세션으로 이벤트를 push할 수 있는 Telegram과 Discord 플러그인.

claude-study에 추가 예정: - 17챕터: Auto Mode (장시간 세션을 위한 자동 권한 승인) - 03챕터 업데이트: Skills 시스템 진화 — 번들 스킬(/simplify, /batch, /debug, /loop, /claude-api), $CLAUDE_SKILL_DIR, context:fork

GitHub 레포지토리를 팔로우해서 최신 상태를 유지하자: - claude-study: github.com/minjikim89/claude-study - Claude Code Catalog: claude-code-catalog.vercel.app