Browser Bisa, tetapi Claude Code Tidak Terhubung? Atur Proxy Terminal
Sun Oct 25 2026
Claude terbuka di browser, tetapi claude di terminal kehabisan waktu atau tidak menyelesaikan login? Pastikan terminal benar-benar memakai proxy. Ekstensi browser, proxy sistem, dan variabel shell adalah pengaturan yang berbeda.
Panduan ini membahas CLI Claude Code mandiri, bukan Claude Desktop. Akun yang memenuhi syarat dan lokasi yang didukung secara resmi tetap diperlukan; koneksi yang berhasil tidak mengubah ketentuan tersebut.
Pengaturan sementara ini berlaku untuk CLI yang dimulai di latar depan dari terminal ini. Untuk --bg atau agen latar belakang, ikuti konfigurasi resmi khusus: proses supervisor yang terus berjalan tidak dapat diandalkan untuk mewarisi perubahan shell berikutnya.
1. Hubungkan aplikasi klien terlebih dahulu
Langganan JMS mengatur node di klien. Jalur permintaan sebenarnya adalah:
Claude Code → port HTTP/mixed lokal pada klien → node JMS yang dipilih → layanan Anthropic.
Impor langganan terbaru ke klien yang mendukung protokol node saat ini. JMS mengubah protokol pada 2026; jangan menganggap klien lama khusus Shadowsocks masih cocok. Baca pemecahan masalah VLESS/Reality atau panduan Clash Verge.
Cari port pendengar HTTP atau mixed lokal dan biarkan klien berjalan. Ini bukan port server jarak jauh, URL langganan, UUID, atau kunci publik Reality. Batasi pendengar ke komputer lokal; berbagi lewat LAN tidak diperlukan untuk panduan ini.
Menurut dokumentasi jaringan resmi, Claude Code mendukung proxy HTTP/HTTPS tetapi tidak mendukung SOCKS secara langsung. Aktifkan pendengar HTTP/mixed atau gunakan klien yang sesuai.
2. Atur terminal yang akan menjalankan Claude
Gunakan terminal terpisah untuk percobaan pertama. Periksa secara lokal apakah https_proxy, HTTPS_PROXY, http_proxy, HTTP_PROXY, all_proxy, ALL_PROXY, no_proxy, atau NO_PROXY sudah diatur. Jangan unggah nilainya: URL proxy dapat berisi kata sandi.
Claude Code memilih nilai pertama yang terpasang dengan urutan https_proxy, HTTPS_PROXY, http_proxy, HTTP_PROXY. Nilai lama berhuruf kecil bisa mengalahkan nilai baru berhuruf besar. Alat lain memiliki aturan berbeda; ALL_PROXY tidak membuat Claude mendukung SOCKS. Simpan nilai lama secara pribadi dan selesaikan konflik sebelum menimpanya.
macOS atau Linux: Bash/Zsh
7890 hanya contoh. Ganti dengan port HTTP/mixed sebenarnya yang terlihat di klien sebelum menjalankan:
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"
claude
Windows: PowerShell
Ganti juga 7890 dengan port HTTP/mixed yang sebenarnya. Gunakan PowerShell, bukan Command Prompt:
$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"
claude
http:// menjelaskan sambungan ke proxy lokal, bukan mengubah HTTPS tujuan menjadi HTTP tanpa enkripsi. NO_PROXY menjaga permintaan lokal tetap langsung sehingga callback login browser bisa mencapai CLI.
Variabel berlaku untuk terminal ini dan proses yang dimulai darinya. Sesi Claude Code yang sudah terbuka tidak membaca ulang perubahan shell. Keluar, atur variabel, lalu jalankan claude dari terminal yang sama. Jangan membuat pengaturan permanen sebelum percobaan berhasil.
Di WSL, kontainer, atau SSH, 127.0.0.1 merujuk pada lingkungan tempat perintah berjalan, bukan selalu komputer yang menjalankan klien. Pastikan alamat dapat dijangkau tanpa membuka proxy ke Internet.
3. Uji tanpa membagikan kredensial
Keluar dari Claude Code dan jalankan pengujian di terminal yang telah diatur. Pengujian ini secara eksplisit menggunakan proxy lokal dan menghubungi host API publik tanpa kunci 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/
Di Windows, gunakan curl.exe untuk menghindari alias curl pada PowerShell lama:
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/
Batas waktu koneksi adalah 10 detik dan keseluruhan permintaan 20 detik. HTTP 401, 403, atau 404 tetap dapat berarti respons HTTP telah diterima; root API bukan panggilan model terautentikasi. Baca kesalahannya: status di luar 2xx tidak otomatis membuktikan kegagalan proxy, dan menerima respons tidak membuktikan kelayakan akun.
HTTP 000 disertai kesalahan koneksi atau waktu habis berarti tidak ada respons HTTP normal. Kesalahan sertifikat perlu diperiksa terpisah. Pertahankan verifikasi TLS: jangan menambahkan -k atau mematikan pemeriksaan sertifikat. Jangan publikasikan URL langganan, kode login, token, atau log diagnosis pribadi.
4. Tentukan pemeriksaan berikutnya berdasarkan gejala
| Gejala | Pemeriksaan berikutnya |
|---|---|
| Koneksi lokal ditolak | Klien berjalan, port HTTP/mixed dan host benar |
| Waktu habis atau koneksi direset | Log klien, node, DNS, firewall, dan rute |
| Login browser berhasil, CLI tidak selesai | Callback lokal, NO_PROXY, mulai ulang CLI, dan petunjuk login resmi |
| HTTP 401/403 pada permintaan terautentikasi | Metode login, kredensial, kebijakan organisasi, dan wilayah yang didukung |
| HTTP 429 atau batas penggunaan | Kuota akun dan frekuensi permintaan; berpindah node tidak menambah kuota |
| Beberapa perangkat gagal bersamaan | Periksa status Anthropic sebelum mengubah pengaturan |
Lihat claude --version, jalankan claude doctor, dan perbarui sesuai metode pemasangan dalam panduan resmi. Bug versi, login kedaluwarsa, atau gangguan platform dapat menyerupai masalah jaringan.
5. Hapus pengaturan sementara
Jika variabel tadi belum ada sebelum pengujian, hapus hanya nilai yang ditambahkan:
Bash/Zsh:
unset HTTPS_PROXY HTTP_PROXY NO_PROXY JMS_PROXY_PORT
PowerShell:
Remove-Item Env:HTTPS_PROXY, Env:HTTP_PROXY, Env:NO_PROXY -ErrorAction SilentlyContinue
Remove-Variable JmsProxyPort -ErrorAction SilentlyContinue
Ini menghapus nilai saat ini; bukan memulihkan nilai lama yang tertimpa. Pulihkan secara pribadi jika diperlukan, lalu mulai ulang Claude Code. Pengaturan permanen sistem atau profil perlu ditinjau terpisah.
Memilih layanan koneksi
JMS menyediakan node untuk klien yang kompatibel; klien dan terminal menghubungkan CLI ke node tersebut. JMS tidak menyediakan langganan Anthropic serta tidak menjamin persetujuan akun atau bebas penangguhan. Proxy lokal juga tidak mengubah jalur keluar konektor MCP yang berjalan di cloud.
Bandingkan paket dan panduan unduhan dengan perangkat dan protokol saat ini. Jika sesuai kebutuhan, lihat layanan Just My Socks.
Pengungkapan afiliasi: kami dapat menerima komisi jika Anda membeli melalui tautan ini.