Przejdź do treści
Biblioteka skilli
AI i agenci · Integracja z narzędziem

network-diagnostics

/network-diagnostics

Diagnozuje i konfiguruje ustawienia sieciowe Claude Code: proxy, certyfikaty CA, mTLS, listy dozwolonych adresów i limity czasu.

Licencja
MIT
Ostatnia zmiana repozytorium
09.11.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
4
Przestarzałość

Brak sygnałów. Repozytorium zmienione 09.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Diagnozuje i konfiguruje ustawienia sieciowe Claude Code: proxy, certyfikaty CA, mTLS, listy dozwolonych adresów i limity czasu.

Wyzwalacze z opisu

unable to connect
Oryginalny opis (EN)

Diagnose and configure Claude Code network settings - HTTP/HTTPS proxy, NO_PROXY, custom CA certificates, TLS-inspection proxies, mTLS client certificates, firewall allowlists, and stream timeouts. Use this skill whenever the user mentions proxy, corporate network, VPN, firewall, certificate errors, "unable to connect", SSL/TLS or handshake errors, NODE_EXTRA_CA_CERTS, HTTPS_PROXY, mTLS, SOCKS, or Claude Code hanging or timing out on requests, even if they do not name these settings explicitly.

Jak działa

  1. Workflow
  2. Symptom to cause
  3. Where to set variables
  4. Core rules (from the official docs)
Sekcje z nagłówków SKILL.md, w oryginale · 45 linii, 657 słów
Podgląd SKILL.md
---
name: network-diagnostics
description: Diagnose and configure Claude Code network settings - HTTP/HTTPS proxy, NO_PROXY, custom CA certificates, TLS-inspection proxies, mTLS client certificates, firewall allowlists, and stream timeouts. Use this skill whenever the user mentions proxy, corporate network, VPN, firewall, certificate errors, "unable to connect", SSL/TLS or handshake errors, NODE_EXTRA_CA_CERTS, HTTPS_PROXY, mTLS, SOCKS, or Claude Code hanging or timing out on requests, even if they do not name these settings explicitly.
---

# Claude Code network diagnostics

Help the user find and fix network problems in Claude Code, or set up a proxy / CA / mTLS configuration correctly the first time.

## Workflow

1. **Collect facts before guessing.** Ask for (or run `/net-check` to get) the exact error text, the install method (native installer or npm), the surface (terminal, Desktop Code tab, Cowork, cloud session), and whether a proxy or TLS-inspection appliance is in the path.
2. **Run the static check.** `/net-check` runs `scripts/check-env.sh`, which validates proxy URLs, certificate files and the `~/.claude/settings.json` `env` block without sending anything.
3. **Confirm with Claude Code itself.** Start with `claude --debug` (log goes to `~/.claude/debug/<session-id>.txt`, or a path given with `--debug-file`) and use `/status` in a session. See `references/verify.md`.
4. **Map the symptom to a cause** with the table below, then give the smallest fix. Prefer settings over shell exports (see "Where to set variables").
5. **Never print secrets.** Mask credentials in proxy URLs and never echo key passphrases.

## Symptom to cause

| Symptom | Likely cause | Fix |
| - | - | - |
| Launch stops with an error naming a proxy variable | Proxy URL cannot be parsed, e.g. missing `http://` scheme | Add the scheme: `http://host:port` |
| Connection errors through a proxy that works for other tools | Proxy is SOCKS (not supported) or needs NTLM/Kerberos | Use an HTTP(S) proxy, or an LLM gateway that supports the auth method |
| Certificate / TLS errors behind a TLS-inspection proxy | Corporate root CA not trusted | Install the root in the OS trust store, or set `NODE_EXTRA_CA_CERTS=/path/ca.pem` |
| Same, on an npm install | Runtime cannot read the OS store | Use Node 22.15+ or the native installer; otherwise use `NODE_EXTRA_CA_CERTS` |
| Requests fail only with gzip bodies through an inspection proxy | Proxy mishandles compressed request bodies | `CLAUDE_CODE_GZIP_REQUEST_BODIES=0` |
| Connection reset / handshake errors with mTLS | Cert or key path wrong, mismatched pair, expired pair | Check `--debug` for `mTLS: Loaded client certificate` lines; fix paths; rotate before expiry |
| Works in terminal, fails in background agents | Variables exported in the shell only | Put them in the `env` block of `~/.claude/settings.json` or managed settings |
| Variables ignored in Desktop/Cowork or cloud sessions | Those sessions read them only from managed settings and `~/.claude/settings.json` (or ignore them entirely in cloud sessions) | Move them to user or managed settings |
| Sign-in or plugin install fails | A required host is blocked | Check `references/hosts.md` |
| Response stalls then retries | Streaming watchdog fired | See `references/hosts.md` (timeouts section) |

