«There was a problem communicating with the secure web proxy server (HTTPS)» (CFNetwork error 310) en el Mac

El Mac está configurado para usar un proxy HTTPS y el proxy no funciona. Falla toda app que siga el proxy del sistema.

Arréglalo con tu agenteCopia un prompt para Claude Code, Codex o cualquier agente que pueda usar Terminal.

Mi Mac tiene este problema: «There was a problem communicating with the secure web proxy server (HTTPS)» (CFNetwork error 310) en el Mac. Lee https://kilobat.app/es/guides/cfnetwork-error-310-problem-communicating-with-the-secure-web-proxy-server.md y resuélvelo conmigo. Instala la CLI de Kilobat si falta: brew install seifip/kilobat/kilobat. Ejecuta tú mismo las comprobaciones de Terminal y de kilobat de la guía y dime qué encuentras. Enumera los pasos que solo yo puedo hacer. Pregunta antes de cambiar cualquier ajuste.

Se aplica a: macOS 13 Ventura y posteriores. El texto se comprobó en CFNetwork de macOS 27.2.Revisado: 29 de octubre de 2026

Síntomas

  • Una app muestra «There was a problem communicating with the secure web proxy server (HTTPS).»
  • La Consola muestra kCFErrorDomainCFNetwork Code=310.
  • Safari muestra «can’t connect to the web proxy server».

Causas probables

  • Un proxy caído o incorrecto. La dirección o el puerto del proxy son incorrectos, o el proxy está apagado.
  • Un ajuste de proxy de una red antigua. El Mac conserva un proxy de trabajo.
  • Un perfil o una app que fija el proxy. Una VPN o una app de seguridad pueden fijarlo.

Cómo comprobarlo

  1. Muestra los ajustes de proxy que usa macOS.

    scutil --proxy
  2. Muestra el ajuste de proxy web seguro del Wi-Fi.

    networksetup -getsecurewebproxy Wi-Fi

Cómo solucionarlo

  1. Abre Ajustes del Sistema › Red › Wi-Fi › Detalles › Proxies. Desactiva «Proxy web seguro (HTTPS)» si no lo necesitas.

  2. Si lo necesitas, corrige la dirección y el puerto con tu administrador.

  3. Desactiva una VPN o una app de filtrado que fije el proxy.

  4. Cierra la app y ábrela de nuevo.

Con Kilobat

  1. Comprueba el Wi-Fi, el router, internet, el DNS y las páginas de inicio de sesión en un solo paso.

    kilobat diagnose
  2. Si falla un sitio o servicio concreto, busca la capa que lo bloquea.

    kilobat why example.com
  3. La CLI es gratis. En la app, los consejos de estas comprobaciones forman parte de Kilobat Pro. Consulta Averiguar por qué no conecta un sitio o una API.

Preguntas

¿Qué es 306?

306 es el mismo mensaje para el proxy web (HTTP). Consulta la línea de proxy HTTP en la lista Proxies.

¿Por qué fallan muchas apps a la vez?

Usan el mismo proxy del sistema.

Fuentes

  • Texto del error en CFNetwork.framework, macOS 27.2 (Localizable.loctable)
  • curl(1) y nc(1), página man incluida en macOS 27.2

Comprobado el 29 de octubre de 2026.