diff --git a/clinical-web/.env.example b/clinical-web/.env.example
index 9ec79e2..a5e3f84 100644
--- a/clinical-web/.env.example
+++ b/clinical-web/.env.example
@@ -1,6 +1,11 @@
 VITE_APP_NAME=medical-sign-clinical
 VITE_API_BASE_URL=/api
 
+# API 代理目标：Vite 开发代理会把 /api 转发到此地址（见 vite.config.ts）。
+# 留空或注释掉时使用 vite.config.ts 里的默认值 http://127.0.0.1:18080（本地后端）。
+# 本地只有前端、无本地后端时，可改为远程真实后端，例如：
+# VITE_API_PROXY_TARGET=https://ipad.shenynet.com
+
 # Mock 开关：按业务模块（对齐侧边栏菜单）独立控制，取值只认 true / false。
 # 留空或注释掉即使用该模块的缺省值，缺省值以 src/utils/mock-flags.ts 为准，
 # 目前只有签署工作台缺省走演示数据；文档库及其余已接入模块缺省走真实接口。