Claude Code SSL Certificate Fix¶
If Claude Code fails with:
This happens when behind corporate SSL inspection (Zscaler, BlueCoat, etc.). The
fixes below go in ~/.zshrc.local — your machine-local, un-committed shell
config — so they never leak into the tracked dotfiles. On a work machine the
certificate is usually set up as part of the work setup.
Quick Fix¶
Option 1: Use Corporate Certificate (Recommended)¶
-
Locate your corporate root certificate:
-
Add to
~/.zshrc.local: -
Reload shell:
Option 2: Disable SSL Verification (Less Secure)¶
Only use if you cannot obtain the corporate certificate.
Add to ~/.zshrc.local:
Reload shell:
Verify Fix¶
Finding Your Certificate¶
If you have a ClaudeCode download folder from IT:
Or check system keychain:
Contact your IT department if you cannot locate the certificate.
See also¶
- Set up a work laptop — the full
work-profile setup flow. - Complete Work Machine Setup Guide — corporate certificates and proxy setup in depth.
- Troubleshooting — other common failures and fixes.