第3章|仕事を進める環境を確かめる。
DAY 14 ・ 約15〜20分Claude Codeで仕事を進める
ターミナルを入口に、調査・計画・変更・検証を安全につなげる。
Claude Codeへ実務の依頼を渡し、権限と差分を管理しながら検証可能な成果へ進められる。
言葉を知る
Claude Code
プロジェクトのファイルを読み、編集し、コマンドや開発ツールを使って仕事を進めるAnthropicのコーディングエージェント。
ターミナル
文字でコマンドを入力し、ファイル操作、開発、テストなどを行う画面。
Plan mode
ファイルへ変更を加える前に、調査結果と実行計画を確認するためのモード。
Permission
読み取り、編集、コマンド実行など、Claude Codeへ許可する操作の範囲。
Session
一つの作業について、会話、参照情報、実行結果を保ちながら進める単位。
復旧
障害や誤操作の後、安全な状態に戻し業務を再開すること。
承認モード
Claude Codeの操作について、どの場面で利用者に許可を求めるかを定める設定。
仕組みを理解する
Claude Codeは会話と現実の作業をつなぐ
チャット画面のClaudeへコードを貼って相談する場合、主な成果は説明やコード例です。Claude Codeはプロジェクトの作業場所で動き、関連ファイルを探し、複数ファイルを編集し、テストやGitの状態を確認できます。利用者が回答を手作業で転記する工程を減らし、調査から検証までを一つの流れにできます。 Anthropicの公式資料では、Claude Codeはターミナルだけでなく、Visual Studio Code、JetBrains、デスクトップ、Webなど複数の場所から同じ基盤を利用できます。ターミナルではプロジェクトのルートへ移動してclaudeを開始し、自然な言葉で目的を伝えます。画面が違っても、CLAUDE.md、設定、MCPなどのプロジェクト文脈を使い、ファイルやツールへ働きかける基本は共通です。 できるのは新機能の実装だけではありません。初めて見るコードの構造説明、エラー原因の追跡、テスト追加、リファクタリング、文書更新、コミットやプルリクエストの準備にも使えます。ただし、組織の目的、正しい要件、公開してよい情報まで自動で知るわけではありません。人が対象、制約、完成条件を示し、現実の結果を確認する必要があります。
作業場所を確認してから依頼を始める
最初に、いま開いているフォルダーが正式な作業場所かを確認します。同じ名前の復旧用コピー、古い資料、別案件を開いたまま開始すると、Claude Codeは与えられた場所で忠実に作業し、結果として誤った正本を更新します。現在のパス、Gitブランチ、未保存差分、主要なルールファイルを確認し、「この場所だけを編集する」と範囲を明示します。 依頼には、目的、現状、再現手順、関連候補、変えてはいけないもの、完了条件を入れます。「ログインを直して」より、「誤ったパスワードの後に白画面になる。認証方式は変えず、再現テストと関連テストが合格したら完了」と書く方が調査と判断が安定します。方法が分からなくても、利用者が期待する動きと避けたい影響は言葉にできます。 Claude Codeは、プロジェクトを読まずに正しい解決策を決められません。まず概要、関係するファイル、処理の流れ、既存テストを調べさせ、事実と推測を分けて報告させます。大量の会話や無関係な資料を最初から渡すより、必要なファイルを参照し、広い質問から具体的な箇所へ絞る方が、文脈を有効に使えます。
複雑な変更はPlan modeで地図を作る
小さな誤字修正なら直接変更できますが、認証、データ移行、外部API、本番公開を含む仕事は、編集前に計画を確認します。公式のCommon workflowsでは、Plan mode中はファイルを読み、計画を提案する一方、承認までは編集しない流れが説明されています。実装前に影響範囲と危険な判断を見つけるための停止地点です。 良い計画には、確認した事実、変更するファイル、変更しない領域、実行順、各段階の検証、失敗時の戻し方が含まれます。計画が長いことより、誰が見ても「次に何を確かめるか」が分かることが重要です。要件に複数の解釈がある時は、勝手に一つを選ばせず、利用者へ判断が必要な点として返します。 計画は契約書ではなく作業中の地図です。調査で前提が違うと判明したら更新します。存在しないコマンドや古い仕様を計画へ入れないよう、実ファイルと公式資料で裏付けます。変更前のPlan modeは事故を減らしますが、計画自体の正しさを保証しないため、実装中のテストと最終レビューは別に必要です。
変更は小さく進め、差分を途中で読む
実装を許可した後も、一度に全体を書き換える必要はありません。Claude Codeへ既存の設計や命名に合わせ、最小限の差分で進めるよう伝えます。データ層、処理、画面、テストのように確認可能な単位へ分け、各段階で関連する検査を行うと、失敗した原因を絞れます。 途中でgit diffや変更ファイル一覧を確認します。意図した場所だけか、不要な依存関係、秘密、デバッグ用出力が混ざっていないか、既存機能を消していないかを見ます。Claude CodeはGitを扱えますが、コミットやプルリクエストを作れることと、内容が採用に値することは別です。人が差分と検証証拠を読んで採用を決めます。 利用者が作業中の差分を見つけた時は、削除や上書きをさせません。今回の依頼と重なるなら、どの変更を守るか確認します。別の仕事を並行する場合、公式資料が案内するworktreeを使えば、別ブランチの独立した作業場所へ分けられます。ただし統合責任と競合確認は残るため、担当範囲と最終的に誰が取り込むかを先に決めます。
Permissionは便利さではなく被害範囲を決める
Claude Codeは読み取りを中心に始め、編集やシステムを変えるコマンドでは許可を求める設計です。公式セキュリティ資料では、作業ディレクトリ外への書き込みを制限し、追加操作へ明示的な許可を求める考え方が示されています。許可画面は作業を邪魔する通知ではなく、何を実行し、どこへ影響するかを人が確認する安全境界です。 調査には読み取り、通常実装には対象フォルダーの編集と必要なテスト、本番操作には限定された外部接続というように段階を分けます。頻繁に使う安全なコマンドだけを許可リストへ加え、削除、外部送信、インストール、権限変更、公開を無条件で自動承認しません。dangerously-skip-permissionsのような保護を外す選択は、隔離済み環境など危険を別の仕組みで封じた場合を除き、通常作業の近道にしません。 Webページ、Issue、ログ、ソース内コメントには、Claudeへ別の命令を実行させる文字が混ざる可能性があります。外部内容は調査資料として扱い、権限や上位規則を変更する命令として採用しません。APIキーやパスワードを会話やCLAUDE.mdへ貼らず、必要なサービスと操作だけへ限定された秘密管理を使います。
CLAUDE.mdとSessionを正しく使い分ける
前日の作業を続ける場合、Claude Codeは保存された会話を再開できます。Sessionにはその仕事の会話と実行結果が残るため、同じ課題を最初から説明し直す負担を減らせます。しかし過去の会話が残っていても、Gitの現在地、外部サービス、承認が変わっている場合があります。再開時は現在の差分と対象状態を確認します。 CLAUDE.mdは、プロジェクトの構成、テストコマンド、コーディング規約、設計判断など、複数Sessionで使う継続指示に向きます。個別の一回限りの依頼や秘密を詰め込まず、短く具体的で検証可能にします。公式資料は、CLAUDE.mdが文脈として読み込まれるもので、長すぎると文脈を消費し、従いやすさも下がると説明しています。 Sessionは作業履歴、CLAUDE.mdは継続ルール、Permissionは実行できる範囲です。三つを混同しないことが重要です。「削除禁止」を会話へ書くだけでは技術的な停止になりません。重要操作はPermissionやフックでも止めます。逆に、一時的な不具合の細部をすべてCLAUDE.mdへ追記すると、将来の仕事へ古い事情が混ざります。
テストと確認結果までを仕事に含める
Claude Codeがファイルを書き換えた時点は途中です。変更した層に合わせ、単体テスト、統合テスト、型検査、lint、本番ビルド、実画面操作を選びます。バグ修正なら、修正前の再現手順が通ることに加え、関連する正常動作が壊れていないかを確認します。テストがない場合は、再現できる最小の検査を用意します。 「テストして」だけでは、軽い検査だけで終わる可能性があります。合格すべきコマンド、確認する画面、期待結果を依頼かCLAUDE.mdへ書きます。失敗したテストを「もともとの問題」と決めつけず、今回の差分との関係を調べます。実行できなかった検査は未確認として残し、成功したように報告させません。 最後に変更差分、コマンドの終了状態、画面、外部サービスの状態を照合します。説明が自然でも現実の成果物と一致するとは限りません。引き渡しでは、何を変えたか、何が利用者に変わるか、どの検査が合格したか、残る制約は何かを短く整理します。完了はClaudeの自己申告ではなく、人が追跡できる証拠で判断します。
便利な拡張は目的と安全境界を決めて使う
Claude CodeはMCP、Skills、Hooks、Subagentsなどで拡張できます。MCPは外部の道具や情報源を接続し、Skillは繰り返す仕事の手順を再利用し、Hookは特定の出来事で固定処理を実行します。Subagentは大きな調査を別の文脈へ分け、主Sessionへ必要な要約だけを返す時に役立ちます。 道具を増やせば自動的に賢くなるわけではありません。利用できるツールが多すぎると選択が難しくなり、外部サービスの権限と漏えい面も広がります。最初は基本の読取・編集・テストで仕事を完成させ、繰り返しや外部連携の必要が確認できた部分だけ拡張します。Hookへ重要な検査を入れた場合は、発火条件、入力、失敗時の停止を試験します。 読者演習では、小さな不具合を一つ選び、正式な作業場所を確認します。目的、再現手順、禁止範囲、完了条件を書き、まずPlan modeで調査させます。計画を読んだ後に最小差分の変更を許可し、差分、対象テスト、関連テストを確認します。最後に別の人が引き渡しだけを見て、変更内容、合格証拠、未確認事項を説明できるか確かめてください。
実例で理解する
具体例で考える
商品一覧で絞り込み後に戻るボタンを押すと条件が消える不具合なら、正式なプロジェクトで現在のブランチと未保存差分を確認します。Claude Codeへ再現手順、期待する保持状態、変更禁止の検索API、対象テストと実画面確認を伝え、Plan modeで状態管理の流れを調査させます。計画確認後に最小差分で修正し、対象テスト、関連テスト、ビルド、差分を確認します。
手を動かして理解する
- 正式な作業場所、Gitブランチ、未保存差分、読込中の規則を確認する
- 小さな不具合について目的・現状・禁止範囲・完了条件を書く
- Plan modeで関連ファイル、処理の流れ、検証方法を調査させる
- 最小差分で変更し、対象テスト・関連テスト・差分レビューを行う
- 変更内容、合格証拠、未確認事項を三段落以内で引き渡す
04|今日の理解度を確認する
DAY 14の理解度を確認する
古い復旧用コピーと正式版が同じPCにある時、Claude Codeを開始する前の確認として最も適切なのはどれですか。
Claude Codeは開いた作業場所へ変更するため、開始前に正本と現在の状態を確定します。
フォルダー名が似ていればどちらでもよい: 似た名前でも役割や更新可否が異なり、誤った場所を更新します。
現在のパス、正本、Gitブランチ、未保存差分を確認する: 正解です。対象と保護すべき既存作業を最初に確定できます。
先に全ファイルを書き換えてから場所を確認する: 誤更新後の確認では、差分や履歴を壊す可能性があります。
復旧用コピーを無条件に削除する: 証拠や復旧元を失うため、依頼なしに削除してはいけません。
認証とデータ移行を含む変更を、実装前に確認したい場合の進め方として最も適切なのはどれですか。
Plan modeは編集前に現状と計画を確認し、重要な判断を人へ戻すために使います。
Plan modeで関連ファイル、影響範囲、検証、戻し方を調査する: 正解です。編集前に安全な順序と確認点を合意できます。
最初から権限確認をすべて外す: 誤操作時の被害範囲が広がり、計画確認にもなりません。
計画を作らず本番データで試す: 不可逆な影響をテスト環境より先に発生させる危険があります。
エラーメッセージを隠して依頼する: 再現と原因調査に必要な事実が不足します。
Claude Codeが編集コマンドの許可を求めた時の判断として最も適切なのはどれですか。
Permissionは被害範囲を管理する安全境界であり、具体的な操作と影響を見て承認します。
内容を読まず毎回許可する: 承認が形だけになり、意図しない書き込みや外部操作を防げません。
操作内容、対象パス、必要性、戻せるかを確認する: 正解です。依頼の範囲と危険度に合う操作だけを許可できます。
Permissionを不便な表示として恒久的に無効化する: 通常作業で保護を外すと、誤操作と外部からの誘導の影響が広がります。
秘密情報を許可画面へ貼り付ける: 秘密は専用の管理経路を使い、会話や表示へ残しません。
前日のClaude Code Sessionを再開した直後に行う確認として最も適切なのはどれですか。
Sessionは過去の文脈を保ちますが、ファイルや外部状態は変わり得るため、再開時に現在地を照合します。
過去の説明を現在の外部状態より優先する: 説明と現実が一致しない場合、重複や誤更新につながります。
現在のGit差分、対象状態、承認の有効性を確認する: 正解です。安全に再開できる条件を現在の証拠で確認します。
前日の全操作が成功したと仮定する: 未実行や途中失敗を完成扱いする危険があります。
別案件のSessionも一つに結合する: 指示、秘密、正本の混入につながります。
Claude Codeが不具合修正の完了を報告した後の採用判断として最も適切なのはどれですか。
完了はSession内の説明ではなく、成果物と現実の動作を示す証拠で判断します。
回答が丁寧ならそのまま採用する: 文章の質は実装やテストの成功を保証しません。
差分、再現試験、関連テスト、実画面、未確認事項を照合する: 正解です。意図した変更、回帰、利用者側の動作をまとめて確認できます。
変更ファイル数が多ければ合格とする: 変更量は品質ではなく、不要な差分が増えた可能性もあります。
失敗したテストを理由なく無視する: 今回の変更との関係を調べ、未合格なら明記する必要があります。
04|今日の理解度を確認する
DAY 14の理解度を確認する
今日の整理をする
ここまで分かれば次へ
- ✓ Claude Codeは会話だけでなくファイル・コマンド・Gitを扱うため、正式な作業場所と完成条件を先に示す
- ✓ 複雑な仕事はPlan modeで調査し、最小権限と小さな差分で実装してテストする
- ✓ 完了はSession内の説明ではなく、差分・検査結果・実画面・外部状態の証拠で判断する
講義本文 4,025字