Tutorial Overview
ClashX is one of the most popular прокси-инструментs on macOS, with over 30,000 GitHub stars and 500,000+ active users. This tutorial will guide you step-by-step through downloading, installing, and configuring ClashX on Mac, with the entire process taking only 3 minutes.
Whether you're using an Intel-based MacBook or the latest Mac with M1/M2/M3 chips, this tutorial applies to you. We'll provide detailed screenshots and solutions to common problems to ensure even beginners can get started easily.
If you're already familiar with ClashX basics, вы можете jump directly to the Download Methods or Установка Steps sections. If you encounter any issues, check the Типичные проблемы section.
Why Choose ClashX?
- Полностью бесплатно: Open-source software with no fees required
- Powerful Features: Supports multiple протокол проксиs with flexible движок правил
- Excellent Производительность: Low память usage with stable and smooth operation
- Native Support: Perfectly adapted for Apple Silicon chips
- Активное сообщество: Complete Chinese documentation with timely problem solving
Pre-download Preparation
Before starting to download ClashX, please ensure your Mac meets the following system requirements. This will ensure the subsequent установка and usage process goes smoothly.
Системные требования
Chip Compatibility
ClashX provides two versions. Please choose the correct version based on your Mac's chip type:
| Chip Type | Compatible Models | Download Version |
|---|---|---|
| Intel 芯片 | 2020年前的 MacBook、iMac、Mac mini | ClashX (Intel) |
| Apple Silicon (M1/M2/M3) |
2020年后的 MacBook Air/Pro、 iMac、Mac mini、Mac Studio |
ClashX (Apple Silicon) |
Click the Apple icon in the top-left corner → Select "About This Mac" → Check the "Chip" or "Processor" field. If it shows "Apple M1/M2/M3", it's Apple Silicon; if it shows "Intel Core", it's an Intel chip.
Preparation Checklist
- ✅ Confirm macOS version is 10.15 or higher
- ✅ Confirm you have administrator privileges (пароль required for установка)
- ✅ Prepare proxy файл конфигурации or ссылка подписки
- ✅ Close other potentially conflicting proxy software
- ✅ Ensure сеть connection is normal
3 Download Methods
ClashX provides multiple download channels. You can choose the most suitable download method based on your situation. Here are detailed instructions for three mainstream download methods.
Method 1: Official Website Download (Recommended)
Downloading through the ClashX official website is the safest and most convenient method. The official website provides verified latest versions with detailed release notes.
Download Steps:
- Visit ClashX official website: https://clashx.tech
- Click the "Download" button or navigate to the download page
- Select the version suitable for your Mac chip (Intel or Apple Silicon)
- Click the download button and wait for download to complete
- Downloaded file is in .dmg format, approximately 10-15MB in size
Official website download is fast, versions are updated promptly, and files are safe and reliable. Suitable для большинства пользователей, especially users in China. The official website also provides detailed version changelogs and usage documentation.
Method 2: GitHub Download
GitHub is ClashX's с открытым исходным кодом hosting platform. You can download the latest or historical versions directly from the GitHub Releases page. This method is suitable for users who need specific versions or want to verify the code.
Download Steps:
- Visit ClashX GitHub repository: https://github.com/yichengchen/clashX
- Click the "Releases" link on the right
- Find the Assets section in the latest release
- Download ClashX.dmg (Intel) or ClashX-arm64.dmg (Apple Silicon)
GitHub access speed may be slow in China. If download speed is too slow, вы можете: 1. Use GitHub mirror acceleration service (such as ghproxy.com) 2. Wait for off-peak hours to download 3. Switch to official website download method
Method 3: Mirror Site Download
Some domestic mirror sites provide ClashX download services, which can solve GitHub's slow download speed problem.
Common Mirror Sites:
- Domestic CDN acceleration: Some tech communities provide accelerated downloads
- Open-source mirror sites: Such as Tsinghua University, USTC mirror sources
- Cloud storage shares: User-uploaded versions (pay attention to security)
When using third-party mirror sites for downloads, be sure to verify file integrity and security. It's recommended to prioritize official website or GitHub official channels. Avoid downloading from unknown sources to prevent viruses or malicious software.
Version Selection Recommendations
Detailed Установка Steps (Illustrated Tutorial)
After download completes, follow these steps to install. The entire установка process is very simple, similar to installing other macOS applications.
Step 1: Open DMG File
- Find the downloaded ClashX.dmg file in Finder (usually in the "Downloads" folder)
- Double-click to open the DMG file
- Wait a moment, the system will mount the disk image and pop up the установка window
Intel chip file name is ClashX.dmg, Apple Silicon file name is ClashX-arm64.dmg. Please make sure you downloaded the version suitable for your chip type.
Step 2: Drag to Applications Folder
- After opening the DMG file, you'll see the ClashX application icon and an Applications folder shortcut
- Drag the ClashX icon to the Applications folder
- Wait for copy to complete (usually only takes a few seconds)
- After copying completes, вы можете eject the DMG disk image
Step 3: First Time Opening ClashX
- Open Launchpad or go to the Applications folder
- Find and click the ClashX icon
- If you see a "cannot open" prompt, refer to the Типичные проблемы section below
When opening for the first time, macOS may show a "cannot open because unable to verify developer" prompt. This is a normal security mechanism. Solution: 1. Open "System Settings" → "Конфиденциальность & Security" 2. Find the "Open Anyway" button at the bottom and click it 3. Or, right-click on the ClashX icon → Select "Open" → Click "Open" in the popup
Step 4: Verify Установка
If ClashX launches successfully, you'll see a cat icon in the строка меню (top-right corner of screen). This indicates ClashX has been successfully installed and is running.
- ✅ Строка меню displays cat icon
- ✅ Clicking the icon shows menu options
- ✅ ClashX is in the Applications folder
First Launch Configuration
After ClashX установка completes, some basic configuration is still needed for normal use. This section will guide you through the first launch configuration process.
Allow System Permissions
When launching ClashX for the first time, the system will request multiple permissions. These permissions are necessary for ClashX to work properly.
Обязательно Permissions:
- Install Helper Tool: First launch will pop up a пароль input box, enter your Mac administrator пароль
- Сеть Access Permission: Allow ClashX to control сеть connections
- System Proxy Settings: Allow ClashX to modify системный прокси configuration
ClashX needs to install a helper tool to manage системный прокси settings. This helper tool needs elevated privileges to modify system-level сеть configuration, so it requires your administrator пароль. This is a one-time operation and won't ask for the пароль again.
Import Configuration File
ClashX needs a файл конфигурации to work. The файл конфигурации contains прокси-сервер information, routing rules, and other key settings. You can import configuration in two ways:
Method 1: Import via Подписка Link
- Click the ClashX icon in the строка меню
- Select "Config" → "Удалённая конфигурация" → "Manage"
- Click the "Add" button
- Paste your ссылка подписки (provided by proxy service provider)
- Click "OK", ClashX will automatically download and apply the configuration
Method 2: Import via Local File
- Prepare the файл конфигурации (usually .yaml format)
- Click the ClashX icon in the строка меню
- Select "Config" → "Open Config Folder"
- Copy the файл конфигурации to the opened folder
- Return to ClashX menu, select "Config" → Select your copied файл конфигурации
Configuration files are usually provided by proxy service providers. If you don't have a файл конфигурации or ссылка подписки yet, вам нужно to purchase a proxy service first. ClashX itself doesn't provide proxy service, it's just a client tool.
Select Proxy Mode
After importing configuration, вам нужно to select the appropriate режим прокси. ClashX provides three main modes:
| Mode | Описание | Suitable Scenarios |
|---|---|---|
| Глобальный режим | All трафик goes through proxy | Accessing all sites requiring proxy |
| Режим правил | Intelligent routing based on rules | Daily use (Recommended) |
| Прямой режим | Don't use proxy | Temporarily disable proxy |
For most users, Rule Mode рекомендуется. This mode automatically identifies sites requiring proxy, ensuring both access speed and saving трафик. Domestic sites go direct, foreign sites go through proxy, with intelligent routing.
Enable System Proxy
- Click the ClashX icon in the строка меню
- Make sure "Установить как системный прокси" option is checked
- Select "Режим исходящего трафика" → "Rule Mode"
- Now ClashX is working
Permission Settings Explained
To ensure ClashX works properly, system permissions need to be configured correctly. This section explains the purpose and configuration method of each permission.
Обязательно Permissions List
- Full Disk Access: Allow ClashX to read configuration and rule files
- Сеть Access Permission: Allow ClashX to make сеть connections
- Helper Tool Permission: Allow ClashX to modify системный прокси settings
Manual Authorization Steps
If permissions weren't correctly authorized at startup, вы можете manually set them following these steps:
- Open "System Settings" (or "System Preferences")
- Go to "Конфиденциальность & Security"
- Find "Full Disk Access" in the left list
- Click the lock icon to unlock, enter administrator пароль
- Click the "+" button, add ClashX application
- Make sure the switch next to ClashX is turned on
Брандмауэр Settings
If you have macOS брандмауэр enabled, вам нужно to allow ClashX connection requests:
- Open "System Settings" → "Сеть" → "Брандмауэр"
- Click the "Options" button
- Find ClashX in the application list
- Set to "Allow incoming connections"
These permissions are all necessary for ClashX to work properly. ClashX is с открытым исходным кодом software with publicly transparent code and won't abuse these permissions. All permissions are used for implementing proxy functionality and won't collect or upload your personal data.
Verify Установка Success
After completing all configuration, let's verify whether ClashX is working properly. Here are several verification methods.
Method 1: Check Menu Bar Icon
- ✅ Строка меню displays cat icon
- ✅ Icon color is normal (not gray)
- ✅ Clicking the icon shows complete menu
- ✅ "Установить как системный прокси" is checked
Method 2: Visit Test Websites
The most direct verification method is to visit some websites that usually require proxy:
- Visit Google.com to see if it opens normally
- Visit YouTube.com to see if videos load
- Visit Twitter.com to see if it displays normally
You can visit ip.sb or ipinfo.io to check your current IP address. If it shows the прокси-сервер's IP, ClashX is working properly.
Method 3: View Connection Logs
- Click the ClashX menu icon
- Select "Dashboard" or "Console"
- A web interface will open showing в реальном времени connection information
- Visit a few websites to see if connection records are generated
- If connection records appear, the proxy is working properly
Method 4: Latency Test
- Click the ClashX menu icon
- Select "Proxy" → "Policy Group"
- Click the "Speed Test" button
- System will test latency of each node
- If latency data is displayed, nodes are available
Типичные проблемы and Solutions
During the process of downloading, installing, or using ClashX, you may encounter some issues. This section lists the most common problems and their solutions.
Issue 1: Slow Download Speed
Downloading ClashX from GitHub is very slow or even fails.
Решения- Use the download link provided by this site (domestic CDN acceleration)
- Use GitHub mirror acceleration service
- Download during off-peak hours (late night or early morning)
- Use download tools (such as IDM, Motrix) for multi-threaded downloading
Issue 2: "Damaged and Cannot Open" Prompt
When opening ClashX, a prompt says "ClashX is damaged and can't be opened. You should move it to the Trash."
РешенияThis is caused by macOS's Gatekeeper security mechanism. Execute the following command:
sudo xattr -r -d com.apple.quarantine /Applications/ClashX.appSteps: 1. Open the "Терминал" app (in the "Other" folder in Launchpad) 2. Copy and paste the above command into Терминал 3. Press Enter, enter administrator пароль 4. Reopen ClashX
Issue 3: Cannot Install Helper Tool
At first launch, it prompts to install helper tool, but установка fails after entering пароль.
Решения- Make sure you're using an administrator account
- Allow ClashX установка in "System Settings" → "Конфиденциальность & Security"
- Restart Mac and try again
- Completely uninstall ClashX, clean up residual files, then reinstall
Issue 4: Configuration Import Failed
Error prompt when importing файл конфигурации or ссылка подписки.
Решения- Check if ссылка подписки is correct, without extra spaces or characters
- Verify файл конфигурации format is correct (YAML syntax)
- Try using the configuration validator on the tools page
- Contact proxy service provider for correct configuration
- Check ClashX log files for specific error information
Issue 5: M1/M2/M3 Chip Compatibility Issues
ClashX runs slowly or crashes frequently on Apple Silicon Mac.
Решения- Make sure downloaded version is Apple Silicon native version (arm64)
- Don't use Intel version running through Rosetta
- Update to latest version of ClashX
- If problems persist, submit Issue on GitHub
Issue 6: Proxy Not Working
ClashX shows running normally, but accessing websites still cannot use proxy.
Решения- Confirm "Установить как системный прокси" is checked
- Check if correct outbound mode is selected (Rule/Global)
- Test node latency, select available nodes
- Restart ClashX and browser
- Check if системный прокси settings were modified by other software
- Close other potentially conflicting proxy software
Issue 7: Permission Errors
Prompts for missing permissions or cannot modify system settings.
Решения- Check permissions in "System Settings" → "Конфиденциальность & Security"
- Make sure ClashX has "Full Disk Access" permission
- Reinstall helper tool
- Run ClashX as administrator
If the above solutions cannot solve your problem, вы можете: • Visit the FAQ page for more common questions • Search or submit issues on GitHub Issues • Join the ClashX Chinese community for help • Check complete tutorials for more usage tips
Дальнейшие шаги
Congratulations! You have successfully installed and configured ClashX. Now вы можете further optimize and customize ClashX for a better experience.
Recommended Follow-up Actions
- Learn rule configuration: Understand how to write and optimize Clash rules for intelligent routing → Configuration File Guide
- Optimize node selection: Learn how to тест скорости and select optimal nodes to improve proxy speed
- Set auto-start: Configure ClashX to start automatically at boot, no manual operation needed
- Backup файл конфигурацииs: Regularly backup configuration to avoid data loss
- Explore advanced features: режим TUN, DNS оптимизация, набор правил subscriptions, etc.
Related Tutorial Recommendations
Daily Usage Tips
| Совет | Описание |
|---|---|
| Quick Mode Switching | Use строка меню to quickly switch Global/Rule/Direct modes |
| Auto-update Subscriptions | Set scheduled auto-update subscriptions to keep nodes updated |
| View В реальном времени Logs | Monitor connection status and трафик through Dashboard |
| Rule Testing | Regularly test node latency to select optimal nodes |
Итоги
Through this tutorial, you have completed downloading, installing, and basic configuration of ClashX on Mac. As a powerful and полностью бесплатно прокси-инструмент, ClashX can meet most users' daily needs.
Content Covered in This Tutorial
- ✅ System requirements and chip compatibility check
- ✅ Three download methods (official website, GitHub, mirror sites)
- ✅ Detailed установка steps and illustrated instructions
- ✅ First launch configuration and permission settings
- ✅ Установка verification methods and testing techniques
- ✅ Common problem troubleshooting and solutions
- ✅ Follow-up оптимизация suggestions and usage tips
1. Choose correct version: Intel and Apple Silicon use different versions 2. Authorize necessary permissions: Helper tool and системный прокси permissions are required 3. Configuration file importance: Correct файл конфигурации is prerequisite for normal use 4. Rule mode recommended: Daily use recommended to use Rule mode for intelligent routing 5. Regular updates and maintenance: Keep software and configuration updated for best experience
Time Investment
Completing the entire установка and configuration process usually takes only 3-5 minutes. If you encounter problems, refer to the Типичные проблемы section of this tutorial, most problems can be solved within 10 minutes.
• Complete Usage Tutorial - Learn ClashX advanced features in depth • Configuration File Guide - Learn how to write and optimize configuration • FAQ - View more Q&A • Blog Articles - Learn usage tips and best practices
Hope this tutorial helps you! If you encounter any problems during use, feel free to visit our FAQ page or submit issues on GitHub. Enjoy a smooth сеть experience!