Source: https://swgbar.com/fr/guides/ai-coding-agents-claude-code-cursor-swg-macos/
Language: fr

# Corriger 'unable to get local issuer certificate' dans Claude Code et Cursor sur Mac (SWG et MCP)

Corrigez l’erreur unable to get local issuer certificate dans Claude Code et Cursor derrière Zscaler, Netskope ou une SWG d’entreprise sur macOS — plus SWG bar MCP et contournement.

SWG bar · Mis à jour 19 novembre 2026

Si **Claude Code**, **Cursor**, **Windsurf** ou **Claude Desktop** échoue sur votre Mac professionnel avec `unable to get local issuer certificate`, `UNABLE_TO_GET_ISSUER_CERT_LOCALLY`, `self-signed certificate in certificate chain` ou `CERTIFICATE_VERIFY_FAILED`, la passerelle web sécurisée (SWG) de votre entreprise (telle que Zscaler, Netskope ou Cloudflare Gateway) effectue une **inspection SSL/HTTPS** et resigne les réponses d’API avec une CA racine d’entreprise à laquelle les runtimes Node.js et Electron ne font pas confiance par défaut.

Voici les deux correctifs sûrs sur macOS — configurer la confiance CA d’entreprise (`NODE_EXTRA_CA_CERTS` / certificats système Cursor) ou activer le contournement SWG par domaine sur les réseaux autorisés — ainsi que la marche à suivre pour connecter le **serveur MCP** intégré à SWG bar afin que votre agent de code IA diagnostique automatiquement les domaines inspectés.

## 1\. Confirmer quels noms d’hôte LLM ou registres sont interceptés

