Files
claude-howto/ja
Luong NGUYEN f393805e4a docs(README): drop hard-coded star/fork counts from trust section
Remove the specific 21,800+ stars and 2,585+ forks numbers across en/zh/ja
READMEs. They go stale within a day of every commit. The Star History chart
already conveys current scale, and the trust bullets read fine without exact
counts.
2026-04-30 00:23:15 +02:00
..

Claude How To

GitHub Stars GitHub Forks License: MIT Version Claude Code

🌐 Language / NgÃŽn ngữ / 语蚀 / МПва / 蚀語: English | Tiếng Việt | äž­æ–‡ | УкраїМська | 日本語

Claude Code を週末でマスタヌする

claude ず打ち蟌むだけの段階から、゚ヌゞェント、フック、スキル、MCP サヌバを束ねる段階ぞ。芖芚的なチュヌトリアル、コピペで䜿えるテンプレヌト、ガむド付き孊習パスで導く。

15 分で始める | 自分のレベルを芋぀ける | 機胜カタログを芋る


目次


課題

Claude Code をむンストヌルし、いく぀かプロンプトを実行した。次は䜕をすべきか。

  • 公匏ドキュメントは機胜を説明するが、組み合わせ方は瀺さない。 スラッシュコマンドの存圚は知っおいおも、フック、メモリ、サブ゚ヌゞェントず連携させお、本圓に時間を節玄するワヌクフロヌに組み立おる方法は分からない。
  • 明確な孊習パスがない。 MCP をフックの前に孊ぶべきか。スキルをサブ゚ヌゞェントの前に孊ぶべきか。結局すべおを流し読みしお、䜕䞀぀マスタヌできない。
  • 䟋題が基本的すぎる。 「hello world」のスラッシュコマンドでは、メモリを䜿い、専門゚ヌゞェントに委譲し、セキュリティスキャンを自動実行する本番品質のコヌドレビュヌパむプラむンは䜜れない。

Claude Code の力の 90% を眠らせたたたで、しかも自分が䜕を知らないかすら分かっおいない状態である。


Claude How To が解決する方法

これは単なる機胜リファレンスではない。構造化された、芖芚的な、サンプル駆動のガむド であり、Claude Code の各機胜の䜿い方を、今日プロゞェクトにそのたたコピヌしお䜿える実践テンプレヌトずずもに教える。

公匏ドキュメント 本ガむド
圢匏 リファレンスドキュメント Mermaid 図぀きの芖芚的チュヌトリアル
深さ 機胜の説明 内郚の動䜜原理
䟋 基本的なスニペット すぐ䜿える本番品質テンプレヌト
構造 機胜別の線成 段階的な孊習パス初玚から䞊玚たで
オンボヌディング 自己孊習 所芁時間぀きガむド付きロヌドマップ
自己評䟡 なし 匱点を芋぀けお個別パスを構築するむンタラクティブ・クむズ

埗られるもの

  • 10 個のチュヌトリアルモゞュヌルスラッシュコマンドからカスタム゚ヌゞェントチヌムたで、Claude Code の党機胜を網矅
  • コピペ可胜な蚭定スラッシュコマンド、CLAUDE.md テンプレヌト、フックスクリプト、MCP 蚭定、サブ゚ヌゞェント定矩、フルプラグむンバンドル
  • Mermaid 図 で各機胜の内郚動䜜を可芖化し、「どう」だけでなく「なぜ」を理解できる
  • ガむド付き孊習パス によっお 11〜13 時間で初玚者からパワヌナヌザヌたで到達できる
  • 組み蟌みの自己評䟡Claude Code 内で /self-assessment たたは /lesson-quiz hooks を実行しお匱点を特定できる

孊習パスを始める ->


仕組み

1. 自分のレベルを芋぀ける

自己評䟡クむズ を受けるか、Claude Code 内で /self-assessment を実行する。すでに知っおいるこずに基づいた個別ロヌドマップが埗られる。

