GUI.for.Clash User Guide

GUI.for.Clash Core Update, Subscriptions and System Proxy

GUI.for.Clash is a Mihomo-based desktop proxy client. Using the Windows app, this guide covers core setup, importing a subscription, starting a profile and checking the system proxy.

Guide details
Platforms
Windows / macOS
Core
Mihomo
Last updated

Step 01Download and install

Windows: Open this site’s download page and prefer its Windows ZIP matching your architecture. Use the official link on that page for other architectures. Extract all files to a writable folder and launch GUI.for.Clash.
Installation note: If WebView2 Runtime is missing, open the Microsoft Edge WebView2 Runtime download page, download and run the Evergreen Bootstrapper, then relaunch GUI.for.Clash after installation.

GUI.for.Clash Installer link on the Windows download page

macOS: Open this site’s download page and choose the ZIP for Intel or Apple Silicon. Extract it, move the app to a writable location such as Desktop, then launch GUI.for.Clash.
Installation note: If macOS cannot verify the developer, close the prompt first. After confirming the source, open the 隐私与安全 (Privacy & Security) page in 系统设置 (System Settings), select 仍要打开 (Open Anyway), then confirm as prompted.

ZIP package entry on the GUI.for.Clash macOS download page

Step 02Update the core

Click 设置 (Settings) → 核心 (Core). If no local core is available, click 立即更新 (Update Now). If downloading fails, check the log and network. If it still fails, follow the official usage guide to install the core manually, then restart the app.

GUI.for.Clash core download progress on macOS

Step 03Get a subscription

Copy the URL for a Clash/Mihomo-compatible subscription from your provider's dashboard. Using 畅连 as an example, open the subscription import window and click “复制订阅链接” (Copy subscription link).

Subscription-link copy control in the provider's import window

Step 04Add a subscription

Click 概览 (Overview) → 快速开始 (Quick Start).

Quick Start entry in GUI.for.Clash Overview

Enter a name in the left field and paste a compatible subscription URL in the right field → click 保存 (Save). The download creates a subscription and its linked profile. Return to Overview to find the profile. If it is missing, check the subscription response and download error, then retry.

GUI.for.Clash subscription URL save dialog on macOS

Step 05Start the core

In 概览 (Overview), select the new profile → 启动核心 (Start Core).

GUI.for.Clash Start Core button on macOS

If startup fails, open the log. Check for empty groups, invalid fields or resource-download errors, fix them and start again.

Step 06Choose a node

After startup, click 控制器 (Controller). Expand a policy group in the proxy panel and click a working node, or keep the profile’s automatic policy.

GUI.for.Clash expanded policy group and node selection on macOS

Step 07Enable system proxy

Return to 概览 (Overview), select 规则 (Rule) → enable 系统代理 (System Proxy). In a browser that follows the OS proxy, first open a site you can normally access directly, then one that needs the proxy. Check the connection records.

GUI.for.Clash system proxy, modes and Controller entry on macOS

If normal access fails, turn off the active system proxy or TUN and reopen a normally accessible site to check recovery.

Step 08Proxy modes explained

In 概览 (Overview), choose 规则 (Rule), 全局 (Global) or 直连 (Direct):

Rule follows the profile rules to a proxy group, direct access or rejection. Use it for everyday routing.

Global skips routing rules and uses the current proxy or policy in GLOBAL. Selecting DIRECT still goes direct. For troubleshooting, choose a working node to test, then return to Rule.

Direct reaches the destination without a proxy node. It does not stop the core or turn off system proxy.

Start the core, then send app traffic through 系统代理 (System Proxy) or TUN模式 (TUN Mode) to GUI.for.Clash. Modes only choose the outbound for received requests; they do not capture other apps automatically.

Verify the Connection Before Troubleshooting

  • Confirm the profile is active
  • Test the selected node
  • Check the matched rule
Troubleshoot Connection and Setup