diff --git a/README-zh.md b/README-zh.md
index 861f6aef..c25dcf52 100755
--- a/README-zh.md
+++ b/README-zh.md
@@ -133,6 +133,13 @@ ChatDev 已从一个专门的软件开发多智能体系统演变为一个全面
     ```
     > 然后访问 Web 控制台：**[http://localhost:5173](http://localhost:5173)**。
 
+    > **💡 提示**：如果前端无法连接后端，可能是默认端口 `6400` 已被占用。
+    > 请将前后端同时切换到一个空闲端口，例如：
+    >
+    > * **后端**：启动时指定 `--port 6401`
+    > * **前端**：设置 `VITE_API_BASE_URL=http://localhost:6401`
+
+
 ### 🔑 配置
 
 *   **环境变量**：在项目根目录创建一个 `.env` 文件。
diff --git a/README.md b/README.md
index 158d4d07..66aaaaf9 100644
--- a/README.md
+++ b/README.md
@@ -134,6 +134,14 @@ See our paper in [Multi-Agent Collaboration via Evolving Orchestration](https://
     VITE_API_BASE_URL=http://localhost:6400 npm run dev
     ```
     > Then access the Web Console at **[http://localhost:5173](http://localhost:5173)**. 
+    
+    
+    > **💡 Tip**: If the frontend fails to connect to the backend, the default port `6400` may already be occupied.
+    > Please switch both services to an available port, for example:
+    >
+    > * **Backend**: start with `--port 6401`
+    > * **Frontend**: set `VITE_API_BASE_URL=http://localhost:6401`
+
 
 ### 🔑 Configuration