跳到正文
gihyo.jp·· 12 天前AI 評分68

Claude Code 如何保存 AI 記憶並提升產出品質

Claude CodeでAIの記憶を永続的にして、成果物のクオリティをアップさせよう

AI 導讀

在 Claude Code 工作流程中,使用者可用 CLAUDE.md、handoff.md 和 decisions.md 保存規則、交接及決策,供新工作階段讀取。文章亦示範以虛構表格建立 Python 遮蔽工具,再用 .bat 在不經 AI 的情況下處理實際資料;是否可交予 AI,須由人按工作場所規則及客戶合約判斷。

正文

第2回で作った催促ツールは、翌週も、翌月も動き続けます。ところが、作った本人がClaude Codeに次の指示を出すとき、Claude Codeは新しい文脈で始まります。前回の会話は引き継がれません。

Claude Codeには自動で書き残すメモの仕組みもありますが、先週「メールは送らない」と決めたことを確実に、人が読める形で次のセッションに渡すには、人がファイルに書いておく必要があります。

AIは毎回、新しい文脈で始まるのが前提です。この前提を忘れると、同じ指示を毎回ゼロから書くことになり、前に決めたことと違う答えが返ってきて、品質がぶれます。

今回は、人の注意力だけに頼らず、仕組みで「記憶」と「守り」を持たせます。全体のルール・引き継ぎ・判断の記録の3つのファイルと、帳票の情報をAIに渡す前に伏せる黒塗りツールを作り、後半で、筆者がなぜこの構成にしたのかを説明します。

1|テンプレート3本と黒塗りツールを作ってみよう

この回で作るもの⁠・前提⁠・所要時間

作るもの
全体のCLAUDE.md・引き継ぎファイル・判断の記録のテンプレート3本(第2回で作ったプロジェクトのCLAUDE.mdは、その下で使います⁠)⁠。それと、ダミーの帳票で動かす黒塗りツール(Pythonのスクリプトと、ダブルクリックで動かすバッチファイル)
前提
Claude Codeのデスクトップ版。第2回の作業フォルダがあればそのまま使えます(画面は2026年10月時点のもの)
所要時間
約45分(Claudeの生成を待つ時間は正味25分ほど。承認を求められる回数が多いので、全体では1時間以上かかることもあります)
使うデータ
すべて架空。黒塗りツールの試験にはダミーの帳票(表1)を使います

全体のフォルダ「仕事」に、全体のルール(CLAUDE.md⁠)⁠・引き継ぎ(handoff.md⁠)⁠・判断の記録(decisions.md)の3つのファイルを置き、その下に第2回の催促ツールと、今回作る黒塗りツールのフォルダを置きます。作業を始めるときは、プリフライト(作業前の点検のこと。詳しくは後程説明します)で引き継ぎと判断の記録を読み、終わりに更新します。実データは、AIを介さず黒塗りツールで伏せ、送ってよいかを人が判断してからAIに渡します。

手順1 ルールの階層を作る

第2回の作業フォルダの一つ上に、全体のフォルダ「仕事」を作り、その下に第2回の「催促ツール」フォルダを移します(第2回で登録したタスクの作業フォルダも直します⁠)⁠。Claude Codeでは、第2回と同じ「環境を選択⁠」⁠→「⁠新しい環境」から、名前を「仕事⁠」⁠、フォルダを全体のフォルダにして環境を作り、ここで作業を始めます。承認モードは「手動」にしておきます。

入力欄に「このフォルダにCLAUDE.mdを作ってください。中身は次のとおりです。」と入力し、続けて次を貼り付けます。

# 全体のルール
このフォルダの下にあるすべてのプロジェクトに適用する。各プロジェクトの CLAUDE.md は、ここに反しない範囲で決まりごとを足せる。
## やってはいけないこと
- お客様の実データを、伏せずに AI に渡す
- メール・チャットなど外部への送信
- 課金が発生する操作(有料 API の実行など)
- 元ファイルの上書き・削除
## 必ず確認してから進めること
- ファイルの削除・移動・名前の変更
- 複数のファイルを一度に書き換える処理
- 新しい道具やライブラリの導入
## セッションの始め方・終わり方
- 「プリフライト」と言われたら、§始め方 のとおり報告する
- 「終了処理」と言われたら、§終わり方 のとおり引き継ぎを書く

書き込みの承認を「一度だけ許可」で通すと、CLAUDE.mdができます。このときClaude Codeは、「⁠『⁠§始め方』『⁠§終わり方』の節がまだないので、『⁠プリフライト』と言われても何を報告すればよいかが決まっていない」と指摘し、書き足すかを聞いてきました。決まりごとの抜けを、AIの側から見つけたわけです。次の手順で書き足します。

