🌐 Language / Ngôn ngữ / 语言 / Мова: English | Tiếng Việt | 中文 | Українська | 日本語

一个周末精通 Claude Code

从在终端输入 claude 开始，进阶到编排 Agent、Hooks、Skills 以及 MCP 服务器——配有可视化教程、即插即用模板和阶梯式学习路径。

15 分钟快速上手 | 评估你的水平 | 浏览功能目录

---

---

你安装了 Claude Code，运行了几个 Prompt。然后呢？

• 官方文档只描述了功能特性——却没有教你如何将它们组合起来。 你知道有斜杠命令（Slash Commands），但不知道如何将它们与 Hooks、Memory 和 Subagents 串联成一个真正能节省数小时的工作流。
• 缺乏清晰的学习路径。 应该在学 Hooks 之前先学 MCP 吗？在学 Subagents 之前先掌握 Skills？结果往往是什么都草草浏览一遍，却什么也没精通。
• 示例过于基础。 一个“Hello World”级别的斜杠命令，无法帮你构建出带有上下文记忆、可委派给专业 Agent 并能自动运行安全扫描的生产级代码审查（Code Review）流水线。

你将 Claude Code 90% 的潜能弃置一旁——而且你甚至不知道自己错过了什么。

---

Claude How To 如何解决这一问题

这不仅是一份功能参考手册。这是一份结构化、可视化、由示例驱动的实战指南，通过可直接复制到你项目中的实战模板，教你驾驭 Claude Code 的每一个特性。

官方文档	本指南
形式	参考文档
深度	功能特性描述
示例	基础代码片段
结构	按功能模块组织
上手指引	自主探索
自我评估	无

• 10 个教程模块，完整覆盖 Claude Code 的每一项特性——从斜杠命令到自定义 Agent 团队
• 即插即用配置——斜杠命令、CLAUDE.md 模板、Hook 脚本、MCP 配置、Subagent 定义及完整插件包
• Mermaid 架构图清晰展示各项特性的内部运作机制，让你知其然更知其所以然
• 系统化学习路径，带你在 11-13 小时内从新手进阶为高阶玩家
• 内置自我评估——直接在 Claude Code 中运行 /self-assessment 或 /lesson-quiz hooks 查漏补缺

开启学习路线 ->

---

参加自我评估测试或在 Claude Code 中运行 /self-assessment。基于你当前的掌握程度获取量身定制的路线图。

2. 遵循引导路径

按顺序学习 10 个模块——每个模块都建立在上一模块的基础之上。边学边将模板直接复制到你的项目中。

3. 将各项功能组合成工作流

真正的威力在于功能的组合。学习如何将斜杠命令 + Memory + Subagents + Hooks 串联为自动化流水线，轻松处理代码审查、部署和文档生成。

4. 检验你的掌握程度

每个模块结束后运行 /lesson-quiz [topic]。自测题会精准指出你遗漏的知识点，助你迅速补齐短板。

15 分钟快速上手

---

• 来自日常使用 Claude Code 开发者的 GitHub Stars 认可
• 来自多个团队针对自身工作流进行定制的 Forks
• 保持积极维护——与 Claude Code 的每一次版本发布保持同步（最新版本：v2.1.302，2026 年 10 月）
• 社区驱动——来自广大开发者贡献的真实生产环境配置

---

参与自我评估或直接选择你的水平级别：

级别	你能够...	从这里开始	预计耗时
初学者	启动 Claude Code 并进行对话	斜杠命令 (Slash Commands)	约 2.5 小时
中级	使用 CLAUDE.md 和自定义命令	技能 (Skills)	约 3.5 小时
高级	配置 MCP 服务器和 Hooks	高级功能 (Advanced Features)	约 5 小时

包含全部 10 个模块的完整学习路径：

查看完整学习路线图 ->

---

15 分钟快速上手

安装说明：从 v2.1.113 开始，Claude Code 作为原生跨平台二进制文件提供（macOS/Linux/Windows）。官方推荐使用原生安装脚本（curl -fsSL https://claude.ai/install.sh | bash）；官方 README 中已废弃 npm 安装方式；推荐优先使用原生安装程序、Homebrew（brew install --cask claude-code）或 WinGet（winget install Anthropic.ClaudeCode）。作为参考，npm install -g @anthropic-ai/claude-code 会在安装时通过各平台的可选依赖拉取相同的原生二进制文件。从 v2.1.116 开始，下载地址来自 https://downloads.claude.ai/claude-code-releases——企业网络代理必须将该域名加入允许访问白名单。

bash

1. 克隆本指南仓库

