Diagram RUMEN-03 · Getting Started · Est. time: 10 min

Setting Up Clash: From Subscription Import to Verified Connection

This page is a lightweight build path: starting from subscription import, through mode selection and connecting, ending at verification — four diagrams, followed in order, get your first setup done. Each diagram states what to click, what you'll see, and what comes next; anything touching on underlying mechanics or field-level detail is flagged with a pointer to the Config Handbook and the FAQ, and isn't expanded on here.

PLATFORM DIFFERENCES NOTE All Clash clients work the same way under the hood, with minor wording differences in the UI: this page uses Clash Verge Rev (Windows / macOS / Linux) as the reference and calls out the equivalent spots in Clash Plus, FlClash, ClashX Meta (macOS menu bar), and Clash Meta for Android at key steps. Haven't installed a client yet? Grab one from the Downloads page; not sure which to pick, check the Client Comparison.
Diagram A-00

Before You Start

Check off these four prerequisites — skip any one and the later steps will stall partway through.

P-1 Client installed

Make sure you have a Clash client installed and can open its main window without errors. If not, grab one from the Downloads page for your platform — the top pick for each platform is flagged with a badge.

P-2 Subscription link ready

A subscription link is a long URL starting with https://, provided by your proxy service in its user dashboard, usually behind a "Copy Subscription" button. Treat it like a login credential — keep it private and don't share it.

P-3 System clock accurate

Most proxy protocols are sensitive to clock drift between client and server — too large a gap and every node handshake will fail. Make sure automatic time sync is on and your time zone is set correctly.

P-4 Other proxy tools closed

Similar tools compete for the system proxy setting and local ports. Quit any other proxy or VPN software before starting, to avoid port conflicts and proxy-setting overrides that look like real bugs but aren't.

Diagram A-01

Import Subscription

Hand your provider's subscription link to the client, which pulls the node list and preset rules automatically.

A subscription is essentially a config file hosted on the provider's side, already populated with available nodes, proxy groups, and routing rules. Once the client has the link, it periodically re-fetches updates, so you never have to manually maintain the node list — this is the step with the most moving parts, and the one most worth getting right.

  • Copy the subscription link

    Log into your provider's dashboard and find the "Copy Subscription" or one-click subscribe button. Make sure the whole link comes through intact — no stray spaces or line breaks at either end. A trailing space from a manual copy is the single most common cause of import failures.

  • Paste it into the client

    Open Clash Verge Rev, go to the "Profiles" tab in the left sidebar, and paste the link into the field at the top, then click "Import" on the right. The client fetches it immediately, and within a few seconds a new profile card appears named after the subscription, showing the node count and traffic info (if the provider includes that data). Equivalent spots in other clients: in Clash Plus, click "Add Subscription" on the home screen; in FlClash, go to "Profiles," tap the "+" in the bottom right, and choose "Import from URL"; in ClashX Meta, use the menu bar icon → "Config → Managed Config → Add"; in Clash Meta for Android, go to "Profiles," tap "+," choose "URL," paste, and save.

  • Activate the profile

    A successful import doesn't mean it's active yet. In Clash Verge Rev, click the profile card that just appeared — a highlighted border means it's now the active one. Switch to the "Proxies" tab and you should see the proxy groups and nodes from the subscription expand one by one. If "Proxies" is still empty, go back to "Profiles" and confirm the card is selected, or click its refresh icon to re-fetch.

IMPORT FAILURE CHECKLIST NOTE If the import errors out or spins forever, the usual suspects, in order, are: an incomplete link copy, an expired subscription, or your current network simply being unable to reach the subscription URL. If none of those explain it, work through the matching entry under the FAQ's Setup & Installation section instead of retrying this step over and over.

A-01 done → subscription and nodes are in place; the next diagram decides how traffic gets routed Continue to A-02

Diagram A-02

Choose a Proxy Mode

Mode decides the routing logic; node decides the actual proxy exit — both get set in this step.

Clash offers three modes with clearly distinct behavior: Rule mode matches traffic against the rules in your config — domestic sites go direct, anything matched by a rule goes through the proxy — and it's the standard choice for everyday use; Global mode skips all rule matching and routes every request through the proxy exit, which noticeably slows down local sites, so it's best used briefly for testing or edge cases; Direct mode disables the proxy entirely, effectively a temporary off switch. For a first setup, just pick Rule mode — your subscription already ships with a working rule set.

  • Switch to Rule mode

    In Clash Verge Rev, the "Proxies" tab has a row of mode buttons at the top (Rule / Global / Direct) — click "Rule" to select it. In ClashX Meta, check "Rule" under the "Proxy Mode" submenu from the menu bar icon; Clash Meta for Android and FlClash both expose a mode switcher on the main screen — look for "Rule." The change takes effect immediately, no restart needed.

  • Pick a node in a proxy group

    The "Proxies" tab lists nodes grouped by proxy group. Find the main group named something like "Proxy," "PROXY," or similar, and click a node inside it to set it as the active exit. Most subscriptions also include an auto-select group (often labeled "Auto") that has the client pick the fastest node by latency automatically — the easiest option if you don't want to compare manually.

  • Run a latency test before you commit

    Each proxy group has a lightning bolt or waveform icon in the top right — click it and the client tests latency for every node in the group. Within a few seconds, each node shows a number in milliseconds: lower is faster, and any node showing "timeout" is temporarily unusable, so just avoid those. Pick a node with stable, low latency and this step is done.

