Claude Codeを120%使いこなす!87個のTips&ワークフロー集大成 — claude-code-best-practice

shanraisshan/claude-code-best-practiceHTML44.6k

claude-code-best-practiceは、AnthropicのAIコーディングツール「Claude Code」を最大限に活用するためのベストプラクティス集です。Claude Code開発者のBoris Cherny氏本人のTipsを含む69個の実践的なアドバイス、サブエージェント(独立した作業を行うAI助手)・コマンド・スキルといった機能の使い方、そして「調査→計画→実行→レビュー→リリース」というワークフロー設計パターンを体系的にまとめています。「なんとなくAIに頼む」段階(バイブコーディング)から「AIを戦略的に指揮する」段階(エージェンティックエンジニアリング)へステップアップしたい開発者に向けた、実戦的なナレッジベースです。

🔥 なぜ話題?

Claude Codeが急速に機能拡張され(Agent SDK、スキル、Routines、Auto Mode、ブラウザ操作など)、単なるコード補完を超えた「AIエージェント開発環境」に進化する中で、その膨大な機能を体系的に整理し実践的に使いこなすガイドへの需要が爆発的に高まっています。開発者Boris Cherny氏本人が推薦するTipsが含まれている点も信頼性と話題性を高めています。

💡 こう使える!

たとえばWebアプリの新機能を開発する際、まずClaude Codeの「プランモード」で設計を立て、別のサブエージェントにその設計をシニアエンジニアとしてレビューさせ、OKが出たらコマンド一つで実装を開始し、フック機能で自動フォーマットをかけてPRを作成する——という一連の流れを、このリポジトリのベストプラクティスに従って構築できます。

ユースケース: Claude Codeを使ったソフトウェア開発で、AIエージェントの設定やワークフローを最適化し、開発効率を大幅に上げたい人向けのガイドブック。

  • Claude Code開発者Boris Cherny氏のTipsを含む69個の実践的アドバイスを網羅
  • サブエージェント・コマンド・スキルの使い分けと「Command→Agent→Skill」オーケストレーションパターンを図解付きで解説
  • Agent Teams、Auto Mode、Voice Dictation、Ralph Wiggumループなど最新機能のベストプラクティスも収録
  • Everything Claude Code、Superpowersなど主要ワークフローフレームワーク10種の比較表を掲載
  • CLAUDE.mdの書き方からGit戦略まで、開発プロセス全体をカバー
GitHubで見る →

from vibe coding to agentic engineering - practice makes claude perfect

技術情報

言語

HTML

ライセンス

MIT

最終更新

2026-04-15

スター数

44,599

フォーク数

4,269

Issue数

14

トピック

agentic-engineeringanthropicbest-practicesborisboris-chernyclaudeclaude-aiclaude-codeclaude-code-agentsclaude-code-best-practicesclaude-code-commandsclaude-code-skillsvibe-coding

技術詳細

アーキテクチャ:オーケストレーションパターン

claude-code-best-practiceが提唱する中核パターンは Command → Agent → Skill のオーケストレーション構造です:

  • Commands.claude/commands/): ユーザーが / で呼び出すプロンプトテンプレート。ワークフローの起点
  • Subagents.claude/agents/): 独立したコンテキストで動く自律的なAIアクター。専用のツール・権限・モデル・メモリを持つ
  • Skills.claude/skills/): 設定可能・プリロード可能・自動検出可能なナレッジ。プログレッシブディスクロージャー(必要な情報を段階的に提供)に対応

主要な機能カテゴリ

コア機能

  • Memory: CLAUDE.md.claude/rules/による永続的なコンテキスト管理
  • Hooks: 特定イベントで実行されるユーザー定義ハンドラ(スクリプト、HTTP、プロンプト、エージェント)
  • MCP Servers: 外部ツール・データベース・APIとの接続プロトコル
  • Plugins: スキル・サブエージェント・フック・MCPサーバーをバンドルした配布可能パッケージ
  • Checkpointing: git ベースの自動追跡と Esc Esc でのリワインド

