概要
このリポジトリは、Claude Code プラットフォームを活用するための実例中心のガイド集です。slash commands、hooks、skills、MCP servers、subagents といった Claude Code の各機能を、段階的に学習できる構成になっており、各レベルでコピペですぐに動作するテンプレートが付属しています。Claude Code の機能を本格的に業務に組み込みたい開発者の「次のステップが見えない」という問題を解決します。
主な機能
- 段階的学習フロー：基本概念から複雑なエージェント実装まで、難度順に整理された章立て
- ビジュアル解説：テキストだけでなくMermaidダイアグラムで概念を視覚化。プラグインモジュールではアーキテクチャ図やシーケンス図で全体像を把握できる
Pluginは Slash Commands・Subagents・MCP Servers・Hooks・Configurationをまとめてバンドルする仕組みだ。
インストール時の処理フローもシーケンス図で示されている。/plugin install pr-review のように1コマンドで各コンポーネントが自動設定される。
- 動作実証済みテンプレート：コピペで即座に動作する実装例が各セクションに付属
- Slash Commands の活用：コマンド設計と実装パターン
- Hooks と状態管理：ワークフロー内での状態保持と連携方法
- Skills の設計と実装：再利用可能なスキルコンポーネントの構築
- MCP Servers との連携：外部ツール・サービス統合の実装ガイド。LangChainやDifyといったエージェントフレームワークとの違いも理解しやすい
- Subagents による分散処理：複数エージェント間の協調と通信パターン
- 実践的なトラブルシューティング：よくある実装エラーと対処法の具体例
技術スタック
- プラットフォーム: Claude Code 2.1+
- ドキュメント形式: Markdown + ビジュアルアセット（PNG, SVG）
- バージョン管理: Git
導入方法
- リポジトリをクローン：
git clone https://github.com/luongnv89/claude-howto.git cd claude-howto -
README の「Getting Started」セクションで、あなたのレベル（初級・中級・上級）を選択
-
各セクションのテンプレートを参照し、Claude Code 内で実装を進める
-
ビジュアルガイドに従い、slash commands、hooks、skills を組み合わせてワークフローを構築
- 動作を確認後、テンプレートを自分のユースケースに適応させる
競合比較
| 特徴 | claude-howto | 公式ドキュメント | LangChain Hub | 他の AI 開発環境 |
|---|---|---|---|---|
| Claude Code テンプレート | ◎（豊富） | △（最小限） | × | × |
| ビジュアル解説 | ◎ | △ | △ | △ |
| ワークフロー設計パターン | ◎ | △ | △ | △ |
| 日本語対応 | ◎ | × | △ | △ |
| 段階的学習フロー | ◎ | △ | △ | △ |
差別化ポイント：
このリポジトリの強みは「Claude Code 特化」と「実装即応性」の両立です。Claude Code Auto Modeのような新機能にも対応しており、公式ドキュメントは機能説明に重点を置き参照リファレンス的であり、他の開発環境ガイドは一般的な LLM 実装に焦点を当てています。claude-howto は Claude Code 環境内での実装に特化し、初級者が「何から始めるか」を示し、中級者が「次に何を学ぶか」を導き、上級者が「複雑なワークフローをどう設計するか」を実例で示す、という一貫した構成になっています。また、ビジュアル資産が豊富なため、複雑な概念（slash command チェーン、hooks による状態遷移、subagents 間の通信など）が直感的に理解できます。
活用シーン
-
開発チーム内での Claude Code スキル共有：チーム内に Claude Code 未経験者がいるとき、段階的なテンプレートで基本から応用まで段階的に習得できる
-
定型タスク自動化の実装：定期レポート生成、ドキュメント分類、データ処理など、既存テンプレートをベースに ワークフローを構築できる
-
複雑なエージェントシステムの設計：複数の skills を組み合わせたシステムを作るとき、「どう分割するか」「状態をどう管理するか」「MCP servers をどう統合するか」をガイドの実装例から学べる
こんな人におすすめ
-
Claude Code は知ってるが、本格実装になると何から始めるか分からない開発者：段階的なテンプレートで迷わずスタートできる
-
チーム全体を Claude Code 活用へ転換したい技術リーダー：統一的な学習パスと実装パターンを提供でき、技術的ばらつきを減らせる
-
エージェント設計の理論は知っているが、Claude Code での実装に落とし込むのに不安がある開発者：実装コード例が豊富で、概念から実践への橋渡しができる
-
ワークフロー自動化を短期間で立ち上げる必要がある小規模チーム：テンプレート活用で開発期間を短縮できる
-
slash commands、hooks、MCP servers の組み合わせ方を学びたい実装者：組み合わせパターンと設計ガイドが明示されている