DEEPER DETAIL REF The rule syntax behind Rule mode — DOMAIN-SUFFIX, GEOIP, RULE-SET, and the like — along with matching order and custom rule writing, is covered in the Rules chapter of the Config Handbook and isn't expanded on here.

A-02 done → routing logic and exit node are set; the next diagram connects your device's traffic to Clash Continue to A-03

Diagram A-03

Connect

The first two steps just drew the blueprint — this one flips the main switch and actually routes your device's traffic through Clash.

Once Clash starts, it's just listening on a local port — traffic doesn't flow in on its own. Desktop and mobile hook in differently, so they're covered separately.

  • Desktop: enable the system proxy

    In Clash Verge Rev, find the "System Proxy" toggle on the "Settings" page. Turning it on points your system's proxy settings at Clash's local mixed port (7897 by default; older core versions commonly used 7890 — check the Settings page for the exact value). From then on, browsers and most apps that respect system proxy settings will route through this port into the rule engine. In ClashX Meta, the equivalent is checking "Set as System Proxy" from the menu bar icon. Once enabled, the main window or menu bar icon shows a status change confirming the system proxy is registered.

  • Desktop, optional: use TUN mode to capture everything

    Some apps — CLI tools, certain games, and other client software — ignore the system proxy setting entirely, so enabling it won't touch their traffic. To capture that as well, turn on "TUN Mode" on the "Settings" page: the client creates a virtual network adapter and intercepts all outbound traffic at the network layer. The first time you enable it, you'll be prompted to install a service or grant admin rights — a one-time authorization that persists afterward. For light everyday use, the system proxy alone is usually enough; see the FAQ's Tips & Tricks section for when TUN mode makes sense and what to watch out for.

  • Android: authorize the VPN connection

    In Clash Meta for Android, tap the start button at the bottom of the main screen. The system shows a "Connection request" dialog — tap "OK" (or "Allow"). This is Android's VpnService mechanism setting up a local tunnel, not handing your traffic to a third-party VPN service. Once authorized, a key icon appears in the status bar, confirming the tunnel is up. Some Android phones' battery-saving features can kill background tunnels — add the client to your battery optimization whitelist to avoid random disconnects.

  • Optional: enable auto-start on boot

    If you want the proxy running as soon as your device boots, enable "Launch on Boot" (or "Auto Start") on the desktop client's "Settings" page — pair it with "Silent Start" so the client stays minimized in the tray instead of popping open its main window. This step doesn't affect today's setup and can be configured any time after you're done.

NOTE A toggle being on doesn't guarantee the proxy is actually working — the system proxy setting can get overridden by other software, and the TUN service might not have been authorized successfully. Once these switches are set, don't skip verification — the next diagram walks through the checks.

A-03 done → traffic is now routed through Clash; the final diagram is your acceptance test Continue to A-04

Diagram A-04

Verify

Three checks, working outward: traffic inside the client, exit location in the browser, and an end-to-end command-line test.

  • Check 1: connection activity in the client

    Open the "Connections" tab in Clash Verge Rev's left sidebar (other clients may call it "Connections," "Logs," or similar), then open any webpage in your browser. If new entries keep scrolling into the panel, each tagged with the rule it matched and its exit (DIRECT or a node name), traffic is genuinely flowing through the rule engine. If the panel stays empty, nothing's getting through — go back to A-03 and check your system proxy or VPN authorization.

  • Check 2: confirm the exit location in a browser

    Open any IP-lookup page in your browser that shows the visitor's location. In Rule mode, visiting a site outside your country should show a location matching the node you picked in A-02. If it still shows your ISP's local address, that request went direct instead — either the rule set didn't match it, or something else is overriding the system proxy. Work through the FAQ's Troubleshooting section to sort it out.

  • Check 3: verify the port from the command line

    A terminal ignores the system proxy setting, which makes it perfect for testing Clash's local port in isolation. Run the following command (use the mixed port from your client's settings page — Clash Verge Rev defaults to 7897; the example below uses the traditional default, 7890):

    curl -x http://127.0.0.1:7890 https://www.gstatic.com/generate_204 -I

    A response header starting with HTTP/1.1 204 or 200 confirms the full chain — local port → rule engine → exit node — is working. "Connection refused" means the port number is wrong or the client isn't running; a timeout usually means the node itself is down — go back to A-02 and pick a node with normal latency instead.

ALL CHECKS PASSED If all three checks pass, your setup is done: leave Rule mode running day to day, and the client will keep the subscription updated automatically — no manual upkeep needed. If any check fails, its symptom points you straight to the diagram to revisit — that's far faster than reinstalling and hoping for the best.
Appendix REF

After You're Done

That covers first-time setup — for anything deeper or ongoing maintenance, use the index below.

REF-1 · Deeper Configuration

Config Handbook

A systematic reference covering the YAML structure, proxy and proxy-group fields, and rule syntax with merge overrides — every section comes with examples.

Read the Config Handbook →
REF-2 · Maintenance Reference

FAQ

Covers the four most common categories — basics, setup & installation, tips & tricks, and troubleshooting — wrapping up every loose thread this guide pointed to.

Browse the FAQ →
REF-3 · Picking the Right Client

Client Comparison

A side-by-side look at features and maintenance status across clients on every platform — check this table before switching devices or clients.

See the comparison →