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

アーキテクチャ：Command → Agent → Skill パターン

claude-code-best-practiceが提唱する中核的なアーキテクチャは「オーケストレーションワークフロー」と呼ばれる3層構造:

• Command（コマンド）: .claude/commands/に配置するMarkdownテンプレート。ユーザーがスラッシュコマンドで呼び出し、ワークフロー全体を指揮する
• Agent（サブエージェント）: .claude/agents/に配置。独立したコンテキストウィンドウで動作する自律的なAI。専用のツール・権限・モデル・メモリを持つ
• Skill（スキル）: .claude/skills/<name>/SKILL.mdに配置。再利用可能な知識パック。プログレッシブ・ディスクロージャー（段階的開示）やコンテキストフォーク（分離実行）に対応

主要な機能・概念一覧

• Hooks: 特定イベントで自動実行されるスクリプト（PostToolUseでコード自動フォーマットなど）
• MCP Servers: 外部ツール・データベース・APIとの接続プロトコル
• Plugins: スキル・エージェント・フック・MCPサーバーのバンドル配布パッケージ
• Memory: CLAUDE.mdファイルによる永続的なコンテキスト（200行以下推奨）
• Checkpointing: git ベースの自動ファイル編集追跡（Esc Escで巻き戻し可能）
• Agent Teams: 複数エージェントが同一コードベースで並列作業
• Auto Mode: 安全性分類器が手動の権限承認を自動化
• Scheduled Tasks: /loopでローカル定期実行（最大3日）、/scheduleでクラウド定期実行
• Voice Dictation: 20言語対応の音声入力
• Chrome連携: ブラウザ自動操作（テスト・デバッグ・データ抽出）
• Ralph Wiggum Loop: 長時間の自律開発ループプラグイン

開発ワークフロー比較

8つの主要ワークフローが比較されており、すべて「Research → Plan → Execute → Review → Ship」パターンに収束:

重要なTips（抜粋）

• CLAUDE.md は200行以下に保ち、<important if="..."> タグで重要なルールを強調する
• 手動 /compact はコンテキスト使用50%で実施（「エージェント鈍化ゾーン」を避ける）
• Plan Mode にはOpus、Code実行にはSonnetを使い分ける
• PRは小さく保つ（中央値118行）、必ずSquash Merge
• サンドボックスで権限プロンプトを84%削減可能
• agentic search（glob + grep）がRAGに勝る（ベクトルDBはコードの変更に追従できないため）

対応環境

• Claude Code v2.1.89以降
• ターミナル: iTerm、Ghostty、tmux推奨（VSCode/Cursorより高速）
• macOS対応のComputer Use機能あり
• GitHub Actions、GitLab CI/CD連携
• Slack統合（@Claude メンション）

競合製品との比較

Claude Codeの各機能が置き換えつつある既存サービス:

• Code Review → Greptile、CodeRabbit、Devin Review等
• Voice Dictation → Wispr Flow、SuperWhisper
• Remote Control → OpenClaw
• Skills/Plugins → 多数のYC AIラッパースタートアップ

ライセンス

READMEにライセンス情報の明記なし（知識共有リポジトリとして公開）

claude-code-best-practiceはコード実行ツールではなく知識リポジトリのため、クローンして読むだけで使えます。

# リポジトリをクローン
git clone https://github.com/shanraisshan/claude-code-best-practice.git

# Claude Codeを起動してサンプルを試す
cd claude-code-best-practice
claude
/weather-orchestrator

使い方の3ステップ:

1. まずリポジトリを教材として読み、コマンド・エージェント・スキル・フックの概念を理解する
2. クローンしてサンプル（weather-orchestratorなど）を実際に動かしてみる
3. 自分のプロジェクトでClaude Codeに「このリポジトリのベストプラクティスから何を取り入れるべきか提案して」と聞く