Skip to content
BENIBIX Learn

BASH_MAX_TIMEOUT_MS

AI⌨️ Claude CodeConfiguration

Also known as BASH_MAX_TIMEOUT_MS environment variable

It sets the longest time Claude may ask a command to run.

Think of it like

It is like the latest time you may stay out. You can ask, but not past it.

Example

Jack's full build takes 20 minutes. He raises the top to 30 minutes, so Claude can ask for enough time on that one command.

Why it matters

Most commands stay short, while the few long ones can still finish when Claude asks.

Definition

BASH_MAX_TIMEOUT_MS sets the longest time Claude may ask for when it runs a shell command. The value is in milliseconds. The default is 600,000, which is 10 minutes. The real top is whichever is larger, this or the default timeout.

Example code

bash
export BASH_MAX_TIMEOUT_MS=1800000
claude
Let Claude ask for up to 30 minutes.
The top is the far mark on the line.

Common mistake

Raising only this and expecting every command to get longer. Claude has to ask. The default stays as it is.

Key takeaways

  1. 1
    The top. Claude can ask up to it.
  2. 2
    Default 10 minutes. 600,000.
  3. 3
    Larger of the two. This or the default.

Compare