diff --git a/README.md b/README.md
index 1a2ab75d..8dab8d2f 100644
--- a/README.md
+++ b/README.md
@@ -85,6 +85,12 @@ npm install
 npm install -g .
 ```
 
+### Install globally with Homebrew (macOS/Linux)
+
+```bash
+brew install qwen-code
+```
+
 ## Quick Start
 
 ```bash