Konfiguracja proxy i VPN

Wiele środowisk przedsiębiorstwa wymaga konfiguracji proxy lub połączeń VPN. Ten przewodnik opisuje, jak skonfigurować Claude Code do bezproblemowej pracy w ograniczonych środowiskach sieciowych.

Zrozumienie ograniczeń sieciowych

Typowe scenariusze przedsiębiorstwa

Proxy HTTP/HTTPS

Przekieruj cały ruch przez korporacyjny serwer proxy dla bezpieczeństwa i monitorowania

Proxy SOCKS

Kieruj ruch przez proxy SOCKS dla dodatkowych protokołów i elastyczności

Wymagane VPN

Połącz się z korporacyjnym VPN przed dostępem do zasobów wewnętrznych lub internetu

Uwierzytelnianie certyfikatu

Używaj korporacyjnych certyfikatów do uwierzytelniania proxy oraz inspekcji SSL

Podstawowa konfiguracja proxy

Zmienne środowiskowe

Ustaw proxy HTTP/HTTPS

# Linux/macOS
export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080
export http_proxy=$HTTP_PROXY
export https_proxy=$HTTPS_PROXY

# Windows (Command Prompt)
set HTTP_PROXY=http://proxy.company.com:8080
set HTTPS_PROXY=http://proxy.company.com:8080

# Windows (PowerShell)
$env:HTTP_PROXY="http://proxy.company.com:8080"
$env:HTTPS_PROXY="http://proxy.company.com:8080"

Skonfiguruj wyjątki no-proxy

# Domeny wewnętrzne, które nie powinny przechodzić przez proxy
export NO_PROXY=localhost,127.0.0.1,*.internal.company.com,10.0.0.0/8

# Windows
set NO_PROXY=localhost,127.0.0.1,*.internal.company.com,10.0.0.0/8

Zweryfikuj konfigurację

# Przetestuj łączność proxy
claude "Przetestuj moją konfigurację sieciową i zweryfikuj:
- Ustawienia proxy są wykryte
- Mogę dotrzeć do zewnętrznych API
- Rozwiązywanie DNS działa
- Walidacja certyfikatu przechodzi"

Uwierzytelnione proxy

# Uwzględnij poświadczenia w URL proxy
export HTTP_PROXY=http://username:password@proxy.company.com:8080
export HTTPS_PROXY=http://username:password@proxy.company.com:8080

# Bezpieczniej: użyj zakodowanych poświadczeń
export HTTP_PROXY=http://$(echo -n username:password | base64)@proxy.company.com:8080

# Dla uwierzytelniania Windows NTLM, użyj CNTLM
# Zainstaluj proxy cntlm
sudo apt-get install cntlm  # Linux
brew install cntlm          # macOS

# Skonfiguruj /etc/cntlm.conf
Username    your_username
Domain      CORPORATE
Proxy       proxy.company.com:8080
NoProxy     localhost, 127.0.0.*, 10.*, 192.168.*
Listen      3128

# Wygeneruj hash hasła
cntlm -H -u your_username -d CORPORATE

# Uruchom cntlm
sudo cntlm -c /etc/cntlm.conf

# Skieruj Claude Code na lokalne proxy
export HTTP_PROXY=http://localhost:3128
export HTTPS_PROXY=http://localhost:3128

# Dla uwierzytelniania Kerberos
# Upewnij się, że Kerberos jest skonfigurowane
kinit username@CORPORATE.REALM

# Użyj proxy z obsługą Kerberos
export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080

# Może być potrzeba ustawienia dodatkowych opcji Kerberos
export KRB5_CONFIG=/etc/krb5.conf

Zarządzanie certyfikatami SSL

Korporacyjne certyfikaty CA

Eksportuj korporacyjne certyfikaty

# Otrzymaj certyfikat od działu IT lub eksportuj z przeglądarki
# Zwykle w formacie .crt, .pem lub .cer

Zainstaluj certyfikaty systemowo

# Skopiuj certyfikat do magazynu systemowego
sudo cp corporate-ca.crt /usr/local/share/ca-certificates/
sudo update-ca-certificates

# Dla RHEL/CentOS
sudo cp corporate-ca.crt /etc/pki/ca-trust/source/anchors/
sudo update-ca-trust