注目の新機能(Hot)

  • Routines: Anthropicクラウド上でのスケジュール実行(マシンオフでも稼働)
  • Agent Teams: 複数エージェントが同一コードベースで並行作業
  • Auto Mode: バックグラウンド安全分類器による権限プロンプト自動化(84%削減実績)
  • Agent SDK: Python/TypeScript SDKでClaude Codeをライブラリとして利用
  • Chrome: ブラウザ自動操作(テスト、フォーム操作、コンソールログ確認)
  • Voice Dictation: 20言語対応のプッシュトゥトーク音声入力
  • Ultraplan: クラウド上で計画策定、ブラウザでレビュー・コメント
  • Ralph Wiggum Loop: 長時間自律開発ループ(完了まで繰り返し)
  • Channels: Telegram/Discord/Webhookからのイベントを実行中セッションにプッシュ

開発ワークフロー比較

全ワークフローは Research → Plan → Execute → Review → Ship パターンに収束。主要フレームワーク10種の比較表が提供されており、エージェント数・コマンド数・スキル数で比較可能:

  • Everything Claude Code(エージェント48、コマンド143、スキル230)
  • Superpowers(TDD駆動、Iron Laws)
  • Spec Kit(GitHub公式、仕様駆動)
  • gstack(ロールペルソナ、並列スプリント)

重要なTipsの要約

  • CLAUDE.md: 1ファイル200行以下を推奨。<important if="..."> タグで無視防止
  • コンテキスト管理: 50%到達で手動 /compact、タスク切替時は /clear
  • モデル選択: 計画にはOpus、コーディングにはSonnetを使い分け
  • PR戦略: p50で118行の小さなPR、スカッシュマージ推奨
  • サンドボックス: /sandbox でファイル・ネットワーク隔離、権限プロンプト84%削減
  • 検索戦略: エージェンティック検索(glob + grep)がRAG(ベクトルDB)より有効

設定ファイル構成

.claude/
├── agents/          # サブエージェント定義
├── commands/        # スラッシュコマンド
├── skills/          # スキルフォルダ(SKILL.md + references/, scripts/)
├── hooks/           # イベントフック
├── rules/           # 分割ルール
├── settings.json    # 階層的設定(権限、モデル、出力スタイル等)
CLAUDE.md            # プロジェクトメモリ
.mcp.json            # MCP サーバー設定

ライセンス

READMEにライセンスの明示的な記載はありません。

関連リポジトリ

インストール・クイックスタート

このリポジトリ自体はドキュメント集なので、特別なインストールは不要です。Claude Codeをセットアップ済みの環境で、オーケストレーションワークフローのデモを試す場合:

# Claude Codeを起動
claude

# デモ用のオーケストレーションコマンドを実行
/weather-orchestrator

Claude Code自体のインストールについては公式ドキュメントを参照してください。

参考になる外部の関連記事

過去のトレンド履歴

関連リポジトリ

AIへの「話しかけ方」が14万人に支持された世界最大のプロンプト集 — prompts.chat

f/prompts.chatHTML157.4k

prompts.chatは、ChatGPTやClaude、Geminiなど様々なAIチャットツールで使える「お手本の質問文(プロンプト)」を集めた世界最大のオープンソースライブラリです。2022年12

AIコーディングアシスタントを最強にチューニング!28エージェント×119スキルの包括的パフォーマンス最適化システム — everything-claude-code

affaan-m/everything-claude-codeJavaScript103.3k

everything-claude-codeは、Claude CodeやCodex、Cursorなどの「AIコーディングアシスタント」の性能を最大限に引き出すための総合チューニングシステムです。28種

使うほど賢くなるAIエージェント — 学習・記憶・自動化を全部入りで月5ドルから運用 — hermes-agent

NousResearch/hermes-agentPython87.5k

Hermes Agentは、Nous Research社が開発した「自己改善するAIエージェント」です。会話するたびに経験からスキルを自動生成し、ユーザーの好みや過去のやり取りを記憶して、使えば使うほ

AIコーディング助手の「記憶喪失」を解決!セッションをまたいで文脈を自動保存・復元 — claude-mem

thedotmack/claude-memTypeScript56.7k

claude-memは、AIコーディングツール「Claude Code」のプラグインで、コーディングセッション中にClaudeが行ったすべての操作を自動的に記録し、AIで圧縮・要約した上で、次回のセッ

ChatGPT・Claude・Geminiの"裏の指示書"を丸ごと公開!主要AIの内部プロンプト集 — system_prompts_leaks

asgeirtj/system_prompts_leaks36.9k

system_prompts_leaksは、ChatGPT、Claude、Gemini、Grok、Perplexityなど主要なAIチャットボットの「システムプロンプト(AIに最初から与えられている裏