読み終えるとできること
道具で何も調べていないのに「入っていません」「できません」と言い切る返事を、Stop フックで差し戻せるようになります。
根拠は、2026-11-18 に偽の会話記録を作って6通りを実行した結果です(下の「動かした結果」)。
何に困ったか
Claude Code が、ファイルや保存先を1つも開かずに「その資料は手元にありません」「ここでは使えません」と答えることがありました。
確かめずに答えて外したことが、同じ会話で3回続きました。
そこで CLAUDE.md に「ないと言う前に調べる」と書くのに加えて、最後の発言のあとに道具を1回も呼んでいないのに否定の言い切りがある返事を、Stop フックで差し戻すことにしました。
仕組み
Stop フックは、Claude Code が返事を終えて止まろうとしたときに動きます。標準入力に transcript_path(会話の記録ファイル)と session_id が JSON で渡され、{"decision": "block", "reason": "..."} を標準出力に出すと、止まらずに reason が Claude に戻ります。
判定は4つです。
- 直近のユーザー発言のあとに、調べる道具(Read・Grep・Bash など)を1回でも呼んだか
- 呼んでいなければ、返事に「できません」「ありません」「入っていない」などの否定の言い切りがあるか
- 「確かめていないが」という断りが入っていないか
- 同じ発言への差し戻しが2回に達していないか(達したら通す)
「調べたことにならない道具」は別に数えます。タスク表の更新・ToolSearch・通知・Write・Edit だけを呼んでも、調べたとは見なしません。
設定: settings.json
{
"hooks": {
"Stop": [
{
"hooks": [
{
"type": "command",
"command": "python3 ~/.claude/hooks/verify-before-no-stop.py",
"timeout": 10
}
]
}
]
}
}
スクリプト: verify-before-no-stop.py(要点)
#!/usr/bin/env python3
import json, os, re, sys
sys.stdout.reconfigure(encoding='utf-8')
MAX_BLOCKS = 2
COUNT_DIR = os.path.expanduser('~/.claude/verify-before-no.d')
NEG = re.compile(
r'(でき(ない|ません)|使え(ない|ません)|見られ(ない|ません)|読め(ない|ません)|書け(ない|ません)|'
r'入って(い)?(ない|ません)|つながって(い)?(ない|ません)|見つから(ない|ず|ません)|存在しない|'
r'置いて(い)?(ない|ません)|届いて(い)?(ない|ません)|来て(い)?(ない|ません)|ありません|残って(い)?(ない|ません))')
ESCAPE = '確かめていないが'
NOT_LOOKUP = {'TaskCreate', 'TaskUpdate', 'TaskGet', 'TaskList', 'AskUserQuestion',
'ToolSearch', 'PushNotification', 'Write', 'Edit', 'NotebookEdit'}
def is_prompt(d):
if d.get('type') != 'user':
return False
if d.get('isMeta'): # フックの差し戻しはユーザー発言ではない
return False
c = d.get('message', {}).get('content')
if isinstance(c, str):
return bool(c.strip())
if isinstance(c, list):
kinds = {p.get('type') for p in c if isinstance(p, dict)}
return 'text' in kinds and 'tool_result' not in kinds
return False
def main():
data = json.load(sys.stdin)
looked, texts, turn = False, [], ''
try:
with open(data.get('transcript_path', ''), encoding='utf-8') as f:
for line in f:
try:
d = json.loads(line)
except ValueError:
continue
if is_prompt(d):
looked, texts, turn = False, [], d.get('uuid', '') or str(len(turn) + 1)
continue
if d.get('type') != 'assistant':
continue
for p in d.get('message', {}).get('content', []) or []:
if not isinstance(p, dict):
continue
if p.get('type') == 'tool_use' and p.get('name') not in NOT_LOOKUP:
looked = True
elif p.get('type') == 'text' and p.get('text'):
texts.append(p['text'])
except OSError:
return
if looked or not texts:
return
body = '\n'.join(texts)
if ESCAPE in body:
return
hits = sorted({m.group(0) for m in NEG.finditer(body)})
if not hits:
return
os.makedirs(COUNT_DIR, exist_ok=True)
cpath = os.path.join(COUNT_DIR, re.sub(r'[^\w-]', '_', f"{data.get('session_id', 'unknown')}_{turn}"))
try:
n = int(open(cpath).read())
except (OSError, ValueError):
n = 0
if n >= MAX_BLOCKS:
return
open(cpath, 'w').write(str(n + 1))
print(json.dumps({
'decision': 'block',
'reason': (
f'返事に「{"」「".join(hits[:5])}」がありますが、最後の発言のあと道具で1回も確かめていません。'
'「ない・できない」と言う前に、使える道具で今の状態を1回見てから書き直してください。'
f'本当に確かめようがないときだけ、その文の前に「{ESCAPE}」と書く。'
f'(差し戻し {n + 1}/{MAX_BLOCKS})'
),
}, ensure_ascii=False))
if __name__ == '__main__':
main()
元のスクリプトから、差し戻し文を短くし、自分の環境にしかない道具名を2つ外しました。元の差し戻し文には「ただの言い回し(『問題ありません』など)ならそのままでよい」という一文も入っています。
「調べたか」は、直近のユーザー発言から今までに、調べる道具が1回でも呼ばれたかだけで見ています。何を調べたかまでは見ません。見られるのは「調べに行ったかどうか」までです。
動かした結果(2026-11-18)
偽の会話記録(JSONL)を6つ作り、同じ会話に対してフックを3回ずつ呼びました。HOME は空の一時フォルダにして、回数の記録が本物に混ざらないようにしています。
- 道具なしで「その設定は入っていません。」→ 1回目・2回目は差し戻し、3回目は通過(上限2回)
- Grep を呼んだあとで同じ返事 → 3回とも通過
- TaskCreate だけ呼んで同じ返事 → 1回目・2回目は差し戻し(調べたことにならない)
- 「確かめていないが、その設定は入っていません。」→ 通過
- 否定のない返事(「はい、あります。」)→ 通過
- 前の発言で Read を呼び、次の発言では道具なしで「他はありません。」→ 差し戻し(前の発言の調べは持ち越されない)
差し戻しの文は、1回目に次の形で出ます。
返事に「入っていません」がありますが、最後の発言のあと道具で1回も確かめていません。…(差し戻し 1/2)
つまずき
- 言い回しの「ありません」も止まる。 道具なしで「問題ありません。」と返すと、2回差し戻されます(同じ実行環境で確認)。止めすぎです。語を「問題ありません」を除く形に絞る手はありますが、まだやっていません。
-
差し戻しをユーザー発言として数えない。 フックの差し戻しは会話記録に
isMeta付きのユーザー発言として入ります。これを発言として数えると、「調べた」の記録が毎回消えて上限も効かず、同じ返事を何度も繰り返しました。is_promptでisMetaを除いたのはこのためです。 -
断りの語は1つだけ。
確かめていないがが入っていれば通します。本当に確かめようがない場面(外部サービスに入れないなど)が逃げ場なく止まるのを避けるためです。ただ、これを毎回付ければすり抜けられます。
向いていない場面
- 返事の中身が正しいかは見ません。調べたあとに間違った結論を言うのは止められません。
- 否定の言い切りが少ない用途(文章の下書きなど)では、ほとんど動きません。
- 調べる道具を使わず、記憶で答えるのが正しい質問(一般的な知識)でも、否定の言い切りがあれば止まります。
確かめていないこと
- 本物の長い会話で、止めすぎが何回あるか(偽の記録6つだけで確かめました)
- Claude Code のバージョンが変わったときの、会話記録の
isMetaの持ち方
今日の一歩
自分の Claude Code に、「ありません」「できません」を含む返事を道具なしで返させてみて、何回止まるかを数えてみてください。偽の記録でも、上のスクリプトにそのまま食わせて確かめられます。