AIFCC
← ブログ一覧
01

514記事から厳選した Claude Code 実践15選 — 編集が必要なのは2ファイルだけ

Claude CodeAIエージェントベストプラクティスAIFCC

AI・Claude Code 記事を数ヶ月かけて 514本 追跡し、再現可能な 166プラクティス に蒸留。その中から以下3条件を全て満たす 15件 を厳選しました:

  1. verified または広く再現されている(opinion ではない)
  2. 全プロジェクトで通用する
  3. 直接的で計測可能なインパクトがある(トークン・時間・失敗率)

全166プラクティスの検索可能なライブラリ: https://sift.aifcc.jp (9カテゴリ) 原典となった日次キュレーションフィード: https://aifcc.jp/blog

リポジトリ(下の2分インストール用スニペット): https://github.com/5dmgmt/claude-code-essentials


朗報: 編集が必要なのは2ファイルだけ

15のうち、編集するファイルは 2 つだけ。残りの 13 は 読んで身につける もの — 設定ファイルもスクリプトもありません。

全体マップ

🔧 インストール(2ファイル編集、コピペ、いつでも取り消し可能)

#内容対象ファイル効果
1.env 保護 Hook~/.claude/settings.json.env 漏洩を機械的に防止
4 + 5 + 7簡潔応答 + トークン節約 + コンテキスト管理~/.claude/CLAUDE.md出力トークン 75% 削減。ヘビーユーザで年間約 $5,800 節約

既存の ~/CLAUDE.md や各プロジェクト CLAUDE.md がある場合: Practice 02(2階層 .claude/)で移行・重複整理を対話的にサポートします。手動コピペ不要、Claude Code が進めます。

📖 読んで身につける(13プラクティス)

#プラクティス一言ベネフィット
22階層 .claude/ フォルダ1つの CLAUDE.md に全部詰めない。プロジェクト vs ユーザースコープを分離
3Auto mode + /fewer-permission-prompts「Bash承認ポチポチ」から解放。並列 Claude 実行が現実的に
6/go で検証長時間タスクが戻ってきた時に本当に動く
7コンテキスト管理5択30万トークン以降の精度劣化を回避。5つの技から選べる
8git worktreeエージェント間の待ち時間ゼロ。同じリポで複数ブランチを並列
9/loop/schedule定期タスクが勝手に走る。ターミナル監視ゼロ
10コンテキスト設計 > リトライ一発で通す設計。実例 37秒→7.5秒
11Prompt caching 設計規律キャッシュヒット率 92% = API料金を桁違いに削減。フラグではなく設計パターン
12Prompt → Project → Skill の複利使うほど AI が賢くなる。セッションごとにリセットされない
13スラッジゼロ設計肥大 CLAUDE.md が隠れて課す 20% 推論コスト増を止める
14LLM はスパーリング相手LLMの「それっぽい答え」を鵜呑みにしない。出荷前に弱点を炙り出す
15Claude Code 事故7選実際に起きた7種の事故を自分に降りかかる前に封じる

Claude Code 自身に適用させる

記事を全部読んで手でコピペする必要はありません。Claude Code に以下の URL を渡せば、対話的にガイドされます:

ultrathink で https://github.com/5dmgmt/claude-code-essentials を読んで、
INSTRUCTIONS.md に従って 15 プラクティスを私のプロジェクトに
1つずつ確認しながら適用してください。

なぜ ultrathink? 15プラクティスの適用可否は環境依存の判断が多い(既存 CLAUDE.md の有無・symlink 配置・重複するルール・プロジェクト固有の例外)。深く推論させることで見落としや誤った一括適用を防げます。

Claude Code は以下を自動で行います:

  1. INSTRUCTIONS.md を読み、安全な進め方を把握
  2. あなたの現在の ~/.claude/ 構造を確認(非破壊)
  3. 15 プラクティスを 1 つずつ:
    • 得られることを 1 行で要約
    • このプロジェクトに該当するかを質問(トレードオフ込み)
    • 書き込み前に 差分を表示
    • あなたの承認後にのみ 適用
    • 動作確認プロンプトを案内
  4. 最終サマリー(適用済 / スキップ / 調整)を報告

変更前に必ずバックアップを取ります。どの practice も skip 可、「ロールバックして」とプロンプト 1 つで元に戻せます。

初心者にとって最も安全な適用方法です。中身だけ知りたい方は以下の 15 件を読み進めてください。


15件の詳細

1. Hooks で決定的制御

得られること: シークレット漏洩をゼロ労力で機械的に封じる。ポリシー強制が「Claude の記憶任せ」から解放される。

~/.claude/settings.json のライフサイクルイベント(SessionStart / PreToolUse / PermissionRequest / Stop)に紐づけます。ポリシー強制は確率より決定論。

