Lazy loaded image
Fix AntiGravity Access Once and for All, No TUN Mode Needed
Words 1550Read Time 4 min
2026-1-18
2026-1-19
type
status
date
slug
summary
tags
category
icon
password
😀
The core focus of this tutorial is to explain how to use AntiGravity’s open-source project Antigravity-proxy to resolve the inconvenience of having to enable TUN proxy mode when using the Google AntiGravity IDE in the past. It provides a detailed analysis of the drawbacks of the traditional TUN mode, introduces a new local socket–based proxy approach, and walks through the software download and configuration process with practical, step-by-step instructions. The tutorial helps users simplify the proxy environment for AntiGravity models, improving both usability and efficiency. Overall, the explanation is clear and easy to follow, with a strong emphasis on hands-on configuration and highlighting the key objective: how to efficiently configure a proxy and break free from TUN mode.
 

Core Knowledge Summary 📚

  • Traditional Proxy Pain Points of AntiGravity Models and Issues with TUN Mode
    • When using the Google AntiGravity IDE in the past, enabling TUN mode was mandatory. This mode proxies all system traffic, increasing local network load and making usage more complex.
    • TUN is a virtual network device that routes traffic from all applications through the proxy, which can negatively impact speed and overall proxy stability.
    • A new solution is introduced: Antigravity-proxy, which eliminates the need for TUN mode by using a local socket–based proxy instead.
  • Overview of the AntiGravity Project Solution
    • The Antigravity-proxy project works in conjunction with local proxy tools (such as v2rayN) to start local socket proxy ports (e.g., 10808 and 10809).
    • By simply enabling these two socket ports, users can access Google AntiGravity models without turning on TUN mode.
    • The setup is straightforward and avoids the hassle of repeatedly launching multiple complex applications.

Tutorial: Getting Started

  • Downloading and Installing AntiGravity
    • Visit the official Google AntiGravity website and download the 64-bit version for your operating system (approximately 152 MB).
    • The installation process is explained, with a recommendation not to install the software on the C drive to avoid potential permission issues.
    • Complete the installation with the default steps and get ready for the subsequent configuration.
  • AntiGravity Features and Built-in Top-Tier Models
    • AntiGravity is Google’s official AI IDE platform, integrating top-tier models such as Google Gemini 3, Cloud Silence 4/5, OPUS, and others.
    • After registration, users can access the platform for free for a limited period, making it suitable for AI model research and practical applications.
  • Preparing the Local Proxy Environment and Enabling LAN Access
    • A local proxy tool such as v2rayN must be running, and the option “Allow connections from LAN” should be enabled to ensure proxy access via 127.0.0.1.
    • The proxy port needs to be configured manually; in this example, port 10808 is used.
    • Important note: This step is critical to ensure that the AntiGravity software can successfully connect to the local proxy.
 
notion image
notion image
notion image
notion image
 
  • Downloading the Antigravity-proxy Project Files and Extracting Them
  • Download the 64-bit release version from the Antigravity-proxy project page and extract it to a suitable location.
 
notion image
notion image
 
  • After extraction, copy washington.dll and config.json into the same directory as the AntiGravity main executable, ensuring that the file structure is correct.
notion image
 
  • Editing the config.json Configuration File
    • Open config.json with a text editor.
    • Change the proxy type to socks5 and update the default port number from 7890 to the port configured in your local proxy software (in this example, 10808 as set in v2rayN).
    • Save the changes to complete the core configuration.
 
notion image
notion image
 
  • Running AntiGravity and Verifying Proxy Status
    • Launch the AntiGravity application and attempt to log in without enabling TUN mode. If you can log in successfully, the setup works. For confirmation, select an AntiGravity model and check whether it connects to the API through the proxy.
    • Use the v2rayN logs to verify that traffic is routed through the local SOCKS proxy, ensuring the proxy is functioning correctly.
    • The proxy configuration file will not be overwritten by online updates, allowing seamless usage—unless the software is completely uninstalled and reinstalled.
 
notion image
notion image
 
  • Tutorial Summary and Recommendations for Future Use
    • The configuration only needs to be done once; afterwards, the software can be launched without repeating the setup or running redundant proxy tools.
    • Quick and convenient, eliminating complex proxy startup steps.
    • Users are encouraged to leave feedback or ask questions.

