wesammustafa/Claude-Code-Everything-You-Need-to-Know

Claude Code – 実践ガイド

何であるか – このリポジトリは、Anthropic社の公式コマンドラインインターフェースである Claude Code についてのステップバイステップガイドです。このツールを使えば、ターミナルから直接Claude（同社の大規模言語モデル）を実行できます。ガイドでは、CLIのインストール、認証、コードの読み取り・編集のためのClaudeへのプロンプト入力、およびカスタム Skills、Hooks、Sub-agents、Workflows、MCP サーバーによる拡張方法を紹介します。

対象読者 –

• 初心者：Claude Codeを一度も使ったことがない方は、「セットアップ → プロンプト工学 → 最初のスキル」の流れで約15分で学べます。
• 経験者：Skills、Hooks、およびModel-Context-Protocol（MCP）の深い部分に直接飛び込むことができます。
• チームリーダー / オートメーションエンジニア：マルチエージェントチームの構築、動的ワークフロー、大規模プロジェクト向けのBMADフレームワークについて学べます。

カバーする主要なコンセプト

機能	機能の概要	ファイルの配置場所
Skills（スラッシュコマンド）	再利用可能なMarkdownプロンプト。/skill-name でClaudeが呼び出せます。繰り返し作業に最適（例：PRの作成、テストの実行）。	.claude/commands/*.md
Hooks	セッション開始、ツール使用、サブエージェント終了などのイベント時に自動実行されるスクリプト。	.claude/settings.json（.claude/hooks/内のPythonスクリプトと接続）
Sub-agents	個別のコンテキストを持つ独立したClaudeセッション。大規模なサブタスクに役立ちます。	.claude/agents/*.md
Workflows	JavaScriptファイルで、複数のエージェントとツールを調整して複雑なタスクを解決します。	.claude/workflows/*.js
MCP（Model-Context-Protocol）サーバー	ClaudeがCLIから外部サービス（ブラウザ、データベース、APIなど）を呼び出せるようにします。プロジェクトごとに設定されます。	プロジェクト固有の設定ファイル（固定パスではない）

このリポジトリがどのように役立つか

• .claude/ ディレクトリ は、各拡張ポイント（7つのスラッシュスキル、5つのサブエージェント、動的ワークフロー、Python Hooksなど）を1つずつ含む、コピーして使える例プロジェクトです。
• 詳細なMarkdownガイド（docs/skills.md、docs/reference/effort-levels.md など）は、エフェクトレベル、プロンプト工学、AIエージェントフレームワーク構築のためのBMAD手法の背後にある思考モデルを解説しています。
• クイックリファレンスリンクやテーブルにより、適切なモデル（Sonnet 5、Opus 4.8、Fable 5など）と適切なエフェクトレベル（low → ultracode）を選択しやすくなります。

なぜ重要か – Claude Codeは、LLM駆動のコーディング支援を開発者のネイティブなシェルワークフローに統合し、モデルが以下を可能にします：

1. リポジトリ全体を読み取る（ファイルツリー、インポート、grep結果）→ 一部のスニペットだけではなく。
2. ファイルを直接編集し、テストスイートを自動実行することで、即時フィードバックを得られます。
3. スラッシュコマンド、Hooks、外部MCPサービスを通じて、既存のツールチェーンと連携できます。

具体的でコピー＆ペースト可能な例を提供することで、このガイドは、特定のエディタやIDEに縛られることなく、チームがAI駆動のオートメーションを採用する障壁を下げます。

---

クイックスタート

npm install -g @anthropic-ai/claude-code   # CLIのインストール
claude                                    # 認証（ブラウザが開く）
cd my-project && claude                    # Claudeセッションを開始
/explain what this codebase does           # サンプルプロンプト