Claude Codeは、会話(セッション)が変わると、前に注意したことを忘れます。私は、1人でClaude Codeを使い続けて、同じ指摘を何度もすることになりました。
そこで、次の3つを入れました。どれも、実際に起きた失敗が元です。
- 失敗を1つずつファイルに残す(メモリ)
- メッセージを送るたびに、確認事項を差し込む(フック)
- できなかった作業を、1つのファイルに集める(未実施タスク表)
何を、どう設定したか、そして、効いたかどうか、分かっていないことまで書きます。
前提
- Windows、Claude Code(デスクトップ版)。1つのプロジェクトのフォルダ(
lp)で、2026年9月から使っています - メモリのフォルダ(
~/.claude/projects/<プロジェクト>/memory/)には、59ファイルあります(2026-11-11時点。索引のMEMORY.mdが1つ、feedback_*が33、project_*が24、user_*が1) - 以下は、私の環境で見えたことです。Claude Codeのバージョンによって、動きが違う可能性があります
1. メモリ: 失敗を、1つずつファイルに残す
ルールは、1つだけです。失敗が起きたら、その場で、1失敗=1ファイルで残す。
実際のファイルを、1つ載せます(文は短くしています)。
---
name: feedback-no-auto-wakeup-claims
description: 「〇時間後に自動で再試行する」と言わない
metadata:
type: feedback
---
Zennの記事投稿が、24時間の間隔制限で保留された。
「24時間後に自動で再デプロイする」と伝えたが、実際には、
セッションが時間経過だけで動くことはなく、ユーザーが
「上がっていない」と指摘するまで、何も起きなかった。
**Why:** 「時間が来たら自動でやる」は、次にユーザーから
何か送られてこない限り、実行されない。
**How to apply:** 時間が経ってからのタスクを約束するときは、
(1)実際に自分を起こす仕組みを使うか、
(2)「時間が経ったら一言ください」と正直に書く。
ポイントは、Why(なぜ起きたか)とHow to apply(次にどうするか)を、必ず書くことです。ルールだけだと、Claude Codeが「どこまで当てはまるか」を、判断できないからです。
もう1つ、気をつけていることがあります。索引のMEMORY.mdは、1ファイル1行にしています。このファイルが、セッションの最初に読み込まれるためです(私の環境での観察)。いま、11,478バイトあります。増えるほど、毎回の読み込みが重くなると考えています(重さの測定は、していません)。
2. フック: メッセージを送るたびに、確認事項を差し込む
メモリを入れても、問題が起きました。
2026年11月7日、メモリに「憶測で答えない」を書いたその日に、自社製品の機能一覧を、仕様書を見ずに答えて、未実装の機能を混ぜました。メモリのファイルは、16:05に更新されています。その4分後の16:09に、次のフックのファイルを作りました(ファイルの更新時刻)。
~/.claude/settings.json:
{
"hooks": {
"UserPromptSubmit": [
{
"hooks": [
{
"type": "command",
"command": "cat \"$HOME/.claude/hooks/memory-reminder.json\""
}
]
}
]
}
}
~/.claude/hooks/memory-reminder.json(515バイト):
{
"hookSpecificOutput": {
"hookEventName": "UserPromptSubmit",
"additionalContext": "【毎回の確認】回答を書く前に: (1) MEMORY.md の索引から、この話題に関係するメモリファイルを開いて読む。(2) 事実・仕様・機能・数字・経緯は、資料・コード・検索で確かめてから書く。憶測で言い切らない。確かめられない部分は「未確認」と明記する。(3) 会話の最初の目的に照らして、聞かれたことに短く答える。"
}
}
メッセージを送るたびに、この文が、会話に追加されます(私の環境では、毎回、「UserPromptSubmit hook additional context」として入っているのを確認しています)。
メモリは、読むかどうかを、Claude Codeが決めます。フックは、毎回、同じ文を差し込みます。ここが違いです。
3. 未実施タスク表: できなかった作業を、1つのファイルに集める
2026年10月21日、ファイルの書き込みが、システム側の確認エラーで通らず、作業が止まりました。コードは変わっていませんでした。
そこで、未実施タスク.mdを作りました。決めたルールは、次の2つです。
- できなかった作業は、項目・対象ファイル・内容を、このファイルに書く。ほかのセッションで「できていない」と言われた分も、ここに集める
- 新しいセッションの最初に、このファイルを読み、未実施の項目を一覧にして、「実行してよいか」を確認してから進める
「時間が経てば、自動で再試行する」と約束しない、という1つ目のメモリ(上の例)と、セットで使っています。
効いたのか
数字では測っていません。 分かっている範囲を、書きます。
- フックを入れたあとも、間違いは、ゼロになっていません。2026年11月11日にも、Claude Codeが、時刻を確認せずに「いまは深夜です」と答え、公開データの時刻と食い違って、訂正しました
- フックは、リマインドで、強制ではありません。差し込まれた文を、Claude Codeがどう扱うかは、毎回、決まっているわけではありません
- 「同じ指摘を、何度もする」回数は、体感では減りました。ただし、回数は数えていません
向いていないこと
- 顧客の名前、パスワード、キーなどを、メモリに書くのは、避けたほうがよいと思います(私は、書かないようにしています)
- 失敗が、毎回、違うものなら、メモリは増えるだけです。同じ失敗が繰り返される場面で、効くと考えています
確かめていないこと
- 3点のうち、どれがいちばん効いたか
- メモリの数が増えたときの、読み込みの重さ
- 他の人の環境、他のバージョンでの動き
- フックの全仕様(公式ドキュメントで、確認してください)
まとめ
- 失敗を、1つずつ、Why/How to applyつきで残す
- 確認事項を、フックで、毎回差し込む
- できなかった作業は、1つのファイルに集めて、新しいセッションの最初に読む
この記事はZennにも投稿しています。