git clone https://github.com/luongnv89/claude-howto.git cd claude-howto

2. 复制你的第一个斜杠命令

mkdir -p /path/to/your-project/.claude/commands cp 01-slash-commands/optimize.md /path/to/your-project/.claude/commands/

3. 试运行——在 Claude Code 中输入：

/optimize

4. 准备进阶？配置项目记忆（Memory）：

cp 02-memory/project-CLAUDE.md /path/to/your-project/CLAUDE.md

5. 安装一项技能（Skill）：

cp -r 03-skills/code-review-specialist ~/.claude/skills/

想要完整配置？这里是 1 小时核心搭建方案：

bash

斜杠命令（15 分钟）

cp 01-slash-commands/*.md .claude/commands/

项目记忆（15 分钟）

cp 02-memory/project-CLAUDE.md ./CLAUDE.md

安装技能（15 分钟）

cp -r 03-skills/code-review-specialist ~/.claude/skills/

周末目标：添加 Hooks、Subagents、MCP 和 Plugins

按照学习路径进行引导式配置

查看完整安装参考文档

---

你可以用它构建什么？

应用场景	你将组合的功能特性
自动化代码审查	斜杠命令 + Subagents + Memory + MCP
团队入职引导	Memory + 斜杠命令 + Plugins
CI/CD 自动化	CLI 参考 + Hooks + 后台任务
文档自动生成	Skills + Subagents + Plugins
安全审计	Subagents + Skills + Hooks（只读模式）
DevOps 流水线	Plugins + MCP + Hooks + 后台任务
复杂代码重构	检查点（Checkpoints）+ 规划模式（Planning Mode）+ Hooks

---

这是免费的吗？ 是的。采用 MIT 许可证，永久免费。可在个人项目、工作环境及团队中自由使用——除保留许可声明外没有任何限制。

项目有人维护吗？ 积极维护中。本指南与 Claude Code 的每一次更新同步。当前版本：v2.1.302（2026 年 10 月），兼容 Claude Code 2.1+。

它与官方文档有什么区别？ 官方文档是功能参考手册。本指南则是包含流程图、生产级模板和进阶学习路径的实战教程。两者相辅相成——从本指南开始学习，在需要查阅具体细节时参考官方文档。

完整学完全部内容需要多长时间？ 完整路径耗时 11-13 小时。但你可以在 15 分钟内获得即时回报——只需复制一个斜杠命令模板并上手尝试。

我可以将这些模板用于 Claude Sonnet / Haiku / Opus 吗？ 可以。所有模板均适配 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。

我可以参与贡献吗？ 当然欢迎。参与规范请参见 CONTRIBUTING.md。我们非常欢迎提交新案例、Bug 修复、文档改进以及社区模板。

支持离线阅读吗？ 支持。运行 uv run scripts/build_epub.py 即可生成包含所有内容和已渲染图表的 EPUB 电子书。

---

立即开启 Claude Code 精通之旅

你已经安装好了 Claude Code。阻碍你实现 10 倍生产力跃升的，唯有对高阶用法的熟练掌握。本指南为你提供了结构化路径、直观的可视化图解以及开箱即用的模板，助你直达目标。

采用 MIT 许可证。永久免费。欢迎克隆、Fork，并打造属于你的配置。

开启学习路线 -> | 浏览功能目录 | 15 分钟快速上手

---

快速导航 — 全功能对比

功能特性	调用方式	持久性	最佳应用场景
斜杠命令 (Slash Commands)	手动 (/cmd)	仅限当前会话	快捷操作指令
记忆 (Memory)	自动加载	跨会话持久	长期沉淀规范与知识
技能 (Skills)	自动调用	文件系统	自动化业务工作流
子智能体 (Subagents)	自动委派	独立上下文环境	复杂任务分工与协作
MCP 协议	自动查询	实时连接	访问实时与外部系统数据
Hooks 钩子	事件触发	配置持久化	流程自动化与前置校验
插件 (Plugins)	单命令加载	包含所有特性	一体化综合解决方案
检查点 (Checkpoints)	手动/自动	会话级存储	安全试错与探索性实验
规划模式 (Planning Mode)	手动/自动	规划阶段	复杂方案设计与实现
后台任务 (Background Tasks)	手动触发	任务生命周期内	耗时较长的后台运算
CLI 参考	终端命令行	会话/脚本环境	自动化运维与脚本编写

安装快速参考：

bash

斜杠命令 (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

插件（从仓库根目录加载本地插件）

claude --plugin-dir ./07-plugins/pr-review

检查点 Checkpoints（自动启用，在设置中配置）

参见 08-checkpoints/README.md

高级功能（在设置中配置）

参见 09-advanced-features/config-examples.json

CLI 参考（无需安装）

使用示例参见 10-cli/README.md

1. 斜杠命令 (Slash Commands)

路径：01-slash-commands/

定义：以 Markdown 文件形式存储、由用户主动触发的快捷操作

示例：

• optimize.md - 代码优化分析
• pr.md - Pull Request 准备
• generate-api-docs.md - API 文档生成器

安装：

bash cp 01-slash-commands/*.md /path/to/project/.claude/commands/

使用：

bash /optimize /pr /generate-api-docs

了解更多：探索 Claude Code 斜杠命令

2. 记忆 (Memory)

路径：02-memory/

定义：跨会话持久保存的上下文规范

示例：

• project-CLAUDE.md - 团队级项目规范
• directory-api-CLAUDE.md - 针对特定目录的规则
• personal-CLAUDE.md - 个人偏好设置

安装：

bash

项目记忆

cp 02-memory/project-CLAUDE.md /path/to/project/CLAUDE.md

目录级记忆

🌐 Language / Ngôn ngữ / 语言 / Мова: English | Tiếng Việt | 中文 | Українська | 日本語

Master Claude Code in a Weekend

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?

• 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.
• There's no clear learning path. Should you learn MCP before hooks? Skills before subagents? You end up skimming everything and mastering nothing.
• 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.

You're leaving 90% of Claude Code's power on the table — and you don't know what you don't know.

---

How Claude How To Fixes This

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

• 10 tutorial modules covering every Claude Code feature — from slash commands to custom agent teams
• Copy-paste configs — slash commands, CLAUDE.md templates, hook scripts, MCP configs, subagent definitions, and full plugin bundles
• Mermaid diagrams showing how each feature works internally, so you understand why , not just how
• A guided learning path that takes you from beginner to power user in 11-13 hours
• Built-in self-assessment — run /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.

2. Follow the guided path

Work through 10 modules in order — each builds on the last. Copy templates directly into your project as you learn.

3. Combine features into workflows

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.

4. Test your understanding

Run /lesson-quiz [topic] after each module. The quiz pinpoints what you missed so you can fill gaps fast.

Get Started in 15 Minutes

---

• GitHub stars from developers who use Claude Code daily
• Forks from teams adapting this guide for their own workflows
• Actively maintained — synced with every Claude Code release (latest: v2.1.302, October 2026)
• Community-driven — contributions from developers who share their real-world configurations

---

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:

Complete Learning Roadmap ->

---

Get Started in 15 Minutes

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-code pulls the same native binary through a per-platform optional dependency at install time. As of v2.1.116, downloads come from https://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

---

What Can You Build With This?

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.302 (October 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.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.

---

Start Mastering Claude Code Today

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 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

01. Slash Commands

Location : 01-slash-commands/

What : User-invoked shortcuts stored as Markdown files

Examples :

• optimize.md - Code optimization analysis
• pr.md - Pull request preparation
• generate-api-docs.md - API documentation generator

Installation :

cp 01-slash-commands/*.md /path/to/project/.claude/commands/

Usage :

/optimize
/pr
/generate-api-docs

Learn More : Discovering Claude Code Slash Commands

02. Memory

Location : 02-memory/

What : Persistent context across sessions

Examples :

• project-CLAUDE.md - Team-wide project standards
• directory-api-CLAUDE.md - Directory-specific rules
• personal-CLAUDE.md - Personal preferences

Installation :

# 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

03. Skills

Location : 03-skills/

What : Reusable, auto-invoked capabilities with instructions and scripts

Examples :

• code-review-specialist/ - Comprehensive code review with scripts
• brand-voice/ - Brand voice consistency checker
• doc-generator/ - API documentation generator

Installation :

# 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

04. Subagents

Location : 04-subagents/

What : Specialized AI assistants with isolated contexts and custom prompts

Examples :

• code-reviewer.md - Comprehensive code quality analysis
• test-engineer.md - Test strategy and coverage
• documentation-writer.md - Technical documentation
• secure-reviewer.md - Security-focused review (read-only)
• implementation-agent.md - Full feature implementation

Installation :

cp 04-subagents/*.md /path/to/project/.claude/agents/

Usage : Automatically delegated by main agent

05. MCP Protocol

Location : 05-mcp/

What : Model Context Protocol for accessing external tools and APIs

Examples :

• github-mcp.json - GitHub integration
• database-mcp.json - Database queries
• filesystem-mcp.json - File operations
• multi-mcp.json - Multiple MCP servers

Installation :

# 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

06. Hooks

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 writing
• pre-commit.sh - Run tests before commits
• security-scan.sh - Scan for security issues
• log-bash.sh - Log all bash commands
• validate-prompt.sh - Validate user prompts
• notify-team.sh - Send notifications on events

Installation :

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:

• Tool Hooks : PreToolUse, PostToolUse, PostToolUseFailure, PostToolBatch, PermissionRequest, PermissionDenied
• Session Hooks : SessionStart, Setup, SessionEnd, Stop, StopFailure, SubagentStart, SubagentStop
• Task Hooks : UserPromptSubmit, 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)
• Lifecycle Hooks : ConfigChange, CwdChanged, DirectoryAdded, FileChanged, PreCompact, PostCompact, PreModelSwitch, PostModelSwitch, WorktreeCreate, WorktreeRemove, Notification, InstructionsLoaded, Elicitation, ElicitationResult

07. Plugins

Location : 07-plugins/

What : Bundled collections of commands, agents, MCP, and hooks

Examples :

• pr-review/ - Complete PR review workflow
• devops-automation/ - Deployment and monitoring
• documentation/ - Documentation generation

Installation :

# 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

08. Checkpoints and Rewind

Location : 08-checkpoints/

What : Save conversation state and rewind to previous points to explore different approaches

Key Concepts :

• Checkpoint : Snapshot of conversation state
• Rewind : Return to previous checkpoint
• Branch Point : Explore multiple approaches from same checkpoint

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 :

• Try different implementation approaches
• Recover from mistakes
• Safe experimentation
• Compare alternative solutions
• A/B testing different designs

09. Advanced Features

Location : 09-advanced-features/

What : Advanced capabilities for complex workflows and automation

Includes :

• Planning Mode — Create detailed implementation plans before coding
• Extended Thinking — Deep reasoning for complex problems (toggle with Alt+T / Option+T)
• Background Tasks — Run long operations without blocking
• Permission Modes — manual (config value default), acceptEdits, plan, auto, dontAsk, bypassPermissions
• Headless Mode — Run Claude Code in CI/CD: claude -p "Run tests and generate report"
• Session Management — /resume, /rename, /fork, /branch, claude -c, claude -r
• Configuration — Customize behavior in ~/.claude/settings.json

See config-examples.json for complete configurations.

10. CLI Reference

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

Complete Code Review Workflow

# 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 + MCP + Hooks

User: /deploy production

Claude:
1. Runs pre-deploy hook (validates environment)
2. Delegates to deployment-specialist subagent
3. Executes deployment via Kubernetes MCP
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

• Start simple with slash commands

• Add features incrementally

• Use memory for team standards

• Test configurations locally first

• Document custom implementations

• Version control project configurations

• Share plugins with team

• Don't create redundant features

• Don't hardcode credentials

• Don't skip documentation

• Don't over-complicate simple tasks

• Don't ignore security best practices

• Don't commit sensitive data

Troubleshooting

1. Check file location and naming

2. Verify YAML frontmatter syntax

3. Check file permissions

4. Review Claude Code version compatibility

5. Verify environment variables

6. Check MCP server installation

7. Test credentials

8. Review network connectivity

9. Check tool permissions

10. Verify agent description clarity

11. Review task complexity

12. Test agent independently

Testing

This project includes comprehensive automated testing:

• Unit Tests : Python tests using pytest (Python 3.10, 3.11, 3.12)

• Code Quality : Linting and formatting with Ruff

• Security : Vulnerability scanning with Bandit

• Type Checking : Static type analysis with mypy

• Build Verification : EPUB generation testing

• Coverage Tracking : Codecov integration

  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 readCONTRIBUTING.md for detailed guidelines on:

• Types of contributions (examples, docs, features, bugs, feedback)
• How to set up your development environment
• Directory structure and how to add content
• Writing guidelines and best practices
• Commit and PR process

Our Community Standards:

Reporting Security Issues

If you discover a security vulnerability, please report it responsibly:

1. Use GitHub Private Vulnerability Reporting : https://github.com/luongnv89/claude-howto/security/advisories
2. Or read .github/SECURITY_REPORTING.md for detailed instructions
3. Do NOT open a public issue for security vulnerabilities

Quick start:

1. Fork and clone the repository
2. Create a descriptive branch (add/feature-name, fix/bug, docs/improvement)
3. Make your changes following the guidelines
4. Submit a pull request with a clear description

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 : October 18, 2026 Claude Code Version : 2.1.302 Sources :