この記事を読み終えると、Claude Code の返事が英語になったときに自動で「日本語で書き直して」と差し戻す Stop フックが置けます。
根拠は、手元で使っているフックに、2026-11-14 に英語・日本語・コード入りの返事の3通りを渡して、差し戻しの回数まで確かめた結果です。
何に困ったか
作業が長くなると、Claude Code の返事が英語になることがありました。英語になるたびに指摘して、4回言い直しました。
CLAUDE.md に「返事は日本語」と書いてあっても止まりません。文章の決まりは、長い作業の途中で薄れます。
そこで、返事を出す直前に機械で言語を数えて、英語なら差し戻すことにしました。Claude Code の Stop フックは、返事を終える直前に動いて、{"decision": "block", "reason": "..."} を返すと、その理由を Claude に渡して続きをやり直させてくれます。
設定: settings.json
{
"hooks": {
"Stop": [
{
"hooks": [
{ "type": "command", "command": "python3 ~/.claude/hooks/japanese-reply-stop.py", "timeout": 10 }
]
}
]
}
}
Stop フックには matcher がいりません。標準入力に、会話の記録ファイルの場所(transcript_path)と session_id が JSON で来ます。
決めたこと
-
最後の返事の地の文だけを見る。コードブロック・
`インラインコード`・URL・リンクの先は数えない(コマンドやファイル名が英語なのは当たり前なので) - 日本語の文字数が、英字の数の半分以上なら通す(
ja >= la * 0.5) - 全体で30字に満たない短い返事は見ない(「OK」で差し戻さない)
- 差し戻しは1回の指示につき2回まで。直らなくても3回目は通す
最後の項目が大事です。Stop フックで差し戻すと、Claude はもう1回返事を書き、また Stop フックが動きます。回数を決めておかないと、直らない限り終わらない無限ループになります。
フックの中身
import json, os, re, sys
sys.stdout.reconfigure(encoding='utf-8')
MAX_BLOCKS = 2
COUNT_DIR = os.path.expanduser('~/.claude/japanese-reply.d')
JA = re.compile(r'[-ヿ㐀-鿿]') # ひらがな・カタカナ・漢字
LATIN = re.compile(r'[A-Za-z]')
def is_prompt(d):
# 人が打った指示の行か(ツールの結果や meta の行は除く)
if d.get('type') != 'user' or 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 plain(t):
t = re.sub(r'```.*?```', ' ', t, flags=re.S) # コードブロック
t = re.sub(r'`[^`]*`', ' ', t) # インラインのコード
t = re.sub(r'\[([^\]]*)\]\([^)]*\)', r'\1', t) # リンクは文字だけ
t = re.sub(r'https?://\S+', ' ', t)
return t
def main():
data = json.load(sys.stdin)
last, turn = '', ''
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):
turn = d.get('uuid', '') or turn + '1' # 指示ごとに数え直す
continue
if d.get('type') != 'assistant':
continue
for p in d.get('message', {}).get('content', []) or []:
if isinstance(p, dict) and p.get('type') == 'text' and p.get('text'):
last = p['text'] # 最後の文章を残す
t = plain(last)
ja, la = len(JA.findall(t)), len(LATIN.findall(t))
if ja + la < 30 or ja >= la * 0.5:
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 # 2回差し戻したら通す
open(cpath, 'w').write(str(n + 1))
print(json.dumps({'decision': 'block', 'reason':
f'返事が英語になっています(地の文の日本語 {ja} 字・英字 {la} 字)。全文を日本語で書き直してください。'
'コード・コマンド・ファイル名は原文のままでよい。'}, ensure_ascii=False))
if __name__ == '__main__':
main()
回数は ~/.claude/japanese-reply.d/ の下に、セッションID_指示のID という名前のファイルで持ちます。次の指示が来れば別の名前になるので、自然に0から数え直しです。
動いた結果(2026-11-14 に実行)
会話の記録ファイルを自分で3つ作って、同じ session_id で3回ずつ渡しました(回数のファイルが本物の ~/.claude に残らないよう、環境変数 HOME を一時フォルダに差し替えて実行)。なお、ここに載せたコードは説明のために最小にしたもので、手元で使っているフックには、記録ファイルが読めないときに黙って通す処理なども入れています。
| 返事の中身 | 1回目 | 2回目 | 3回目 |
|---|---|---|---|
| 英語の文だけ(英字128・日本語0) | 差し戻し | 差し戻し | 通す |
| 日本語の文だけ | 通す | 通す | 通す |
日本語の文の間に npm install ... のコードブロック |
通す | 通す | 通す |
英語の返事には、返事が英語になっています(地の文の日本語 0 字・英字 128 字)。… という理由が JSON で返りました。3回目は何も出力せず、そのまま終われます。
つまずきやすいところ
-
コードブロックの英語を数えない。日本語の説明にコマンドを並べた返事は、英字のほうが多くなります。
plain()でコードとURLを消してから数えるのは、そのための処理です -
「最後の返事」の取り方。記録ファイルは1行1メッセージで、ツールを呼ぶたびに assistant の行が増えます。最後の
textだけを残すようにしないと、途中のつぶやきを見てしまいます -
回数の数え直し。
session_idだけをキーにすると、次の指示でも残りの回数が減ったままになります。人が打った指示のuuidも名前に入れて、指示ごとに数え直しています - 割合の
0.5は勘で決めた値です。固有名詞やコマンドの多い返事が差し戻されるようなら、この値を下げるか、最低文字数(30)を上げます
向いていない場面
- 英語で返してほしい作業(英文の添削など)では、このフックは邪魔になります。プロジェクトごとの設定に入れて、そこだけ外してください
- 言語を見るだけです。「日本語だが意味が違う」は止められません。品質の確認は別のフックやレビューで行います
まとめ
- Stop フックで
{"decision": "block", "reason": ...}を返すと、返事のやり直しをさせられる - コード・URL を除いた地の文で、日本語と英字の数を比べる
- 差し戻しの回数に上限を付ける(付けないと直らない限り終わらない)
- 回数は「セッション × 指示ごと」に持つ
今日の一歩(5分)
手元の Stop フックに、英語だけの返事の記録ファイルを渡してみてください(フックの置き場所は、自分のパスに読み替えてください)。decision が返れば、止める仕組みが動いています。
python3 - <<'PY' > /tmp/en.jsonl
import json
print(json.dumps({"type":"user","uuid":"u1","message":{"content":"こんにちは"}}))
print(json.dumps({"type":"assistant","message":{"content":[{"type":"text","text":"I checked the repository and all tests pass now. The build finished without errors and the deploy script is ready."}]}}))
PY
echo '{"transcript_path":"/tmp/en.jsonl","session_id":"test"}' | python3 ~/.claude/hooks/japanese-reply-stop.py
参考
- Claude Code の Hooks(Stop フックの
decision: "block"): https://docs.claude.com/en/docs/claude-code/hooks