図1 全体のフォルダに置いたCLAUDE.md。右のファイル欄に、全体のCLAUDE.mdと催促ツール フォルダのCLAUDE.mdが階層で並ぶ

手順2 始め方と終わり方を決める

「CLAUDE.mdの最後に、次の2節を書き足してください。」と入力し、続けて次を貼り付けます。

## 始め方(プリフライト)
次の4つを、この順で報告する。
1. いまどこにいるか:作業フォルダ名、前回の終了日時
2. 前回からの引き継ぎ:handoff.md の「次にやること」を読み上げる
3. いま危ないもの:未完了の作業、承認待ちの操作、期限が近いもの
4. 今日の最初の一手:引き継ぎから読み取った最優先の作業
## 終わり方(終了処理)
1. 今日変更したファイルを一覧にする
2. handoff.md を更新する:到達点、次にやること、未解決のこと、今日わかったこと
3. 方針として残す判断があれば decisions.md に D-番号で追記する

書き終えたら、試してみます。「⁠新規作成」で新しいセッションを開き、入力欄に「プリフライト」とだけ入力します。

Claude Codeは、まず「handoff.mdもdecisions.mdも、このフォルダのどこにもありません」と伝え、続けて4項目を報告します。初回なので、引き継ぎは「まだ無い」となります。

図2 1回目のプリフライト。引き継ぎが無いことを最初に伝え、「いまどこにいるか」から順に報告している

ここでは、守りの決まりごとに沿った振る舞いも見られました。催促ツールのフォルダにある確認一覧やメールの下書きについて、「⁠お客様のデータが入っているかもしれないので、中身は開いていません」と報告し、読んでよいかを聞いてきました。

次に、「⁠終了処理」と入力します。Claude Codeは今日変更したファイルを確かめ、handoff.mdを作って、到達点・次にやること・未解決のこと・今日わかったことを書きます。

図3 終了処理で作られたhandoff.md。前回の終了・到達点・次にやること・未解決のこと・今日わかったこと、の節が並ぶ

もう一度新しいセッションを開き、「⁠プリフライト」と入力すると、今度はhandoff.mdを読み、「⁠前回の終了は(handoff.mdより)この日時です」と確かめたうえで、「⁠次にやること」を読み上げます。これが「記憶を持たせる」の実体です。

図4 2回目のプリフライトで、前回の引き継ぎを読み上げている画面

手順3 判断を記録する

全体のフォルダにdecisions.mdを作ります。「⁠このフォルダにdecisions.mdを作ってください。中身は次のとおりです。」と入力し、続けて次を貼り付けます。

# 判断の記録
| 番号 | 日付 | 題 | 状態 |
|---|---|---|---|
| D-001 | 2026-11-03 | 催促メールは下書きまで。送信は人が行う | 有効 |
| D-002 | 2026-11-03 | 期限前と期限超過で文面を変える | 有効 |
## D-001 催促メールは下書きまで。送信は人が行う
決めた理由:送信の誤りは取り返しがつかない。下書きの確認に1分かけるほうが安い。
## D-002 期限前と期限超過で文面を変える
決めた理由:期限前の相手に強い文面を送ると、関係を損ねる。

続けて、「⁠D-003として、『⁠元ファイルは読むだけ。書き換えない』を追記してください。」と指示すると、一覧表と本文の両方に足してくれます。理由を伝えなかったので、Claude Codeは理由の欄を「⁠(⁠未記入⁠)⁠」とし、「⁠私が考えて書くことはせず」と断ったうえで、どう書くかを聞いてきました。

図5 decisions.md。D-001〜D-003の一覧表と、番号ごとの本文

試しに、過去の決定と食い違う指示を出してみます。「⁠催促メールを自動で送るようにしてください。」と入力します。

Claude Codeは、「⁠催促メールの自動送信は、このままでは作れません。今のルールと判断の記録に反するためです」と答えました。根拠として、全体のCLAUDE.mdの「外部への送信⁠」⁠、催促ツールのCLAUDE.mdの「メールは送らない⁠」⁠、decisions.mdのD-001の3つを挙げ、ルールを変える手順と、ルールの範囲でできる代わりの案を示して、どちらにするかを聞いてきます。

図6 過去の決定との食い違いをClaude Codeが指摘した画面。D-001と2つのCLAUDE.mdを根拠に挙げている

