OpenSource-Hub

claude-howto

튜토리얼

luongnv89/claude-howto

기초부터 고급 에이전트까지 다루는 Claude Code 실전 가이드.

개요

Claude Code의 슬래시 명령, 메모리, 훅, 서브 에이전트 등의 기능을 다루는 구조화된 비주얼 가이드로, 복사 가능한 템플릿과 퀴즈를 제공합니다.

README 미리보기

\n  \n  \n\n\n\n  \n    \n  \n\n\n[](https://github.com/luongnv89/claude-howto/stargazers)\n[](https://github.com/luongnv89/claude-howto/network/members)\n[](LICENSE)\n[](CHANGELOG.md)\n[](https://code.claude.com)\n\n🌐 **Language / Ngôn ngữ / 语言 / Мова:** [English](README.md) | [Tiếng Việt](vi/README.md) | [中文](zh/README.md) | [Українська](uk/README.md) | [日本語](ja/README.md)\n\n# Master Claude Code in a Weekend\n\nGo from typing `claude` to orchestrating agents, hooks, skills, and MCP servers — with visual tutorials, copy-paste templates, and a guided learning path.\n\n**[Get Started in 15 Minutes](#get-started-in-15-minutes)** | **[Find Your Level](#not-sure-where-to-start)** | **[Browse the Feature Catalog](CATALOG.md)**\n\n---\n\n## Table of Contents\n\n- [The Problem](#the-problem)\n- [How Claude How To Fixes This](#how-claude-how-to-fixes-this)\n- [How It Works](#how-it-works)\n- [Not Sure Where to Start?](#not-sure-where-to-start)\n- [Get Started in 15 Minutes](#get-started-in-15-minutes)\n- [What Can You Build With This?](#what-can-you-build-with-this)\n- [FAQ](#faq)\n- [Contributing](#contributing)\n- [License](#license)\n\n---\n\n## The Problem\n\nYou installed Claude Code. You ran a few prompts. Now what?\n\n- **The official docs describe features — but don't show you how to combine them.** You know slash commands exist, but not how to chain them with hooks, memory, and subagents into a workflow that actually saves hours.\n- **There's no clear learning path.** Should you learn MCP before hooks? Skills before subagents? You end up skimming everything and mastering nothing.\n- **Examples are too basic.** A "hello world" slash command doesn't help you build a production code review pipeline that uses memory, delegates to specialized agents, and runs security scans automatically.\n\nYou're leaving 90% of Claude Code's power on the table — and you don't know what you don't know.\n\n---\n\n## How Claude How To Fixes This\n\nThis isn't another feature reference.

FAQ (5)

문제 해결
`ruff check scripts/` 실행 시 Ruff가 파일을 0개만 검사하는 문제를 해결하는 방법

scripts/pyproject.toml에서 Ruff는 include 패턴을 설정 파일이 위치한 디렉터리를 기준으로 해석하므로, scripts/**/*.py가 scripts/scripts/**/*.py로 처리됩니다. 다음과 같이 변경하세요:

[tool.ruff]
include = ["**/*.py"]

또는 Ruff 설정을 루트 수준의 `pyproject.toml`로 옮기세요. 해당 위치에서는 `scripts/**/*.py`가 올바릅니다. 주변의 `include`/`exclude` 설정에도 동일한 상대 경로 실수가 있는지 함께 검토하세요.

다음 명령으로 확인하세요:
bash
ruff check scripts/ --show-files
``

이 명령은 scripts/` 아래의 Python 파일을 나열해야 합니다. 새로 활성화된 검사가 보고하는 문제는 수정하거나 명시적으로 무시하세요.

원본 Issue #160
informational
Claude Code settings.json 파일의 올바른 우선순위 순서는 무엇인가요?

올바른 우선순위는 높은 것부터 낮은 순으로 다음과 같습니다: Managed/Policy → CLI 인수 → Local → Project → User. 설정 파일의 경우 이는 .claude/settings.local.json(로컬)이 .claude/settings.json(프로젝트)을 재정의하고, .claude/settings.json이 ~/.claude/settings.json(사용자)을 재정의한다는 의미입니다. Managed 정책/MDM 설정이 가장 높은 우선순위를 가지며, 그 뒤를 --model 또는 --settings와 같은 CLI 플래그가 잇습니다. project → local → policy → user 또는 user → project → local로 표시된 문서는 잘못된 것이며, policy → local → project → user로 수정되었습니다.

원본 Issue #130
문제 해결
Claude Code 훅 이벤트의 개수에 대해 정확한 답이 없을 때 Lesson 06 Q9를 어떻게 수정해야 하나요?

Claude Code v2.1.251에서 PreModelSwitch와 PostModelSwitch가 추가되어 훅 이벤트의 총 개수가 31개에서 33개로 늘어났습니다. 따라서 v2.1.257에서 정답은 16, 25, 31, 40이 아닌 **33**입니다. 퀴즈 선택지와 정답 키를 업데이트하여 33을 포함시키고, 모든 훅 이벤트 목록에 두 개의 새 이벤트를 추가하며, 오래된 31 참조(및 베트남어와 중국어 문서에 남아 있는 25 참조)를 교체하고, 각 언어의 CATALOG.md에서 파생된 총계를 다시 계산하세요. 튜토리얼이 업데이트되기 전까지는 제공된 선택지로는 퀴즈 문제에 올바르게 답할 수 없습니다.

원본 Issue #179
문제 해결
Lesson 08 Checkpoints 퀴즈에서 현재 rewind 및 checkpoint 설정이 오답으로 표시되는 문제를 어떻게 해결하나요?

Lesson 08에 맞게 .claude/skills/lesson-quiz/references/question-bank.md를 업데이트하세요. Q3에서는 답을 5에서 **6개의 되감기 옵션**으로 변경하고, “Summarize from here”와 함께 **“Summarize up to here”**를 추가하세요. 이는 README v2.1.216+와 일치합니다. Q8에서는 autoCheckpoint: false를 fileCheckpointingEnabled: false로 교체하세요. 이 설정의 기본값은 true이며, v2.1.119부터 문서화된 환경 변수 CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING으로도 비활성화할 수 있습니다. 퀴즈가 수정될 때까지는 오래된 퀴즈가 오답으로 채점하더라도 현재 08-checkpoints/README.md에 따라 답변하세요.

원본 Issue #165
문제 해결
Claude Code는 총 몇 개의 훅 이벤트를 지원하나요?

Claude Code v2.1.257 기준으로, 정확한 총 개수는 **31개의 훅 이벤트 유형**입니다. **25**라는 답은 v2.1.245 경의 이전 콘텐츠에는 정확했지만 현재는 오래된 정보입니다. 레슨 퀴즈에서 31을 거부하는 경우, 퀴즈와 Hooks README를 v2.1.257 문서에 맞게 업데이트/동기화하세요. 해당 수정은 이 이슈를 닫는 docs sync PR에 포함되어 있습니다. claude --version으로 설치된 버전을 확인하세요.

원본 Issue #172