claude-howto로 주말에 Claude Code 끝날까요? 10개 모듈 열어 본 2026 기준
퀀텀점프클럽 정상록14분 읽기8 views무료 자료
PDF · 무료
무료 클로드 코드 교재, 순서만 알면 쉬워요
긴 글을 다 읽기 전에, 실무 가이드부터 먼저 챙겨가세요.
claude-howto로 주말에 Claude Code 끝날까요? 10개 모듈 열어 본 2026 기준
claude-howto는 별 45,315개(2026-10-27 기준)를 받은 커뮤니티 무료 교재예요. 권장 순서는 폴더 번호와 다르고, 주말 10시간 계획은 로드맵 모듈 표 합계(12~13시간)보다 짧아요. 훅은 하나씩 읽고 켜세요.
주말이면 정말 Claude Code가 끝나는 교재일까요?
claude-howto는 깃허브 별 45,315개(2026-10-27 기준)를 받은 무료 Claude Code 학습 가이드입니다. 직접 열어 본 결론부터 말하면 쓸 만한 실습 교재예요. 다만 폴더 번호, 주말 시간표, 훅 스크립트 설치 방법 세 곳은 그대로 따르면 어긋납니다.
"주말이면 진짜 끝나나요?" "공식 자료라서 믿어도 되죠?" 이런 질문이 먼저 떠오르는 게 당연해요. 별이 많다고 내용이 검증된 건 아니니까요. 그래서 README와 로드맵 문서를 끝까지 읽고 모듈 폴더를 하나씩 열어 공식 문서와 맞춰 봤어요.
이 글은 정체, 구성, 권장 순서, 주말 시간표, 공식 문서와 어긋난 곳, 안전 수칙, 버전과 한국어판 순서로 답합니다.
claude-howto는 공식 교재인가요?
아니에요. claude-howto(luongnv89/claude-howto)는 개인 개발자가 만든 커뮤니티 자료이고 Anthropic 공식 교재가 아닙니다. README도 자기 위치를 스스로 구분해요. "The official docs are a feature reference. This guide is a tutorial…" 공식 문서는 기능 사전이고 이 가이드는 따라 하는 튜토리얼이라는 뜻이죠.
GitHub API로 확인한 수치(2026-10-27 기준)는 별 45,315개, 포크 5,557개, 라이선스 MIT입니다. 저장소는 2025-11-07에 만들어졌고 마지막 push는 2026-10-26(UTC)이에요. 10개 모듈과 레벨 진단 스킬 2개가 뼈대입니다.
X에서는 소개형 게시물이 중심이에요. RoundtableSpace가 2026-10-24 올린 게시물(좋아요 164)은 "주말에 나머지 90%를 배운다"는 식으로 홍보하는데, 이 90%에는 측정 근거가 없습니다. 내용을 따져 본 비판 글은 찾지 못했고 Reddit은 접근이 막혀 확인하지 못했어요. 반응은 참고만 하고 판단은 열어 본 내용으로 합니다.
열어 보면 무엇이 들어 있나요?
소요 시간과 레벨은 README와 LEARNING-ROADMAP 표의 값이에요. 들어 있는 파일은 main 브랜치 폴더를 직접 세어 확인했습니다(2026-10-27 수집).
| 권장 순서 | 폴더 | 레벨 | 표 시간 | 실제 들어 있는 것 |
|---|---|---|---|---|
| 1 | 01-slash-commands | Beginner | 30분 | 명령 파일 8개 (optimize, pr, commit 등) |
| 2 | 02-memory | Beginner+ | 45분 | CLAUDE.md 템플릿 3개 (팀 공통·폴더별·개인) |
| 3 | 08-checkpoints | Intermediate | 45분 | 설명 문서 1개 (설치물 없음) |
| 4 | 10-cli (기초) | Beginner+ | 30분 | README 1개 (claude -p 등 명령 예시) |
| 5 | 03-skills | Intermediate | 1시간 | 스킬 폴더 6개 |
| 6 | 06-hooks | Intermediate | 1시간 | 셸 스크립트 9개 + 파이썬 2개 |
| 7 | 05-mcp | Intermediate+ | 1시간 | MCP 설정 JSON 4개 |
| 8 | 04-subagents | Intermediate+ | 1.5시간 | 서브에이전트 정의 9개 |
| 9 | 09-advanced-features | Advanced | 2~3시간 | 설정 예시와 계획 모드 문서 |
| 10 | 07-plugins | Advanced | 2시간 | 플러그인 번들 3개 |
| 11 | 10-cli (마스터리) | Advanced | 1시간 | CI/CD·배치 처리 실습 (로드맵 표에만 있는 행) |
용어가 낯설면 이렇게 보세요. 슬래시 명령은 /로 시작하는 단축 명령, CLAUDE.md는 Claude가 매번 먼저 읽는 프로젝트 규칙 메모예요. 스킬은 필요할 때 불러 쓰는 작업 설명서, 훅은 특정 순간에 자동으로 실행되는 스크립트입니다. MCP는 Claude를 외부 도구·서비스에 연결하는 표준 연결 방식이고, 서브에이전트는 일을 나눠 맡기는 보조 AI예요.
README의 접힘 섹션 "Directory Structure"는 실제보다 파일을 적게 보여줍니다. 예를 들어 01은 명령 3개, 04는 에이전트 5개, 06은 스크립트 6개만 적혀 있어요. 구성은 표처럼 폴더를 직접 열어 보는 편이 정확합니다.
폴더 번호대로 공부하면 안 되는 이유가 뭔가요?
권장 경로가 번호 순서가 아니기 때문이에요. README 학습 경로 표에 따르면 순서는 01 → 02 → 08 → 10 → 03 → 06 → 05 → 04 → 09 → 07입니다. 체크포인트(08)와 CLI 기초(10)가 스킬·훅·MCP보다 앞에 오죠. 실험하다 망쳐도 되돌릴 수 있게 하려는 배치로 읽히는데, 이 부분은 제 해석입니다.
그런데 로드맵 문서의 Learning Philosophy 절에는 "The folders in this repository are numbered in recommended learning order"라고 적혀 있어요. 폴더가 권장 학습 순서대로 번호가 매겨져 있다는 문장인데, 같은 문서의 표와 어긋납니다. 번호 순서로 풀면 07 플러그인(Advanced)과 08 체크포인트 사이에서 길을 잃기 쉬워요. 표의 순서를 기준으로 삼으세요.
주말 10시간으로 정말 끝날까요?
빠듯합니다. 로드맵 문서에 따르면 주말 계획은 토요일 오전 3시간, 오후 3시간, 일요일 4시간으로 모두 10시간이에요. 그런데 같은 문서의 모듈 표 11행을 더하면 1213시간이 됩니다. 비교 기준은 같은 문서의 모듈 표 합계이고, 주말 계획이 23시간 짧아요.
주말 10시간으로 정말 끝날까요?
가이드 주말 계획은 10시간이지만 같은 문서의 모듈 표 시간을 그대로 넣으면 12
13시간이라 주말 계획이 23시간 짧다자료: github.com · QJC 재구성
레벨별 시작점도 문서마다 달라요. README는 Beginner 약 2.5시간, Intermediate 약 3.5시간, Advanced 약 5시간이고 로드맵의 레벨 판정표는 3시간, 5시간, 5시간입니다. 로드맵 체크리스트 8문항 중 체크가 02개면 Level 1, 35개면 Level 2, 6~8개면 Level 3에서 시작하라고 해요.
모듈 표 시간을 그대로 넣어 다시 짠 현실적인 주말표는 아래와 같습니다.
| 시간대 | 모듈 (표 시간) | 끝내는 기준 |
|---|---|---|
| 토요일 오전 | 01·02·08·10 기초 (2.5시간) | /optimize 동작, 프로젝트 CLAUDE.md 생성, /rewind로 실험 되돌리기, claude -p 한 번 |
| 토요일 오후 | 03·06·05·04 (4.5시간) | 스킬 1개 자동 호출, 훅 1개 동작, MCP 1개 연결, 서브에이전트 위임 1회 |
| 일요일 | 09·07·10 마스터리 (5~6시간) | 계획 모드·권한 모드 체험, 플러그인 로드, CI 스크립트 1개 |
토요일 오후는 가이드 계획(3시간)보다 1.5시간 길고, 일요일은 가이드 계획(4시간)보다 1~2시간 길어요. 일요일 분량이 넘치면 09와 07은 다른 주말로 미뤄도 됩니다. 두 모듈의 선행 조건이 "All previous"라서 앞 단계 이해에는 지장이 없거든요.
내 수준은 어떻게 확인하나요?
저장소에 진단 스킬 2개가 들어 있어요. /self-assessment는 Quick 2분 또는 Deep 5분으로 10개 영역 점수와 맞춤 학습 경로를 알려 줍니다. /lesson-quiz [레슨]은 레슨당 10문항이고, 문제은행에서만 출제하도록 되어 있어요.
주의할 점이 둘 있어요. 두 스킬은 저장소의 .claude/skills/에 있어서, 저장소를 복제한 폴더 안에서 claude를 실행해야 보입니다(공식 Skills 문서의 프로젝트 스킬 위치 규칙으로 본 추론이에요). 그리고 문제은행이 영어라, 한국어로 풀고 싶으면 질문 번역을 요청하는 방식이 무난합니다.
공식 문서와 어긋나는 곳은 어디인가요?
먼저 맞는 부분부터요. 공식 문서와 대조해 보니 핵심 설명 대부분은 일치합니다. README의 훅 이벤트 33개는 공식 Hooks reference 표의 고유 이벤트 이름 수 33개와 같아요. 커스텀 명령이 스킬로 합쳐졌다는 설명, 메모리 import 깊이 4단계, 권한 모드 표기도 맞습니다.
어긋나거나 낡은 곳은 세 군데예요.
1. 체크포인트 한계 서술이 공식 문서보다 단순해요
가이드 08 모듈은 "Bash command changes NOT tracked"라고 단정합니다. 공식 Checkpointing 문서는 조건을 나눠요. Claude가 편집 도구로 한 번 고친 파일은 이후 Bash 변경도 /rewind로 되감기되지만, "A file that only Bash commands changed isn't tracked and stays as it is"(Bash 명령으로만 바뀐 파일은 추적되지 않고 그대로 남는다)라고 적혀 있어요. 실습할 때는 "Bash로만 바꾼 파일은 못 되돌린다, git을 쓴다"로 이해하면 양쪽과 모순이 없습니다.
2. claude -p 세션의 훅 실행 경고가 빠져 있어요
공식 문서는 -p 세션이 신뢰 대화상자 없이 폴더를 신뢰한 것으로 보고, 저장소에 커밋된 훅을 그대로 실행한다고 경고합니다. 가이드 06 모듈의 보안 절에는 이 동작이 없어요. 10-cli 모듈은 --bare와 --restricted 플래그를 표로 소개하지만 같은 설명은 없습니다. 10-cli가 claude -p를 CI/CD 핵심 도구로 가르치기 때문에, 실습자에게 중요한 누락이라고 봅니다.
3. 빠른 시작이 옛 위치에 복사시켜요
README의 "Get Started in 15 Minutes"는 .claude/commands/에 파일을 복사하게 합니다. 공식 Skills 문서는 이 위치를 "the older format and still works"(옛 형식이지만 여전히 동작한다)라고 설명하고, 새 작업에는 스킬(.claude/skills/)을 권해요. 동작에는 문제가 없지만 위치가 두 군데라는 점은 알고 시작하세요. 07 플러그인 예제 3개도 commands/ 폴더를 쓰는데, 가이드 스스로 "legacy"라고 적고 있습니다.
따라 하기 전에 지킬 안전 수칙은 무엇인가요?
핵심은 훅 안전 수칙입니다. 공식 Hooks reference는 이렇게 경고해요. "Command hooks execute shell commands with your full user permissions." 커맨드 훅은 내 계정의 전체 권한으로 셸 명령을 실행한다는 뜻이고, 계정이 접근할 수 있는 모든 파일을 고치거나 지울 수 있다는 설명이 이어집니다.
- 훅은 하나씩 읽고 켜세요. README 설치 예시는
cp 06-hooks/*.sh ~/.claude/hooks/뒤 사용자 설정(~/.claude/settings.json)에 등록하게 합니다. 사용자 설정은 모든 프로젝트에 적용되니, 처음에는 연습용 프로젝트의.claude/settings.json에 하나씩 넣고 스크립트 내용을 읽은 뒤 켜세요. - 남의 저장소에서
claude -p를 돌리기 전에.claude/설정을 읽거나 훅을 끄세요. 공식 문서는--bare로 시작하거나--settings '{"disableAllHooks": true}'로 그 실행의 훅을 끄라고 안내합니다. - MCP는 연결 전에 믿을 수 있는 서버인지 확인하세요. 공식 MCP 문서의 문장은 "Verify you trust each server before connecting it."입니다. GitHub MCP 예시는 개인 액세스 토큰을 명령줄에 직접 넣으니, 읽기 전용 토큰을 쓰고 실습이 끝나면 폐기하세요. 가이드 05 모듈도 DB 예제에서 "Use a local or throwaway database, never production."이라고 적었어요. PR 200(2026-10-20 병합)으로 데이터베이스 예제는 기본 읽기 전용이 됐습니다.
- 체크포인트를 git 대신 쓰지 마세요. Bash로만 바꾼 파일과 편집기에서 직접 바꾼 파일은 되감기되지 않아요. 실습 폴더는 git으로 관리하세요.
- CLAUDE.md 템플릿은 줄여 쓰세요. 공식 Memory 문서는 "target under 200 lines per CLAUDE.md file."(파일당 200줄 이하를 목표로)이라고 권하고, 길수록 컨텍스트를 먹고 지시 준수율이 떨어진다고 설명합니다. 템플릿을 통째로 붙이지 말고 내 프로젝트 규칙만 남기세요.
버전과 한국어판은 어디까지 따라왔나요?
가이드는 Claude Code 버전 2.1.302 기준이고, 한국어판은 아직 없습니다. 동기화 PR 194가 2026-10-19에 병합됐어요. 반면 npm 레지스트리 기준 공식 최신판은 2.1.311(2026-10-26 게시)이라, 2026-10-27 기준 2.1.303~2.1.311 사이 9개 릴리스는 반영 전입니다.
README의 "synced with every Claude Code release"(모든 릴리스마다 동기화)는 과장이에요. 동기화 PR 제목을 보면 2.1.245부터 2.1.302까지 9번에 걸쳐 묶음으로 따라잡았고, 저장소 자체 CHANGELOG.md 최상단은 v2.1.245(2026-08-25 항목)에 머물러 있습니다. 버전을 인용할 때는 날짜를 함께 적는 게 안전해요.
번역판 현황도 확인했어요. 언어판은 영어, 베트남어, 중국어, 우크라이나어, 일본어 5개입니다. 한국어 전체 번역 PR 150은 2026-07-02에 만들어졌지만 병합되지 않았어요. 중국어판과 일본어판은 버전 표기가 2.1.112, 2.1.119에 멈춰 있어서, 번역판을 읽으면 낡은 설명을 볼 수 있습니다. 한국어 사용자는 영어 원문을 기준으로 삼고 막히는 문장만 번역을 요청하세요.
마무리
claude-howto는 공식 교재가 아니라 따라 하기 좋은 커뮤니티 실습서입니다. 표의 권장 순서를 따르고, 주말 시간표는 12~13시간으로 잡고, 훅과 claude -p는 연습용 폴더에서만 다루면 충분히 쓸모가 있어요.
천천히 검토하셔도 됩니다. 시작하려면 연습용 폴더를 하나 만들어 git으로 관리하고, 토요일 오전 몫인 01·02·08·10 네 모듈 2.5시간부터 열어 보세요. 막히는 지점이 생기면 그때 공식 문서와 claude-howto 저장소를 번갈아 펼쳐 보면 됩니다.
자주 묻는 질문
한국어로 된 claude-howto는 없나요?
2026-10-27 기준 한국어판은 없습니다. 언어판은 영어·베트남어·중국어·우크라이나어·일본어 5개이고, 한국어 번역 PR 150은 2026-07-02에 만들어진 뒤 병합되지 않았어요. 중국어·일본어판은 버전 표기가 2.1.112, 2.1.119에 멈춰 있어 영어 원문이 더 안전합니다.
훅 스크립트 9개를 그냥 전부 설치해도 되나요?
권하지 않아요. 공식 Hooks reference는 커맨드 훅이 내 계정의 전체 권한으로 셸 명령을 실행한다고 경고합니다. 06-hooks 폴더의 셸 스크립트 9개와 파이썬 2개는 연습용 프로젝트에서 하나씩 읽고 켜는 쪽이 안전해요.
개발 경험이 없어도 따라갈 수 있나요?
앞쪽 모듈은 가능하지만 뒤로 갈수록 어려워져요. 01 슬래시 명령(30분)은 Beginner, 02 메모리(45분)는 Beginner+이고 권장 순서 세 번째인 08 체크포인트부터 Intermediate가 섞입니다. 터미널이 낯설다면 10-cli 기초(30분)를 미리 훑어보고, 로드맵 체크리스트 8문항 중 0~2개만 체크되면 Level 1부터 시작하세요.