ここで止まったのは、決まりごとと判断が「フォルダの中のファイル」に書いてあり、Claude Codeが毎回それを読むからです。ただし、書いてあれば必ず止まる、という保証ではありません。確実に止めたい操作は、承認モードと二重にしておきます。

判断の記録は、使い続けるとすぐに肥大化します。筆者は、月に1回など定期的に、終わった判断や一度きりの判断を圧縮して「過去」フォルダに移し、decisions.mdには、いま有効な判断の一覧と要点だけを残しています。仕分けはClaude Codeに指示でき、消えて困る理由がないかを人が確かめてから承認します。引き継ぎのhandoff.mdは毎回上書きなので肥大化しません。

手順4 黒塗りツールを作る

最後に、守りの道具です。黒塗りツールはClaude Codeに作らせますが、できあがるのはPythonのスクリプトで、動かすときにAIは介在しません。全体のフォルダの下に「黒塗り」フォルダを作り、ダミーの帳票を置きます。

表1 ダミーの帳票(架空。この形のExcelを「帳票.xlsx」として作る)
氏名 住所 電話番号 金額 備考
山田 太郎 東京都〇〇区1-2-3 03-0000-0000 1,250,000 10月分
佐藤 花子 大阪府〇〇市4-5-6 06-0000-0000 880,000 10月分(分割)

Claude Codeに指示します。

黒塗り フォルダの帳票.xlsx を読み、氏名・住所・電話番号・金額を伏せ字にした「帳票_黒塗り.xlsx」を作るツールを作ってください。氏名は「氏名A」「⁠氏名B⁠」⁠、住所は都道府県だけ残す、電話番号は全部「***⁠」⁠、金額は「約●●万円」に丸めてください。元ファイルは書き換えないでください。作る前に計画を見せてください。

ここでもClaude Codeは、守りの決まりごとに沿って動きました。帳票が実データかどうかわからないので、「⁠セルの値は出さずに、形だけを調べました」と報告し、列の見出しとデータの種類だけを確かめてから、伏せ方の表を計画として出します。指示に無かった「備考」列は、扱いを提案したうえで確認を求めてきました。計画を読んで、「⁠この計画で作る」を押します。

できあがったあと、Claude Codeは自分で「3行目の備考のかっこが半角になっている」と不具合に気づき、出力した黒塗り版を消して作り直してよいかを聞いてきました。ファイルの削除は、全体のルールで「必ず確認してから進めること」に入れてあります。

図7 元の帳票と黒塗り後の帳票(2つの画面を並べた合成。すべて架空データ)。氏名は氏名A・氏名B、住所は都道府県だけ、電話番号は「***」、金額は「約125万円」「約88万円」に

黒塗り後の帳票を見て、伏せ方が足りているかを確かめます。伏せても、金額や日付の組み合わせから相手が推測できることはあるので、「⁠これで送ってよいか」は、お勤め先のルールとお客様との契約に照らして人が決めます。元の帳票は、作業の前後で変わっていません。

動かすときはAIを介さない。 できあがった黒塗りツールはClaude Codeからも動かせますが、実データを扱うときはそうしません。Claude Codeは、動かしたスクリプトの出力を読むからです。ダブルクリックで動かせるようにしておきます。

黒塗り フォルダに、ダブルクリックで 黒塗り.py を動かす「黒塗り.bat」を作ってください。Claude Codeを介さず、Explorerから直接実行するためのものです。作る前に中身を見せてください。

Claude Codeは、置き場所と .bat の中身を見せ、「⁠黒塗り.pyは元の帳票.xlsxを読むだけで書き換えません。伏せる前の値も画面に出しません」と説明してから、作ってよいかを聞いてきます。

図8 Claude Codeが見せた 黒塗り.bat の案。置き場所と中身が並ぶ

筆者の環境では、ここでClaude Codeが自分のミスを報告してきました。確認のために .bat を1回動かして新しい 帳票_黒塗り.xlsx を作ってしまった、実行前にフォルダの状態を見直していなかった、というものです。元の帳票が変わっていないことを確かめ、できたファイルを残すか消すかを聞いてきました。

このようにAIは間違えます。間違えたときに報告する振る舞いを、決まりごとと承認の仕組みが引き出しています。

ここからはClaude Codeに触りません。Explorerで黒塗りフォルダを開き、黒塗り.batをダブルクリックします。黒い窓が開き、伏せた件数と「終わりました」が出て、同じフォルダに 帳票_黒塗り.xlsx ができています。

