diff --git a/CLAUDE.md b/CLAUDE.md
index d5f33ab..1fe1667 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -70,6 +70,35 @@ ssh vote "pm2 status"
 ssh vote "pm2 logs gala-server --lines 50"
 ```
 
+### 环境变量配置
+
+#### 服务端 `.env`
+
+```bash
+# 必需配置
+NODE_ENV=production
+DATABASE_URL=mysql://user:pass@localhost:3306/gala
+REDIS_HOST=localhost
+JWT_SECRET=your-secret-key
+ADMIN_ACCESS_CODE=your-admin-code
+MOBILE_CLIENT_URL=https://your-domain.com
+
+# 微信公众号（扫码登录）
+WECHAT_MP_APP_ID=your-mp-app-id
+WECHAT_MP_APP_SECRET=your-mp-app-secret
+WECHAT_MP_REDIRECT_ALLOWLIST=your-domain.com
+```
+
+#### 移动端 `packages/client-mobile/.env.production`
+
+```bash
+# 必须配置正确的生产环境地址，否则 API 调用会失败
+VITE_SOCKET_URL=https://your-domain.com
+VITE_API_URL=https://your-domain.com
+```
+
+> **注意**：如果 `VITE_API_URL` 为空，会使用默认的本地开发地址 `http://192.168.1.5:3000`，导致生产环境无法访问 API。
+
 ---
 
 ## 开发规范