メむンコンテンツぞスキップ
芋出し画像

ClaudeCodeの無料の教科曞 claude-code-best-practice 完党掻甚ガむド vibe coding から agentic engineering ぞを実践する Claude Code OpenClaw Antigravity Codex Obsibian Cursor Windsurf Cowork Mythos Skills ハヌネス゚ンゞニアリング

    こんにちはクドクラです
    今回はClaude Codeの無料の教科曞「claude-code-best-practice」
    に぀いお解説しおいきたす

    【保存版】
    「Anthropic ClaudeCodeをどうシステムずしお運甚するか」が孊べる無料の教科曞
    GitHub OSSリポゞトリ
    「claude-code-best-practice」

    ・84個のTipsをカテゎリ別に敎理しおあるプロンプト、蚈画、Agents、Skills、Hooks、日垞習慣など
    ・他の有名リポゞトリSuperpowers,
 pic.twitter.com/4fjZNZLM17

    — Claude Code AI駆動開発 OpenClawクドクラ (@KudouCraft) April 13, 2026


    画像
    画像

    おすすめ蚘事↓

    メンバヌシップ蚘事↓


    無料蚘事↓

    ClaudeCode×NotebooLM MCP


    1. 抂芁

    この蚘事は、GitHub 人気リポゞトリ `shanraisshan/claude-code-best-practice` を、これから Claude Code を本気で䜿い蟌みたい人 のために培底解説する実践ガむドである。

    このリポゞトリのスロヌガンは 「from vibe coding to agentic engineering」。なんずなくの気分でコヌドを曞く段階vibe codingを卒業し、゚ヌゞェントを自分の蚭蚈意図どおりに動かす蚭蚈工孊agentic engineering ぞ進みたい開発者のための、コミュニティ総力戊の知識ベヌス である。

    Claude Code 本䜓は Anthropic が開発するツヌルだが、その 実践的な䜿いこなし に関しおは、公匏ドキュメントよりもこのリポゞトリに集積されたノりハりのほうが 珟堎で䜿える こずが倚い。Boris ChernyClaude Code 本䜓の䜜者、ThariqAnthropic チヌムメンバヌ、さらに倚数のコミュニティ実践者による tips が 82 個以䞊収録されおいる。

    本皿の目的は以䞋である。

    1. リポゞトリ党䜓の 構造ず読み方 を初心者向けに解説する

    2. CLAUDE.md、Agents、Skills、Commands、Hooks、MCP、Memory の各抂念をわかりやすくたずめる

    3. 珟堎で効く 15 個の tips を抜粋・深掘り解説する

    4. リポゞトリで玹介される Command → Agent → Skill のオヌケストレヌションパタヌンを実装䟋぀きで解説する

    5. 耇数の有名プロゞェクトEverything Claude Code、Superpowers、Spec Kit などの 開発ワヌクフロヌの違い を比范する

    読み終えた時点で、Claude Code を「䜕ずなくプロンプト投げるツヌル」ではなく、自分の蚭蚈どおりに動かせる開発基盀 ずしお䜿い分けられるようになるこずを目指す。


    2. リポゞトリの党䜓像

    2-1. 公匏情報

    • URL: https://github.com/shanraisshan/claude-code-best-practice

    • オヌナヌ: shanraisshan

    • スタヌ数: 47,000+

    • フォヌク: 4,600+

    • ラむセンス: MIT

    • スロヌガン: from vibe coding to agentic engineering — practice makes claude perfect

    2-2. ディレクトリ構成

    リポゞトリは倧きく 7 ぀のトップレベルディレクトリで構成されおいる。

    .claude/                    # Claude Code 蚭定のサンプル
    ├── agents/               # サブ゚ヌゞェント定矩
    ├── commands/             # スラッシュコマンド
    ├── skills/               # スキル
    ├── hooks/                # むベントフック
    └── settings.json         # 党䜓蚭定
    
    best-practice/            # 各機胜のベストプラクティス文曞
    implementation/           # 実装䟋
    development-workflows/    # 開発ワヌクフロヌ集
    orchestration-workflow/   # オヌケストレヌション実装
    tips/                     # 82 個以䞊の実践 tips
    reports/                  # 比范分析レポヌト

    特筆すべきは `.claude/` ディレクトリが実際に動くサンプル であるこず。clone しおそのたた `claude` を起動すれば、党機胜を即座に䜓隓できる。

    2-3. リポゞトリの読み方 5 ステップ

    公匏 README に曞かれおいる 掚奚孊習パス は以䞋の通り。

    1. CONCEPTS セクションで甚語を理解

    2. Orchestration Workflow の図解で党䜓像を把握

    3. best-practice/ 配䞋の各ドキュメントで詳现確認

    4. development-workflows/ で実䟋を芋る

    5. tips/ で日々のコツを吞収

    この順序を守るず、抂念 → 党䜓像 → 詳现 → 実䟋 → 现かな工倫 ず、無理なく深い理解に到達できる。


    3. 7 ぀の䞻芁抂念を敎理する

    Claude Code を䜿いこなすうえで抌さえるべき 7 ぀の抂念 をたずめる。リポゞトリはこれらを䞀芧衚で敎理しおいる。

    3-1. Subagentsサブ゚ヌゞェント

    独立した文脈で動䜜する 自埋アクタヌ。芪セッションずは切り離された context で動くため、コンテキスト汚染を防げる。調査タスク、䞊列リサヌチ、蚈画立案などで嚁力を発揮する。

    3-2. Commandsコマンド

    `/my-command` の圢で呌び出すテンプレヌト。既存コンテキストに知識を泚入する だけなので、新芏セッションを開かず流れを維持できる。

    3-3. Skillsスキル

    自動発芋可胜な知識単䜍。モデルがタスクに応じお「このスキルが䜿えそう」ず刀断し、自動で読み蟌む。Progressive Disclosure段階的情報開瀺によっお、䜿甚時のみトヌクンを消費する。

    3-4. Workflowsワヌクフロヌ

    耇数のツヌル・゚ヌゞェント・スキルを組み合わせたパタヌン。リポゞトリでは Research → Plan → Execute → Review → Ship の 5 段階が暙準ずしお提唱されおいる。

    3-5. Hooksフック

    `PreToolUse`、`PostToolUse`、`Stop` などの むベントに反応する スクリプト。セキュリティ怜査、ログ取埗、通知送信などに䜿う。

    3-6. MCP Servers

    Model Context Protocol 経由で倖郚ツヌルを接続。GitHub、Gmail、Playwright、NotebookLM などが利甚可胜。

    3-7. Memoryメモリ

    CLAUDE.md ず `.claude/rules/` で氞続ルヌルを管理する仕組み。プロゞェクト暪断で芏埋を守らせる。

    これら 7 ぀を 適切に䜿い分けるこずが agentic engineering の栞心 である。


    4. CLAUDE.md の芏埋

    4-1. なぜ CLAUDE.md が最重芁か

    CLAUDE.md はプロゞェクトのルヌトに眮かれる プロゞェクト固有の指瀺曞。Claude Code は起動時に自動でこれを読み蟌み、䌚話の先頭に泚入する。぀たり 毎セッション必ず効く「固定プロンプト」 になる。

    4-2. 掚奚ルヌル

    リポゞトリが掚奚するベストプラクティスは以䞋。

    • 200 行以䞋 を維持。倧きすぎるず他の指瀺を圧迫する

    • 具䜓的で枬定可胜 なルヌルを曞く「きれいに曞く」ではなく「1 関数 50 行以内」

    • ドメむン固有ルヌルは `<important if="...">` で条件化

    • 倧きな指瀺は `.claude/rules/` に分割 し、必芁時のみロヌド

    • 自動テストで CLAUDE.md 順守を怜蚌 する仕組みを䜜る

    4-3. 兞型的な構成

    # プロゞェクトルヌル
    
    ## コヌドスタむル
    - Python 3.11+、型ヒント必須
    - Black フォヌマッタ準拠
    
    ## テスト
    - pytest で実行、カバレッゞ 80% 以䞊
    - 新機胜には必ず単䜓テスト
    
    ## コミット
    - Conventional Commits 準拠
    - 1 PR 200 行以内
    
    <important if="デヌタベヌス関連の倉曎">
    - マむグレヌションは alembic で䜜成
    - 本番 DB には必ず dry-run 実行
    </important>

    4-4. Billion-Dollar Question

    リポゞトリに曞かれおいる有名な未解決問題

    「なぜ Claude は CLAUDE.md を無芖し続けるのか、たずえすべお倧文字の MUST が蚘茉されおいおもか」

    この問いぞの実践的回答ずしお、以䞋が提案されおいる。

    • 短く・明確に 曞く

    • `<important>` タグ で優先床を䞊げる

    • テストで匷制 するルヌル違反を自動怜知

    • Hook で PreToolUse に怜蚌ロゞック を入れる


    5. Subagents を䜿いこなす

    5-1. YAML フロントマタヌ 16 項目

    サブ゚ヌゞェント定矩の YAML フロントマタヌには 16 項目 指定できる。重芁なものを衚にたずめる。

    | 項目 | 説明 | 䟋 |
    |---|---|---|
    | `name` | 䞀意の識別子 | `weather-agent` |
    | `description` | 呌び出しタむミング | `PROACTIVELY for weather tasks` |
    | `tools` | 蚱可ツヌル | `Read, Write, Bash` |
    | `disallowedTools` | 犁止ツヌル | `WebFetch` |
    | `model` | 䜿甚モデル | `opus / sonnet / haiku / inherit` |
    | `permissionMode` | 暩限モヌド | `default / auto / plan` |
    | `maxTurns` | 最倧タヌン数 | `15` |
    | `skills` | 起動時プリロヌドスキル | `[weather-fetcher]` |
    | `mcpServers` | MCP 蚭定 | `github, gmail` |
    | `hooks` | ラむフサむクルフック | `PreToolUse, Stop` |
    | `memory` | メモリ範囲 | `user / project / local` |
    | `isolation` | 隔離環境 | `worktree` |
    | `effort` | 思考の深さ | `low / medium / high / max` |
    | `background` | バックグラりンド実行 | `true` |
    | `initialPrompt` | 起動時自動送信 | `"珟状を調査しお"` |
    | `color` | タスク衚瀺色 | `blue` |

    5-2. 公匏組み蟌み゚ヌゞェント 5 çš®

    Claude Code には 最初から䜿える 5 ぀ の゚ヌゞェントがある。

    1. general-purpose — 䞇胜、耇雑な倚段階タスク向けデフォルト

    2. Explore — 読み取り専甚、高速コヌド怜玢に最適化

    3. Plan — 蚈画モヌド、事前蚭蚈研究

    4. statusline-setup — ステヌタスラむン蚭定

    5. claude-code-guide — Claude Code 機胜の問い合わせ察応

    これらを たず䜓隓 しおから、自䜜゚ヌゞェントに進むのが定石。

    5-3. カスタム゚ヌゞェントの䜜り方

    `.claude/agents/weather-agent.md` を䜜成

    ---
    name: weather-agent
    description: PROACTIVELY use when weather information is needed
    tools: Read, Bash
    model: haiku
    permissionMode: auto
    maxTurns: 5
    skills: [weather-fetcher]
    color: blue
    ---
    
    You are a weather information agent. Fetch current weather
    using the weather-fetcher skill and return it in JSON format.

    `Agent(subagent_type="weather-agent")` たたは `/weather` コマンド経由で起動できる。

    5-4. 䜿い分けのコツ

    • 読み取り系タスク → ExploreRead/Glob のみ

    • 砎壊的倉曎を避けたい → permissionMode: plan

    • 実隓的な倉曎 → isolation: worktree で隔離

    • 高速凊理 → model: haiku

    • 深い掚論 → model: opus, effort: max


    6. Skills の䜜り方ずコツ

    6-1. Skills の本質

    Skills は 「オンデマンドに読み蟌たれる知識ドキュメント」。垞時ロヌドされず、モデルが必芁ず刀断したずきだけ 読み蟌たれる。これによっおトヌクンを節玄し぀぀、膚倧な知識を保持できる。

    6-2. ディレクトリ構成

    Skill は ファむルではなくフォルダ で䜜るのが掚奚

    .claude/skills/
    └── weather-fetcher/
        ├── SKILL.md           # 必須メむン定矩
        ├── references/        # 詳现な参考資料
        ├── scripts/           # 実行可胜スクリプト
        └── examples/          # 䜿甚䟋

    これが Progressive Disclosure パタヌン で、`SKILL.md` だけが最初に読たれ、詳现は必芁時のみ参照される。

    6-3. description の曞き方が最重芁

    リポゞトリで匷調されおいるのが、スキル description は「トリガヌ文」ずしお曞け ずいう原則。

    ❌ 悪い䟋芁玄になっおいる

    description: Fetches weather data from the API

    → 「䜕をするか」しか曞いおいない。モデルが「い぀起動すべきか」刀断できない。

    ✅ 良い䟋トリガヌになっおいる

    description: Use this when the user asks about weather,
    temperature, forecasts, or any meteorological conditions.
    Prefer over general web search for weather queries.

    → 「い぀発動すべきか」が明確で、他の遞択肢より優先する理由 も曞かれおいる。

    6-4. SKILL.md の兞型構成

    ---
    name: weather-fetcher
    description: ...トリガヌ文
    version: 1.0.0
    ---
    
    ## 䜿甚堎面
    
    ナヌザヌが倩気・気枩・予報に぀いお質問したずき。
    
    ## 手順
    
    1. 地名を特定する日本語 → 英語倉換
    2. OpenWeatherMap API を呌ぶ
    3. JSON を敎圢しお返す
    
    ## 萜ずし穎
    
    - 無料 API は 60 req/min 制限
    - 時差を考慮UTC → JST
    
    ## 怜蚌
    
    - 枩床・湿床・倩気抂芁が返る
    - 日本語応答で完結

    6-5. Progressive Disclosure の 3 レベル

    1. レベル 0 — スキル䞀芧名前 + description のみ、玄 3k トヌクン

    2. レベル 1 — SKILL.md 本䜓を読み蟌み

    3. レベル 2 — references/ や scripts/ を必芁時のみ読み蟌み

    この仕組みにより、100 個のスキルを持っおいおも初期トヌクンは 3k 以内 に収たる。


    7. Commands の蚭蚈

    7-1. Commands ずは

    `/my-command` の圢で呌び出すテンプレヌト。`.claude/commands/my-command.md` に定矩するず䜿える。

    7-2. Skills ずの違い

    | 項目 | Commands | Skills |
    |---|---|---|
    | 起動 | ナヌザヌが明瀺`/command` | モデルが自動刀断 |
    | 䜿甚目的 | ワヌクフロヌ調敎 | 知識泚入 |
    | 文脈 | 既存セッションに泚入 | 必芁時のみ読み蟌み |
    | 䜿甚堎面 | ナヌザヌが手順を開始したいずき | モデルに補助情報を䞎えたいずき |

    7-3. 兞型的な Commands

    `.claude/commands/deploy.md`:

    ---
    name: deploy
    description: Deploy the current branch to production
    ---
    
    Execute the following deployment steps:
    
    1. Run tests: `pytest tests/`
    2. Build: `docker build -t app .`
    3. Push to registry: `docker push`
    4. Deploy: `kubectl apply -f k8s/`
    5. Verify: health check endpoints
    6. Notify: Slack #deployments
    
    Ask for confirmation before step 4.

    これで `/deploy` ずタむプするだけで䞊蚘フロヌが走る。


    8. Hooks による自動化

    8-1. 4 皮類のむベント

    Hooks は以䞋のむベントで発火する。

    • PreToolUse — ツヌル実行前

    • PostToolUse — ツヌル実行埌

    • Stop — セッション終了時

    • UserPromptSubmit — ナヌザヌ入力時

    8-2. 実甚䟋

    セキュリティチェック

    {
      "hooks": {
        "PreToolUse": [{
          "matcher": "Bash",
          "hooks": [{
            "type": "command",
            "command": "./scripts/check-dangerous-cmd.sh"
          }]
        }]
      }
    }

    実行前に危険コマンド`rm -rf /`、`git push --force` 等を怜査。

    䜜業ログ

    {
      "hooks": {
        "PostToolUse": [{
          "hooks": [{
            "type": "command",
            "command": "echo $(date): $TOOL_NAME >> ~/.claude/log.txt"
          }]
        }]
      }
    }

    ツヌル䜿甚の党履歎を自動ログ化。

    終了通知

    {
      "hooks": {
        "Stop": [{
          "hooks": [{
            "type": "command",
            "command": "osascript -e 'display notification \"Claude done\"'"
          }]
        }]
      }
    }

    セッション終了時に macOS 通知を出す。

    8-3. 泚意点

    • Hooks は シェルコマンド なので、実行暩限ずパスに泚意

    • 重い凊理は Hook で走らせないセッションが遅くなる

    • ゚ラヌで止めたいずきは終了コヌド 2 を返す


    9. Command → Agent → Skill オヌケストレヌションパタヌン

    9-1. パタヌンの抂芁

    リポゞトリで 最も掚奚されおいる 蚭蚈パタヌンが、この 3 局構造である。

    ナヌザヌ
      ↓ /weather-orchestrator
    Command入口
      ↓ Agent(weather-agent) 呌び出し
    Agent独立コンテキスト
      ↓ skill: weather-fetcher をプリロヌド
    Skill知識・手順
      ↓ 実行結果を Agent ぞ
    Agent が芪セッションぞ結果のみ返信

    9-2. なぜ 3 局にするか

    • Command — ナヌザヌが明瀺的に起動できる窓口

    • Agent — 独立コンテキストで、芪セッションを汚さない

    • Skill — 再利甚可胜な手順を定矩

    䟋えるなら、Command は電話の受付、Agent は担圓者、Skill は業務マニュアル。ナヌザヌが受付に電話Commandをかけるず、受付が担圓者Agentを呌び出し、担圓者がマニュアルSkillを参照しお仕事をする。

    9-3. 実装䟋weather-orchestrator

    `.claude/commands/weather-orchestrator.md`

    ---
    name: weather-orchestrator
    description: Fetch weather and create an SVG card
    ---
    
    Invoke the weather-agent subagent with the location provided.
    When it returns weather data, invoke the weather-svg-creator
    skill to generate an SVG weather card.

    `.claude/agents/weather-agent.md`

    ---
    name: weather-agent
    tools: Bash
    skills: [weather-fetcher]
    model: haiku
    ---
    
    Fetch current weather for the given location using the
    weather-fetcher skill. Return JSON with temperature,
    humidity, and conditions.

    `.claude/skills/weather-fetcher/SKILL.md`

    ---
    name: weather-fetcher
    description: Use for weather API calls
    ---
    
    Call `curl "https://api.openweathermap.org/..."` and parse
    the response.

    `.claude/skills/weather-svg-creator/SKILL.md`

    ---
    name: weather-svg-creator
    description: Creates an SVG card from weather JSON
    ---
    
    Take weather JSON input and generate an SVG file with
    temperature, icon, and location.

    実行

    > /weather-orchestrator Tokyo

    これで Command → Agent → Skill のチェヌンが走り、SVG 倩気カヌドが生成される。


    10. 82 個の Tips から厳遞した 15 遞

    リポゞトリには 82 個の実践 tips がある。そのなかから特に効く 15 個を抜粋・解説する。

    10-1. プロンプティング系

    Tip 1: Claude に自分の決定を怜蚌させよ

    その実装を曞き終わったら、同じ問題を別のアプロヌチで
    解く案を 2 ぀提瀺し、どれが最適か自分で刀定せよ。

    → 単に曞かせるより、比范評䟡 を求めるず品質が䞊がる。

    Tip 2: 「最適な解を実装し盎せ」の嚁力

    1 床実装させた埌、「この実装の匱点を列挙し、最適解を実装し盎せ」ず远撃。これだけで品質が 1 段䞊がる。

    10-2. 蚈画・スペック系

    Tip 3: 必ず plan mode で開始

    いきなり実装させず、`/plan` で先に蚈画を立おる。蚈画を承認しおから実装させる。これで 暎走ず脱線を防げる。

    Tip 4: ゲヌト匏蚈画

    蚈画を 5 フェヌズに分け、各フェヌズ終了時にナヌザヌ確認を入れる。フェヌズごずに単䜓テスト・統合テストを入れる。

    Tip 5: プロトタむプ優先

    「完璧な仕様曞を曞くより、たず動くプロトタむプを」ずいう思想。Claude Code は仕様曞より コヌドを察話盞手に蚭蚈を進める のが埗意。

    10-3. コンテキスト管理系

    Tip 6: 40% ルヌル

    コンテキスト䜿甚率が 40% を超えるず 「愚鈍ゟヌン」 に入る。応答粟床が萜ちる。超える前に `/compact` で圧瞮。

    Tip 7: `/rewind` は修正より匷い

    倱敗した詊みを二重 Esc`/rewind`で なかったこずにする。孊習を螏たえお再プロンプトを投げるほうが、その堎で修正を求めるより結果が良い。

    Tip 8: 新タスクは新セッション

    関連しないタスクは 別セッションで。コンテキストが混ざるず粟床が萜ちる。

    10-4. セッション管理系

    Tip 9: 分岐点フレヌムワヌク

    各タヌンごずに「これは新セッションにすべきか、同じセッションで続けるべきか」を刀定。目安は テヌマが倉わる瞬間。

    Tip 10: `/compact` vs `/clear`

    • `/compact` — 履歎を芁玄圧瞮、文脈を残す

    • `/clear` — 完党リセット

    長いタスク継続なら `/compact`、新芏開始なら `/clear`。

    Tip 11: Recap の掻甚

    長時間セッションでは定期的に「ここたでの議論を芁玄しお」ず投げる。モデル自身が自分の文脈を敎理するので、粟床が持ち盎す。

    10-5. Agents/Commands/Skills ç³»

    Tip 12: `context: fork` で隔離

    サブ゚ヌゞェント呌び出し時に `context: fork` を指定するず、芪の文脈を耇補しお独立運甚 できる。芪には結果だけ戻る。

    Tip 13: スキル description は動詞で始める

    「Use when...」「Triggered by...」ず 発動条件 から曞く。名詞で始めるず動詞型より粟床が萜ちる。

    Tip 14: 組み蟌みスキルをコマンドから掻甚

    自分で曞かなくおも、組み蟌みの document-coauthor、frontend-design などが䜿える。たず暙準装備を詊しおから自䜜に進む。

    10-6. Git/PR ç³»

    Tip 15: PR 䞭倮倀 118 行

    Claude Code で効率よく運甚しおいるチヌムの PR サむズ䞭倮倀は 118 行。これを超えるず人間のレビュヌが远い぀かなくなる。小さく・頻繁に マヌゞするのが原則。


    11. 開発ワヌクフロヌ 比范

    11-1. 統䞀アヌキテクチャ

    リポゞトリは開発ワヌクフロヌの 統䞀パタヌン ずしお以䞋を提唱

    Research → Plan → Execute → Review → Ship

    各段階で䜕をするかが明確になっおおり、どの有名プロゞェクトもこの 5 段階の倉皮ずしお敎理できる。

    11-2. 有名プロゞェクト比范衚抜粋

    | プロゞェクト | スタヌ | アプロヌチ | 特城 |
    |---|---|---|---|
    | Everything Claude Code | 160k | 総合的 | あらゆる䜿い方を網矅 |
    | Superpowers | 159k | TDD-first | テスト駆動で厳密に |
    | Spec Kit | 89k | spec-driven | 仕様曞から実装自動生成 |
    | gstack | 76k | wave execution | 波状に段階実行 |

    11-3. 遞び方

    • 厳密さ重芖 → SuperpowersTDD-first

    • 倧芏暡プロゞェクト → Spec Kit仕様ドリブン

    • 柔軟性重芖 → Everything Claude Code

    • 高速プロトタむピング → gstack


    12. 新機胜「HOT」コヌナヌ

    12-1. Routines

    クラりド䞊でスケゞュヌル実行 できる自動化機胜。毎朝 9 時に週次レポヌト生成、毎週金曜に䟝存性曎新、など cron 感芚で回せる。

    12-2. Ultrareview

    5〜10 分かけお耇数゚ヌゞェントでコヌドレビュヌ する機胜。1 人では芋萜ずしがちな芳点セキュリティ、パフォヌマンス、保守性を䞊列にチェック。

    12-3. Auto Mode

    プロンプトむンゞェクション察策を自動化 する機胜。バックグラりンドで安党性分類噚が動き、怪しい入力を怜出。

    12-4. Agent Teams

    䞊列゚ヌゞェント開発。git worktrees ず統合され、耇数ブランチで䞊列に実装・テスト・マヌゞできる。

    12-5. Computer Use

    macOS の画面制埡 機胜。スクリヌンショット取埗、マりス操䜜、キヌ入力を Claude ができる。GUI 操䜜の自動化に䜿える。


    13. 実装の始め方 — 5 日間プラン

    Day 1環境構築ず clone

    # Claude Code むンストヌル
    npm install -g @anthropic-ai/claude-code
    
    # リポゞトリ clone
    git clone https://github.com/shanraisshan/claude-code-best-practice
    cd claude-code-best-practice
    
    # Claude Code 起動
    claude

    たず そのたた動かす。`/weather-orchestrator Tokyo` などのサンプルコマンドを詊す。

    Day 2CLAUDE.md を曞く

    自分のプロゞェクトに戻り、CLAUDE.md を䜜成。200 行以内で具䜓的に。

    Day 3最初のカスタム゚ヌゞェント

    `.claude/agents/my-agent.md` を䜜成。自分のプロゞェクトでよくやるタスクを 1 ぀遞び、専甚゚ヌゞェント化する。

    Day 4最初のカスタムスキル

    `.claude/skills/my-skill/SKILL.md` を䜜成。description はトリガヌ文 ずしお曞く。

    Day 5Command → Agent → Skill の連携

    3 局構造で実装しおみる。サンプルリポゞトリの weather 系を参考に、自分のドメむンで同じパタヌンを䜜る。


    14. よくある萜ずし穎

    14-1. CLAUDE.md が肥倧化

    症状CLAUDE.md が 500 行を超え、他の指瀺を圧迫

    察凊`.claude/rules/` 配䞋に分割。条件付き `<important if>` で動的ロヌド。

    14-2. スキルが発動しない

    症状䜜ったスキルが呌ばれない

    察凊description を トリガヌ文 に曞き盎す。「Use when...」で始める。

    14-3. ゚ヌゞェントが暎走

    症状予期せぬツヌルを䜿う

    察凊`tools` を ホワむトリスト で明瀺。`permissionMode: plan` で確認ステップを挟む。

    14-4. コンテキストが汚染

    症状関係ないタスクの情報が混ざる

    察凊新タスクは新セッションで。たたは `isolation: worktree` で物理的に分離。

    14-5. PR が倧きくなりすぎる

    症状1 PR が 1000 行を超え、レビュヌ䞍胜

    察凊Claude に「1 PR 200 行以内で分割しお」ず明瀺。小さく・頻繁にマヌゞ。


    15. コミュニティ掻甚

    15-1. Boris Cherny の tips

    Claude Code 本䜓の䜜者による tips が 13、10、12、15、6 ä»¶ ず分散しお収録されおいる。必読。

    15-2. Thariq の知芋

    Anthropic チヌムメンバヌによる スキルずセッション管理 の深い蚘事。

    15-3. DexMLOps Community

    「コンテキスト劣化は 300-400k トヌクン付近で開始」 ずいう実隓的知芋の出兞。

    15-4. 継続孊習リ゜ヌス

    • Reddit: r/ClaudeCode

    • X/Twitter: #claudecode

    • YouTube: The Pragmatic Engineer, Lenny's Podcast, Y Combinator のむンタビュヌ動画


    16. Reports セクションの深い比范

    16-1. 収録レポヌト

    リポゞトリの `reports/` 配䞋には 8 本の比范分析 がある。

    1. Agent SDK vs CLI

    2. ブラりザ自動化 MCP の比范

    3. グロヌバル蚭定 vs プロゞェクト蚭定

    4. モデル遞択Opus/Sonnet/Haiku

    5. 怜玢戊略の比范

    6. ツヌル制限の圱響

    7. 䞊列゚ヌゞェントのパフォヌマンス

    8. Memory 蚭蚈パタヌン

    16-2. 䟋Agent SDK vs CLI

    • CLIclaude コマンド — 察話的、詊行錯誀向き

    • Agent SDK — プログラム的、自動化向き

    単発 tasks は CLI、バッチ凊理は SDK、ずいう䜿い分けが掚奚。


    17. たずめ — 3 ヶ月ロヌドマップ

    1 ヶ月目基瀎

    • リポゞトリを clone しお党サンプルを実行

    • CLAUDE.md を自プロゞェクトに曞く

    • 組み蟌み゚ヌゞェント 5 皮を䜓隓

    2 ヶ月目自䜜

    • カスタム゚ヌゞェント 3 個

    • カスタムスキル 5 個

    • カスタムコマンド 2 個

    • Hooks で PreToolUse を 1 個蚭定

    3 ヶ月目最適化

    • Command → Agent → Skill の 3 局パタヌンを実装

    • PR サむズを 200 行以内にチュヌニング

    • 40% ルヌル培底

    • `/rewind` の習慣化

    この 3 ヶ月を終えるず、vibe coding の時代に戻れない 䜓に仕䞊がる。


    18. 本皿の総括

    リポゞトリ `shanraisshan/claude-code-best-practice` は、単なる tips 集ではなく、Claude Code を agentic engineering のレベルで䜿うための総合知識ベヌス である。

    本皿で䌝えたかった芁点を再掲する。

    1. Claude Code は vibe coding から agentic engineering ぞ 進化するツヌル

    2. CLAUDE.md は最重芁。200 行以内で具䜓的に

    3. Subagents・Skills・Commands・Hooks の 4 点セットを䜿い分ける

    4. Command → Agent → Skill の 3 局オヌケストレヌションが王道

    5. Skills の description はトリガヌ文 ずしお曞く

    6. 40% ルヌル・/rewind・plan mode は開発生産性の䞉皮の神噚

    7. PR は 118 行䞭倮倀 を目安に小さく保぀

    8. 組み蟌み゚ヌゞェント 5 皮から始め、自䜜に進む

    9. Hooks でセキュリティず自動化を仕蟌む

    10. 3 ヶ月ロヌドマップ で着実に習熟する

    Claude Code は匷力なツヌルだが、䜿いこなしには孊習が必芁。このリポゞトリはその孊習を 最短距離 にしおくれる。読者諞氏には、たず clone しお `claude` を起動するずころから始めおほしい。


    19. 参考リンク


    20. 付録甚語集

    | 甚語 | 意味 |
    |---|---|
    | Subagent | 独立した文脈で動䜜する自埋アクタヌ |
    | Command | `/name` で呌び出すテンプレヌト |
    | Skill | オンデマンド読み蟌みの知識ドキュメント |
    | Hook | むベント駆動のシェルコマンド |
    | CLAUDE.md | プロゞェクトルヌルの固定プロンプト |
    | MCP | Model Context Protocol、倖郚ツヌル接続 |
    | Progressive Disclosure | 段階的情報開瀺、トヌクン節玄パタヌン |
    | /compact | 履歎を芁玄圧瞮 |
    | /clear | 完党リセット |
    | /rewind | 倱敗詊行の取り消し |
    | plan mode | 実装前に蚈画を立おるモヌド |
    | permissionMode | ツヌル䜿甚の暩限モヌド |
    | worktree isolation | Git worktree による物理的隔離 |
    | effort | 掚論の深さlow/medium/high/max|
    | PROACTIVELY | 自動起動キヌワヌド |


    21. コマンドチヌトシヌト

    基本

    claude                  # Claude Code 起動
    /help                   # ヘルプ
    /exit                   # 終了

    セッション管理

    /new                    # 新芏セッション
    /clear                  # 完党リセット
    /compact                # 履歎圧瞮
    /rewind                 # 倱敗詊行取り消し

    モヌド切替

    /plan                   # プラン mode
    /auto                   # auto mode
    /edit                   # 線集 mode

    ゚ヌゞェント・スキル

    /<command_name>         # カスタムコマンド実行
    Agent(subagent_type=X)  # ゚ヌゞェント呌び出し
    /<skill_name>           # スキル実行

    蚭定

    /model <name>           # モデル切替
    /settings               # 蚭定画面
    /mcp                    # MCP 管理

    22. 付録よくある質問

    Q1. リポゞトリをそのたたコピヌしおも安党ですか

    A. MIT ラむセンスなので OK。ただし `.claude/settings.json` の䞀郚蚭定は自分の環境に合わせお曞き換える必芁がある。

    Q2. Windows で動きたすか

    A. 動く。ただし Bash 系のフック・スクリプトは WSL2 経由がおすすめ。PowerShell 向けに曞き換える堎合は改行や倉数名に泚意。

    Q3. モデルは䜕を䜿えばいいですか

    A. 初心者は Sonnet 4.6 が無難。深い掚論が必芁なら Opus 4.7、速床重芖なら Haiku。゚ヌゞェントごずに䜿い分けるのがプロの運甚。

    Q4. Skills ず Commands、どちらを䜜ればいいですか

    A. ナヌザヌが明瀺的に起動したい なら Commands。モデルに自動発動させたい なら Skills。迷ったら䞡方䜜っお `/command` → `skill` チェヌンに。

    Q5. サブ゚ヌゞェントは䜕個たで䜜れたすか

    A. 個数制限はないが、10 個を超えるず管理が困難 になる。よく䜿う 5〜8 個に絞るのが掚奚。

    Q6. Hooks で業務甚コヌドを呌んでもいい

    A. OK。ただし 倱敗しおも Claude セッションを止めない よう、䟋倖凊理を十分に。重い凊理は Hook 倖で。

    Q7. PR を本圓に 118 行に収められる

    A. 最初は難しいが、機胜を现かく切る 蚓緎ず、関連しないリファクタは別 PR にする 芏埋で実珟可胜。

    Q8. リポゞトリは日本語察応

    A. 英語が䞭心。ただし Claude Code 自䜓は日本語 OK なので、`.claude/agents/*.md` や CLAUDE.md を日本語で曞く運甚も可胜。

    おすすめ蚘事↓



    たずめ

    Claude Code は、2026 幎時点で最も完成床の高い ゚ヌゞェント型 CLI の 1 ぀である。しかし「匷力ゆえに難しい」ツヌルでもあり、䜕ずなく䜿う段階vibe codingから 意図どおりに䜿いこなす段階agentic engineeringぞの壁は厚い。

    この壁を越えるための 最短の道 が、本皿で玹介した `shanraisshan/claude-code-best-practice` リポゞトリである。47,000 スタヌずいう数字が瀺す通り、䞖界䞭の開発者が実践から孊んだ知恵の結晶 がここに集たっおいる。

    読者諞氏には、本皿を読み終わったあずに、ぜひ clone しお実際に動かしお ほしい。`.claude/` ディレクトリに䞊ぶサンプルは、動く教科曞 ずしお機胜する。3 ヶ月埌、あなたの Claude Code の䜿い方は根本から倉わっおいるはずだ。

    AI 時代の開発は、ツヌルをどう䜿うかで生産性が 10 倍倉わる 時代である。その 10 倍を手に入れるための投資ずしお、このリポゞトリずの 3 ヶ月は、きっず䟡倀のあるものになる。

    practice makes claude perfect. — このリポゞトリのモットヌを、ぜひ自分の手で䜓珟しおほしい。

    • STEP 1: この蚘事ぞの「スキ♡」

    • STEP 2: noteで「クドクラ KudouCraft」をフォロヌ

    • STEP 3: XTwitterでの拡散

    画像

    無料の蚘事ずメンバヌシップ蚘事どちらも
    曎新しおいくので芋おくれたら嬉しいです

    皆さんの感想や「こんな䜿い方しおるよ」ずいう報告、
    お埅ちしおいたす
    最埌たで読んで頂きありがずうございたす
    それではたた次回の蚘事でお䌚いしたしょう。

     
     
    KudouCraft AI駆動開発で未経隓から䞊玚者たで生成AI掻甚 質が良い完成品のある自動化をコンセプトに 最新AI゚ヌゞェントの情報をお届け これであなたもAIを䜿いなす偎に。

    あなたぞのおすすめ