2026-04-20

514記事から整理した Claude Code 実践15選 — ファイル編集を伴う2項目と確認ポイント

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

注記（2026-07 追記）: 本文中のプラクティス件数「166」は掲載時点（2026-04）のものです。ライブラリはその後も増え続けています。最新のプラクティス集は aifcc.jp/blog の Siftプラクティスタブでご覧いただけます。

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

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

全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プラクティス）

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

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

適用前に、Claude Codeへ差分表示とバックアップを依頼してください。環境によっては自動バックアップや復元が十分でない場合があるため、重要な設定は自分でも退避し、1件ずつ確認します。中身だけ知りたい方は以下の15件を読み進めてください。

15件の詳細

1. Hooks で決定的制御

得られること: Hookによってシークレット漏洩のリスクを下げます。環境ごとの確認が必要であり、完全な防止を保証するものではありません。

~/.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段階（加算）:

簡単なタスクは Haiku に振る
/compact を積極運用（40%消費前）
Prompt caching（#11）
大量処理は Batch API
claude --usage で監視

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

※編集部注(2026-07-27): 現在の AIFCC 運用では、この使い分けを4段（設計・監査は Fable 5 / 実装は Opus 5・Sonnet 5 / 大量の軽い処理は Haiku 4.5）へ拡張しています。本記事の考え方はそのまま有効です。

出典: @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 が賢くなる複利構造。セッションごとにリセットされる消耗型から脱却。

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

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

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

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

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

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

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

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

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

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 + 読み取り専用ユーザ
3	APIキー投稿	pre-commit で鍵パターンスキャン
4	WebFetch経由 prompt injection	Web内容はサンドボックス化、出力を信用しない
5	`rm -rf` 暴走	`Bash(rm:*)` deny + `--interactive` 再バインド
6	`.gitignore` 漏れ	commit 前強制チェック Hook
7	MCP 認証情報抜き取り	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

この実践を、体系的に進めるなら

整える — SIFT ↗作る — Workshop ↗回す — RUN ↗

参加案内を見る →

← ブログ一覧に戻る

514記事から整理した Claude Code 実践15選 — ファイル編集を伴う2項目と確認ポイント

ファイル編集を伴う2項目

全体マップ

Claude Code 自身に適用させる

15件の詳細

1. Hooks で決定的制御

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

3. Auto mode + /fewer-permission-prompts

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

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

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

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

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

9. /loop と /schedule で定期実行

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

11. Prompt caching は設計規律

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

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

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

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

次のステップ

謝辞

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

3. Auto mode + `/fewer-permission-prompts`

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

9. `/loop` と `/schedule` で定期実行