Key Terms and Definitions ⚙️

  • AntiGravity: Google’s official AI integrated IDE, supporting the invocation and editing of multiple top-tier AI models.
  • TUN Proxy Mode: A virtual network device mode that proxies all system traffic, adding extra load.
  • Socket Proxy: A local proxy set up on a specific port (e.g., 10808) that routes traffic from selected programs only, offering more flexibility and efficiency.
  • SOCKS5 Proxy: A proxy type supporting multiple protocols, suitable for handling TCP connections and commonly used in local proxy software.
  • v2rayN: A widely used local proxy software for launching and managing SOCKS5 and other protocol proxies.
  • washington.dll and config.json: Key configuration files in the GunProperties project that define proxy type and connection parameters.

Reasoning Flow 🧠

  1. Premise: In mainland China, Google AntiGravity models require a proxy to access APIs.
  1. Problem: Traditional TUN mode proxies all system traffic, increasing local network load and making usage cumbersome.
  1. Solution: Use the Antigravity-proxy project to connect via a local socket proxy over LAN, avoiding global TUN proxy.
  1. Operation Steps:
      • Launch a local proxy tool (e.g., v2rayN) and set up a SOCKS5 proxy port.
      • Download and install the AntiGravity software.
      • Download the Antigravity-proxy configuration and DLL files, and copy them to the AntiGravity directory.
      • Modify config.json to match the local proxy port.
      • Launch AntiGravity, which automatically uses the local proxy to access models.
  1. Conclusion: This method greatly simplifies the setup process, avoids resource waste, and allows seamless use of AntiGravity models.

Example Walkthrough 🎯

  • Create a local SOCKS5 proxy on port 10808 using v2rayN, enabling the “Allow connections from LAN” option to ensure AntiGravity can access the proxy.
  • Launch the modified AntiGravity program, select an AI model (e.g., Cloud Silence 4/5), and observe the logs showing requests successfully routed through the SOCKS proxy, confirming the proxy configuration is correct.
This example demonstrates the entire workflow—from software installation, proxy setup, to model invocation—helping users grasp operational details.

Common Pitfalls ⚠️

  • Mistake: Using TUN mode to proxy all traffic, causing slow network and wasted resources.
    • Correct: Use a LAN SOCKS proxy to route only necessary traffic.
  • Mistake: Ignoring the local proxy’s “Allow connections from LAN” option, causing AntiGravity to fail to connect.
    • Correct: Enable this option to ensure LAN IP access.
  • Mistake: Failing to update config.json with the correct proxy port, leading to connection failure.
    • Correct: Ensure the proxy port matches the local proxy software.
  • Mistake: Installing AntiGravity on the C drive, which may cause permission issues.
    • Correct: Install on a non-system drive.

Review Tips and Self-Test 📝

Review Questions (without answers)
  • What are the differences between TUN mode and socket proxy?
  • How to configure local proxy software to support AntiGravity access?
  • What changes are needed in AntiGravity’s config.json?
  • Why enable “Allow connections from LAN” in the local proxy software?
Practice Questions (with answers)
  1. Question: What is the main drawback of TUN proxy mode?
    1. Answer: It proxies all system traffic, increasing local network load and making configuration complex.
  1. Question: What problem does the Antigravity-proxy project solve?
    1. Answer: It eliminates the need for TUN mode by using a local socket proxy, simplifying proxy configuration.
  1. Question: What port should the socks5 proxy in config.json be set to?
    1. Answer: It should match the port of the local SOCKS5 proxy, e.g., 10808.
  1. Question: Why install AntiGravity on a drive other than C?
    1. Answer: To avoid system permission restrictions affecting software operation and file writing.

Summary 🔍

This tutorial systematically introduces a new method to bypass the cumbersome TUN proxy mode when using Google AntiGravity IDE. By leveraging the Antigravity-proxy project and a local socket proxy, it greatly simplifies proxy setup and startup procedures. The guide walks users step by step—from proxy theory, software download, file configuration, to software operation and verification—providing clear hands-on guidance. Mastering this tutorial allows users to manage fewer programs, achieve stable and smooth access to Google’s top AI models, and improve learning and research efficiency.