You'll noticeTier: how much it should matter to you
2Useful: my rating, 1 to 5
1Signal: worth watching, 1 to 5
InternalsArea: what it touches
ImprovementsKind: in v2.1.273,
ImprovementsSection of the release
What
When Claude Code fails to connect because of a certificate verification error (such as an unverifiable or self-signed certificate), the error message now explains that this usually happens because of a corporate proxy that inspects TLS traffic, or a private certificate authority gateway. It points to the NODE_EXTRA_CA_CERTS environment variable as the fix, and links to the network configuration documentation page.
Why
This makes it much easier to understand and resolve a common cause of connection failures on corporate networks, instead of just seeing a cryptic certificate error.
The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.
Added sinceA small documentation edit on Enterprise network configuration touched a line naming NODE_EXTRA_CA_CERTS after this was published.By default, Claude Code trusts both its bundled Mozilla CA certificates and your operating system's certificate store. Reading the OS store requires a runtime with `tls.getCACertificates`: the native installer always has it, and npm instal…network-configsee the edit
Confirmed sinceAnthropic's documentation has since written up NODE_EXTRA_CA_CERTS, on Error reference.Unable to connect to API: SSL certificate verification failed (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). The certificate comes from an authority Claude Code doesn't trust, usually a TLS-inspecting corporate proxy or a gateway signed by a private…errorssee the edit
How sure we are
Two sources agreeTwo things we can check say the same as this entry.
Anthropic's documentation agreesAnthropic's documentation has since written up NODE_EXTRA_CA_CERTS, on Error reference.
Anthropic's release notes agreeImproved the in-session SSL certificate and proxy connection errors to name the error code and what to fix, such as NODE_EXTRA_CA_CERTS for…