図9 Explorerから黒塗り.batをダブルクリックして動かしたところ。伏せた件数の報告だけが出て、伏せる前の値は画面に出ない

この手順にAIは関わっていません。動いているのはPythonのスクリプトだけで、伏せる前の値は画面にもAIにも出ていません。作るときにClaude Codeが見たのは、ダミーの帳票だけです。第2回で書いた「作るときの頭脳と、動かすときの配管を分ける」が、ここでは守りの理由になります。

実データを扱うときは、この .batで伏せ、送ってよいかを確かめてからAIに渡します。

ここまでで約45分です。

注意点

今回作った仕組みは、すべて「フォルダの中のファイル」です。Claude Codeの設定でも、クラウドの機能でもありません。中身はMarkdownなので持ち運べますが、自動で読み込まれる仕組みや置き場所は、環境に合わせて直します。

一方で、ファイルである以上、消えれば記憶も消えます。上位ルール・引き継ぎ・判断の記録は、必ずバックアップの対象に入れてください。

2|なぜ⁠、仕組みで持たせるのか知ろう

記憶は仕組みで持たせる

Claude Codeを使い始めて最初に困るのは、「⁠前に決めたことを、もう一度説明している自分」に気づくことです。資料の書き方の決まりや使ってはいけない表現、確認してから進めてほしい操作といったことを毎回のセッションで書き、書き忘れた日は違う結果が返ってきます。

解決したのは、3つの仕組みです。

ルールの階層
上位ルールには「やってはいけないこと」「⁠必ず確認してから進めること」を書き、プロジェクトのCLAUDE.mdには、そのプロジェクト固有の要件を書きます。第2回で書いたCLAUDE.mdは、この下の階層にあたります。
始め方と終わり方
プリフライトは、飛行機の離陸前点検と同じで、毎回同じ項目を同じ順で確かめます。終了処理では、到達点と次にやることを引き継ぎファイルに書かせます。次のプリフライトは、この引き継ぎを読むところから始まります。
判断の記録
「なぜそう決めたか」を、番号付きで1か所に残します。Claude Codeは、新しい指示が過去の決定と食い違うとき、この記録を根拠に「前回はこう決めています」と言えるようになります。記録は定期的に圧縮し、有効な判断だけを残します。

この3つに共通するのは、記憶を「フォルダの中のファイル」に置くことです。ファイルなら、AIが毎回読めるだけでなく、人や別のAIにも読ませられます。

3|守りも仕組みで行おう

記憶と同じ理屈で、守りも仕組みにします。

データを入力する前に伏せる

第1回で書いた「入れてはいけない情報」を、そのまま渡さないための手順です。個人情報の入った帳票をAIに渡す前に、氏名・金額・住所を伏せ字にします。人の注意力だけでやると見落とすので、ダミーの帳票で黒塗りツールを先に作り、実データはそのツールを通し、送ってよいかを確かめてからAIに渡します。ツールを作るのはAIですが、動かすときにAIは介在しません。

契約ごとに扱いを決める

お客様ごとに、「⁠どのAIに、どこまで渡してよいか」を決めて記録しておきます。この区別は、お客様との契約と、お勤め先のルールで決まるので、AIには判断させません。

危険な操作は、禁止と確認に分ける

外部への送信、課金が発生する操作、元ファイルの上書き・削除は、上位ルールの「やってはいけないこと」に書きます。作業用ファイルの削除・移動や一括の書き換えは「必ず確認してから進めること」に書き、承認モードの確認画面でも内容を確かめます。CLAUDE.mdだけで操作を強制的に止められるわけではないので、二重にしておきます。

これらは、チームで使うときの話に聞こえるかもしれません。筆者は一人で使っていますが、同じ仕組みが要りました。「⁠昨日の自分」と「今日の自分」は、AIから見れば別の人だからです。

結び

AIは毎回、新しい文脈で始まります。だから、記憶も守りも、フォルダの中のファイルに置きます。

今回作った、上位ルールとCLAUDE.md、プリフライトと終了処理、判断の記録、黒塗りツールの4つは、書籍の第10章のCLAUDE.md・仕組みの守り・オートモードの節(Sec.114〜116)と、第1章の情報の3分類(Sec.07)を、一人の作業環境に落とし込んだものです。チームで使うときは、このひな形を土台に、置き場所や権限、承認の運用を環境に合わせて整えます。

次回は連載の最終回です。Claude Codeを安全に使い続けるための環境設定を行います。エンジニアの作法のどこをまねし、どこをまねしないかも整理します。

來源:gihyo.jp · gihyo.jp