AI Agentと安全に仕事を進める — Claude Code実践
Claude Code のような AI エージェントに仕事を任せたいけれど、勝手にファイルを書き換えられるのは怖い。AI Agent は回答するだけでなく、許可された範囲でファイルを読み、編集し、コマンドを実行できます。便利さと影響範囲が同時に広がるため、任せ方と確認方法をセットで設計します。このレッスンでは、安全な依頼に必要な5項目と、調査・計画・実行・検証・承認の流れを身につけます。
学習目標
- チャット型AIとAI Agentの違いを、影響範囲の観点から説明できる
- AI Agentへ安全に依頼するための5項目を含む指示を作れる
- 変更前後の差分と検証結果を確認して、承認・修正を判断できる
チャット型AIとの違い
チャット型AIは、主に会話欄へ回答を返します。Claude CodeのようなAI Agentは、作業フォルダのファイルや開発ツールへアクセスし、複数の手順を進められます。
| 観点 | チャット型AI | AI Agent |
|---|---|---|
| 主な出力 | 回答、文章、案 | ファイル変更、コマンド結果、成果物 |
| 文脈 | 会話や添付資料 | 作業フォルダ、履歴、設定、ツール |
| 影響 | 画面内で完結しやすい | 実データや外部サービスへ及ぶ場合がある |
| 確認 | 内容レビュー | 内容、差分、実行結果、権限をレビュー |
AI Agentは「代わりに作業する人」に近いため、依頼者は作業場所と権限を意識する必要があります。
Claude Codeを始める前に
公式ドキュメントでは、現在はネイティブインストーラーが推奨されています。インストール方法は変わるため、教材のコマンドを暗記せず、実行時に公式手順を確認してください。
最新の手順:Claude Code 公式セットアップ
セットアップ後は、対象の作業フォルダへ移動してから起動します。
cd /path/to/project
claude
初回は、機密情報を含まない練習用フォルダで試します。業務データを扱う場合は、組織の利用ルール、契約、アクセス権を先に確認します。
安全な依頼に必要な5項目
- 目的:誰の、何を改善するか
- 対象:読んでよいファイル、変更してよい範囲
- 制約:触ってはいけない情報・機能、守る規約
- 完了条件:どの状態なら終わりか
- 検証:テスト、比較、レビューをどう行うか
このフォルダのREADMEを初心者向けに改善してください。
まず現状と関連ファイルを読み、変更案を3点以内で示してください。
対象はREADMEだけです。設定・コード・外部サービスは変更しないでください。
承認後に編集し、最後に差分とリンク切れの確認結果を示してください。
基本のワークフロー
1. 調査
現状、関連ファイル、既存ルール、未確認事項を読ませます。分からないことを推測で埋めないよう伝えます。
2. 計画
変更箇所、理由、影響、検証方法を先に示させます。大きな変更や外部への書き込みがある場合は、ここで人が確認します。
3. 実行
対象を限定して変更させます。不要な一括変更、秘密情報の表示、勝手な公開を許可しません。
4. 検証
テスト、画面確認、リンク確認、元資料との照合を行わせます。成功メッセージだけでなく、何を検査したかを確認します。
5. 人が承認
差分と検証結果を読み、目的を満たすか、関係ない変更がないか、元に戻せるかを判断します。
止めて確認する操作
次の操作は、対象と影響を確認してから進めます。
- ファイルや履歴の削除
- 外部サービスへの送信・公開
- 本番環境や顧客データの変更
- 課金、契約、権限変更
- 秘密情報や個人情報へのアクセス
- 大量のファイルを一括変更する処理
AIが実行できることと、実行してよいことは別です。権限があっても、依頼範囲を越える操作は承認しません。
非エンジニアにも使える応用
AI Agentの基本はコード以外でも同じです。
- 複数文書を読み、会議用の論点メモを作る
- CSVを整理し、検査結果と例外行を出す
- 既存資料からテンプレートへ転記する
- 手順書のリンクと表記を点検する
どの場合も「対象を限定する」「元データを残す」「結果を検証する」を守ります。
まとめ
- AI Agentはファイルやツールへ作用できるため、チャットより影響範囲が広い
- 依頼には目的・対象・制約・完了条件・検証を含める
- 基本は「調査 → 計画 → 実行 → 検証 → 人が承認」
- 実行可能な操作でも、依頼範囲と権限を越えてよいわけではない
- コード以外の文書・データ業務にも同じ設計を応用できる
出典・クレジット
本文の構成・図・演習は本教材のために作成。外部資料は現行の製品概要と導入方法の確認にのみ使用しています。
メールアドレスだけ・1分で登録できます。冒頭は登録なしで読めます。全文は無料登録(メールアドレスだけ)で全11回を読めます。
冒頭は登録なしで読めます。全文は無料登録(メールアドレスだけ)で全11回を読めます。