Avant de modifier vos profils shell ou réglages, vérifiez quels noms d’hôte exacts (`api.anthropic.com`, `api2.cursor.sh`, `registry.npmjs.org`, hôtes de connexion OAuth ou points de terminaison MCP) sont resignés sur votre Mac via **SWG bar → Domaines** ou la [CLI](<https://swgbar.com/fr/cli/>) `--json` :

```
swgbar overview --json
swgbar domains list --status confirmed --json
swgbar probe api.anthropic.com --json
swgbar domains detail registry.npmjs.org --json
```

Portez une attention particulière aux points de terminaison secondaires : un IDE IA contacte souvent des noms d’hôte distincts pour l’inférence de modèles, l’authentification, la télémétrie et les places de marché d’extensions.

## 2\. Corriger `unable to get local issuer certificate` dans Claude Code et Cursor

Évitez de définir `NODE_TLS_REJECT_UNAUTHORIZED=0`, qui désactive globalement la validation TLS et expose vos clés d’API sur les réseaux non fiables. Choisissez l’une des deux méthodes sûres ci-dessous :

### Option A : configurer la confiance de la CA racine d’entreprise (maintient le déchiffrement SWG actif)

Exportez la CA racine de votre entreprise, de Zscaler ou de Netskope au format PEM (par exemple `$HOME/.certs/corporate-ca.pem`) depuis Trousseau d’accès ou auprès de l’IT, puis configurez chaque outil :

*   **Claude Code** (`~/.zshrc` et `~/.claude/settings.json`) :

```
export NODE_EXTRA_CA_CERTS="$HOME/.certs/corporate-ca.pem"
```

```
{
  "env": {
    "NODE_EXTRA_CA_CERTS": "/Users/<your-user>/.certs/corporate-ca.pem",
    "CLAUDE_CODE_CERT_STORE": "bundled,system"
  }
}
```

*   **Cursor** (`Preferences: Open User Settings (JSON)`) : activez les certificats système (et désactivez éventuellement HTTP/2 si le proxy SWG interrompt le streaming), puis quittez complètement (`Cmd + Q`) et relancez Cursor depuis Terminal afin qu’il hérite de `NODE_EXTRA_CA_CERTS` :

```
{
  "http.experimental.systemCertificatesV2": true,
  "cursor.general.disableHttp2": true
}
```

Pour les commandes de bundles CA propres à Zscaler, Netskope et Cloudflare, consultez également [Inspection SSL Zscaler sur Mac](<https://swgbar.com/fr/guides/zscaler-ssl-inspection-bypass-mac/>), [Inspection SSL Netskope sur Mac](<https://swgbar.com/fr/guides/netskope-ssl-inspection-bypass-mac/>) et [Corriger les erreurs de certificats TLS et SSL liés à une SWG dans les outils CLI et IA](<https://swgbar.com/fr/guides/swg-tls-certificate-errors-macos/>).

### Option B : activer le contournement SWG par domaine sur un Mac autorisé

Lorsque vous travaillez sur un réseau que vous administrez ou êtes autorisé à configurer — en particulier si le streaming HTTP/2 ou le _certificate pinning_ échoue encore malgré `NODE_EXTRA_CA_CERTS` — activez le contournement par nom d’hôte via l’interface physique IPv4 `Matériel` de votre Mac dans **SWG bar → Domaines → Contourner la SWG → Activer le contournement pour ce domaine** ou dans Terminal :

```
swgbar bypass enable api.anthropic.com
swgbar bypass status --json
swgbar probe api.anthropic.com --json
```

Redémarrez Claude Code ou Cursor après l’apparition de **Contournement actif** afin que les sockets existants se rouvrent proprement. Si votre pare-feu d’entreprise bloque les connexions sortantes directes, désactivez le contournement (`swgbar bypass disable <domain>`) et utilisez l’Option A ou demandez à l’IT une règle **Do Not Decrypt**. Suivez [Comment contourner une SWG sur Mac](<https://swgbar.com/fr/guides/how-to-bypass-swg/>) pour la configuration complète et le comportement au redémarrage.

## 3\. Connecter SWG bar MCP à Claude Code ou Cursor

Vérifiez que [SWG bar est installé](<https://swgbar.com/fr/install/>) dans `/Applications/SWGBar.app` et fonctionne sur macOS 14+ (puce Apple). Enregistrez le serveur MCP stdio local en une commande pour **Claude Code** :

```
claude mcp add swgbar -- /Applications/SWGBar.app/Contents/MacOS/swgbar mcp
```

Ou ajoutez le bloc serveur dans `.cursor/mcp.json` (pour **Cursor**) ou `claude_desktop_config.json` (pour **Claude Desktop**) :

```
{
  "mcpServers": {
    "swgbar": {
      "command": "/Applications/SWGBar.app/Contents/MacOS/swgbar",
      "args": ["mcp"]
    }
  }
}
```

Consultez le [guide MCP complet](<https://swgbar.com/fr/mcp/>) pour découvrir tous les domaines d’outils exposés (**Vue d’ensemble**, **Domaines**, **Certificats**, **Contourner la SWG**, sondes à la demande, extension navigateur et préférences de l’application).

## Garder à l’esprit les limites des preuves locales

Le serveur MCP de SWG bar s’exécute localement via stdio sur la base de données locale de votre Mac : rien n’est transmis aux serveurs cloud de SWG bar. Évitez néanmoins de coller des informations brutes sur la CA racine de votre entreprise ou des noms d’hôte internes privés dans des rapports de bogues publics ; consultez [Autorisations de SWG bar et confidentialité locale](<https://swgbar.com/fr/guides/macos-network-extension-privacy-probe-limits/>) avant de partager des journaux de diagnostic.

## Pour aller plus loin

*   [Comment contourner une SWG sur Mac (contournement par domaine en 1 clic et CLI)](<https://swgbar.com/fr/guides/how-to-bypass-swg/>)
*   [Comment contourner l’inspection SSL sur Mac (SWG d’entreprise et par domaine)](<https://swgbar.com/fr/guides/bypass-ssl-inspection-mac/>)
*   [Comment contourner l’inspection HTTPS et TLS sur macOS (guide break-and-inspect)](<https://swgbar.com/fr/guides/bypass-https-tls-inspection-mac/>)
*   [Comment contourner l’inspection SSL d’un proxy d’entreprise et d’une SWG sur Mac](<https://swgbar.com/fr/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [Comment savoir si votre Mac est intercepté par une SWG (inspection HTTPS et SSL)](<https://swgbar.com/fr/guides/detect-https-inspection/>)
*   [Comment vérifier si votre employeur ou Mac professionnel intercepte HTTPS (inspection SSL)](<https://swgbar.com/fr/guides/check-if-work-mac-intercepting-https/>)
*   [Vérificateur d’inspection SSL pour Mac : outil de barre des menus pour détecter l’interception HTTPS](<https://swgbar.com/fr/guides/ssl-inspection-checker-mac/>)
*   [Inspection SSL Zscaler sur Mac : comment vérifier et contourner par domaine](<https://swgbar.com/fr/guides/zscaler-ssl-inspection-bypass-mac/>)
*   [Inspection SSL Netskope sur Mac : vérifier le déchiffrement et contourner par domaine](<https://swgbar.com/fr/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Inspection TLS Cloudflare WARP et Zero Trust sur Mac : détecter et contourner](<https://swgbar.com/fr/guides/cloudflare-warp-tls-inspection-mac/>)
*   [Inspection HTTPS Confirmé vs Suspecté dans SWG bar](<https://swgbar.com/fr/guides/confirmed-vs-suspected-https-inspection/>)
*   [Inspecter les certificats racines MITM et les émetteurs dans SWG bar](<https://swgbar.com/fr/guides/inspect-mitm-root-certificates-macos/>)
*   [Inspection HTTPS par SWG d’entreprise et MDM sur Mac](<https://swgbar.com/fr/guides/enterprise-swg-https-inspection-macos/>)
*   [Contournement de SWG vs exception d’inspection TLS (break-and-inspect)](<https://swgbar.com/fr/guides/swg-bypass-vs-tls-exception/>)
*   [Contourner la SWG pour applications web multi-domaines, SSO, CDN et API sur Mac](<https://swgbar.com/fr/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [Corriger Restauration…, Contournement en pause et erreurs de connexion SWG sur Mac](<https://swgbar.com/fr/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [Interfaces virtuelles VPN macOS vs inspection HTTPS d’une SWG](<https://swgbar.com/fr/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [Pourquoi les apps à certificate pinning et mTLS cassent sous inspection SWG](<https://swgbar.com/fr/guides/certificate-pinning-mtls-swg-inspection-macos/>)
*   [Corriger les erreurs de certificats TLS et SSL liés à une SWG dans les outils CLI et IA sur Mac](<https://swgbar.com/fr/guides/swg-tls-certificate-errors-macos/>)
*   [Confiance CA Homebrew, Docker, Python et Node.js derrière une SWG sur Mac](<https://swgbar.com/fr/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)
*   [Vérifier les certificats TLS avec openssl et security verify-cert sur Mac](<https://swgbar.com/fr/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [Autorisations de SWG bar, confidentialité locale et limites des sondes TLS](<https://swgbar.com/fr/guides/macos-network-extension-privacy-probe-limits/>)
*   [Comment SWG bar vérifie l’inspection HTTPS](<https://swgbar.com/fr/how-it-works/>)
*   [Télécharger et installer SWG bar pour Mac (macOS 14+)](<https://swgbar.com/fr/install/>)
*   [Extension Chrome pour détecter l’inspection SSL et HTTPS (compagnon SWG bar)](<https://swgbar.com/fr/chrome-extension/>)
*   [Guide de SWG bar CLI](<https://swgbar.com/fr/cli/>)
*   [Guide de SWG bar MCP](<https://swgbar.com/fr/mcp/>)
*   [Informations de version de SWG bar](<https://swgbar.com/fr/releases/>)
*   [À propos de SWG bar](<https://swgbar.com/fr/about/>)
