kTerm

claude-code-activity.sh をダウンロードして ~/.claude/hooks/（Claude Code）または ~/.codex/hooks/（Codex CLI）に置き、chmod +x で実行権限を付けます。続いて下の例のとおり各イベントに登録します。<you> はご自身のユーザ名に置き換えてください。両方使う場合は 1 か所に置き、両方の設定でそのパスを指定します。

以前にダウンロードしたスクリプトを使っている場合は、1.0.9 に合わせて新しいものに置き換えてください。

ファイルが既にある場合は、置き換えずに追記します。"hooks" が無ければ、ほかの設定と並べて最上位に "hooks" のブロックを加えます。既にあればその中に各イベントを加え、hooks を登録済みのイベントには、その配列の末尾に { "hooks": [...] } の項目を足します。

Claude Code - ~/.claude/settings.json

{
  "hooks": {
    "SessionStart":      [{ "hooks": [{ "type": "command", "command": "/Users/<you>/.claude/hooks/claude-code-activity.sh" }] }],
    "UserPromptSubmit":  [{ "hooks": [{ "type": "command", "command": "/Users/<you>/.claude/hooks/claude-code-activity.sh" }] }],
    "PreToolUse":        [{ "hooks": [{ "type": "command", "command": "/Users/<you>/.claude/hooks/claude-code-activity.sh" }] }],
    "PostToolUse":       [{ "hooks": [{ "type": "command", "command": "/Users/<you>/.claude/hooks/claude-code-activity.sh" }] }],
    "PermissionRequest": [{ "hooks": [{ "type": "command", "command": "/Users/<you>/.claude/hooks/claude-code-activity.sh" }] }],
    "Notification":      [{ "hooks": [{ "type": "command", "command": "/Users/<you>/.claude/hooks/claude-code-activity.sh" }] }],
    "Stop":              [{ "hooks": [{ "type": "command", "command": "/Users/<you>/.claude/hooks/claude-code-activity.sh" }] }],
    "StopFailure":       [{ "hooks": [{ "type": "command", "command": "/Users/<you>/.claude/hooks/claude-code-activity.sh" }] }],
    "SessionEnd":        [{ "hooks": [{ "type": "command", "command": "/Users/<you>/.claude/hooks/claude-code-activity.sh" }] }]
  }
}

Codex CLI 0.155 以降 - ~/.codex/hooks.json

{
  "hooks": {
    "SessionStart":      [{ "hooks": [{ "type": "command", "command": "/Users/<you>/.codex/hooks/claude-code-activity.sh" }] }],
    "UserPromptSubmit":  [{ "hooks": [{ "type": "command", "command": "/Users/<you>/.codex/hooks/claude-code-activity.sh" }] }],
    "PreToolUse":        [{ "hooks": [{ "type": "command", "command": "/Users/<you>/.codex/hooks/claude-code-activity.sh" }] }],
    "PostToolUse":       [{ "hooks": [{ "type": "command", "command": "/Users/<you>/.codex/hooks/claude-code-activity.sh" }] }],
    "PermissionRequest": [{ "hooks": [{ "type": "command", "command": "/Users/<you>/.codex/hooks/claude-code-activity.sh" }] }],
    "Stop":              [{ "hooks": [{ "type": "command", "command": "/Users/<you>/.codex/hooks/claude-code-activity.sh" }] }],
    "Interrupt":         [{ "hooks": [{ "type": "command", "command": "/Users/<you>/.codex/hooks/claude-code-activity.sh" }] }],
    "SessionEnd":        [{ "hooks": [{ "type": "command", "command": "/Users/<you>/.codex/hooks/claude-code-activity.sh" }] }]
  }
}

次のシーケンスを標準出力に書きます。制御端末を持たない hooks などのプロセスからは、エスケープ文字を除いた同じ内容を 1 接続につき 1 行、$KTERM_ACTIVITY_SOCKET の受け口へ送ります（例: printf '7777;activity;busy;\n' | nc -U "$KTERM_ACTIVITY_SOCKET"）。KTERM_ACTIVITY_SOCKET を引き継げば tmux の中でも動きます。

printf '\e]7777;activity;busy;\e\\'         # 考え中
printf '\e]7777;activity;tool;Bash\e\\'     # ツール実行中（ラベル付き）
printf '\e]7777;activity;attention;\e\\'    # 応答待ち
printf '\e]7777;activity;done;\e\\'         # 完了
printf '\e]7777;activity;error;\e\\'        # 失敗
printf '\e]7777;activity;off;\e\\'          # 消灯

作業状態の音は kTerm が鳴らすので、Claude Code 側の設定は要りません。Codex CLI は完了をベルで知らせるよう、~/.codex/config.toml に次を追加します。

[tui]
notifications = true
notification_method = "bel"
notification_condition = "always"

kTerm は終了しています。動き続けているのは Codex CLI の常駐サーバーです。Codex CLI 0.157 以降は、次回の起動を速くするため、起動したターミナルを閉じてもこのサーバーが動き続けます。macOS はこのサーバーを起動元のアプリの一部として数えるため、kTerm の名前でシステム設定の「一般 > ログイン項目」に表示します。止めるときは codex app-server daemon stop を実行します。常駐させずに使うときは codex --no-daemon で起動します。