Claude Code ベストプラクティス＆実務テクニック集【2026】CLAUDE.md設計・権限・コスト管理

Claude Code は使えるが、CLAUDE.md がうまく効かない・コンテキストが詰まって精度が落ちる・コストや権限の勘所が分からない。こうした実務の壁は、使い方の型を押さえると減らせる。本記事は2026年6月23日時点のAnthropic公式ドキュメントに基づき中立に整理する。

Claude Code を実務で活かす要点は4つ。1. コンテキストウィンドウを最重要リソースとして管理する（埋まるほど性能が落ちる）。2. Claudeが自分で正否を確かめられる検証手段（テスト・ビルド・スクリーンショット）を与える。3. CLAUDE.md は「この行を消すとClaudeがミスするか?」で剪定し簡潔に保つ。4. コストは利用上限の仕組みを理解し /clear ・subagent で無駄打ちを減らす。

なお当社（YDAIコンサルティング AI編集部）は Claude 系ツールのヘビーユーザーであり、Anthropic のエコシステムで開発受託も行う立場にある。その当事者性を開示したうえで、本記事は Claude Code を勝たせる書き方をせず、向かない場面と代替（GitHub Copilot ／ Cursor ／ Codex 等）も同じ粒度で扱う。

結論：Claude Code を活かす4本柱

Claude Code は万能ではなく、用途と運用次第で成果が大きく変わる道具である。下表は公式のベストプラクティスを「何を最優先にすべきか」で再編成した4本柱の早見である。

本柱	要点	中核手段
コンテキスト管理	埋まるほど性能が落ちる最重要リソース	/clear ・subagent で分離
検証ループ	成功は主張でなく証拠で示させる	テスト・ビルド・リンタ・スクリーンショット
CLAUDE.md 設計	簡潔に保ち指示を埋もれさせない	剪定・@import 分割・hook化
コスト最適化	枠を増やすより無駄打ちを減らす	/clear ・subagent ・手戻り削減

すべての根底にある制約は「コンテキストウィンドウはすぐ埋まり、埋まるほど以前の指示を忘れミスが増える」ことだ（出典: code.claude.com/docs／参照2026-06-23時点）。

対象読者：習熟段階別の早見

同じプラクティスでも、現在地によって優先順位は変わる。下表は公式の各プラクティスを「個人入門・エンジニア実務・チーム運用」で再編成した本記事独自のマッピングである。

習熟段階	最優先プラクティス	委譲先
個人・入門	/init で CLAUDE.md 雛形・/clear の習慣・Plan modeで様子見	未導入は委譲先へ
エンジニア・実務	検証ループ・/compact ・権限モードの使い分け・@import分割	MCP手順は委譲先へ
チーム・運用	CLAUDE.md の hook化・subagentで検証・claude -p でCI連携・worktreeで並列	ツール選定は委譲先へ

まだ導入していない・非エンジニアの方は「非エンジニアのClaude Code活用」が入口になる。どのツールを使うか自体を決めかねている場合は「AIコーディングツール比較（4ツール総合）」で起点を整理できる。

CLAUDE.md 設計

CLAUDE.md は Claude が各会話の冒頭で読む特別なファイルで、Bashコマンド・コードスタイル・ワークフロールールを記載する。ここの設計が成果を左右する。

配置場所と階層運用

/init を実行するとコードベースを解析してビルド・テスト・コードパターンを検出し、雛形を生成できる。配置場所は5系統ある。~/.claude/CLAUDE.md は全セッション、プロジェクトの ./CLAUDE.md は git で共有、./CLAUDE.local.md は個人用、親ディレクトリは monorepo で自動読込、子ディレクトリは該当ファイルを読むときだけオンデマンドで読まれる。

当社の運用知見として、多数の事業を「親＝全社共通ルール ／ 子＝事業固有ルール」の階層で運用すると、共通ルールを重複記述せず、事業ディレクトリに入ったときだけ固有ルールが読まれる。経験に基づく一次知見であり、社内の具体設定は割愛する（出典: code.claude.com/docs／参照2026-06-23時点）。

何を書く・何を書かない

含めるべきは、推測できないBashコマンド・既定と異なるコードスタイル・テスト指示・リポジトリ固有の作法・環境のクセ・非自明な落とし穴である。

