Claude Codeの生産性を上げる小技12選 — 編集者の運用知見

このTipsでできること

Claude Codeを毎日使い込んだ編集者が、運用で効いた12の小技を取り上げます。それぞれは数秒〜数分で導入できる小さな改善ですが、積み重なると対話のテンポと出力の質が大きく変わります。

やり方

1. /clear を計画的に挟む

長セッションでcontextが圧迫されると応答が劣化します。フェーズ切れ目で /clear を打ってcontextを初期化すると、その後の作業の精度が上がります。直前の状態はgit logやTODOに残しておけば失われません。詳細はClaude Codeが期待通りに動かない10シナリオシナリオ1を参照。

2. 大ファイルはReadよりGrepを先に

5,000行以上のファイルを Read で全文取り込むとcontext windowが一気に圧迫されます。先に Grep で該当箇所を絞り、必要な部分だけReadするのが定石。

3. CLAUDE.mdは300行以内に保つ

CLAUDE.mdは毎セッション開始時に必ず読まれるため、肥大化すると1セッションごとに大きなcontextを消費します。手順型のノウハウはSkillsに逃がし、規約と方針だけを残すのが原則です。

4. PostToolUse Hookで正規化を自動化

「保存後にフォーマット」のような毎回手動でやっている作業はHookで自動化できます。設定1つで、保存時にprettierやlintが自動実行される構成はHooks実例カタログレシピ2を参照。

5. 重い調査は Task で隔離

「リポジトリ全体をスキャンして」「過去100 PRを読んで」のようなタスクは、メイン会話で直接やるとcontextを圧迫します。Task で Explore 型サブエージェントに丸投げすれば、メインには要約1通だけ返ります。詳細はサブエージェント完全活用。

6. 独立タスクは並列起動

互いに依存しない作業(別ディレクトリの実装)は Task を2〜3体並列起動。所要時間が1/Nに短縮できます。担当ファイルをプロンプトで明示するのがコツ。

7. Bash の長時間プロセスは run_in_background: true

npm run dev 等の常駐プロセスをforegroundで起動すると、Claude Codeが完了を待ち続けて固まります。run_in_background: true を渡すと完了通知が来るまで他の作業が続けられます。

8. PR作成はHEREDOCで本文を渡す

gh pr create --body を渡すとき、引用符のエスケープでハマりやすい。HEREDOCを使うと改行 / 記号がそのまま渡せます。

gh pr create --title "..." --body "$(cat <<'EOF'
## Summary
...
EOF
)"

9. 機微ファイル編集はHookで警告

.env credentials への編集を検出して警告を出すHookを仕込んでおくと、誤コミット事故の最後の砦になります。レシピはHooks実例カタログレシピ9を参照。

10. settings.jsonの worktree.baseRef を環境別に

チームでは fresh、個人では head。プロジェクトごとに設定を変えるだけで、worktreeが走る起点が変わります。詳細はWorktree完全活用。

11. PRの自動マージにラベルでガード

auto-merge botを使う場合、緊急停止用ラベル(do-not-merge)と手動マージ用ラベル(skip-ai-review)を準備しておくと、CI込みのフルパスとローカルレビュー済みパスを使い分けられます。

12. 1セッションで1目的に絞る

複数の関心事を1セッションで進めると、contextが混雑して見落としが増えます。「リファクタ」「新機能追加」「テスト整備」を別セッションに分けるだけで、それぞれの精度が上がります。/clear の代わりに別ターミナル / 別worktreeを立てる選択肢もあります。

補足: 12個を一気に入れる必要はない

実運用での効きを実感するために、1つずつ導入するのが現実的です。最初に効くのは1 / 5 / 11(/clear / Taskで重い調査 / マージラベル)あたり。慣れたら順に他のも試してみてください。

他記事で書かれていない切り口

本記事の中で、他のClaude Code記事に見ない要素を3つ強調しておきます。

• Tip 3(CLAUDE.mdを300行以内): 「肥大化しないように」という制約はあまり明示されていない。常時読まれる性質を理解してこそ重要
• Tip 6(独立タスクの並列起動): 「並列化が可能」というのは知られているが、並列体数の上限(3〜5)や担当ファイル明示といった運用ルールはあまり共有されていない
• Tip 11(マージラベルでガード): AI駆動のauto-mergeを回す場合の運用tips。手動マージ運用とのハイブリッド設計はまだ事例が少ない

まとめ

Claude Codeは「使う側の設計次第で生産性が大きく変わる」ツールです。本記事の12個は、設定 / Hook / Task / 運用ルールにまたがる小さな改善の集合体ですが、全部入れると確実に体感が変わります。気になったものから1つずつ試して、自分のワークフローに馴染むものを残してください。