Clash Verge Rev Guide
From installation to daily use — everything you need to configure subscriptions, the system proxy, Tun mode, and nodes in Clash Verge Rev v2.5.7.
Beginner setup order: install the latest build from the download center, import a Clash / Clash Meta subscription, update it until nodes appear, test and choose a stable node, then enable the system proxy. If the node count stays at 0, fix the subscription first; if nodes exist but traffic stays direct, check proxy, port, browser, and Tun settings.
Step 1: Download & install
Clash Verge Rev runs on Windows, macOS, and Linux. Head to the Download Center and grab the installer for your system — use this site’s download buttons to get the package.
-
Windows: Run the
.exeand follow the wizard. If SmartScreen warns you, click "More info → Run anyway". -
macOS: Open the
.dmgand drag the app to Applications. On first launch, if macOS blocks it, allow it under "System Settings → Privacy & Security". -
Linux: Use
sudo dpkg -ifor DEB,sudo rpm -ifor RPM, or make the AppImage executable and run it.
Not sure which architecture to download or how to clear each OS's warning? See installing on Windows, macOS & Linux; for a full first-run walkthrough, read the beginner guide.
Step 2: Import your subscription
Clash Verge Rev is only a proxy client — it does not include nodes. You'll need a subscription URL (in Clash / Clash Meta format) from your provider.
- Open the app and go to the "Profiles" page.
- Paste your subscription URL and click "Import".
- After importing, click the update button on the profile card to fetch the latest nodes.
Tip: If importing keeps spinning or fails, your current network probably can't reach the subscription URL. Try updating on another network, or set a working update proxy in the profile settings.
More on subscriptions in the blog: how to import a subscription and subscription shows no nodes.
Step 3: Pick a node & turn on the proxy
- Open the "Proxies" page to see the node groups from your subscription.
- Select a node manually, or run a "Latency Test" to let the client pick the fastest one.
- Go to "Settings" and enable "System Proxy" so most apps (like your browser) route through the proxy.
How to pick a node: see testing and choosing nodes.
Step 4: Tun mode (global routing)
Some apps ignore the system proxy (certain CLI tools, games). Enabling "Tun mode" creates a virtual network interface that captures all traffic for true global proxying. The first time you enable it, you'll need to grant admin permission to install the service. More in what Tun mode is and how to enable it.
Handy tips
- Rule-based routing: The default rules from your provider keep local traffic direct and route overseas traffic through the proxy — no manual setup needed. To customize, see rule-based routing basics.
- Config override: Use merge / script overrides under "Profiles" to customize rules without editing your provider's original config.
- WebDAV sync: Configure WebDAV under "Settings → Backup" to sync your config across devices.
Running into issues?
Match your symptom in common errors and how to fix them, or check the FAQ. If sites won't open or you suspect DNS pollution, see DNS setup & leak prevention. If that doesn't help, search or post on GitHub Issues. Ready to go? Get the latest v2.5.7 from the Download Center.
Quick FAQ
What is the right setup order for Clash Verge Rev beginners?
Install, import a subscription, update until nodes appear, test and choose a node, then enable the system proxy. This order isolates problems quickly: nodes first, connectivity second, proxy routing last.
Does Clash Verge Rev include nodes?
No. It is a client, not a node provider. You need a compatible subscription URL before the Proxies page can show usable nodes.
Should I use system proxy or Tun mode first?
Use system proxy first for normal browser traffic. Enable Tun mode when games, command-line tools, Telegram Desktop, or other apps bypass the proxy.
Browse tutorials by topic
Jump into cluster articles below — they extend this pillar guide.
Getting started
Hold the success bar in week one. Week two: learn Tun/rules/AI on demand; on shared PCs, agree who edits subscriptions.
Install Installing on Windows, macOS & LinuxMatch arch before installing. Upgrade via backup → overwrite → accept; on day one watch boot restore and subscription updates before Tun.
Setup How to Choose a Subscription ProviderIgnore vanity node counts. Confirm Clash Meta format and your regions; trial evening peak before annual billing.
Subscriptions
Follow a week-one health schedule after import. On shared PCs, isolate subscriptions so nobody deletes another person’s primary link.
Troubleshooting Subscription Shows No Nodes? FixesCompare the panel with the field checklist. After nodes appear, latency + system proxy accept; all-red goes to latency tests—not reinstall loops.
Setup Clash Verge Subscription Update Failing or Timing Out? Three Fixes I TestedCheck the panel before the client. Triage with the status-code card; rotate backup links by day—do not swap three times in one afternoon.
Proxy & advanced
Tun fits CLI/AI; browsing-only can stay on system proxy. Watch CPU/sleep stability; do not assume containers are captured.
Advanced Clash Verge Windows Service Mode: What It Is and How to InstallOn Windows, install and accept Service Mode before blaming the airport when Tun won't stay up.
Troubleshooting Browser Not Using the Clash Verge Proxy? A Step-by-Step DiagnosisVerify toggle and ports, then Connections. Use a toggle contrast test; if only one browser fails, check extensions first.
Advanced Clash Verge Rule vs Global vs Direct: Which Mode to UseRead the mode label and Connections hit line before flipping Rule / Global / Direct. Don't confuse dead nodes with the wrong mode.
Advanced Clash Verge Mixed Port Explained: HTTP and SOCKS SetupWhen Telegram or a terminal proxy fails, check the live mixed port in Settings before blaming nodes.
Advanced Rule-Based Routing BasicsSnapshot Merge before edits. After Rule/Global toggles, verify with Connections; prefer lean sets over mystery mega lists.
Rules Clash Verge Merge custom rules: write them and fix “not applying”Keep Merge as small patches. After edits, verify hits in Connections. If rules do not apply, check mode, syntax, and priority before adding more lines.
Rules Clash Verge script extensions: use, failures, risksScripts are powerful and risky. Prefer Merge for static exceptions; keep scripts short, understood, and instantly disable-able.
Rules Clash Verge chain/relay proxy setup and instability fixesChains can stitch exits but double failure points. Prove each hop alone, then chain; segment-disable when unstable.
Rules Steam downloads direct on Clash Verge (faster games)Steam downloads often should DIRECT. Patch via Merge, confirm in Connections, and never stack Tun with another game booster.
Advanced DNS Configuration & Leak PreventionAfter DNS edits, watch 24 hours. Do not give every device a different DNS story; roll back the snapshot first when things break.
DNS What fake-ip is in Clash Verge (and when to switch)fake-ip speeds routing with synthetic addresses. If apps break, contrast redir-host and filter LAN domains before reinstalling.
Tips Clash Verge Slow, Laggy or Dropping Packets? How to Speed It UpRun the 10-minute control at peak hours. If tuning fails, swap nodes/providers—do not endlessly edit DNS and rules.
Troubleshooting
Match the check card, then open the article. After upgrade storms, restore backups first and fix subscription → nodes → capture in order.
Troubleshooting Clash Verge Update Check Failed / In-App Update Won’t FinishA failed update check doesn't mean the client is dead. Compare version strings, then overlay a manual installer.
Troubleshooting Clash Verge Offline After Sleep / Wake: Proxy Stops WorkingOffline after lid-close: check whether Connections shows rows. Most cases need a full relaunch or Tun toggle.
Troubleshooting How to Safely Reset Clash Verge Config Without Losing SubscriptionsCopy subscription URLs and Merge before any reset. Reinstalling binaries often leaves a messy user config untouched.
Troubleshooting Clash Verge proxy group blank / no nodes showingIf a group is empty, check total nodes first, then filters and group references. Empty group ≠ dead provider by default.
Troubleshooting Clash Verge core communication error / core failed to startKill leftover cores first, then AV/ports, then repair/reinstall the core. Do not blame “communication error” for all-red nodes.
Troubleshooting Clash Verge high memory or CPU usage: what to trySplit UI vs core first. Stop aggressive testing/logging, check Tun and dual clients, then restart or upgrade.
Troubleshooting Proxy Is On but Google, YouTube or ChatGPT Won't Open — FixesWhen Connections has rows but pages fail, check rules/DNS/HTTPS inspection. IP works but domain fails → DNS first, not a client reinstall.
Troubleshooting Clash Verge Port Already in UseIdentify the occupant first. After changing ports, sync system proxy/IDE/phone and write the new port down to prevent repeats.
Diagnostics Read the Logs and Connections Pages to Diagnose Problems YourselfConnections first, logs second. Capture only the repro time window and redact tokens; map keywords to articles before editing.
Backup Where are Clash Verge config files? Paths, backup, resetLocate the config directory first, then back up or reset. Subscription URLs and Merge matter more than copying mystery folders blindly.
Backup Clash Verge WebDAV backup setup and failuresWebDAV is great for snapshots, not your only backup. Test a manual upload before automation; keep subscription URLs elsewhere too.
Windows
Allow only trusted sources. On shared PCs, do not permanently exclude Downloads; watch 24 hours for AV re-quarantine after allowing.
Windows Troubleshooting Clash Verge Starts with Windows but Proxy Does Not WorkAuto-start ≠ proxy written. Triage client → core → subscription → system proxy/Tun → network ready. AI/CLI still need Tun.
Troubleshooting Clash Verge Offline After Sleep / Wake: Proxy Stops WorkingOffline after lid-close: check whether Connections shows rows. Most cases need a full relaunch or Tun toggle.
Advanced Clash Verge Windows Service Mode: What It Is and How to InstallOn Windows, install and accept Service Mode before blaming the airport when Tun won't stay up.
Windows Advanced Make PowerShell, Git and npm Use the Clash Verge Proxy on WindowsA working browser does not mean the terminal is proxied. Confirm the mixed port, set HTTP_PROXY or tool config — or use Tun when you run many AI CLIs.
CLI proxy WSL2 through Clash Verge: env vars vs TunWSL2 does not inherit Windows system proxy. Point HTTP_PROXY at the host IP:mixed port, or validate Tun carefully. Confirm Linux egress in Connections.
Safety & platforms
Download only from verifiable channels. Appeal false positives with hashes and release pages—never switch to mystery “AV-proof” packs.
macOS Troubleshooting Clash Verge "Damaged / Can't Be Opened" on Mac? Here's the FixVerify a trusted download, then remove quarantine. After it opens, accept via import → latency → system proxy—do not enable Tun first.
Linux Install How to Install and Use Clash Verge Rev on Linux (Full Guide)Trust Connections, not the tray icon. Match package format and permissions; you can toggle proxy from the window without a tray.
Platforms & Devices Is There a Clash Verge Mobile App? Using It on Android & iOSOn travel, test both cellular and hotel Wi‑Fi. Agree on one subscription URL with desktop; whitelist background to avoid fake-online.
Install Installing on Windows, macOS & LinuxMatch arch before installing. Upgrade via backup → overwrite → accept; on day one watch boot restore and subscription updates before Tun.
Migration New PC or Fresh OS? Move Your Whole Clash Verge Setup AcrossKeep subscription URLs in a password manager and Merge dated. Finish restore acceptance before retiring the old PC; do not leave tokenized links in public cloud roots.
AI tools & app proxy
Stop per-app proxy sprawl. Test a live node, enable Tun, verify each tool in Connections. Geo errors need new nodes; ignored system proxy is what Tun solves.
App proxy What Is DeepSeek Harness? How It Differs from the ModelHarness decides how a model does work, not which weights you download. Separate those layers before you touch Clash Verge.
App proxy Try DeepSeek Harness Fast: npx @deepseek-ai/dsh webWant the UI first? Install Node, run one npx. If the download stalls, fix shell egress before cloning the monorepo.
App proxy Install DeepSeek Harness from Source: git clone + pnpmClone when you need plugins or mainline. Flow: clone → pnpm install → build → dsh web. Verify GitHub and registry egress separately.
App proxy Run DeepSeek Harness with Clash Verge ProxyA working API chat is not a working agent tool path. Make one outbound mini-task leave a Clash connection row before you tune anything else.
App proxy DeepSeek Harness for Teams: Web Deploy, Shared Instances, Clash ProxyThe Web UI binds to localhost and has no team login wall. Decide per-laptop vs one host + SSH tunnel before you share keys or workspaces.
App proxy Open Claude.ai and Claude Desktop through Clash VergeA working browser session is not a working desktop app. Accept Claude.ai first, then Desktop; do not debug them as if they were Claude Code.
App proxy Codex in VS Code or ChatGPT fails? Clash Verge proxy checksA working CLI is not a working VS Code extension. Accept ChatGPT web Codex, the VS Code extension, and Codex CLI as three layers.
App Proxy How to Access ChatGPT Behind a Proxy: Fixing unsupported_countryAfter switching accounts, re-run one chat acceptance. Team workspaces may be stricter—pin a verified exit.
App Proxy How to Access Google Gemini Behind a Proxy: Region Limits & SetupAccept with one chat in Connections. Region blocks with rows mean swap egress; Google Search working ≠ Gemini working.
App Proxy How to Use Claude Code Behind a Proxy: Clash Verge Terminal SetupAccept with one chat in a fresh terminal. After Claude Code upgrades, recheck Tun/env vars; do not keep a different port story from Cursor.
App Proxy How to Use OpenAI Codex Behind a Proxy: Clash Verge Setup & FixesUnify ports when multiple Codex installs coexist. Under forced corporate PAC, use Tun or direct office domains while proxying model traffic.
App Proxy How to Set Up a Proxy for Cursor AI Editor: Fixing TimeoutsRe-verify one completion after workspace trust changes. Direct or off-peak large index/npm traffic so it does not crowd model nodes.
App Proxy How to Set Up a Proxy for GitHub Copilot: Login & Timeout FixesAfter major IDE updates, re-run one completion acceptance. Separate timeouts from auth; do not twist corporate PAC and Clash together.
App Proxy How to Set Up a Proxy for Aider AI Coding CLI: Timeout FixesPin a verified node before long jobs. If the repo hard-codes a proxy, switch it to env vars or Tun before moving machines.
App proxy Telegram & Discord through Clash VergeDesktop Telegram/Discord often ignore system proxy. Fill 127.0.0.1:mixed-port or enable Tun; treat voice as a separate UDP/node check.
Streaming YouTube/Netflix buffering or blocked on Clash VergeProve proxy capture first, then use streaming-capable nodes with enough bandwidth. Low latency is not 4K capacity.
Comparisons
Treat Rev as the maintained client line. Subscriptions usually migrate; scripts/paths may need tweaks. Verify the Release, not the blog title.
Comparisons Clash Verge vs Clash Meta: how to chooseRev for maintained desktop GUI; Meta often means kernel ecosystem or Android apps. Reuse subscriptions; do not dual-run desktop GUIs.
Comparison Clash Verge Rev vs Clash for WindowsBefore uninstalling CFW, confirm boot restore and Tun on the new setup. Do not expect 100% plugin-path compatibility—trust Connections.
Comparison Same Mihomo Core, Different GUIs: Which Clash Client Should You Pick?A/B the same subscription for cold start/Tun/updates/source. Review screenshots cannot replace your Connections page.
Comparison Clash Verge Rev Alternatives: FlClash, Nyanpasu & What to Pick in 2026On migration day change only the GUI or only the provider—not both. Stop if the trial table fails.