Overview

The quickest safe path is to choose a client for your operating system, import a provider subscription URL, update the profile, select a proxy group and use Rule mode for daily routing.

First run checklist

Download a maintained client for your platform.
Copy the subscription URL from the Changlian provider dashboard.
Import it as a remote profile and update it.
Select a node or proxy group.
Enable system proxy, VPN mode or TUN only as needed.

Recommended defaults

Use Rule mode first. Keep DNS settings unchanged until basic connectivity works. Avoid editing YAML manually before you understand the profile structure.

Next steps

After the first successful connection, learn rules, DNS and proxy groups so you can troubleshoot without replacing the whole client.

Reference examples

These examples mirror the corresponding Chinese documentation page so the English page carries the same configuration material.

$ go install github.com/Dreamacro/clash@latest
go: downloading github.com/Dreamacro/clash v1.15.1

$ $GOPATH/bin/clash -v
Clash unknown version darwin arm64 with go1.20.3 unknown time

$ git clone --depth 1 https://github.com/Dreamacro/clash
Cloning into 'clash'...
remote: Enumerating objects: 359, done.
remote: Counting objects: 100% (359/359), done.
remote: Compressing objects: 100% (325/325), done.
remote: Total 359 (delta 25), reused 232 (delta 17), pack-reused 0
Receiving objects: 100% (359/359), 248.99 KiB | 1.63 MiB/s, done.
Resolving deltas: 100% (25/25), done.
$ cd clash && make darwin-arm64
GOARCH=arm64 GOOS=darwin CGO_ENABLED=0 go build -trimpath -ldflags '-X "github.com/Dreamacro/clash/constant.Version=unknown version" -X "github.com/Dreamacro/clash/constant.BuildTime=Mon May  8 16:47:10 UTC 2023" -w -s -buildid=' -o bin/clash-darwin-arm64
$ file bin/clash-darwin-arm64
bin/clash-darwin-arm64: Mach-O 64-bit executable arm64

Reference links

Makefile

Getting Started