A visual, example-driven guide to Claude Code β from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
curl -fsSL https://cookapps.net/api/skills/install?skills=β’β’β’β’β’β’β’ | nodeClaude How To
π Language / NgΓ΄n ngα»― / θ―θ¨ / ΠΠΎΠ²Π° / μΈμ΄: English | TiαΊΏng Viα»t | δΈζ | Π£ΠΊΡΠ°ΡΠ½ΡΡΠΊΠ° | ζ₯ζ¬θͺ | νκ΅μ΄ | ΩΨ§Ψ±Ψ³Ϋ
Go from typing claude to orchestrating agents, hooks, skills, and MCP servers β with visual tutorials, copy-paste templates, and a guided learning path.
**Get Started in 15 Minutes | Find Your Level | Browse the Feature Catalog**
You installed Claude Code. You ran a few prompts. Now what?
You're leaving 90% of Claude Code's power on the table β and you don't know what you don't know.
This isn't another feature reference. It's a structured, visual, example-driven guide that teaches you to use every Claude Code feature with real-world templates you can copy into your project today.
| Official Docs | This Guide | |
|---|---|---|
| Format | Reference documentation | Visual tutorials with Mermaid diagrams |
| Depth | Feature descriptions | How it works under the hood |
| Examples | Basic snippets | Production-ready templates you use immediately |
| Structure | Feature-organized | Progressive learning path (beginner to advanced) |
| Onboarding | Self-directed | Guided roadmap with time estimates |
| Self-Assessment | None | Interactive quizzes to find your gaps and build a personalized path |
/self-assessment or /lesson-quiz hooks directly in Claude Code to identify gaps**Start the Learning Path ->**
Take the self-assessment quiz or run /self-assessment in Claude Code. Get a personalized roadmap based on what you already know.
Work through 10 modules in order β each builds on the last. Copy templates directly into your project as you learn.
The real power is in combining features. Learn to wire slash commands + memory + subagents + hooks into automated pipelines that handle code reviews, deployments, and documentation generation.
Run /lesson-quiz [topic] after each module. The quiz pinpoints what you missed so you can fill gaps fast.
Star History Chart
Take the self-assessment or pick your level:
| Level | You can... | Start here | Time |
|---|---|---|---|
| Beginner | Start Claude Code and chat | Slash Commands | ~2.5 hours |
| Intermediate | Use CLAUDE.md and custom commands | Skills | ~3.5 hours |
| Advanced | Configure MCP servers and hooks | Advanced Features | ~5 hours |
Full learning path with all 10 modules:
| Order | Module | Level | Time |
|---|---|---|---|
| 1 | Slash Commands | Beginner | 30 min |
| 2 | Memory | Beginner+ | 45 min |
| 3 | Checkpoints | Intermediate | 45 min |
| 4 | CLI Basics | Beginner+ | 30 min |
| 5 | Skills | Intermediate | 1 hour |
| 6 | Hooks | Intermediate | 1 hour |
| 7 | MCP | Intermediate+ | 1 hour |
| 8 | Subagents | Intermediate+ | 1.5 hours |
| 9 | Advanced Features | Advanced | 2-3 hours |
| 10 | Plugins | Advanced | 2 hours |
**Complete Learning Roadmap ->**
Installation note: Starting in v2.1.113, Claude Code ships as a native per-platform binary (macOS/Linux/Windows). The recommended install is the native installer (curl -fsSL https://claude.ai/install.sh | bash); npm installation is deprecated in the official README; prefer the native installer, Homebrew (brew install --cask claude-code) or WinGet (winget install Anthropic.ClaudeCode). For reference,npm install -g @anthropic-ai/claude-codepulls the same native binary through a per-platform optional dependency at install time. On npm 12, which skips Claude Code's postinstall step by default, that install ends withError: claude native binary not installed.β switch to the native installer or follow Fix an npm 12 install. As of v2.1.116, downloads come fromhttps://downloads.claude.ai/claude-code-releasesβ corporate proxies must allowlist this host.
# 1. Clone the guide git clone https://github.com/luongnv89/claude-howto.git cd claude-howto # 2. Copy your first slash command mkdir -p /path/to/your-project/.claude/commands cp 01-slash-commands/optimize.md /path/to/your-project/.claude/commands/ # 3. Try it β in Claude Code, type: # /optimize # 4. Ready for more? Set up project memory: cp 02-memory/project-CLAUDE.md /path/to/your-project/CLAUDE.md # 5. Install a skill: cp -r 03-skills/code-review-specialist ~/.claude/skills/
Want the full setup? Here's the 1-hour essential setup:
# Slash commands (15 min) cp 01-slash-commands/*.md .claude/commands/ # Project memory (15 min) cp 02-memory/project-CLAUDE.md ./CLAUDE.md # Install a skill (15 min) cp -r 03-skills/code-review-specialist ~/.claude/skills/ # Weekend goal: add hooks, subagents, MCP, and plugins # Follow the learning path for guided setup
**View the Full Installation Reference**
| Use Case | Features You'll Combine |
|---|---|
| Automated Code Review | Slash Commands + Subagents + Memory + MCP |
| Team Onboarding | Memory + Slash Commands + Plugins |
| CI/CD Automation | CLI Reference + Hooks + Background Tasks |
| Documentation Generation | Skills + Subagents + Plugins |
| Security Audits | Subagents + Skills + Hooks (read-only mode) |
| DevOps Pipelines | Plugins + MCP + Hooks + Background Tasks |
| Complex Refactoring | Checkpoints + Planning Mode + Hooks |
Is this free?
Yes. MIT licensed, free forever. Use it in personal projects, at work, in your team β no restrictions beyond including the license notice.
Is this maintained?
Actively. The guide is synced with every Claude Code release. Current version: v2.1.323 (November 2026), compatible with Claude Code 2.1+.
How is this different from the official docs?
The official docs are a feature reference. This guide is a tutorial with diagrams, production-ready templates, and a progressive learning path. They complement each other β start here to learn, reference the docs when you need specifics.
How long does it take to go through everything?
11-13 hours for the full path. But you'll get immediate value in 15 minutes β just copy a slash command template and try it.
Can I use this with Claude Sonnet / Haiku / Opus?
Yes. All templates work with Claude Fable 5.2, Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5, Claude Sonnet 5.5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 5.5, and Claude Haiku 4.5.
Can I contribute?
Absolutely. See CONTRIBUTING.md for guidelines. We welcome new examples, bug fixes, documentation improvements, and community templates.
Can I read this offline?
Yes. Run uv run scripts/build_epub.py to generate an EPUB ebook with all content and rendered diagrams.
You already have Claude Code installed. The only thing between you and 10x productivity is knowing how to use it. This guide gives you the structured path, the visual explanations, and the copy-paste templates to get there.
MIT licensed. Free forever. Clone it, fork it, make it yours.
**Start the Learning Path -> | Browse the Feature Catalog | Get Started in 15 Minutes**
Quick Navigation β All Features
| Feature | Description | Folder |
|---|---|---|
| Feature Catalog | Complete reference with installation commands | CATALOG.md |
| Slash Commands | User-invoked shortcuts | 01-slash-commands/ |
| Memory | Persistent context | 02-memory/ |
| Skills | Reusable capabilities | 03-skills/ |
| Subagents | Specialized AI assistants | 04-subagents/ |
| MCP Protocol | External tool access | 05-mcp/ |
| Hooks | Event-driven automation | 06-hooks/ |
| Plugins | Bundled features | 07-plugins/ |
| Checkpoints | Session snapshots & rewind | 08-checkpoints/ |
| Advanced Features | Planning, thinking, background tasks | 09-advanced-features/ |
| CLI Reference | Commands, flags, and options | 10-cli/ |
| Blog Posts | Real-world usage examples | Blog Posts |
Feature Comparison
| Feature | Invocation | Persistence | Best For |
|---|---|---|---|
| Slash Commands | Manual (/cmd) | Session only | Quick shortcuts |
| Memory | Auto-loaded | Cross-session | Long-term learning |
| Skills | Auto-invoked | Filesystem | Automated workflows |
| Subagents | Auto-delegated | Isolated context | Task distribution |
| MCP Protocol | Auto-queried | Real-time | Live data access |
| Hooks | Event-triggered | Configured | Automation & validation |
| Plugins | One command | All features | Complete solutions |
| Checkpoints | Manual/Auto | Session-based | Safe experimentation |
| Planning Mode | Manual/Auto | Plan phase | Complex implementations |
| Background Tasks | Manual | Task duration | Long-running operations |
| CLI Reference | Terminal commands | Session/Script | Automation & scripting |
Installation Quick Reference
# Slash Commands cp 01-slash-commands/*.md .claude/commands/ # Memory cp 02-memory/project-CLAUDE.md ./CLAUDE.md # Skills cp -r 03-skills/code-review-specialist ~/.claude/skills/ # Subagents cp 04-subagents/*.md .claude/agents/ # MCP claude mcp add --transport http github https://api.githubcopilot.com/mcp/ --header "Authorization: Bearer YOUR_GITHUB_PAT" # Hooks mkdir -p ~/.claude/hooks cp 06-hooks/*.sh ~/.claude/hooks/ chmod +x ~/.claude/hooks/*.sh # Plugins (load a local plugin from the repo root) claude --plugin-dir ./07-plugins/pr-review # Checkpoints (auto-enabled, configure in settings) # See 08-checkpoints/README.md # Advanced Features (configure in settings) # See 09-advanced-features/config-examples.json # CLI Reference (no installation needed) # See 10-cli/README.md for usage examples
Location: 01-slash-commands/
What: User-invoked shortcuts stored as Markdown files
Examples:
optimize.md - Code optimization analysispr.md - Pull request preparationgenerate-api-docs.md - API documentation generatorInstallation:
cp 01-slash-commands/*.md /path/to/project/.claude/commands/
Usage:
/optimize /pr /generate-api-docs
Learn More: Discovering Claude Code Slash Commands
Location: 02-memory/
What: Persistent context across sessions
Examples:
project-CLAUDE.md - Team-wide project standardsdirectory-api-CLAUDE.md - Directory-specific rulespersonal-CLAUDE.md - Personal preferencesInstallation:
# Project memory cp 02-memory/project-CLAUDE.md /path/to/project/CLAUDE.md # Directory memory cp 02-memory/directory-api-CLAUDE.md /path/to/project/src/api/CLAUDE.md # Personal memory cp 02-memory/personal-CLAUDE.md ~/.claude/CLAUDE.md
Usage: Automatically loaded by Claude
Location: 03-skills/
What: Reusable, auto-invoked capabilities with instructions and scripts
Examples:
code-review-specialist/ - Comprehensive code review with scriptsbrand-voice/ - Brand voice consistency checkerdoc-generator/ - API documentation generatorInstallation:
# Personal skills cp -r 03-skills/code-review-specialist ~/.claude/skills/ # Project skills cp -r 03-skills/code-review-specialist /path/to/project/.claude/skills/
Usage: Automatically invoked when relevant
Location: 04-subagents/
What: Specialized AI assistants with isolated contexts and custom prompts
Examples:
code-reviewer.md - Comprehensive code quality analysistest-engineer.md - Test strategy and coveragedocumentation-writer.md - Technical documentationsecure-reviewer.md - Security-focused review (read-only)implementation-agent.md - Full feature implementationInstallation:
cp 04-subagents/*.md /path/to/project/.claude/agents/
Usage: Automatically delegated by main agent
Location: 05-mcp/
What: Model Context Protocol for accessing external tools and APIs
Examples:
github-mcp.json - GitHub integrationdatabase-mcp.json - Database queries (point DATABASE_URL at a SELECT-only user; see read-only setup)filesystem-mcp.json - File operationsmulti-mcp.json - Multiple MCP serversInstallation:
# Set environment variables export DATABASE_URL="postgresql://..." # Add MCP server via CLI claude mcp add --transport http github https://api.githubcopilot.com/mcp/ --header "Authorization: Bearer YOUR_GITHUB_PAT" # Or add to project .mcp.json manually (see 05-mcp/ for examples)
Usage: MCP tools are automatically available to Claude once configured
Location: 06-hooks/
What: Event-driven shell commands that execute automatically in response to Claude Code events
Examples:
format-code.sh - Auto-format code after writingpre-commit.sh - Run tests before commitssecurity-scan.sh - Scan for security issueslog-bash.sh - Log all bash commandsvalidate-prompt.sh - Validate user promptsnotify-team.sh - Send notifications on eventsInstallation:
mkdir -p ~/.claude/hooks cp 06-hooks/*.sh ~/.claude/hooks/ chmod +x ~/.claude/hooks/*.sh
Configure hooks in ~/.claude/settings.json:
{
"hooks": {
"PostToolUse": [
{
"matcher": "Write",
"hooks": [
{ "type": "command", "command": "~/.claude/hooks/format-code.sh" },
{ "type": "command", "command": "~/.claude/hooks/security-scan.sh" }
]
}
]
}
}Usage: Hooks execute automatically on events
Hook Types (5): command, http, prompt, mcp_tool, agent β how a hook runs.
Hook Events (33, in 4 categories) β when it runs:
PreToolUse, PostToolUse, PostToolUseFailure, PostToolBatch, PermissionRequest, PermissionDeniedSessionStart, Setup, SessionEnd, Stop, StopFailure, SubagentStart, SubagentStopUserPromptSubmit, UserPromptExpansion, MessageDisplay, TaskCompleted, TaskCreated, TeammateIdle β TaskCompleted and TaskCreated only fire when the todo tools are enabled, which is available by default only on Claude 3.x models, Opus 4 through 4.7, Sonnet 4 through 4.6, and Haiku 4.5 (CLAUDE_CODE_ENABLE_TODO_TOOLS=1 restores them)ConfigChange, CwdChanged, DirectoryAdded, FileChanged, PreCompact, PostCompact, PreModelSwitch, PostModelSwitch, WorktreeCreate, WorktreeRemove, Notification, InstructionsLoaded, Elicitation, ElicitationResultLocation: 07-plugins/
What: Bundled collections of commands, agents, MCP, and hooks
Examples:
pr-review/ - Complete PR review workflowdevops-automation/ - Deployment and monitoringdocumentation/ - Documentation generationInstallation:
# From the repo root (this repo ships no marketplace, so /plugin install does not apply) claude --plugin-dir ./07-plugins/pr-review claude --plugin-dir ./07-plugins/devops-automation claude --plugin-dir ./07-plugins/documentation
Usage: Use bundled slash commands and features
Location: 08-checkpoints/
What: Save conversation state and rewind to previous points to explore different approaches
Key Concepts:
Usage:
# Checkpoints are created automatically with every user prompt # To rewind, press Esc twice or use: /rewind # Then choose from six options: # 1. Restore code and conversation # 2. Restore conversation # 3. Restore code # 4. Summarize from here # 5. Summarize up to here # 6. Never mind
Use Cases:
Location: 09-advanced-features/
What: Advanced capabilities for complex workflows and automation
Includes:
Alt+T / Option+T)manual (config value default), acceptEdits, plan, auto, dontAsk, bypassPermissionsclaude -p "Run tests and generate report" --permission-mode auto/resume, /rename, /fork, /branch, claude -c, claude -r~/.claude/settings.jsonSee config-examples.json for complete configurations.
Location: 10-cli/
What: Complete command-line interface reference for Claude Code
Quick Examples:
# Interactive mode claude "explain this project" # Print mode (non-interactive) claude -p "review this code" # Process file content cat error.log | claude -p "explain this error" # JSON output for scripts claude -p --output-format json "list functions" # Resume session claude -r "feature-auth" "continue implementation"
Use Cases: CI/CD pipeline integration, script automation, batch processing, multi-session workflows, custom agent configurations
Example Workflows
# Uses: Slash Commands + Subagents + Memory + MCP User: /review-pr Claude: 1. Loads project memory (coding standards) 2. Fetches PR via GitHub MCP 3. Delegates to code-reviewer subagent 4. Delegates to test-engineer subagent 5. Synthesizes findings 6. Provides comprehensive review
# Uses: Skills + Subagents + Memory User: "Generate API documentation for the auth module" Claude: 1. Loads project memory (doc standards) 2. Detects doc generation request 3. Auto-invokes doc-generator skill 4. Delegates to api-documenter subagent 5. Creates comprehensive docs with examples
# Uses: Plugins + Subagents + Hooks User: /devops-automation:deploy production Claude: 1. Runs pre-deploy hook (validates environment) 2. Delegates to deployment-specialist subagent 3. Runs the deploy script (kubectl) 4. Monitors progress 5. Runs post-deploy hook (health checks) 6. Reports status
Directory Structure
βββ 01-slash-commands/ β βββ optimize.md β βββ pr.md β βββ generate-api-docs.md β βββ README.md βββ 02-memory/ β βββ project-CLAUDE.md β βββ directory-api-CLAUDE.md β βββ personal-CLAUDE.md β βββ README.md βββ 03-skills/ β βββ code-review-specialist/ β β βββ SKILL.md β β βββ scripts/ β β βββ templates/ β βββ brand-voice/ β β βββ SKILL.md β β βββ templates/ β βββ doc-generator/ β β βββ SKILL.md β β βββ generate-docs.py β βββ README.md βββ 04-subagents/ β βββ code-reviewer.md β βββ test-engineer.md β βββ documentation-writer.md β βββ secure-reviewer.md β βββ implementation-agent.md β βββ README.md βββ 05-mcp/ β βββ github-mcp.json β βββ database-mcp.json β βββ filesystem-mcp.json β βββ multi-mcp.json β βββ README.md βββ 06-hooks/ β βββ format-code.sh β βββ pre-commit.sh β βββ security-scan.sh β βββ log-bash.sh β βββ validate-prompt.sh β βββ notify-team.sh β βββ README.md βββ 07-plugins/ β βββ pr-review/ β βββ devops-automation/ β βββ documentation/ β βββ README.md βββ 08-checkpoints/ β βββ checkpoint-examples.md β βββ README.md βββ 09-advanced-features/ β βββ config-examples.json β βββ planning-mode-examples.md β βββ README.md βββ 10-cli/ β βββ README.md βββ README.md (this file)
Best Practices
Troubleshooting
Testing
This project includes comprehensive automated testing:
# Install development dependencies uv pip install -r scripts/requirements-dev.txt # Run all unit tests pytest scripts/tests/ -v # Run tests with coverage report pytest scripts/tests/ -v --cov=scripts --cov-report=html # Run code quality checks ruff check scripts/ ruff format --check scripts/ # Run security scan bandit -c scripts/pyproject.toml -r scripts/ --exclude scripts/tests/ # Run type checking mypy scripts/ --ignore-missing-imports
Tests run automatically on every push to main/develop and every PR to main. See TESTING.md for detailed information.
EPUB Generation
Want to read this guide offline? Generate an EPUB ebook:
uv run scripts/build_epub.py
This creates claude-howto-guide.epub with all content, including rendered Mermaid diagrams.
See scripts/README.md for more options.
Contributing
Found an issue or want to contribute an example? We'd love your help!
**Please read CONTRIBUTING.md for detailed guidelines on:**
Our Community Standards:
If you discover a security vulnerability, please report it responsibly:
Quick start:
add/feature-name, fix/bug, docs/improvement)Need help? Open an issue or discussion, and we'll guide you through the process.
Additional Resources
We welcome contributions! Please see our Contributing Guide for details on how to get started.
MIT License - see LICENSE. Free to use, modify, and distribute. The only requirement is including the license notice.
Last Updated: November 13, 2026
Claude Code Version: 2.1.323
Sources:
Compatible Models: Claude Fable 5.2, Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5, Claude Sonnet 5.5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 5.5, Claude Haiku 4.5
One MCP for reverse engineering across binaries, applications, and runtime behavior. Point your AI coding agent at any compiled app to understand its mechanics down to the binary level.
The definitive suite of 39 production grade agent skills by Matt Pocock for real software engineering, domain modeling, rigorous alignment grilling, TDD, and deep module architecture.
Get instant access to complete setup guides, repository source code, and integration assets.