CLAUDE_CODE_HOOK_HEARTBEAT_INTERVAL_MS
Updated by Alex Sorokoletov
CLAUDE_CODE_HOOK_HEARTBEAT_INTERVAL_MS is a Claude Code environment variable: Interval in milliseconds between hook heartbeat timer ticks, which also sets how many ticks fit within the limit; defaults to a built-in value. Added between v2.1.321 and v2.1.323 and still present in v2.1.324. It is not in the official reference.
| Status | Present in v2.1.324 |
|---|---|
| Added | Added between v2.1.321 and v2.1.323 |
| Category | Other |
| Official docs | Not listed |
How to set it
For one session, export it in the shell that starts Claude Code:
export CLAUDE_CODE_HOOK_HEARTBEAT_INTERVAL_MS=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_CODE_HOOK_HEARTBEAT_INTERVAL_MS": "<value>"
}
}Release notes that mention it
- Claude Code Version Tracker: Undocumented Env Vars, Feature Gates & Models
- claude-code-env-vars-v2-1-323
Related variables
CLAUDE_CODE_EMIT_USER_PROMPT_SUBMIT_HOOK_EVENTS: When set, enables emitting start and end hook events for user prompt submission; the value is read once and then cleared.CLAUDE_CODE_STOP_HOOK_BLOCK_CAP: Cap how long a stop hook can block session termination.CLAUDE_PTY_HEARTBEAT_MS: Interval in milliseconds between heartbeat pings the PTY host sends to clients; defaults to 60000, and a client is dropped after three missed pings.CLAUDE_CODE_FEATURE_FLAGS_REFRESH_INTERVAL_MSCLAUDE_CODE_GB_REFRESH_INTERVAL_MSCLAUDE_SCRIPT_HOOK_ACKANTHROPIC_BETAS: Comma-separated beta feature headers.ANTHROPIC_CUSTOM_HEADERS: Custom HTTP headers (newline-separated Key: Value).
Frequently asked questions
What does CLAUDE_CODE_HOOK_HEARTBEAT_INTERVAL_MS do?
Interval in milliseconds between hook heartbeat timer ticks, which also sets how many ticks fit within the limit; defaults to a built-in value.
Which Claude Code version has CLAUDE_CODE_HOOK_HEARTBEAT_INTERVAL_MS?
Added between v2.1.321 and v2.1.323 and still present in v2.1.324.
How do I set CLAUDE_CODE_HOOK_HEARTBEAT_INTERVAL_MS?
Export it before starting Claude Code (export CLAUDE_CODE_HOOK_HEARTBEAT_INTERVAL_MS=value), or add it to the "env" object in ~/.claude/settings.json to apply it to every session.
All variables, searchable: Claude Code environment variables.