Claude Code mendukung konfigurasi proxy HTTP/HTTPS standar melalui variabel lingkungan. Ini memungkinkan Anda untuk merutekan semua lalu lintas Claude Code melalui server proxy organisasi Anda untuk tujuan keamanan, kepatuhan, dan pemantauan.

Konfigurasi proxy dasar

Variabel lingkungan

Claude Code menghormati variabel lingkungan proxy standar:

# Proxy HTTPS (direkomendasikan)
export HTTPS_PROXY=https://proxy.example.com:8080

# Proxy HTTP (jika HTTPS tidak tersedia)
export HTTP_PROXY=http://proxy.example.com:8080

Claude Code saat ini tidak mendukung variabel lingkungan NO_PROXY. Semua lalu lintas akan dirutekan melalui proxy yang dikonfigurasi.

Claude Code tidak mendukung proxy SOCKS.

Autentikasi

Autentikasi dasar

Jika proxy Anda memerlukan autentikasi dasar, sertakan kredensial dalam URL proxy:

export HTTPS_PROXY=http://username:password@proxy.example.com:8080

Hindari hardcoding kata sandi dalam skrip. Gunakan variabel lingkungan atau penyimpanan kredensial yang aman sebagai gantinya.

Untuk proxy yang memerlukan autentikasi lanjutan (NTLM, Kerberos, dll.), pertimbangkan untuk menggunakan layanan LLM Gateway yang mendukung metode autentikasi Anda.

Masalah sertifikat SSL

Jika proxy Anda menggunakan sertifikat SSL kustom, Anda mungkin mengalami kesalahan sertifikat.

Pastikan Anda mengatur jalur bundle sertifikat yang benar:

export SSL_CERT_FILE=/path/to/certificate-bundle.crt
export NODE_EXTRA_CA_CERTS=/path/to/certificate-bundle.crt

Persyaratan akses jaringan

Claude Code memerlukan akses ke URL berikut:

  • api.anthropic.com - Endpoint API Claude
  • statsig.anthropic.com - Telemetri dan metrik
  • sentry.io - Pelaporan kesalahan

Pastikan URL ini dimasukkan ke dalam daftar putih dalam konfigurasi proxy dan aturan firewall Anda. Ini sangat penting ketika menggunakan Claude Code dalam lingkungan jaringan yang dikontainerisasi atau terbatas.

Sumber daya tambahan