2. ガむド付きパスを進む

10 モゞュヌルを順に進める。各モゞュヌルは前のモゞュヌルの䞊に積み䞊がる。孊びながら、テンプレヌトをそのたたプロゞェクトにコピヌする。

3. 機胜を組み合わせおワヌクフロヌにする

真の力は機胜の組み合わせにある。スラッシュコマンド、メモリ、サブ゚ヌゞェント、フックを連携させお、コヌドレビュヌ、デプロむ、ドキュメント生成を自動化するパむプラむンの䜜り方を孊ぶ。

4. 理解床を詊す

各モゞュヌルの埌に /lesson-quiz [トピック] を実行する。クむズが芋萜ずした箇所を特定するため、匱点をすばやく埋められる。

15 分で始める


開発者に信頌されおいる

  • GitHub スタヌ日垞的に Claude Code を䜿う開発者から
  • フォヌク自チヌムのワヌクフロヌに合わせお応甚するチヌムから
  • 積極的にメンテナンスClaude Code のリリヌスに同期最新は v2.1.119、2026 幎 4 月
  • コミュニティ駆動実際の運甚蚭定を共有する開発者からのコントリビュヌト

Star History Chart


どこから始めればよいか分からない

自己評䟡を受けるか、レベルを遞ぶ。

レベル できるこず スタヌト地点 所芁時間
初玚 Claude Code を起動しお察話 スラッシュコマンド 箄 2.5 時間
侭箚 CLAUDE.md ずカスタムコマンドを䜿う スキル 箄 3.5 時間
侊箚 MCP サヌバずフックを蚭定する 高床な機胜 箄 5 時間

å…š 10 モゞュヌルの完党孊習パス

順序 モゞュヌル レベル 所芁時間
1 スラッシュコマンド 初玚 30 分
2 メモリ 初玚+ 45 分
3 チェックポむント 侭箚 45 分
4 CLI 基瀎 初玚+ 30 分
5 スキル 侭箚 1 時間
6 フック 侭箚 1 時間
7 MCP 侭箚+ 1 時間
8 サブ゚ヌゞェント 侭箚+ 1.5 時間
9 高床な機胜 侊箚 2〜3 時間
10 プラグむン 侊箚 2 時間

完党孊習ロヌドマップ ->


15 分で始める

むンストヌルに関する泚蚘v2.1.113 以降、Claude Code はプラットフォヌム別のネむティブバむナリmacOS / Linux / Windowsずしお配垃される。npm install -g @anthropic-ai/claude-code も匕き続き利甚可胜で、初回利甚時にネむティブバむナリがオプション䟝存関係ずしおダりンロヌドされる。v2.1.116 以降、ダりンロヌド元は https://downloads.claude.ai/claude-code-releases であり、䌁業プロキシではこのホストを蚱可リストに加える必芁がある。

# 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. 次に進みたければ、プロゞェクトメモリを蚭定:
cp 02-memory/project-CLAUDE.md /path/to/your-project/CLAUDE.md

# 5. スキルをむンストヌル:
cp -r 03-skills/code-review ~/.claude/skills/

フルセットアップが必芁なら、1 時間で必芁な蚭定 はこちら。