## Where to set variables

- Variables exported in a shell are read once at startup; a running session does not pick up later changes.
- Every network variable can also go in the `env` block of `~/.claude/settings.json` (or managed settings). This is the only place that reliably reaches background agents, because they run under a shared supervisor process that inherits the environment of whichever shell started it first.
- `CLAUDE_CODE_CERT_STORE` has no dedicated schema key; set it via the `env` block or the process environment.

## Core rules (from the official docs)

- Proxy variables: `HTTPS_PROXY`, `HTTP_PROXY`, `NO_PROXY`. Lowercase variants work; the first one set wins in the order `https_proxy`, `HTTPS_PROXY`, `http_proxy`, `HTTP_PROXY`.
- `NO_PROXY` accepts space- or comma-separated lists, or `*` to bypass the proxy entirely.
- Basic auth goes in the URL (`http://user:pass@host:port`). Do not hardcode passwords in scripts.
- SOCKS proxies are not supported.
- Default CA trust is `bundled,system` (Mozilla set plus the OS store); narrow it with `CLAUDE_CODE_CERT_STORE=bundled` or `system`.
- mTLS: `CLAUDE_CODE_CLIENT_CERT`, `CLAUDE_CODE_CLIENT_KEY`, optional `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`. Replacing the files at the same paths rotates the pair; Claude Code re-reads after a connection-level failure.

The docs change over time. When a detail matters (a version number, a host list, a variable name), check the live page: https://code.claude.com/docs/en/corporate-proxy
Pliki w paczce (3)
  • SKILL.md 5 KB
  • references/hosts.md 2 KB
  • references/verify.md 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · v-ai-laboratory/claude-net-doctor90MIT
laurigates/claude-plugins100MIT

Migawka bazy z 13.11.2026 · wersja paczki 182db0a6ca60 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90mtls-trust-chain
    Konfiguruje i diagnozuje wzajemne TLS między usługami: certyfikaty klienta, łańcuchy zaufania, politykę siatki lub proxy i rotację.
  • 100managing-tls-certificates
    Zarządza certyfikatami TLS klastrów CockroachDB: konfiguracja CA, uwierzytelnianie certyfikatem klienta, rotacja, diagnoza błędów SSL/TLS i mTLS dla changefeedów CDC.
  • 100node-cert
    Naprawia zaufanie do certyfikatów Node.js za firmowymi proxy z inspekcją SSL: NODE_EXTRA_CA_CERTS, błąd UNABLE_TO_VERIFY_LEAF_SIGNATURE, npm, Claude Code i Gemini CLI w VPN.
  • 98performing-ssl-tls-inspection-configuration
    Konfiguruje inspekcję TLS na zaporach i proxy: odszyfrowanie, ponowne szyfrowanie, certyfikaty CA i wyjątki dla aplikacji z przypinaniem certyfikatów.
  • 100network-troubleshooting
    Systematycznie diagnozuje awarie sieciowe w pracy programisty, z naciskiem na bezpieczeństwo: odmowa połączenia, błędy DNS, certyfikaty TLS, proxy i timeouty rejestrów pakietów.
  • 100implementing-mtls-for-zero-trust-services
    Konfiguruje wzajemne uwierzytelnianie TLS między mikroserwisami w Pythonie, generuje certyfikaty i sprawdza łańcuchy oraz daty ważności.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.