やりがちな失敗 20 選

コース構成

このコースで学ぶこと

1. 01

   セットアップで詰まる 5 つ

   最初の 1 日で必ず誰かが踏む地雷。ここで詰まるとモチベーションを失い、Claude Code を二度と触らなくなる人が一定数います。先に共有しておくだけで初日の落伍が激減します。

   • ❌ ターミナルを開かずに Claude.ai でやろうとする → Claude Code はターミナルツール。ブラウザではない
   • ❌ 個人アカウントでログインしてしまう → 社用 Pro/Max アカウントに切替
   • ❌ プロジェクトの外で起動してしまう → cd してから claude を起動。さもなくばホームディレクトリ全体が文脈に
   • ❌ 古い Node でインストール失敗 → ネイティブバイナリ版（v2.1.113+）を使う
   • ❌ Windows で Git for Windows がなくて起動失敗 → v2.1.119 から PowerShell でも OK

   理解度チェック

   1. Q1.プロジェクトのルートではなく、ホームディレクトリで `claude` を起動するとどうなる？

      A起動できない（エラーになる）Bホームディレクトリ全体が文脈になり、無関係なファイルまで読みに行きやすいC起動はするが必ず /tmp で作業するDセッションが自動でホームディレクトリだけにスコープされる

   2. Q2.初日にセットアップで詰まった人を救う最初のコマンドは？

      A`claude reset`B`claude doctor`（環境チェックを一括で実行）C`claude help`D`rm -rf ~/.claude`
   権限・セキュリティで事故る 5 つ
