SOCKS5 proxy

For networks that only allow traffic through a SOCKS5 proxy, such as an SSH tunnel. The Claude and OpenAI Codex usage calls then go through it.

Set it up

In Settings -> General -> Proxy, turn on Enable SOCKS5 proxy and set Host and Port (default 127.0.0.1 and 1080). Authentication is not supported. A typical tunnel:

bash

ssh -D 1080 user@bastion

Proxied: api.anthropic.com and chatgpt.com, including Check connection in Settings -> Providers. Direct: status.claude.com, update traffic to GitHub, and the Claude connection test in onboarding.

If the proxy is down, the app shows a network error: fix the settings, no restart needed.

An invalid host or port (empty, port outside 1 to 65535, spaces, / or @) is ignored: calls then go out directly.