上のインストール手順で .env ブロックを追加済み。ルールを増やしたい時は同じパターンで。

出典: @bcherny — https://x.com/bcherny/status/2038454336355999749 · 日本語訳


2. .claude/ は2階層で持つ

得られること: CLAUDE.md の肥大化を止める。プロジェクト間で同じ設定をコピペする無駄を撲滅。

プロジェクト固有は {repo}/.claude/、ユーザー共通は ~/.claude/。Claude が自動で統合:

~/.claude/CLAUDE.md              ← 全プロジェクト共通ルール(上でペーストしたもの)
{project}/.claude/CLAUDE.md      ← このコードベース・スタック・決定事項
{project}/.claude/skills/        ← プロジェクト固有スキル

インストール不要 — メンタルモデル。1つのファイルに全部詰めないだけ。

出典: @akshay_pachaar — https://x.com/akshay_pachaar/status/2035341800739877091 · 日本語訳


3. Auto mode + /fewer-permission-prompts

得られること: Bash 承認ポチポチから解放される。並列 Claude 実行が現実的に。

Shift+Tab で Auto mode をトグル。モデルベースの分類器が権限を判定。セッション終了後 /fewer-permission-prompts を実行すると履歴からアローリスト候補を自動生成。

ランタイムコマンド — インストール不要。今すぐ試せる。

出典: @bcherny — https://x.com/bcherny/status/2044847848035156457 · 日本語訳


4. トークン浪費追跡 — 75%削減

得られること: Claude料金の 75% が「タスク外」に溶ける状態を止める。実例で月 $500 削減。

