Skip to content
← Back to release · 2.1.281
Improvements / v2.1.281

Point to allowLocalBinding on bind failures

CHANGELOG · original

Improved sandbox guidance on macOS: when a local dev server can't bind a port, Claude now points to sandbox.network.allowLocalBinding
Open official changelog ↗

Documentation

Documentation excerpt

sandbox.network.allowLocalBinding

Let sandboxed commands on macOS listen on network ports, for example to start a dev server, and connect to any port on localhost. A command that listens on a non-loopback address accepts connections from other machines. The key has no effect on Linux and WSL2, where each sandboxed command has its own loopback interface. To reach a server on the host from Linux or WSL2, see A command fails to reach a server on localhost.

  • Scope: Any file, with limits on project and local settings
  • Type: Boolean
    • true: sandboxed commands on macOS can listen on any local address and connect to any port on localhost
    • false: sandboxed commands on macOS can't listen on a port or connect directly to servers on localhost
  • Default: false
{
  "sandbox": {
    "network": {
      "allowLocalBinding": true
    }
  }
}

Documentation snapshot · 2026-11-20

Change details