# Dodaj do systemowego pęku kluczy
sudo security add-trusted-cert -d -r trustRoot \
  -k /Library/Keychains/System.keychain corporate-ca.crt

# Lub użyj GUI Keychain Access

# Uruchom jako Administrator
Import-Certificate -FilePath "corporate-ca.crt" `
  -CertStoreLocation Cert:\LocalMachine\Root

Skonfiguruj Node.js do używania certyfikatów

# Wskaż na pakiet certyfikatów
export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.crt

# Lub wyłącz weryfikację SSL (NIE zalecane dla produkcji)
export NODE_TLS_REJECT_UNAUTHORIZED=0

Omijanie inspekcji SSL

# Tymczasowe omijanie SSL do testów
claude --no-verify-ssl "Twoje polecenie tutaj"

# Skonfiguruj git do pracy z korporacyjnym proxy
git config --global http.proxy http://proxy.company.com:8080
git config --global https.proxy http://proxy.company.com:8080
git config --global http.sslVerify false  # Tylko jeśli konieczne

Konfiguracja VPN

VPN z tunelem dzielonym

Optymalizacja używania VPN

# Sprawdź tabelę routingu aby zrozumieć wpływ VPN
claude "Analizuj moje routowanie sieciowe:
- Pokaż aktualne trasy
- Zidentyfikuj interfejsy VPN
- Sprawdź, który ruch przechodzi przez VPN
- Zasugeruj optymalizacje dla Claude Code"

# Skonfiguruj Claude Code do używania bezpośredniego internetu gdy możliwe
export CLAUDE_DIRECT_CONNECTION=true  # Jeśli obsługiwane

Skrypty połączenia VPN

Automatyczne połączenie VPN

#!/bin/bash
# Połącz się z VPN
echo "Łączenie z korporacyjnym VPN..."
/opt/cisco/anyconnect/bin/vpn -s connect vpn.company.com << EOF
username
password
y
EOF

# Poczekaj na połączenie
sleep 5

# Zweryfikuj połączenie
if ip addr show | grep -q "vpn0"; then
  echo "VPN połączone pomyślnie"

  # Ustaw proxy dla sieci VPN
  export HTTP_PROXY=http://internal-proxy:8080
  export HTTPS_PROXY=http://internal-proxy:8080

  # Uruchom sesję Claude Code
  claude "VPN połączone, gotowe do pracy"
else
  echo "Połączenie VPN nieudane"
  exit 1
fi

Czyszczenie po rozłączeniu VPN

#!/bin/bash
# Rozłącz VPN
/opt/cisco/anyconnect/bin/vpn disconnect

# Wyczyść ustawienia proxy
unset HTTP_PROXY
unset HTTPS_PROXY

echo "VPN rozłączone, ustawienia proxy wyczyszczone"

Zaawansowane scenariusze proxy

Konfiguracja proxy SOCKS

# Dla proxy SOCKS5
export ALL_PROXY=socks5://proxy.company.com:1080
export all_proxy=$ALL_PROXY

# Z uwierzytelnianiem
export ALL_PROXY=socks5://username:password@proxy.company.com:1080

# Tunel SSH jako proxy SOCKS
ssh -D 1080 -N jumphost.company.com
export ALL_PROXY=socks5://localhost:1080

Konfiguracja pliku PAC

Automatyczna konfiguracja proxy

// Przykład logiki pliku PAC
function FindProxyForURL(url, host) {
  // Bezpośrednie połączenie dla stron wewnętrznych
  if (isInNet(host, "10.0.0.0", "255.0.0.0") ||
      dnsDomainIs(host, ".internal.company.com")) {
    return "DIRECT";
  }

  // Użyj proxy dla stron zewnętrznych
  return "PROXY proxy.company.com:8080";
}

# Użyj pliku PAC z Claude Code
export AUTO_PROXY=http://proxy.company.com/proxy.pac

# Parsuj plik PAC ręcznie jeśli potrzeba
claude "Parsuj ten plik PAC i wyodrębnij:
- Reguły proxy
- Domeny bezpośredniego połączenia
- Utwórz równoważne zmienne środowiskowe"

Rozwiązywanie problemów

Typowe problemy i rozwiązania

# Zwiększ wartości timeout
export CLAUDE_TIMEOUT=300  # 5 minut

# Przetestuj łączność
claude "Zdebuguj moje problemy z połączeniem:
- Przetestuj łączność proxy
- Sprawdź rozwiązywanie DNS
- Zweryfikuj uścisk dłoni SSL
- Zmierz opóźnienie"

# Debuguj problemy SSL
openssl s_client -connect api.anthropic.com:443 \
  -proxy proxy.company.com:8080

# Sprawdź łańcuch certyfikatów
claude "Analizuj łańcuch certyfikatów SSL:
- Pokaż wszystkie certyfikaty
- Zweryfikuj, że korporacyjny CA jest zaufany
- Sprawdź wygasłe certyfikaty
- Zasugeruj poprawki"

# Debuguj uwierzytelnianie proxy
curl -v -x http://proxy.company.com:8080 https://api.anthropic.com

# Przetestuj różne metody uwierzytelniania
claude "Przetestuj uwierzytelnianie proxy:
- Spróbuj basic auth
- Przetestuj NTLM jeśli domena Windows
- Sprawdź bilet Kerberos
- Zweryfikuj poświadczenia"

Polecenia diagnostyczne

Diagnostyka sieci

claude "Uruchom kompleksową diagnostykę sieci:
- Pokaż wszystkie interfejsy sieciowe
- Wyświetl tabelę routingu
- Sprawdź serwery DNS
- Przetestuj łączność proxy
- Zweryfikuj magazyny certyfikatów
- Sprawdź zmienne środowiskowe"

Skrypt testowy proxy

claude "Utwórz skrypt testowy proxy, który:
- Testuje łączność HTTP/HTTPS
- Weryfikuje uwierzytelnianie proxy
- Sprawdza walidację certyfikatu SSL
- Mierzy czasy odpowiedzi
- Testuje dostęp do API Claude Code"

Walidacja środowiska

claude "Zwaliduj moje środowisko dla Claude Code:
- Sprawdź wszystkie zmienne proxy
- Zweryfikuj konfigurację certyfikatów
- Przetestuj endpointy API
- Sprawdź konflikty
- Wygeneruj raport"

Optymalizacja wydajności

Konfiguracja proxy cache

Lokalne proxy cache

# Zainstaluj Squid jako lokalne proxy cache
sudo apt-get install squid

# Skonfiguruj Squid do cache'owania żądań Claude Code
claude "Skonfiguruj proxy Squid dla:
- Cache odpowiedzi API gdzie odpowiednie
- Przekierowanie do korporacyjnego proxy
- Obsługa SSL bumping jeśli potrzeba
- Optymalizacja dla użycia Claude Code"

Pooling połączeń

# Skonfiguruj ponowne użycie połączeń
export CLAUDE_KEEP_ALIVE=true
export CLAUDE_MAX_SOCKETS=10

# Dla lepszej wydajności przez proxy
export HTTP_KEEP_ALIVE=true
export HTTPS_KEEP_ALIVE=true

Najlepsze praktyki bezpieczeństwa

Bezpieczne zarządzanie poświadczeniami

# Użyj secret-tool do przechowywania poświadczeń
echo -n "proxy-password" | secret-tool store \
  --label="Corporate Proxy" \
  service proxy \
  username myusername

# Pobierz w skrypcie
PROXY_PASS=$(secret-tool lookup service proxy username myusername)
export HTTP_PROXY="http://myusername:${PROXY_PASS}@proxy.company.com:8080"

# Przechowaj w Keychain
security add-generic-password \
  -a "myusername" \
  -s "Corporate Proxy" \
  -w "proxy-password"

# Pobierz w skrypcie
PROXY_PASS=$(security find-generic-password \
  -a "myusername" \
  -s "Corporate Proxy" \
  -w)

# Przechowuj w Credential Manager
cmdkey /add:proxy.company.com /user:myusername /pass:proxy-password

# Użyj w skryptach z przechowanymi poświadczeniami

Następne kroki

Opanuj więcej funkcji przedsiębiorstwa:

Brama LLM dla niestandardowych endpointów
Integracja przedsiębiorstwa dla narzędzi korporacyjnych
Monitorowanie kosztów dla śledzenia użycia

Pamiętaj: Konfiguracja proxy może być złożona w środowiskach przedsiębiorstwa. Zawsze współpracuj z zespołem IT, aby zapewnić zgodność z politykami bezpieczeństwa przy jednoczesnym utrzymaniu produktywności z Claude Code.