2. 02

   権限・セキュリティで事故る 5 つ

   「動いたから OK」では済まされない領域。本番ファイルの破壊や顧客情報の漏洩は、組織信用に直結する事故になります。最初に押さえれば 99% の事故が起きない 5 つを共有します。

   • ❌ いきなり Auto モードで本番リポジトリに突入 → まず plan モードで読み取り中心
   • ❌ deny ルールを書かない → `.env` `infra/prod/**` `rm -rf` は最初に deny
   • ❌ 顧客名簿をそのまま貼る → 個人特定情報は絶対 NG。集計値だけ渡す
   • ❌ API キーをプロンプトに書く → 環境変数 + MCP 経由で参照させる
   • ❌ git status を見ずに commit させる → 何をコミットするか必ず diff で確認してから

   機密情報の取り扱い（必修）

   理解度チェック

   1. Q1.API キーを Claude に渡したいとき、最も安全な方法は？

      Aプロンプト本文に直接貼り付けるBCLAUDE.md にコメントとして書いておくC環境変数に置き、MCP / 環境変数経由で参照させるDSlack DM 経由で Claude に送る

   2. Q2.本番リポジトリに初めて触るときの“事故が一番少ない”入り方は？

      Aいきなり Auto モードで全部任せるBplan モードで読み取り中心に始め、deny ルール（.env / infra/prod/** / rm -rf）を最初に入れるCメイン Claude のセッションで本番に SSH してから作業Ddeny ルールは不要、口頭で気をつける
   セットアップで詰まる 5 つコンテキスト管理で失敗する 5 つ
3. 03

   コンテキスト管理で失敗する 5 つ

   「Claude が急に忘れた」「動作が重くなった」「指示と違うことをやり始めた」の正体は、ほぼコンテキスト問題です。背景を理解すれば自分で対処でき、サポートに泣きつくこともなくなります。

   • ❌ CLAUDE.md に 500 行書く → 200 行以内に削る。長いものは Skill へ
   • ❌ MCP を全部繋ぐ → 使うものだけ。`/mcp` でトークンコスト確認
   • ❌ 同じ作業を 1 セッションで延々続ける → `/compact` で定期圧縮、まとまったら `/clear`
   • ❌ 重い検索をメインで走らせる → Explore サブエージェントに投げる
   • ❌ ファイルを丸ごと貼り付ける → Claude に Read させればいい。コピペ不要

   Lv.2 — コア概念

   理解度チェック

   1. Q1.「Claude が急に指示と違う動きをし始めた」典型的な原因は？

      AAI モデルが古くなったからBコンテキストが膨らみすぎて、初期指示が薄まっているからCネットワークが不安定だからDAPI キーが期限切れだから

   2. Q2.CLAUDE.md を 500 行書いてしまった人へのアドバイスとして正しいのは？

      Aそのままで OK。長いほど精度が上がるB200 行以内に削り、それ以外は Skill（必要なときだけ呼ばれる）に逃がすCファイル名を CLAUDE_BIG.md に変更DClaude のモデルを Opus に変更すれば 500 行でも対応可能
   権限・セキュリティで事故る 5 つ運用で詰まる 5 つ
4. 04

   運用で詰まる 5 つ

   1 ヶ月使ううちに必ず気づく『もっと早く知りたかった』系。これらは知っているだけで日々の作業時間が確実に減ります。新規導入のチームには初日に共有するのがおすすめ。

   • ❌ 同じプロンプトを 3 回打つ → 3 回目で Skill 化のサイン
   • ❌ 1 セッションで何時間も粘る → コンパクション thrash で詰まる。fork して分割
   • ❌ Esc を知らない → Esc 1 回で割り込み、Esc 2 回でチェックポイント巻き戻し
   • ❌ /context を見ずに「重い」と諦める → 内訳が見えれば対処法が分かる
   • ❌ 失敗したらすぐ叩き直す → 一度コンテキストごとリセット（/clear → 新規）の方が早いことが多い

   理解度チェック

   1. Q1.同じプロンプトを 3 回打ったとき、最も生産的な次のアクションは？

      Aもう少し改善するまで打ち続けるBプロンプトを長くして精度を上げるCSkill 化して `/skill-name` 一発で呼べる状態にするDAI モデルを変えてみる

   2. Q2.Esc キーの“1 回押し”と“2 回押し”の違いは？

      Aどちらもセッション終了B1 回 = 走っている処理を割り込み停止、2 回 = チェックポイントまで巻き戻しC1 回 = 何もしない、2 回 = セッション保存D1 回 = 設定画面、2 回 = ヘルプ
   コンテキスト管理で失敗する 5 つ次の一歩：自分の失敗集を作る
5. 05

   次の一歩：自分の失敗集を作る

   ここに無い『あなた特有の失敗』が必ず出てくる。記録し、チームで共有すれば、20 件のリストが組織の知恵になる。新人オンボーディングの最強の教材にもなる。

   失敗は『誰かが踏んでくれた地雷』として最も価値が高い。ただし共有されなければ全員が同じ穴に落ちる。社内 Notion か docs/lessons-learned.md に蓄積する場所を 1 つ作るのが起点になる。

   markdown

   # 弊社版・やりがちな失敗
   
   ## 1. CLAUDE.md に書き忘れた“触らないファイル”
   - 状況: customers/ を直接編集してしまった
   - 原因: CLAUDE.md に未記載
   - 対策: NEVER セクションに追記、deny ルール追加
   - 報告者: @yamada (2026-04-12)
   
   ## 2. テスト DB ではなく本番 DB に migration を流した
   - 状況: ...
   - 原因: ...
   - 対策: ...

   手を動かす

   0 / 5

   • 社内 Notion / Confluence / docs/ に『失敗集』ページを 1 つ作る
   • 1 ヶ月使った後、自分が踏んだミス TOP 5 をメモ
   • テンプレ（状況・原因・対策・報告者）に沿ってチームに共有
   • 月次振り返り会で 5 分だけ『今月の失敗 3 件』を読み上げる
   • 再発防止策を CLAUDE.md か Skill にも反映

   理解度チェック

   1. Q1.「失敗集」を運用する一番の目的は？

      A原因を作った人を特定して反省させるB個人で同じミスを繰り返さないため、自分用メモを作るC誰かが踏んだ地雷を共有し、組織全体が学ぶためD監査時に責任の所在を示すため
   運用で詰まる 5 つ