# スラッシュコマンド (15 分)
cp 01-slash-commands/*.md .claude/commands/

# プロゞェクトメモリ (15 分)
cp 02-memory/project-CLAUDE.md ./CLAUDE.md

# スキルをむンストヌル (15 分)
cp -r 03-skills/code-review ~/.claude/skills/

# 週末ゎヌル: フック、サブ゚ヌゞェント、MCP、プラグむンを远加
# ガむド付きセットアップは孊習パスに埓う

完党むンストヌルリファレンスを芋る


䜕が䜜れるか

ナヌスケヌス 組み合わせる機胜
自動コヌドレビュヌ スラッシュコマンド + サブ゚ヌゞェント + メモリ + MCP
チヌムオンボヌディング メモリ + スラッシュコマンド + プラグむン
CI/CD 自動化 CLI リファレンス + フック + バックグラりンドタスク
ドキュメント生成 スキル + サブ゚ヌゞェント + プラグむン
セキュリティ監査 サブ゚ヌゞェント + スキル + フック読み取り専甚モヌド
DevOps パむプラむン プラグむン + MCP + フック + バックグラりンドタスク
耇雑なリファクタリング チェックポむント + プランニングモヌド + フック

FAQ

無料か そう。MIT ラむセンスで氞遠に無料。個人プロゞェクト、業務、チヌムで自由に䜿える。ラむセンス衚蚘の同梱以倖に制玄はない。

メンテナンスされおいるか 積極的に。本ガむドは Claude Code のリリヌスごずに同期される。珟行バヌゞョンは v2.1.1192026 幎 4 月で、Claude Code 2.1+ ず互換。

公匏ドキュメントずの違いは 公匏ドキュメントは機胜リファレンスである。本ガむドは図、本番品質テンプレヌト、段階的な孊習パスを備えたチュヌトリアルである。䞡者は補完関係にある。孊ぶずきはここから始め、具䜓的な仕様が必芁なずきに公匏を参照するずよい。

党郚進めるのにどれくらいかかるか 完党パスで 11〜13 時間。ただし 15 分で即座に䟡倀が埗られる。スラッシュコマンドのテンプレヌトをコピヌしお詊すだけでよい。

Claude Sonnet / Haiku / Opus ず䞀緒に䜿えるか 䜿える。すべおのテンプレヌトは Claude Sonnet 4.6、Claude Opus 4.7、Claude Haiku 4.5 で動䜜する。

コントリビュヌトできるか もちろん。ガむドラむンは CONTRIBUTING.md を参照。新しい䟋、バグ修正、ドキュメント改善、コミュニティテンプレヌトを歓迎する。

オフラむンで読めるか 読める。uv run scripts/build_epub.py を実行すれば、すべおのコンテンツずレンダリング枈みの図を含む EPUB 電子曞籍が生成される。


今日から Claude Code をマスタヌし始める

すでに Claude Code はむンストヌル枈みのはず。あずは䜿いこなし方を知るだけで、生産性が 10 倍になる。本ガむドはそこに到達する構造化されたパス、芖芚的な解説、コピペで䜿えるテンプレヌトを提䟛する。

MIT ラむセンス。氞遠に無料。クロヌンしお、フォヌクしお、自分のものにしおほしい。

孊習パスを始める -> | 機胜カタログを芋る | 15 分で始める


クむックナビゲヌション — 党機胜
機胜 説明 フォルダ
機胜カタログ むンストヌルコマンド付き完党リファレンス CATALOG.md
スラッシュコマンド ナヌザヌが実行するショヌトカット 01-slash-commands/
メモリ 氞続的なコンテキスト 02-memory/
スキル 再利甚可胜な機胜 03-skills/
サブ゚ヌゞェント 専門特化した AI アシスタント 04-subagents/
MCP プロトコル 倖郚ツヌルアクセス 05-mcp/
フック むベント駆動の自動化 06-hooks/
プラグむン バンドルされた機胜 07-plugins/
チェックポむント セッションのスナップショットず巻き戻し 08-checkpoints/
高床な機胜 プランニング、思考、バックグラりンドタスク 09-advanced-features/
CLI リファレンス コマンド、フラグ、オプション 10-cli/
ブログ蚘事 実際の利甚䟋 Blog Posts
機胜比范
機胜 起動方法 氞続性 適しおいる甚途
スラッシュコマンド 手動 (/cmd) セッション内のみ クむックショヌトカット
メモリ 自動ロヌド セッション暪断 長期的な孊習
スキル 自動起動 ファむルシステム 自動化ワヌクフロヌ
サブ゚ヌゞェント 自動委譲 コンテキスト分離 タスク分散
MCP プロトコル 自動問い合わせ リアルタむム ラむブデヌタアクセス
フック むベントトリガヌ 蚭定倀で氞続化 自動化ず怜蚌
プラグむン 1 コマンド 党機胜を含む 完党な゜リュヌション
チェックポむント 手動 / 自動 セッション単䜍 安党な実隓
プランニングモヌド 手動 / 自動 蚈画フェヌズ 耇雑な実装
バックグラりンドタスク 手動 タスク存続期間 長時間凊理
CLI リファレンス タヌミナルコマンド セッション / スクリプト 自動化ずスクリプト
むンストヌル早芋衚
# 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 ~/.claude/skills/

# Subagents
cp 04-subagents/*.md .claude/agents/

# MCP
export GITHUB_TOKEN="token"
claude mcp add github -- npx -y @modelcontextprotocol/server-github

# Hooks
mkdir -p ~/.claude/hooks
cp 06-hooks/*.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.sh

# Plugins
/plugin install pr-review

# Checkpoints (自動有効、蚭定で調敎)
# 08-checkpoints/README.md を参照

# Advanced Features (蚭定で調敎)
# 09-advanced-features/config-examples.json を参照

# CLI Reference (むンストヌル䞍芁)
# 利甚䟋は 10-cli/README.md を参照
01. スラッシュコマンド

配眮堎所01-slash-commands/

抂芁Markdown ファむルずしお保存される、ナヌザヌが実行するショヌトカット

䟋

  • optimize.md — コヌド最適化分析
  • pr.md — プルリク゚スト準備
  • generate-api-docs.md — API ドキュメント生成

むンストヌル

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

䜿い方

/optimize
/pr
/generate-api-docs

詳しく孊ぶDiscovering Claude Code Slash Commands

02. メモリ

配眮堎所02-memory/

抂芁セッションをたたいで保持される氞続的なコンテキスト

䟋

  • project-CLAUDE.md — チヌム共通のプロゞェクト芏玄
  • directory-api-CLAUDE.md — ディレクトリ固有のルヌル
  • personal-CLAUDE.md — 個人の奜み

むンストヌル

# プロゞェクトメモリ
cp 02-memory/project-CLAUDE.md /path/to/project/CLAUDE.md

# ディレクトリメモリ
cp 02-memory/directory-api-CLAUDE.md /path/to/project/src/api/CLAUDE.md

# 個人メモリ
cp 02-memory/personal-CLAUDE.md ~/.claude/CLAUDE.md

䜿い方Claude が自動的に読み蟌む

03. スキル

配眮堎所03-skills/

抂芁指瀺曞ずスクリプトを備えた、再利甚可胜で自動起動される機胜

䟋

  • code-review/ — スクリプト぀きの包括的なコヌドレビュヌ
  • brand-voice/ — ブランドボむスの䞀貫性チェッカヌ
  • doc-generator/ — API ドキュメント生成

むンストヌル

# 個人スキル
cp -r 03-skills/code-review ~/.claude/skills/

# プロゞェクトスキル
cp -r 03-skills/code-review /path/to/project/.claude/skills/

䜿い方関連する堎面で自動的に起動される

04. サブ゚ヌゞェント

配眮堎所04-subagents/

抂芁分離されたコンテキストずカスタムプロンプトを持぀、専門特化した AI アシスタント

䟋

  • code-reviewer.md — 包括的なコヌド品質分析
  • test-engineer.md — テスト戊略ずカバレッゞ
  • documentation-writer.md — 技術ドキュメント䜜成
  • secure-reviewer.md — セキュリティ重芖のレビュヌ読み取り専甚
  • implementation-agent.md — 機胜の完党実装

むンストヌル

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

䜿い方メむン゚ヌゞェントが自動的に委譲する

05. MCP プロトコル

配眮堎所05-mcp/

抂芁倖郚ツヌルや API にアクセスするための Model Context Protocol

䟋

  • github-mcp.json — GitHub 連携
  • database-mcp.json — デヌタベヌスク゚リ
  • filesystem-mcp.json — ファむル操䜜
  • multi-mcp.json — 耇数の MCP サヌバ

むンストヌル

# 環境倉数を蚭定
export GITHUB_TOKEN="your_token"
export DATABASE_URL="postgresql://..."

# CLI で MCP サヌバを远加
claude mcp add github -- npx -y @modelcontextprotocol/server-github

# たたはプロゞェクト .mcp.json に手動远加 (䟋は 05-mcp/ を参照)

䜿い方蚭定埌、MCP ツヌルは自動的に Claude から利甚可胜になる

06. フック

配眮堎所06-hooks/

抂芁Claude Code のむベントに応じお自動実行されるむベント駆動シェルコマンド

䟋

  • format-code.sh — 曞き蟌み前にコヌドを自動敎圢
  • pre-commit.sh — コミット前にテストを実行
  • security-scan.sh — セキュリティ問題のスキャン
  • log-bash.sh — すべおの bash コマンドをログに蚘録
  • validate-prompt.sh — ナヌザヌプロンプトを怜蚌
  • notify-team.sh — むベント発生時の通知送信

むンストヌル

mkdir -p ~/.claude/hooks
cp 06-hooks/*.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.sh

~/.claude/settings.json でフックを蚭定する

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Write",
      "hooks": ["~/.claude/hooks/format-code.sh"]
    }],
    "PostToolUse": [{
      "matcher": "Write",
      "hooks": ["~/.claude/hooks/security-scan.sh"]
    }]
  }
}

䜿い方むベント発生時にフックが自動実行される

フックの皮類5 系統、28 むベント

  • ツヌル系フックPreToolUse、PostToolUse、PostToolUseFailure、PermissionRequest
  • セッション系フックSessionStart、SessionEnd、Stop、StopFailure、SubagentStart、SubagentStop
  • タスク系フックUserPromptSubmit、TaskCompleted、TaskCreated、TeammateIdle
  • ラむフサむクル系フックConfigChange、CwdChanged、FileChanged、PreCompact、PostCompact、WorktreeCreate、WorktreeRemove、Notification、InstructionsLoaded、Elicitation、ElicitationResult
07. プラグむン

配眮堎所07-plugins/

抂芁コマンド、゚ヌゞェント、MCP、フックをたずめたバンドル

䟋

  • pr-review/ — 完党な PR レビュヌワヌクフロヌ
  • devops-automation/ — デプロむず監芖
  • documentation/ — ドキュメント生成

むンストヌル

/plugin install pr-review
/plugin install devops-automation
/plugin install documentation

䜿い方バンドルされたスラッシュコマンドや機胜を利甚する

08. チェックポむントず巻き戻し

配眮堎所08-checkpoints/

抂芁䌚話の状態を保存し、過去地点に巻き戻しお別のアプロヌチを詊す機胜

䞻芁抂念

  • チェックポむント䌚話状態のスナップショット
  • 巻き戻し以前のチェックポむントぞ戻る
  • 分岐点同じチェックポむントから耇数のアプロヌチを詊す

䜿い方

# チェックポむントはナヌザヌプロンプトのたびに自動䜜成される
# 巻き戻しは Esc を 2 回抌すか、次を実行:
/rewind

# 5 ぀の遞択肢から遞ぶ:
# 1. コヌドず䌚話を埩元
# 2. 䌚話のみ埩元
# 3. コヌドのみ埩元
# 4. ここから芁玄
# 5. やめる

ナヌスケヌス

  • 耇数の実装アプロヌチを詊す
  • ミスからのリカバリ
  • 安党な実隓
  • 代替案の比范
  • 異なる蚭蚈の A/B テスト
09. 高床な機胜

配眮堎所09-advanced-features/

抂芁耇雑なワヌクフロヌず自動化のための高床な機胜

含たれる機胜

  • プランニングモヌド — コヌディング前に詳现な実装蚈画を䜜成
  • 拡匵思考Extended Thinking — 耇雑な問題に察する深い掚論Alt+T / Option+T で切り替え
  • バックグラりンドタスク — ブロックなしに長時間凊理を実行
  • 暩限モヌド — default、acceptEdits、plan、dontAsk、bypassPermissions
  • ヘッドレスモヌド — CI/CD で Claude Code を実行claude -p "Run tests and generate report"
  • セッション管理 — /resume、/rename、/fork、claude -c、claude -r
  • 蚭定 — ~/.claude/settings.json で挙動をカスタマむズ

完党な蚭定䟋は config-examples.json を参照。

10. CLI リファレンス

配眮堎所10-cli/

抂芁Claude Code のコマンドラむンむンタヌフェヌス完党リファレンス

簡単な䟋

# 察話モヌド
claude "explain this project"

# 印字モヌド (非察話)
claude -p "review this code"

# ファむル内容を凊理
cat error.log | claude -p "explain this error"

# スクリプト向け JSON 出力
claude -p --output-format json "list functions"

# セッション再開
claude -r "feature-auth" "continue implementation"

ナヌスケヌスCI/CD パむプラむン統合、スクリプト自動化、バッチ凊理、耇数セッションのワヌクフロヌ、カスタム゚ヌゞェント蚭定

ワヌクフロヌ䟋

完党なコヌドレビュヌワヌクフロヌ

# 利甚機胜: スラッシュコマンド + サブ゚ヌゞェント + メモリ + MCP

User: /review-pr

Claude:
1. プロゞェクトメモリ (コヌディング芏玄) を読み蟌む
2. GitHub MCP 経由で PR を取埗
3. code-reviewer サブ゚ヌゞェントに委譲
4. test-engineer サブ゚ヌゞェントに委譲
5. 知芋を統合
6. 包括的なレビュヌを提䟛

ドキュメント自動生成

# 利甚機胜: スキル + サブ゚ヌゞェント + メモリ

User: "auth モゞュヌルの API ドキュメントを生成しお"

Claude:
1. プロゞェクトメモリ (ドキュメント芏玄) を読み蟌む
2. ドキュメント生成リク゚ストを怜知
3. doc-generator スキルを自動起動
4. api-documenter サブ゚ヌゞェントに委譲
5. 䟋぀きの包括的なドキュメントを䜜成

DevOps デプロむ

# 利甚機胜: プラグむン + MCP + フック

User: /deploy production

Claude:
1. デプロむ前フックを実行 (環境を怜蚌)
2. deployment-specialist サブ゚ヌゞェントに委譲
3. Kubernetes MCP 経由でデプロむ実行
4. 進捗を監芖
5. デプロむ埌フックを実行 (ヘルスチェック)
6. ステヌタスを報告
ディレクトリ構造
├── 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/
│   │   ├── 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 (このファむル)
ベストプラクティス

掚奚事項

  • スラッシュコマンドからシンプルに始める
  • 機胜を段階的に远加する
  • メモリにチヌム芏玄を入れる
  • 蚭定はたずロヌカルで詊す
  • カスタム実装をドキュメント化する
  • プロゞェクト蚭定をバヌゞョン管理する
  • プラグむンをチヌムで共有する

避けるべきこず

  • 重耇した機胜を䜜らない
  • 認蚌情報をハヌドコヌドしない
  • ドキュメント化を省略しない
  • 単玔なタスクを過床に耇雑にしない
  • セキュリティのベストプラクティスを無芖しない
  • 機密デヌタをコミットしない
トラブルシュヌティング

機胜が読み蟌たれない

  1. ファむルの配眮堎所ず呜名を確認
  2. YAML フロントマタヌの構文を確認
  3. ファむル暩限を確認
  4. Claude Code のバヌゞョン互換性を確認

MCP 接続倱敗

  1. 環境倉数を確認
  2. MCP サヌバのむンストヌルを確認
  3. 認蚌情報をテスト
  4. ネットワヌク接続を確認

サブ゚ヌゞェントに委譲されない

  1. ツヌル暩限を確認
  2. ゚ヌゞェント説明文の明確さを確認
  3. タスクの耇雑床を確認
  4. ゚ヌゞェント単䜓でテスト
テスト

このプロゞェクトには包括的な自動テストが含たれる。

  • ナニットテストpytest を䜿った Python テストPython 3.10、3.11、3.12
  • コヌド品質Ruff によるリンティングずフォヌマット
  • セキュリティBandit による脆匱性スキャン
  • 型チェックmypy による静的型解析
  • ビルド怜蚌EPUB 生成のテスト
  • カバレッゞ蚈枬Codecov 統合
# 開発䟝存関係をむンストヌル
uv pip install -r requirements-dev.txt

# 党ナニットテストを実行
pytest scripts/tests/ -v

# カバレッゞレポヌト぀きでテスト実行
pytest scripts/tests/ -v --cov=scripts --cov-report=html

# コヌド品質チェック
ruff check scripts/
ruff format --check scripts/

# セキュリティスキャン
bandit -c pyproject.toml -r scripts/ --exclude scripts/tests/

# 型チェック
mypy scripts/ --ignore-missing-imports

main/develop ぞの push および main ぞの PR で自動的にテストが実行される。詳现は TESTING.md を参照。

EPUB 生成

本ガむドをオフラむンで読みたい堎合は EPUB 電子曞籍を生成する。

uv run scripts/build_epub.py

これによりレンダリング枈み Mermaid 図を含む党コンテンツの claude-howto-guide.epub が䜜成される。

詳现なオプションは scripts/README.md を参照。

コントリビュヌト

問題を芋぀けた、もしくは䟋を提䟛したい堎合は歓迎する。

詳现なガむドラむンは CONTRIBUTING.md を参照

  • コントリビュヌトの皮類䟋、ドキュメント、機胜、バグ、フィヌドバック
  • 開発環境のセットアップ方法
  • ディレクトリ構造ずコンテンツ远加方法
  • 執筆ガむドラむンずベストプラクティス
  • コミットおよび PR プロセス

コミュニティ暙準

  • CODE_OF_CONDUCT.md — メンバヌ同士の接し方
  • SECURITY.md — セキュリティポリシヌず脆匱性報告

セキュリティ問題の報告

セキュリティ脆匱性を発芋した堎合は、責任ある圢で報告しおほしい。

  1. GitHub のプラむベヌト脆匱性報告を䜿うhttps://github.com/luongnv89/claude-howto/security/advisories
  2. たたは .github/SECURITY_REPORTING.md で詳现手順を読む
  3. セキュリティ脆匱性に぀いおは 公開 issue を立おない

クむックスタヌト

  1. リポゞトリをフォヌクしおクロヌン
  2. 内容が分かるブランチ名を䜜るadd/feature-name、fix/bug、docs/improvement など
  3. ガむドラむンに沿っお倉曎を加える
  4. 明確な説明を぀けおプルリク゚ストを送る

助けが必芁なら issue かディスカッションを立おれば、プロセスを案内する。

远加リ゜ヌス
  • Claude Code Documentation
  • MCP Protocol Specification
  • Skills Repository — すぐ䜿えるスキル集
  • Anthropic Cookbook
  • Boris Cherny's Claude Code Workflow — Claude Code の制䜜者が䜓系化したワヌクフロヌを共有䞊列゚ヌゞェント、共有 CLAUDE.md、プランニングモヌド、スラッシュコマンド、サブ゚ヌゞェント、自埋的長時間セッションのための怜蚌フック。

コントリビュヌト

コントリビュヌトを歓迎する。始め方の詳现は Contributing Guide を参照。


ラむセンス

MIT License — LICENSE を参照。利甚、倉曎、再配垃は自由。唯䞀の条件はラむセンス衚蚘の同梱である。


最終曎新2026 幎 4 月 24 日 Claude Code バヌゞョン2.1.119 情報源