브라우저는 되는데 Claude Code 터미널은 연결되지 않나요? HTTP 프록시 설정
Sun Oct 25 2026
브라우저에서는 Claude가 열리는데 터미널의 claude는 시간 초과가 나거나 로그인하지 못한다면, 먼저 터미널이 프록시를 사용하는지 확인하세요. 브라우저 확장 프로그램, 시스템 프록시, 셸 환경 변수는 서로 다른 설정입니다.
이 글은 독립 실행형 Claude Code CLI를 다룹니다. Claude Desktop 설정 안내가 아닙니다. 공식 지원 지역과 계정 자격 조건은 별도로 충족해야 하며, 연결이 된다고 이용 자격이 바뀌지는 않습니다.
이 임시 설정은 현재 터미널에서 포그라운드로 시작하는 CLI에 적용됩니다. --bg나 백그라운드 에이전트는 공식 별도 설정을 따르세요. 오래 실행되는 관리 프로세스가 이후 셸 변경을 확실히 상속한다고 볼 수 없습니다.
1. 프록시 클라이언트부터 연결하기
JMS 구독은 클라이언트에 노드를 설정하는 데 사용됩니다. 실제 요청 경로는 다음과 같습니다.
Claude Code → 클라이언트의 로컬 HTTP/mixed 포트 → 선택한 JMS 노드 → Anthropic 서비스.
현재 노드의 실제 프로토콜을 지원하는 클라이언트에 최신 구독을 가져오세요. JMS는 2026년에 프로토콜을 변경했으므로 예전 Shadowsocks 전용 클라이언트가 계속 작동한다고 가정하면 안 됩니다. VLESS/Reality 연결 점검과 Clash Verge 구독 설정을 먼저 참고할 수 있습니다.
클라이언트에서 로컬 HTTP 또는 mixed 수신 포트를 찾고 프로그램을 계속 실행해 두세요. 원격 서버 포트, 구독 URL, UUID, Reality 공개 키가 아닙니다. 수신 주소는 로컬 컴퓨터로 제한하고, 이 설정을 위해 LAN 공유를 켤 필요는 없습니다.
공식 네트워크 문서에 따르면 Claude Code는 HTTP/HTTPS 프록시를 지원하지만 SOCKS 프록시는 직접 지원하지 않습니다. SOCKS 포트만 있다면 HTTP/mixed 수신을 활성화하거나 호환 클라이언트를 사용하세요.
2. Claude를 시작할 터미널에서 설정하기
처음에는 별도 터미널을 사용하는 편이 좋습니다. https_proxy, HTTPS_PROXY, http_proxy, HTTP_PROXY, all_proxy, ALL_PROXY, no_proxy, NO_PROXY가 이미 설정되어 있는지 로컬에서 확인하세요. 프록시 URL에는 비밀번호가 들어갈 수 있으므로 값을 공개하지 마세요.
Claude Code는 https_proxy, HTTPS_PROXY, http_proxy, HTTP_PROXY 순서로 먼저 설정된 값을 사용합니다. 오래된 소문자 변수가 새 대문자 설정보다 우선할 수 있습니다. 도구마다 처리 방식이 다르므로 ALL_PROXY만으로 Claude가 SOCKS를 사용한다고 생각하면 안 됩니다. 덮어쓰기 전에는 기존 값을 비공개로 보관하고 충돌을 해결하세요.
macOS 또는 Linux: Bash/Zsh
7890은 예시입니다. 실행하기 전에 클라이언트에 표시된 실제 HTTP/mixed 포트로 바꾸세요.
JMS_PROXY_PORT=7890
export HTTPS_PROXY="http://127.0.0.1:${JMS_PROXY_PORT}"
export HTTP_PROXY="$HTTPS_PROXY"
export NO_PROXY="localhost,127.0.0.1,::1"
claudeWindows: PowerShell
여기서도 7890을 실제 HTTP/mixed 포트로 변경하세요. 명령 프롬프트가 아닌 PowerShell에서 실행합니다.
$JmsProxyPort = 7890
$env:HTTPS_PROXY = "http://127.0.0.1:$JmsProxyPort"
$env:HTTP_PROXY = $env:HTTPS_PROXY
$env:NO_PROXY = "localhost,127.0.0.1,::1"
claudehttp://는 로컬 프록시까지 연결하는 방식입니다. 대상 서버의 HTTPS 통신을 평문으로 바꾸는 설정이 아닙니다. NO_PROXY는 로컬 요청을 직접 연결하여 브라우저 로그인 콜백이 CLI에 도달하도록 돕습니다.
변수는 현재 터미널과 그곳에서 시작한 프로세스에만 적용됩니다. 실행 중인 Claude Code는 나중에 바꾼 셸 변수를 다시 읽지 않습니다. 종료한 뒤 설정하고, 같은 터미널에서 claude를 다시 시작하세요. 임시 테스트가 성공하기 전에는 셸 시작 파일에 저장하지 않아도 됩니다.
WSL, 컨테이너, SSH의 127.0.0.1은 명령이 실행되는 환경을 뜻하며, 클라이언트가 실행 중인 Windows나 호스트와 다를 수 있습니다. 연결 가능 여부를 확인하고 프록시를 인터넷에 공개하지 마세요.
3. 자격 증명 없이 연결 테스트하기
Claude Code를 종료하고 방금 설정한 터미널에서 해당 명령을 실행하세요. 로컬 프록시를 명시적으로 사용해 공개 API 호스트만 요청하며 API 키를 보내지 않습니다.
macOS/Linux:
curl --proxy "$HTTPS_PROXY" --noproxy "localhost,127.0.0.1,::1" --connect-timeout 10 --max-time 20 --output /dev/null --silent --show-error --write-out 'HTTP %{http_code}\n' https://api.anthropic.com/Windows에서는 이전 PowerShell의 curl 별칭을 피하기 위해 curl.exe를 사용합니다.
curl.exe --proxy $env:HTTPS_PROXY --noproxy "localhost,127.0.0.1,::1" --connect-timeout 10 --max-time 20 --output NUL --silent --show-error --write-out "HTTP %{http_code}\n" https://api.anthropic.com/연결 대기는 최대 10초, 전체 요청은 최대 20초입니다. HTTP 401, 403, 404도 HTTP 응답을 받았다는 의미일 수 있습니다. API 루트 주소는 인증된 모델 호출이 아닙니다. 실제 오류를 함께 살펴보세요. 2xx가 아니라고 프록시 장애로 단정할 수도 없고, 응답을 받았다고 계정 이용이 보장되는 것도 아닙니다.
연결 오류나 시간 초과와 함께 HTTP 000이 나오면 정상 HTTP 응답을 받지 못한 상태입니다. 인증서 오류는 별도로 진단하세요. TLS 검증을 유지하고 -k를 붙이거나 인증서 확인을 끄지 마세요. 공개 도움 요청에 구독 URL, 로그인 코드, 토큰, 비공개 진단 로그를 올리지 마세요.
4. 증상별 다음 점검
| 증상 | 확인할 항목 |
|---|---|
| 로컬 연결 거부 | 클라이언트 실행 여부, HTTP/mixed 포트, 호스트 |
| 시간 초과 또는 연결 초기화 | 클라이언트 로그, 노드, DNS, 방화벽, 경로 |
| 브라우저 로그인 후 CLI가 완료되지 않음 | 콜백 연결, NO_PROXY, CLI 재시작 및 공식 로그인 안내 |
| 인증된 요청에서 HTTP 401/403 | 로그인 방식, 자격 증명, 조직 정책, 지원 지역. 속도 문제로만 보지 않기 |
| HTTP 429 또는 사용량 제한 | 계정 할당량과 요청 빈도. 노드를 바꿔도 한도는 늘어나지 않음 |
| 여러 기기에서 동시에 실패 | 설정 변경 전에 Anthropic 서비스 상태 확인 |
claude --version으로 버전을 확인하고 claude doctor를 실행하세요. 업데이트는 공식 설치 문서의 설치 방식별 절차를 따릅니다. 버전 결함, 로그인 만료, 플랫폼 장애도 네트워크 문제처럼 보일 수 있습니다.
5. 임시 설정 삭제하기
테스트 전에 해당 변수가 없었다면 위에서 추가한 값만 삭제할 수 있습니다.
Bash/Zsh:
unset HTTPS_PROXY HTTP_PROXY NO_PROXY JMS_PROXY_PORTPowerShell:
Remove-Item Env:HTTPS_PROXY, Env:HTTP_PROXY, Env:NO_PROXY -ErrorAction SilentlyContinue
Remove-Variable JmsProxyPort -ErrorAction SilentlyContinue이 명령은 현재 값을 삭제할 뿐, 덮어쓴 이전 값을 복원하지 않습니다. 필요하면 기존 값을 로컬에서 직접 복구하세요. 환경을 바꾼 뒤에는 Claude Code를 다시 시작해야 합니다. 시스템이나 셸 설정 파일의 영구 설정은 따로 확인하세요.
연결 서비스 선택하기
JMS는 호환 클라이언트에 노드를 제공하고, 클라이언트와 터미널 설정이 CLI에 연결을 전달합니다. Anthropic 구독을 제공하거나 계정 승인·정지 방지를 보장하지 않습니다. 로컬 프록시는 클라우드 MCP 커넥터의 외부 연결 경로도 바꾸지 않습니다.
기기와 현재 프로토콜에 맞춰 요금제와 클라이언트 다운로드 안내를 확인하세요. 필요에 맞는다면 Just My Socks 서비스 보기에서 확인할 수 있습니다.
제휴 안내: 위 링크를 통해 구매하면 이 사이트에 수수료가 지급될 수 있습니다.