3
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Code が調べずに「ありません」「できません」と答えるのを Stop フックで差し戻す(道具を1回も呼んでいない返事だけを止める)

3
Posted at

読み終えるとできること

道具で何も調べていないのに「入っていません」「できません」と言い切る返事を、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 に、「ありません」「できません」を含む返事を道具なしで返させてみて、何回止まるかを数えてみてください。偽の記録でも、上のスクリプトにそのまま食わせて確かめられます。

3
0
1

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
3
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?