逆に除外すべきは、コードから分かること・標準的な言語慣習・詳細なAPI文書（リンクで足りる）・頻繁に変わる情報だ。取捨の基準は一つ、「この行を消すと Claude がミスするか?」である（出典: code.claude.com/docs／参照2026-06-23時点）。

肥大化を避ける剪定と@import分割

肥大化した CLAUDE.md は、重要な指示が埋もれて Claude が無視する原因になる。簡潔に保ち、内容が増えたら @path/to/import で別ファイルに分割するのが定石だ。

当社でも CLAUDE.md が長すぎて指示が効かなくなり、不要な行を削ったら従うようになった経験がある。さらに、確実に毎回起こしたい動作は助言的な CLAUDE.md ではなく、決定的に動く hooks へ寄せると安定する（出典: code.claude.com/docs／参照2026-06-23時点）。

環境設定と権限

環境の整え方と権限モードの選択は、自動化の安全性と速度を同時に左右する。

権限モードの使い分け

権限モードは6種類ある。default は読取のみで編集は都度承認、acceptEdits は読取に加えファイル編集と一般FSコマンドを許可、plan は読取のみで調査と計画に使う。auto は背景の安全チェック付きで全許可（研究プレビュー扱い）、dontAsk は事前承認したツールのみ、bypassPermissions は全許可で隔離環境専用だ。

Shift+Tab でモードを切り替えられ、bypassPermissions 以外は保護パスへの書込が自動承認されない。auto では分類器が危険操作（本番デプロイ・大量削除・force push 等）をブロックする。権限の落とし穴とセキュリティの深掘りは「エージェント権限の落とし穴」へ譲る（出典: code.claude.com/docs／参照2026-06-23時点）。

hooks・skills・MCP連携

hooks は .claude/settings.json に置き、確実に毎回起こしたい動作を決定的に実行する（/hooks で閲覧）。skills は .claude/skills/ 配下の SKILL.md でオンデマンドのワークフローやドメイン知識を与える。

MCP は claude mcp add で接続し、トランスポートは HTTP（推奨）・SSE（非推奨）・stdio（ローカル）の3種だ。MCP 接続の具体手順は「Claude Code と MCP の連携手順」、概念は「MCPとは」で確認できる（出典: code.claude.com/docs）。

コンテキスト運用

コンテキスト管理は4本柱の根幹だ。詰まりを感じたら、続けるより一度切る判断が効く。

/clear で無関係タスクをリセット

長いセッションで無関係なコンテキストが溜まると性能が落ちる。無関係なタスクの間は /clear でコンテキストを完全にリセットするのが基本だ。

同じ修正を2回以上繰り返してしまうときは、そのまま続けるより /clear して良いプロンプトで再開する方が良い結果になりやすい。長く続けるほど良くなるわけではない（出典: code.claude.com/docs／参照2026-06-23時点）。

/compact で要約圧縮

/compact は会話履歴を要約して圧縮する。/compact <instructions> のように焦点を指定でき（例: API変更に集中）、CLAUDE.md 側で圧縮時に保持する内容をカスタマイズすることもできる。

自動圧縮は上限が近づくと発動し、コードや決定を保持しようとする。Esc+Esc や /rewind で、特定地点からの部分的な圧縮・巻き戻しも可能だ（出典: code.claude.com/docs／参照2026-06-23時点）。

Plan modeと検証ループ

Plan mode は編集前に調査・計画させる読取専用モードで、Shift+Tab で切り替えるか単発プロンプトに /plan を前置して使う（Ctrl+G で計画を外部エディタ編集）。着手前に方針を固めたいときに向く。

検証ループはベストプラクティスの中核だ。テスト・ビルドの終了コード・リンタ・スクリーンショットなど Claude が読める pass/fail を与えると、自律的に反復して直す。成功は主張ではなく、出力やコマンド結果などの証拠で示させるのが要点である（出典: code.claude.com/docs／参照2026-06-23時点）。

並列・自動化

複数の作業を回したい・スクリプトに組み込みたい段階で効くのが、並列実行とヘッドレス実行だ。

worktree と subagents

claude --worktree で隔離された git チェックアウトのセッションを並列起動できる（履歴・リモートは共有）。並行作業を干渉させずに進めたいときに向く。

