diff --git a/docs/users/integration-jetbrains.md b/docs/users/integration-jetbrains.md
index 3f4739eab..baced8149 100644
--- a/docs/users/integration-jetbrains.md
+++ b/docs/users/integration-jetbrains.md
@@ -16,6 +16,30 @@
 
 ### Installation
 
+#### Install from ACP Registry (Recommend)
+
+1. Install Qwen Code CLI:
+
+   ```bash
+   npm install -g @qwen-code/qwen-code
+   ```
+
+2. Open your JetBrains IDE and navigate to AI Chat tool window.
+
+3. Click **Add ACP Agent**, then click **Install**.
+
+   ![Install](https://img.alicdn.com/imgextra/i4/O1CN01qNdPCW1y8AcqxRgCy_!!6000000006533-2-tps-2490-1788.png)
+
+   For users using JetBrains AI Assistant and/or other ACP agents, click **Install From ACP Registry** in Agents List, then install Qwen Code ACP.
+
+   ![Add from Agents List](https://img.alicdn.com/imgextra/i2/O1CN01ZyOugP26BOKzNgZXx_!!6000000007623-2-tps-479-523.png)
+
+4. The Qwen Code agent should now be available in the AI Assistant panel.
+
+   ![Qwen Code in JetBrains AI Chat](https://img.alicdn.com/imgextra/i4/O1CN013kAVE41XVzbIZOxyv_!!6000000002930-2-tps-3188-2170.png)
+
+#### Manual Install (for older version of JetBrains IDEs)
+
 1. Install Qwen Code CLI:
 
    ```bash
diff --git a/docs/users/integration-zed.md b/docs/users/integration-zed.md
index 7379bf69b..003d31709 100644
--- a/docs/users/integration-zed.md
+++ b/docs/users/integration-zed.md
@@ -18,6 +18,24 @@
 
 ### Installation
 
+#### Install from ACP Registry (Recommend)
+
+1. Install Qwen Code CLI:
+
+```bash
+npm install -g @qwen-code/qwen-code
+```
+
+2. Download and install [Zed Editor](https://zed.dev/)
+
+3. In Zed, click the **settings button** in the top right corner, select **"Add agent"**, choose **"Install from Registry"**, find **Qwen Code**, then click **Install**.
+
+   ![ACP Registry](https://img.alicdn.com/imgextra/i4/O1CN0186ybL61EeG35fHFjy_!!6000000000376-2-tps-3056-1705.png)
+
+   ![Qwen Code ACP Installed](https://img.alicdn.com/imgextra/i1/O1CN01OXHhoR1J8irAvjs8F_!!6000000000984-2-tps-1247-703.png)
+
+#### Manual Install
+
 1. Install Qwen Code CLI:
 
 ```bash