Claude Codeを3ヶ月使い込んだ運用メモ — 最初に知っておけば良かった9のこと

このTipsでできること

Claude Codeを本格運用して3ヶ月。「最初にこれを知っていれば回り道しなかった」と思う9つの知見を並べます。新規導入の検討者 / 始めたばかりの人にとって、最初の1ヶ月の試行錯誤を圧縮する材料として読んでください。

9のこと

1. CLAUDE.mdを最初に書く価値が想像の3倍ある

CLAUDE.mdは地味な準備に見えますが、書いた瞬間から毎セッション開始時に効果を発揮します。「コミット規約を毎回伝える」「テストコマンドを毎回教える」が消えるだけで、1セッションあたり5〜10分の節約になり、3ヶ月で大量の時間に化けます。

2. Hookは「1つから始める」が王道

PostToolUse でいきなり5つのhookを仕込むと、応答性の劣化とdebug地獄が同時に来ます。最初は1つ(prettier自動実行 等)だけ入れて、効果と副作用を体感してから次を追加します。

3. Skillsは「自分が同じ依頼を3回繰り返したら」作る

Skillを作る判断基準は「同じ依頼を3回した」。1度 / 2度の依頼でSkill化すると、テンプレ化のコストが回収できません。3回目で「あ、これパターン化できそう」と気づいたタイミングが最適です。

4. サブエージェントは「contextを温存する」のが本質的価値

並列化(時短)と説明されることが多いですが、3ヶ月使った実感として**「contextを温存する」効果が遥かに大きい**です。重い調査をメインで直接やるとcontext圧迫で後の作業が劣化しますが、Task で分離すれば要約1通だけ返り、メインの 思考能力が保たれます。

詳細はサブエージェント完全活用。

5. /clear は「劣化を感じてから」より「フェーズ切れ目」で

応答が劣化したと感じてから /clear するのでは遅い。フェーズが切り替わるタイミング(調査終了、実装完了、レビュー開始)で計画的に /clear するのが王道。直前の状態はgit logと作業メモファイルで保つ。

6. AIにレビューさせる構造的価値は「独立した目」

実装エージェントにセルフレビューさせるより、別Taskで立てたレビュアーに見せる方が見落としが減ります。これは別セッションが異なるcontextで見るためで、人間の「pair review」と本質的に同じ効果。

7. 危険コマンドのブロックは「ブラックリスト」より「sandbox」が堅い

PreToolUse Hookで rm -rf をブロックする発想は分かりやすいですが、バイパスの余地が常にあります。本気で守るならDevContainer / Docker sandboxでコンテナ境界を引くのが確実。詳細はDevContainer / Sandbox完全実装。

8. Worktreeは「個人開発でも価値がある」

「Worktreeはチーム開発の機能」と思われがちですが、個人開発でも「リファクタを別worktreeで試す」用途で頻繁に使います。本流を止めずに実験できる安心感は、運用2〜3ヶ月で実感する典型機能です。

9. Auto-merge botは「人間の眠っている時間」を活かす

個人運営 / 小チームでauto-merge botを入れると、夜間 / 週末に自動実行されたタスクが朝にはマージ済みという非同期性が出ます。本サイトではauto-merge botで最大限活用しており、その設計はメディア運営記に詳しい。

9知見の体系化

これらを早く効くもの → 長期で効くもので並べ直すと:

まとめ

Claude Codeは使い始めの1ヶ月で大体の機能を触れるものの、3ヶ月かけて「使い方」が固まるツールです。本記事の9知見は、3ヶ月後の自分が「最初に知りたかった」と思った内容です。これから始める人にとって、回り道を圧縮するチェックリストとして使ってもらえれば幸いです。

ロードマップ的に学びたい場合はClaudeを学ぶ1週間ロードマップ、業務導入の段階的進め方は業務導入9ステップチェックリストを併読してください。