CLAUDE_CODE_REMOTE_TOOLS_HOST_IDLE_RELEASE_MINUTES

Updated October 31, 2026 by Alex Sorokoletov

CLAUDE_CODE_REMOTE_TOOLS_HOST_IDLE_RELEASE_MINUTES is a Claude Code environment variable: Minutes of idle time before the remote tools host channel is released, applied as that value times 60000 milliseconds; when unset, no idle release timeout is set. Added in v2.1.312 and still present in v2.1.315. It is not in the official reference.

Status	Present in v2.1.315
Added	Added in v2.1.312
Category	Shell and tools
Official docs	Not listed

How to set it

For one session, export it in the shell that starts Claude Code:

export CLAUDE_CODE_REMOTE_TOOLS_HOST_IDLE_RELEASE_MINUTES=<value>
claude

To apply it to every session, add it to the env object of a settings file:

// ~/.claude/settings.json
{
  "env": {
    "CLAUDE_CODE_REMOTE_TOOLS_HOST_IDLE_RELEASE_MINUTES": "<value>"
  }
}

Related variables

CLAUDE_CODE_REMOTE_TOOLS_HOST_ALLOWS_UNATTENDED
CLAUDE_CODE_REMOTE_TOOLS_POLICY: Selects how tools are served to Remote Control clients.
CLAUDE_CODE_REMOTE_TOOLS_SERVE: Controls serving of remote tools; serving is enabled by default, and setting it to a false value turns serving off.
CLAUDE_CODE_REMOTE_TOOLS_ASK_SEATS
CLAUDE_CODE_REMOTE_TOOLS_CALLER_SESSIONS_MAX
CLAUDE_CODE_REMOTE_TOOLS_FORWARD
CLAUDE_CODE_REMOTE_TOOLS_JUMP_QUEUE
CLAUDE_CODE_REMOTE_TOOLS_PIN_STORED_LOGIN

Frequently asked questions

What does CLAUDE_CODE_REMOTE_TOOLS_HOST_IDLE_RELEASE_MINUTES do?

Minutes of idle time before the remote tools host channel is released, applied as that value times 60000 milliseconds; when unset, no idle release timeout is set.

Which Claude Code version has CLAUDE_CODE_REMOTE_TOOLS_HOST_IDLE_RELEASE_MINUTES?

Added in v2.1.312 and still present in v2.1.315.

How do I set CLAUDE_CODE_REMOTE_TOOLS_HOST_IDLE_RELEASE_MINUTES?

Export it before starting Claude Code (export CLAUDE_CODE_REMOTE_TOOLS_HOST_IDLE_RELEASE_MINUTES=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.