Claude のトークンコストの約 75% は「あなたのタスク」ではなく、コンテキスト再読み込み・冗長な履歴に消えます。5段階(加算):

  1. 簡単なタスクは Haiku に振る
  2. /compact を積極運用(40%消費前)
  3. Prompt caching(#11)
  4. 大量処理は Batch API
  5. claude --usage で監視

上のインストールで基礎ルール(「再読込しない」)を追加済み。他は実行時習慣。

出典: @meta_alchemist — https://x.com/meta_alchemist/status/2038919582111670415 · 日本語訳


5. 原始人Claude — 出力を75%圧縮

得られること: CLAUDE.md 一段落で出力トークン75%削減。年間 $5,800 節約の実績あり。

出力トークンが約180→45に圧縮。たった1つの変更 —「ナレーションをやめ、プロセスではなく結果を報告」。

上のインストールに含む。効果はセッション1回目から体感できる。

出典: @k1rallik — https://x.com/k1rallik/status/2043694049769455877 · 日本語訳


6. /go で長時間タスクを検証

得られること: 戻ってきた時に本当にコードが動く。「動いてるように見えて壊れてる」を撲滅。

プロンプト末尾に /go。Claude が (1) bash/browser/computer-use で E2Eテスト (2) /simplify (3) PR作成 を自動実行。

ランタイムコマンド — インストール不要。数時間見ていられないタスクで使う。

出典: @bcherny — https://x.com/bcherny/status/2044847848035156457 · 日本語訳


7. コンテキスト管理の5択

得られること: 30万トークン以降の精度劣化を回避。「どの技を使うか」が迷わなくなる。

1M ウィンドウでも Context rot は 30〜40万トークンから始まる:

場面
続きをやりたいContinue
道を誤ったRewind(Esc ×2)
完全新規/clear
要約して続行/compact
独立サブタスクサブエージェント

原則: 新タスク = 新セッション。上のインストールに一行リマインダを含む。

出典: @ClaudeCode_love — https://x.com/ClaudeCode_love/status/2044672857998016940 · 日本語訳


8. git worktree で並列エージェント

得られること: 待ち時間ゼロ。1つのエージェント終了を待たずに次の作業を並列で走らせる。

claude -w feature-a
claude -w feature-b   # 別ターミナルで

ランタイムコマンド — インストール不要。独立した機能を同時に作る時に。

出典: @bcherny — https://x.com/bcherny/status/2038454336355999749 · 日本語訳


9. /loop/schedule で定期実行

得られること: 定期タスクが勝手に走る。ターミナルを見張る時間がゼロに。

/loop 5m /check-prs              # 5分ごと
/schedule "0 9 * * *" /daily-report

/loop は最大1週間。日次リポ監査・PR 見守り・デプロイ監視・ログポーリング等。

ランタイムコマンド — インストール不要。

出典: @bcherny — https://x.com/bcherny/status/2038454336355999749 · 日本語訳


10. コンテキスト設計 > リトライ

得られること: 一発で通る設計。リトライループで消耗しない。実例 37秒→7.5秒。

臨床AIパイプラインで 37秒 → 7.5秒。リトライループ最適化ではなく タスク分解+コンテキスト絞り込み。経験則: リトライ回数が2回を超えたら入力設計が間違っている。

メンタルモデル — インストール不要。エージェントを作る時に適用。

出典: @sullyai — https://x.com/sullyai/status/2044466240597459230 · 日本語訳


11. Prompt caching は設計規律

得られること: キャッシュヒット率 92% でAPI料金を桁違いに削減。「フラグ」ではなく設計で効かせる。

Claude は 92% キャッシュヒット率を出せます。「フラグを有効化」ではなく、システムプロンプト・ツール定義・履歴のプレフィックスが安定する設計が条件。

  • システムプロンプトは固定(リクエストごとにテンプレ変更しない)
  • ツール定義の順序が決定的
  • 履歴は追記のみ。再構成しない

SDK ユーザ向けメンタルモデル — CLI ユーザは Anthropic 内部キャッシュで恩恵を受けられる。

出典: @_avichawla — https://x.com/_avichawla/status/2044670188998803855 · 日本語訳


12. 3層複利: Prompt → Project → Skill

得られること: 使うほど AI が賢くなる複利構造。セッションごとにリセットされる消耗型から脱却。

知識を上位層へ移すほど効果が複利で増える:

  1. Prompt — 一回切り、セッション後に消える
  2. Project — CLAUDE.md レベル、プロジェクト内で永続
  3. Skill — 名前で呼び出せる手順

反復するプロンプトは全て「隠れスキル」。昇格させる。

メンタルモデル + 習慣 — インストール不要。自分のプロンプトにパターンを見つけること。

出典: @kkawsb — https://x.com/kkawsb/status/2044610786560221674 · 日本語訳


13. スラッジゼロ設計の3原則

得られること: CLAUDE.md 肥大が隠れて課す 20% の推論コスト増を止める。

Roo Code / DeepAgent / HumanLayer ビルダーから:

  1. CLAUDE.md は人間が書く最小限のみ — LLM 生成 CLAUDE.md は推論コスト約20%増
  2. R.P.I フレーム: Role / Problem / Intent — スタッフエンジニア水準の問題把握
  3. サブエージェント分離 — 独立サブタスクは全て委任、メインコンテキストを清潔に

CLAUDE.md を書く時のメタルール — インストール不要。

出典: @thealexker — https://x.com/thealexker/status/2045203785304232162 · 日本語訳


14. LLM は真実マシンではなくスパーリング相手

得られること: LLM の「それっぽい答え」を鵜呑みにしない。出荷前に弱点を自分で炙り出せる。

Karpathy のリフレーム。LLM はどの方向にも説得力を持って議論できる = 真実マシンではない。ドラフトを作らせた後、反対意見を求める。

1. LLM でドラフト
2. 「この主張への最強の反論は?」
3. 反論が新情報を出さなくなるまで反復

習慣 — インストール不要。重要な判断時に使う。

出典: @karpathy — https://x.com/karpathy/status/2037921699824607591 · 日本語訳


15. Claude Code 事故7選と防止策

得られること: 実際に起きた .env 漏洩・本番DB 削除など 7 種の事故を、自分に降りかかる前に封じる。

日本人ユーザーの実運用事故:

#事故防止策
1.env 漏洩Hook で .env* 書き込み阻止(上のインストールで対応済)
2本番DB 誤削除Bash(psql:*) deny + 読み取り専用ユーザ
3APIキー投稿pre-commit で鍵パターンスキャン
4WebFetch経由 prompt injectionWeb内容はサンドボックス化、出力を信用しない
5rm -rf 暴走Bash(rm:*) deny + --interactive 再バインド
6.gitignore 漏れcommit 前強制チェック Hook
7MCP 認証情報抜き取りMCP サーバリスト監査、1Password CLI 統合

上のインストールで #1 は対応済。他の6件はリスク許容度に応じて追加。

出典: @yousukezan — https://x.com/yousukezan/status/2045018702782079271 · 日本語訳


次のステップ

この15件が「当たり前」になったら、全166プラクティス を探索してください。新しいプラクティスの源泉は aifcc.jp/blog の日次キュレーションフィード。

自分のワークフローで16件目を見つけた? @5dmgmt にリプライか DM、またはリポの Issues へ。

謝辞

この15プラクティスの原典となった記事の著者の皆さんに感謝します:

@bcherny @akshay_pachaar @meta_alchemist @k1rallik @ClaudeCode_love @sullyai @_avichawla @kkawsb @thealexker @karpathy @yousukezan

皆さんの発信がこのキュレーションの原材料です。 全166プラクティス: https://sift.aifcc.jp 日次フィード: https://aifcc.jp/blog スニペット: https://github.com/5dmgmt/claude-code-essentials


Curated by 望月貴生(Takao Mochizuki)/ 五次元経営(5dmgmt, Inc.) / AIFCC Built with Claude Code + Claude Opus 4.7