subagents は .claude/agents/ 配下の markdown で定義する隔離アシスタントで、独自のコンテキストと許可ツールで動く。多数ファイルの調査や、書いた本人でない新鮮なモデルによる検証に有効だ。複数エージェントを束ねる設計観点は「マルチエージェント設計パターン」も参考になる（出典: code.claude.com/docs）。

headless（claude -p）で自動化

claude -p "prompt" で非対話（ヘッドレス）実行ができる。CI・pre-commit フック・スクリプトに組み込め、--output-format（text／json／streaming json）で結果をプログラム解析できる。

複数ファイルへの fan-out（for ループで各ファイルに claude -p を回す）も可能で、--permission-mode も併用できる。対話を開かずに定型処理を自動化したい場面で効く（出典: code.claude.com/docs／参照2026-06-23時点）。

コスト管理

コストは「枠を増やす技」より「無駄打ちを減らす技」で効く。前提として利用上限の仕組みを押さえたい。

利用上限の考え方とバケット改定の現状

Claude・Claude Code・Claude Desktop など、すべてのプロダクト面の利用は同一のサブスク利用上限にカウントされる。プランごとに週次上限が設定されるが、具体数値はアカウント依存のため、本文では断定せず Settings>Usage で確認する前提とする。

ここで鮮度の論点がある。2026年6月15日に予定されていた、Agent SDK ・claude -p ・サードパーティアプリを別クレジットへ分離する課金改定は、Anthropic が保留（PAUSE）した。現在はこれらも従来どおりサブスク利用上限から消費される（公式 support が明言）。二次情報には改定がすでに発効したとする記述も見られるが、保留中＝現状は従来どおりが正しい。実務の最適化は、/clear で無関係コンテキストを切る・調査を subagent に逃がす・検証ループで手戻りを減らす、の3点に尽きる（出典: support.claude.com／参照2026-06-23時点）。

使うべきでないケースと代替

Claude Code は強力だが起点にすべきでない場面もある。中立に挙げると、既存エディタ（VS Code 拡張や JetBrains）を変えたくない場合、コード補完中心の使い方が主体の場合、特定のクラウド常駐エージェントや非同期委譲を主軸にしたい場合などだ。

代替も同粒度で示す。既存環境に足したいなら拡張型の GitHub Copilot、AIネイティブIDEで対話しながら書きたいなら Cursor、別エコシステムに合わせたいなら Codex や Gemini CLI が起点になる。どれが勝者ということはなく、開発スタイルと料金体系の相性で選ぶ。詳細な比較は「AIコーディングツール比較（4ツール総合）」へ譲る（出典: code.claude.com/docs／参照2026-06-23時点）。

よくある失敗パターンと対処

公式は典型的な失敗パターンを明示している。心当たりがあれば対処はシンプルだ。

無関係な作業を1セッションに詰め込む「kitchen sink」は /clear で分離する。同じ修正の繰り返しは、2回失敗したら /clear して再プロンプトする。過剰な CLAUDE.md は剪定し、確実に効かせたい指示は hook 化する。主張を鵜呑みにする「信頼-検証ギャップ」は、検証手段（テスト・スクリプト・スクリーンショット）を与えて埋める。終わらない無限探索は、スコープを限定するか subagent に逃がす（出典: code.claude.com/docs／参照2026-06-23時点）。

まとめ

Claude Code を実務で活かす要点は、コンテキスト管理・検証ループ・CLAUDE.md設計・コスト最適化の4本柱に集約される。CLAUDE.md は「この行を消すとClaudeがミスするか?」で剪定し、コンテキストは /clear ・/compact で整え、コストは無駄打ちを減らす方向で最適化する。

一方で Claude Code は万能ではなく、向かない場面では GitHub Copilot ・Cursor ・Codex 等が起点になる。当社は Claude 系のヘビーユーザーかつ Anthropic エコシステムの受託という立場を開示したうえで、どのツールも勝たせず用途で選ぶ姿勢を採る。MCP 連携は「Claude Code と MCP の連携手順」も参考にしてほしい。料金・権限仕様は変動が速いため、最新は公式（code.claude.com/docs・support.claude.com）で確認するのが確実だ。

---

自社の開発体制に合うツールを中立に整理したい方へ

どのツールが自社に合うかを整理したい場合は、AIコーディングツール比較（4ツール総合）も参考になります。