읽지 말고 직접 해보면서 Claude Code 배우기
Learn Claude Code by doing, not reading
TL;DR Highlight
브라우저에서 바로 실행되는 터미널 시뮬레이터, Config Builder, 퀴즈 등을 갖춘 Claude Code 인터랙티브 학습 플랫폼으로, 설치나 API 키 없이도 Claude Code의 핵심 기능을 실습할 수 있다.
Who Should Read
Claude Code를 처음 접하거나 slash commands, hooks, CLAUDE.md, MCP 서버 설정 등 고급 기능을 체계적으로 익히고 싶은 개발자. 특히 설치 없이 먼저 기능을 탐색해보고 싶은 입문자에게 적합하다.
Core Mechanics
- Ahmed Nagdy가 만든 claude.nagdy.me는 Claude Code를 브라우저 안에서 인터랙티브하게 학습할 수 있는 플랫폼으로, API 키나 별도 설치 없이 바로 실습 가능하다.
- 총 11개 모듈로 구성되어 있으며 Beginner부터 Advanced까지 단계별로 나뉜다. Slash Commands(30분), Memory & CLAUDE.md(45분), Project Setup(45분), Commands Deep Dive(30분), Skills(1시간) 등의 순서로 진행된다.
- 브라우저 내 터미널 시뮬레이터가 내장되어 있어 slash commands, hooks, skills 같은 기능을 실제로 타이핑하면서 연습할 수 있다. 실제 환경과 동일한 감각을 미리 익힐 수 있는 게 장점이다.
- Config Builder 도구를 통해 CLAUDE.md(프로젝트별 AI 행동 지침 파일), hooks(특정 이벤트에 반응하는 스크립트), MCP 서버 설정, 플러그인 설정 등을 인터랙티브 폼으로 생성하고 바로 복사해서 프로젝트에 붙여넣을 수 있다.
- 각 모듈 마지막에 퀴즈가 있으며, 틀렸을 때 단순히 정답만 알려주는 게 아니라 왜 그 답이 맞는지 설명을 제공해서 개념을 확실히 다질 수 있다.
- Playground(전용 터미널 샌드박스), Cheat Sheet(자주 쓰는 명령어/단축키 요약), Feature Index(기능 전체 목록 검색) 등 학습 외 참고 도구도 함께 제공된다.
- 'Find Your Level' 퀴즈로 자신의 수준을 진단하고 적절한 모듈부터 시작할 수 있도록 설계되어 있다. 다만 커뮤니티 반응에서 보듯이 이 진단의 정확도에는 의문이 제기되고 있다.
Evidence
- 실제로 Claude Code를 매일 사용하고 플러그인, skills, MCP 서버, 서브에이전트 워크플로까지 써본 고급 사용자가 'Find Your Level' 퀴즈를 풀었더니 Beginner 판정을 받았다는 경험담이 여럿 올라왔다. D나 C를 골라도, 심지어 D만 골라도 Beginner가 나온다는 보고가 있어서 퀴즈 로직에 버그나 설계 문제가 있는 것으로 보인다.
- 터미널에 익숙한 개발자라면 그냥 설치하고 직접 써보는 게 더 빠른 '진짜 learning by doing'이라는 의견이 있었다. 이 플랫폼은 오히려 터미널 자체가 낯선 완전 초보자에게 더 유용할 것 같지만, 그런 사용자에게는 '터미널이 뭔지', '명령어가 뭔지'부터 설명하는 더 기초적인 내용이 필요하다는 지적도 함께 나왔다.
- Claude Code의 quota 소진 속도에 대한 불만이 댓글에서 제기됐다. Max5 플랜($100/월)을 쓰는 사용자가 단 하나의 프롬프트로 10분 만에 세션 quota의 약 10%를 소진했다고 하며, 최근 Anthropic이 무언가를 변경한 것 같다는 의심이 있다. 학습 플랫폼 자체와는 별개지만, Claude Code를 실제로 도입하려는 사람에게는 비용 예측이 어렵다는 현실적인 우려다.
- '또 새로운 툴을 외워야 하나'라는 피로감을 표현하는 댓글도 있었다. AI한테 원하는 걸 그냥 말로 하면 되는데 굳이 Claude Code 문법을 따로 배울 필요가 있냐는 시각이다. 이에 대해 암묵적으로는 slash commands나 hooks 같은 구조화된 기능을 활용할 때 정확하게 쓰는 방법을 아는 게 실제로 더 좋은 결과를 낸다는 반론이 존재한다.
- 'RTFM(공식 문서 읽으면 되지 않냐)'이라는 냉소적인 반응도 있었다. 문서를 안 읽으려고 학습 플랫폼을 찾는다는 비판인데, 반대로 공식 문서보다 인터랙티브한 방식이 실제로 더 빠르게 익힌다는 입장도 있어 학습 방식에 대한 취향 차이가 드러났다.
How to Apply
- Claude Code를 처음 도입하려는 팀이라면 claude.nagdy.me의 Config Builder를 활용해서 CLAUDE.md 파일 초안을 인터랙티브하게 생성해보면 좋다. 폼에 프로젝트 정보를 입력하면 바로 복사 가능한 설정 파일이 나오므로, 처음부터 빈 파일에 작성하는 것보다 훨씬 빠르게 시작할 수 있다.
- Claude Code에서 hooks나 MCP 서버를 써보고 싶지만 설정이 복잡하게 느껴진다면, 설치 전에 이 플랫폼의 터미널 시뮬레이터로 먼저 명령어 흐름을 익혀두면 실제 환경에서 실수를 줄일 수 있다. 특히 hooks 설정은 잘못 건드리면 워크플로 전체가 꼬일 수 있어서 사전 연습이 유용하다.
- 팀에 Claude Code 온보딩을 진행해야 하는 경우, 이 플랫폼의 11개 모듈 순서(Slash Commands → Memory & CLAUDE.md → Project Setup → Commands Deep Dive → Skills 순)를 그대로 팀 학습 커리큘럼으로 활용할 수 있다. 모듈별 예상 소요 시간이 명시되어 있어 일정 계획 세우기도 쉽다.
- Claude Code를 $100/월 Max5 플랜으로 도입 검토 중이라면, quota 소진 속도가 예상보다 훨씬 빠를 수 있다는 커뮤니티 경험담을 감안해 초기에는 사용 패턴별로 quota 소비량을 모니터링하면서 비용 예측 모델을 만들어두는 것이 좋다.
Terminology
CLAUDE.mdClaude Code가 프로젝트 디렉토리에서 읽는 설정 파일로, AI가 해당 프로젝트에서 어떻게 행동해야 하는지(코딩 스타일, 금지 사항, 프로젝트 구조 등)를 미리 지정해두는 일종의 'AI를 위한 README'다.
slash commandsClaude Code에서 /로 시작하는 단축 명령어들. 예를 들어 /help, /clear 같은 식으로 특정 기능을 빠르게 호출할 때 사용한다.
hooks특정 이벤트가 발생했을 때 자동으로 실행되는 스크립트. 예를 들어 파일 저장 후 자동으로 린터를 실행하거나, Claude가 응답하기 전에 특정 처리를 끼워 넣는 방식으로 활용한다.
MCPModel Context Protocol의 약자로, AI 모델이 외부 도구(파일 시스템, 데이터베이스, API 등)와 통신할 수 있도록 Anthropic이 만든 표준 프로토콜이다. MCP 서버를 설정하면 Claude Code가 해당 도구를 직접 사용할 수 있게 된다.
skillsClaude Code에서 자주 반복하는 작업이나 특정 패턴을 미리 정의해둔 재사용 가능한 절차. 일종의 커스텀 매크로나 워크플로 템플릿이라고 볼 수 있다.
subagent workflowClaude Code에서 하나의 큰 작업을 여러 개의 하위 AI 에이전트로 분리해서 처리하는 방식. 복잡한 태스크를 병렬 또는 순차적으로 나눠서 더 효율적으로 처리할 수 있다.