What You Need
- An installed Clash graphical client
- A working subscription link
- Correct system date, time, and time zone
- A basic network connection that can reach the subscription service
Follow “Import subscription → Choose proxy mode → Enable connection → Verify results” to complete the initial setup. This guide focuses on the common workflow for graphical clients, with no prior knowledge of configuration syntax required.
Before you begin, prepare a Clash graphical client suitable for your system and the subscription link generated by your service provider. A subscription link is usually a URL beginning with https://; it lets the client retrieve proxy nodes, policy groups, and routing rules. It is not a regular webpage address and should not be pasted into a browser search box. Add it to the client’s subscription or configuration page instead.
If the client is not installed yet, open the download page for your platform first. Menu locations and labels vary slightly, but the core workflow is the same: Windows and macOS clients usually call the entry “Subscriptions,” “Configurations,” or “Profiles”; Android clients may show “Configuration,” “Subscription Management,” or “Import from URL”; iOS clients generally add remote configurations from the configuration management page; Linux graphical clients work much like desktop clients.
Also confirm that the device date, time, and time zone are correct. HTTPS connections rely on certificate time validation, so a significant clock error can cause subscription updates and website access to fail. Temporarily close other tools that control the system proxy or VPN to prevent multiple programs from changing network settings at once. Keep the network environment simple during initial setup, then restore other tools one at a time after verification to make the source of any issue easier to identify.
A subscription link is a personal configuration entry and is usually tied to an account plan. Do not publish it on public pages, in screenshots, or in shared documents. If the link has been exposed, reset the subscription address in your provider’s dashboard and import the new address into the client.
After opening the Clash client, go to the subscription or configuration management page. On desktop clients, the entry is usually in the left navigation; on Android, it is often near the current configuration name on the home screen. Look for “Add Subscription,” “New Configuration,” “Import from URL,” or a plus button to open the add screen. If both “Local File” and “Remote Link” are available, choose the remote link so the subscription can be updated directly from the provider later.
Enter an easy-to-recognize name, such as “Daily Subscription” or the provider name, in the name field, then paste the complete subscription link into the URL field. Check that no spaces were added at either end, especially when copying from a chat app, and make sure periods, parentheses, and explanatory text were not included. Click “Save,” “Import,” or “Add” when everything looks correct. Some clients download the configuration immediately; others create the subscription entry first and require one more click on the update button.
Keep the client in the foreground during the update and wait for the status to change from “Updating” to a success state. Normally, the subscription entry will show the configuration name and most recent update time, while the proxy page will display policy groups. Group names are determined by the provider and may refer to node selection, automatic selection, failover, or a specific purpose. There is no need to edit them individually; confirming that the page is no longer blank means the client has parsed the configuration.
After the subscription downloads successfully, select it as the current configuration. Some clients activate the latest imported configuration automatically, while others keep the previous one active. If this step is skipped, the proxy groups shown later may still come from the old subscription. Check the current configuration name, update time, or proxy group names to confirm the switch.
After importing the subscription, find the automatic update option in the entry settings. Daily use does not require frequent refreshes, so choose an hourly interval offered by the client. Updating at startup can work well when switching devices often or when subscription content changes frequently. If the subscription service is occasionally unreachable, a failed startup update does not immediately invalidate the existing configuration; clients usually retain the last successfully downloaded content.
At this point, the client should show the current configuration and at least one selectable proxy strategy. Do not enable every network option yet. First choose a proxy mode so the client knows which requests should go through the proxy.
Open the client’s “Mode,” “Proxy Mode,” or “Mode” setting to find the three common options: rule, global, and direct. Rule mode is recommended for first-time use. It reads the routing rules in the current configuration and sends requests through a proxy strategy, directly, or blocks them based on the domain, IP, application, or other conditions. This allows proxy access where needed while keeping suitable requests on the local network.
Global mode sends most capturable traffic through one proxy strategy. It is useful for briefly checking whether a rule match is causing an access problem. For example, if a website fails in rule mode but works in global mode, inspect which rule matched that website instead of relying on global mode permanently. Global mode may route services that could connect directly through the proxy, so it is not recommended as the default.
Direct mode sends traffic without a proxy. It can temporarily pause proxying, compare network behavior, or help determine whether a fault is related to the current proxy configuration. Direct mode is not the same as quitting the client: the system proxy toggle, TUN capture, and background client process may remain active. During troubleshooting, check both the mode and the capture switches.
Uses configuration rules to decide between proxying and direct connection. Recommended for everyday use and used in the steps that follow.
Sends requests through a specified strategy, making it suitable for briefly testing whether rules affect the target website.
Bypasses proxy strategies to pause proxying or compare the current baseline network connection.
After selecting rule mode, open the “Proxy” or “Proxies” page. This shows the policy groups in the configuration, not necessarily a simple list of nodes. Some groups allow manual selection, some test nodes and choose an available one automatically, and others reference additional policy groups. For the first connection, find the group whose name resembles “Node Selection” or the main proxy entry, then choose an available strategy.
Latency results only show connection time to a specific test address; they do not represent download speed, video stability, or the real experience across every website. The goal of initial setup is to confirm that the route works, so choose a strategy that completes the test and remains stable rather than repeatedly chasing the smallest number. For policy group nesting, URL Test, failover, and rule matching order, continue with the rule-based routing section of the user manual.
The client now has the three prerequisites for a working setup: the current subscription, a proxy mode, and a selected strategy. The next step is to send system or application traffic through Clash. Selecting a node alone is not enough; without the system proxy or TUN enabled, the browser will usually connect directly.
Return to the client home screen or settings page and enable “System Proxy,” “System Proxy,” or a similar toggle. This directs applications that support system proxy settings to Clash’s local listening port. Most desktop browsers read the system proxy, so use it for the first verification instead of enabling TUN immediately.
Watch the client status after enabling it. Normally, the core shows that it is running, the system proxy remains enabled, and the log does not repeatedly report a port conflict or permission error. If the toggle turns off immediately, fully quit other proxy programs and restart the client. When another process occupies the port, Clash cannot listen properly; a selected subscription and strategy will not create a usable connection on their own.
Android and iOS clients usually capture traffic through the system VPN interface. On first launch, the system displays a connection permission prompt; after approval, a VPN indicator appears in the status bar. This permission only allows the client to create a local network tunnel. Actual traffic routing is still determined by the current Clash configuration and proxy mode. If permission is denied, the client may retain its configuration, but requests from other applications will not enter the proxy path.
If the browser works normally but a desktop application, game launcher, or command-line program consistently bypasses the proxy, consider enabling TUN. The first time TUN is enabled on a desktop system, the client may request administrator access, install a service, or create a virtual network adapter. Follow the client’s prompts, wait for the interface to come up, and reopen the application you want to test.
Do not change TUN, DNS, ports, and rules simultaneously before completing basic verification. Changing several options at once makes the source of a failure difficult to identify. If enabling TUN disconnects the entire device, turn TUN off first and confirm that the system proxy path still works, then check permissions, DNS interception, and routing settings. For a fuller explanation of TUN behavior and DNS configuration, see the TUN section of the user manual.
Once the connection toggle remains stable, keep the client running and move to the final step. Do not rely only on an “Connected” label, which usually means merely that the local core has started. A working setup also requires confirming that browser requests enter the client, match the expected rules, and receive a normal response.
Fully close and reopen the browser first to avoid old connections, cached data, or existing network sessions affecting the result. Visit a target website that requires a proxy in your current network environment while keeping Clash’s connection or log page visible. If the page opens normally and the client shows a connection record for the corresponding domain, the browser request has entered Clash.
Next, inspect the rule and strategy information for that connection. In rule mode, the client typically shows that the request matched a domain rule, rule set, or final rule, along with the policy group used. The target website should match the expected proxy strategy, while local services and sites suitable for direct access may show DIRECT. Seeing different requests use proxy and direct connections is exactly what indicates that rule-based routing is working.
If the page opens but the client shows no new connection record, the browser may not be reading the system proxy or may be using another network path. Confirm that the system proxy remains enabled, then check for a browser-specific proxy, extensions, or network modules in security software. You can also test with another browser that follows system proxy settings for comparison.
If the client logs the connection but the page times out, focus on which strategy handled the request. Switch to another available strategy and try again. If several strategies fail, check whether the subscription has expired, whether the basic network is stable, and what error type appears in the client log. If only one domain fails, briefly switch to global mode for testing. If global mode works while rule mode fails, the issue is usually rule matching or policy group selection.
For everyday use, keep rule mode and automatic subscription updates enabled, and toggle the system proxy as needed. Desktop clients do not need the link re-imported to update a subscription; click update on the existing subscription entry. If a mobile device briefly loses access after switching networks, disconnect and reconnect the local VPN interface so the system can rebuild the network tunnel.
When subscription content changes, confirm after updating that the current configuration is still selected and check whether the main policy group retained its previous choice. Some updates change policy group names or structure, so the old selection may no longer correspond. Open the proxy page and choose a strategy again; there is no need to delete and reinstall the client.
Check each layer from the subscription to system traffic capture, changing only one setting at a time. Most first-time setup issues can be located among the six checks below.
Check that the subscription updated successfully, is set as the current configuration, and that policy groups appear on the proxy page. Adding a subscription without selecting its configuration may leave later steps using old content.
Use rule mode for everyday testing first. If one website fails, briefly switch to global mode and compare the result to determine whether rule matching is involved.
A successful latency test does not mean every connection will be stable. Switch to another available strategy and send the request again, avoiding reuse of an old browser connection.
On desktop, confirm that the system proxy has not turned itself off. On mobile, confirm that system VPN permission was granted. If a special application ignores the system proxy, consider TUN.
Quit other proxies, VPNs, and programs that can modify system network settings, then restart Clash. If the log reports a port conflict, free the port or adjust the listening settings first.
DNS resolution failures, connection timeouts, insufficient permissions, and certificate errors have different causes. Note the time and target domain, then continue troubleshooting by error type in the user manual.