Claude Codeが止まったら?8つの視点で原因を調べる確認帳

1.この教材でできるようになること

読む前 「動かない」としか説明できずにいる。

読み終えたら 止まった場所と次に確かめる1操作を相談メモに書ける。

最初に試すこと:手元の症状を1つ選び、観察と推定を分けて書く。

用意するもの 今回の内容
練習の題材 貸出メモを使う8つの症状
最後に残すもの 症状の記録/次の確認/再試行後の結果
基本の順番 症状を選ぶ→最後の成功を残す→1条件だけ試す→結果を記録

練習素材の受け取り方

12教材の素材一覧を開くから「shiftai-agent-bonus-12-complete.zip」を受け取ります。

ZIPは複数の資料を1つにまとめた包みです。PCで開いて中身を取り出すことを「展開」と呼びます。

展開後、assets/training/CC04-training.zipを開き、CC04フォルダを取り出してください。この教材で使う主な素材は CC04/simulated-cases.txt と CC04/consultation-template.txt です。教材の名前と同じ記号のZIPを使えば、別教材の資料と混ざりません。

用語|フォルダ ファイルをまとめる入れ物。例えば、国語と算数のプリントを別の箱へ分けるように使います

受け取り後は練習フォルダ内のREADMEを開きます。READMEは、その一式をどう使うかを書いた入口の説明書です。素材一覧で受け取ったものと、この教材のファイル名が合っているか確かめてから始めます。

用語|ファイル PCに保存する1つのまとまり。例えば、作文1枚や写真1枚に当たります

読む順番

初回は「2.基本を理解する」→「3.操作して確かめる」→「4.追加練習」→「6.最終確認」の順で進みます。「5.応用」は基本の練習を終えてから選んで使えます。

長い説明を一度に覚える必要はありません。使う資料を1つ開き、1つ頼み、返ったものを1つ確かめるところまでを最初の区切りにしてください。

2.基本を理解する

この教材でできること

「動かない」を、次に確認できる問いへ変えます。完成物は、自分の状況を1枚に記録した相談ノートです。8ケースのカードから近いものを選び、直前の操作、表示、保存状態を整理します。

この教材は、全てのエラーを解決する修復コマンド集ではありません。表示文は環境によって異なります。説明のための模擬例を、実際に出たエラーログと混同しないでください。闇雲な再実行や権限変更をする前に、状態を絞ります。

用語|コマンド PCやアプリへ文字で伝える命令です。「この場所のファイル一覧を見せて」と短い決まった書き方で頼みます。

用語|エラー 処理を進められなかったことを伝える表示です。「資料が見つかりません」のような、つまずいた場所を知らせるメモです。

用語|権限 どの操作をしてよいかの決まり。例えば、図書室の本を読むことと、貸出簿を書き換えることは別の許可です

用語|ログ 行った操作や起きたことの記録です。いつ何をしたかを書いた作業日誌に当たります。