diff --git a/frontend/CLAUDE.md b/frontend/CLAUDE.md
index 6af86ab..ab409e5 100644
--- a/frontend/CLAUDE.md
+++ b/frontend/CLAUDE.md
@@ -34,7 +34,7 @@ docker-compose -f docker-compose.dev.yml up --build
 
 - 访问：`http://localhost:3000`
 - 源码通过 volume 挂载，修改后自动热更新
-- API 请求通过 Vite proxy 转发到后端网关（默认 `http://host.docker.internal:80`）
+- API 请求通过 Vite proxy 转发到后端网关（默认走 Docker 网络容器名 `http://api-gateway`，需保证网关加入 `frontend_asset-helper-network`）
 
 **如需修改后端地址：**
 ```bash
diff --git a/frontend/docker-compose.dev.yml b/frontend/docker-compose.dev.yml
index 2483258..fa8bfe8 100644
--- a/frontend/docker-compose.dev.yml
+++ b/frontend/docker-compose.dev.yml
@@ -7,7 +7,8 @@ services:
     environment:
       - NODE_ENV=development
       - CHOKIDAR_USEPOLLING=true
-      - VITE_API_BASE_URL=${VITE_API_BASE_URL:-http://host.docker.internal:80}
+      # 走 Docker 网络容器名，规避 host.docker.internal 仅解析到 IPv6 导致的连接失败
+      - VITE_API_BASE_URL=${VITE_API_BASE_URL:-http://api-gateway}
     ports:
       - "3000:5173"
     volumes: