
Claude Codeの作業記録の残し方、納品と説明のために──「AIがやりました」で終わらせない作業記録票、Gitのコミット、会話の書き出しの型
この記事は、Claude Codeで作業した内容の記録を、納品と取引先への説明のために残す方法を扱います。
「この変更、誰がどう確認したんですか」
納品から2か月後、取引先から不具合の連絡が来ます。
原因を調べると、Claude Codeで直した箇所でした。
「どんな指示で、どこを変えて、誰が確認したのか」を聞かれても、答えられない。
当時の担当者の記憶にしかなく、会話の画面も、もう残っていない。
AIで作業が速くなるほど、何をしたかの記録は薄くなります。記録がないと、説明も、原因の調査も、次の見積もりもできません。
Claude Codeの作業記録とは、指示・変更・人の確認の3つを、AIの画面の外に、案件の番号で残すことである
黒字化の外科医です。Claude Codeの作業記録の残し方を解剖します。
なお私は弁護士ではありません。実務の指針として読み、個別の判断は専門家や公的な窓口に確認してください。
画面の外に残すべき理由は、三つあります。
第一に、手元の記録は、いずれ消えるから。
公式ドキュメントによると、セッションのファイルのスナップショットは、既定ではおよそ30日後に自動で削除され、期間は cleanupPeriodDays という設定で変えられます(code.claude.com「Checkpointing」、2026年10月27日確認)。納品の説明に使う記録を、手元の履歴に頼るのは危険です。
第二に、チェックポイントは、記録の代わりにならないから。
同じ公式ドキュメントでは、チェックポイントはセッションの中で素早く戻すためのもので、恒久的な履歴にはGitなどのバージョン管理を使うよう書かれています(同上)。
第三に、取引先が知りたいのは、AIの会話ではなく「人が何を確かめたか」だから。
長い会話をそのまま渡されても、取引先は読めません。必要なのは、変更の中身と、確認した人と、確認の結果です。
今すぐ試せる:作業記録票を下書きするプロンプト
Claude Codeの作業が終わったところで、同じセッションの中で頼みます。
今回のセッションで行った作業を、作業記録票の形でまとめてください。
【案件番号】〔 〕
【依頼の内容(取引先からの依頼)】〔 〕
1. 依頼に対して、行った作業を3〜5行で書く。
2. 変更したファイルの一覧と、それぞれの変更の目的を書く。
3. 実行したテストやコマンドと、その結果を書く。
4. まだ確認できていないこと、人が判断すべきことを書く。
推測で書かず、このセッションで実際に行ったことだけを書くこと。出てきた下書きは、そのまま使わず、担当者が読んで直します。最後の「人が判断すべきこと」を、確認した人が埋めて完成です。
作業記録工場:残す3つの場所と型
1. 作業記録票(案件の台帳に残す)
【作業記録票】
案件番号:〔 〕 作業日:〔 〕
依頼:〔取引先の依頼の要約〕
作業者:〔名前〕 使ったツール:Claude Code
指示の要点:〔AIに渡した指示を2〜3行で〕
変更したファイル:〔一覧〕
テストと結果:〔実行したテスト、目で確認したページ〕
人の確認:〔確認した人〕〔確認した日〕〔結果:OK/要修正〕
未確認・残りの課題:〔 〕
コミット:〔Gitのコミットの識別子〕2. Gitのコミット(変更そのものを残す)
コミットのメッセージの型:
〔案件番号〕〔何を、なぜ変えたか〕
例:
A-2410 お問い合わせフォームの送信後の画面で、二重送信を防ぐ
(Claude Codeで修正、山田がレビュー、テスト環境で確認済み)コミットを細かく分けておけば、問題が起きたときに、どの変更が原因かを特定しやすくなります。
3. 会話の書き出し(必要なときだけ)
公式ドキュメントでは、/export というコマンドで、今の会話をテキストとして書き出せると説明されています(code.claude.com「Commands」、2026年10月27日確認)。
全部の作業で残す必要はありません。取引先の情報を扱った作業、本番に関わる作業、判断が分かれた作業だけ、案件のフォルダに保存します。
記録にかかる時間(数字は例)
作業記録票 1件:10分
月の作業:20件
20件 × 10分 = 200分(約3時間20分)検算:200分 ÷ 60 = 3.33…時間、つまり約3時間20分です。この時間は、保守や開発の見積もりに、作業の一部として入れておきます。
構造的なリスク
逆説を指摘しておきます。
記録を細かくしすぎると、誰も書かなくなります。
最初は「人の確認」の欄だけを必ず埋める、と決めてください。誰が確かめたかが残っていれば、他の欄は後から復元できることが多いのです。
また、会話の書き出しには、取引先の情報が含まれることがあります。保存する場所と、残す期間を、社内のルールで決めてください。
▶ 生成AIの社内ルールがない制作会社は、納品物を説明できない──入力禁止の情報、お客様への説明と同意、成果物の確認責任、著作権の基本
よくあるQ&A
Q. 記録は、取引先に渡すべきか?
全部を渡す必要はありません。納品の報告書には、変更の一覧と確認の結果を載せ、作業記録票は社内に残します。納品報告の型は、こちらにあります。
Q. 小さな修正まで記録するのか?
案件番号とコミットだけは、必ず残します。作業記録票は、本番に関わる変更から始めてください。
Q. 記録がないことで、責任を問われることはあるか?
記録の有無で責任が決まるわけではありませんが、説明できないことは、信頼を大きく損ないます。責任の考え方は、こちらで整理しています。
▶ AI生成コードの責任は誰が持つか──「AIが書いたので」は通らない。契約不適合責任・検収・保証範囲で、制作会社が負う責任の線を先に引く
最後に
Claude Codeの作業記録は、AIの会話を残すことではなく、指示・変更・人の確認を、案件の番号で残すことです。
導入支援で、お客様にこの記録の型を渡すメニューも、こちらにまとめています。
▶ Claude Code導入支援サービス設計キット──診断・初期設定・研修・伴走のメニューと料金表、提案書の構成、設定の雛形、契約の確認点
AIの画面の外に記録を残した会社だけが、半年後の不具合にも、次の見積もりにも、根拠をもって答えられるのです。
これまでの記事は、メンバーシップ「黒字化オペ室」でまとめて読めます。月額1,980円、記事2本分の金額です。詳しくはプロフィールから。
#Web制作会社 #ClaudeCode #作業記録 #納品 #品質管理 #Git #制作会社経営 #中小企業 #AI駆動開発 #説明責任