Mac VPN Setup
Get macOS connected in 5 minutes
Recommended clients
Hiddify
RecommendedGet Hiddify-MacOS.dmg and drag it to Applications (our S3 accelerate endpoint, reachable in China). To route terminal tools like Claude Code / Codex, switch the mode to "VPN" after connecting.
Clash Verge
AlternativeApple Silicon (M-series) uses this; Intel Macs use https://jr-image.s3-accelerate.amazonaws.com/files/clash-verge/v2.5.1/Clash.Verge_2.5.1_x64.dmg . Both mirrored to our S3 accelerate endpoint (reachable in China). Enable Tun Mode to route the terminal.
Step-by-step (~5 minutes first time)
- 1
Download Hiddify-MacOS.dmg and install
Drag to Applications. First launch is blocked by Gatekeeper → System Settings → Privacy & Security → scroll down → 'Open Anyway'.
- 2
Back to jiangren.com.au → Account → VPN tab
Tap '🔗 Copy link' to get your ss:// or vless:// link.
- 3
Open Hiddify → '+' top right → 'Add from Clipboard'
It reads the link and the node appears under 'Profiles'; the top dropdown switches regions.
- 4
Select node → connect → set mode to 'VPN'
Key step. The three modes at the bottom are 'Proxy / System Proxy / VPN' — pick the rightmost 'VPN' (full TUN). 'System Proxy' only covers browsers; 'VPN' makes claude / codex / npm / git all route through automatically.
- 5
Verify in both browser and terminal
Browser: open https://ifconfig.me, IP should be overseas. Terminal: run curl https://ifconfig.me — the IP should change there too, which confirms VPN mode is live and claude is ready to use.
Mac troubleshooting
Terminal / Claude Code isn't using the proxy
The Hiddify mode isn't set to 'VPN'. 'System Proxy' only covers browsers; the terminal needs 'VPN' (full TUN). After switching, run curl https://ifconfig.me to confirm the IP changed.
Gatekeeper blocking
macOS 14+: System Settings → Privacy & Security → scroll down → 'Hiddify was blocked' → 'Open Anyway'.
Connected but overseas sites won't load
Make sure you're on VPN mode, not just system proxy. If it persists, switch region (singapore is usually fastest) or reconnect once.
No internet after quitting Hiddify
Disconnect before quitting. If you forgot: System Settings → Network → turn off any leftover VPN / proxy config to restore.
Links go to official sources / GitHub. If GitHub is unreachable in your region, email contact@jiangren.com.au for our mirror packages.