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 localhostfalse: 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