From 8b662a66a6f8e4f72005b9dc5fe65b735c13a580 Mon Sep 17 00:00:00 2001
From: leesu <admin@localhost>
Date: Wed, 1 Apr 2026 17:55:36 +0800
Subject: [PATCH] docs: add VPN/proxy requirement for China users

---
 guide.html | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/guide.html b/guide.html
index f20d61d..fcaba56 100644
--- a/guide.html
+++ b/guide.html
@@ -231,7 +231,18 @@
   <!-- ============================================================ -->
   <div class="section">
     <h2><span class="num">1</span>安装依赖软件</h2>
-    <p>需要安装 3 个软件。如果已装过可跳到下一步。</p>
+
+    <div class="alert danger">
+      <span class="alert-icon">&#9888;</span>
+      <div>
+        <strong>国内必须：代理/VPN 软件</strong><br>
+        Claude Code 启动时会检查 <code>api.anthropic.com</code>，国内无法直连。<br>
+        请先安装并启动代理软件（Clash / V2Ray / 快柠檬 / 任意 VPN），安装脚本会<strong>自动检测</strong>系统代理。<br>
+        无代理 = Claude Code 无法启动。
+      </div>
+    </div>
+
+    <p>需要安装以下软件。如果已装过可跳到下一步。</p>
 
     <!-- Node.js -->
     <div class="step">
@@ -560,6 +571,7 @@ Start-Process msiexec.exe -ArgumentList "/i $env:TEMP\node-install.msi" -Wait</c
       <li><strong>已获取 Gitea 账号密码</strong> &mdash; 管理员提供</li>
       <li><strong>已获取主密码</strong> &mdash; 管理员提供（用于解密 API 凭证）</li>
       <li><strong>能访问 code.letcareme.com</strong> &mdash; 浏览器打开确认</li>
+      <li><strong>代理/VPN 已启动</strong> &mdash; 国内必须，脚本自动检测 (Clash/V2Ray/快柠檬等)</li>
     </ul>
   </div>