• Docs
  • Docs
Quick Start
Agent setup
Claude Code setup
Codex setup
Cursor setup
Visual Studio Code Copilot setup
Web browser proxy setup
SDK setup
Vertex AI

Web browser proxy setup

  • aiproxy running locally (examples assume http://localhost:8080)
  • Complete the Quick Start → TLS certificate steps so your OS trusts the aiproxy certificate authority

Firefox

  1. Open Settings → General → Network Settings → Settings….
  2. Select Manual proxy configuration.
  3. Enter localhost for HTTP Proxy and set the port to 8080.
  4. Check Use this proxy server for all protocols.
  5. Click OK, then restart Firefox.

Google Chrome (and Chromium-based browsers)

Chrome delegates proxy settings to the operating system:

  • macOS: open System Settings → Network → Proxies, enable Web Proxy (HTTP) and Secure Web Proxy (HTTPS), and set both to localhost:8080.
  • Windows: open Settings → Network & Internet → Proxy, enable Use a proxy server, and set the address to localhost with port 8080.
  • Linux (GNOME): open Settings → Network → Network Proxy, choose Manual, and set HTTP/HTTPS to localhost:8080.
  • Linux (KDE Plasma): open System Settings → Wifi & Internet, select Proxy, choose Manual proxy configuration, and set HTTP/HTTPS to localhost with port 8080.

Restart Chrome after making the change.

Microsoft Edge

Edge uses the same system proxy settings as Chrome. Apply the instructions above for your operating system, then restart Edge.

Safari

Safari follows macOS network preferences:

  1. Open System Settings → Network.
  2. Select the active interface, click Details, then visit the Proxies tab.
  3. Enable Web Proxy (HTTP) and Secure Web Proxy (HTTPS).
  4. Set both to localhost port 8080, click OK, then Apply.
  5. Restart Safari.

We currently test with chatgpt.com and capture all traffic through aiproxy. Support for additional AI-backed web apps is on the roadmap.

    On this page

  • Firefox
  • Google Chrome (and Chromium-based browsers)
  • Microsoft Edge
  • Safari