From 88149b6154e237086fdaac6de92a362cd138139f Mon Sep 17 00:00:00 2001
From: catlog22 <catlog22@github.com>
Date: Fri, 6 Mar 2026 11:43:14 +0800
Subject: [PATCH] =?UTF-8?q?fix:=20=E4=BD=BF=E7=94=A8127.0.0.1=E6=9B=BF?=
 =?UTF-8?q?=E4=BB=A3localhost=E4=BB=A5=E7=A1=AE=E4=BF=9DIPv4=E8=BF=9E?=
 =?UTF-8?q?=E6=8E=A5=EF=BC=8C=E9=81=BF=E5=85=8DIPv6=E8=A7=A3=E6=9E=90?=
 =?UTF-8?q?=E9=97=AE=E9=A2=98?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .claude/commands/workflow/analyze-with-file.md | 2 +-
 ccw/frontend/vite.config.ts                    | 3 ++-
 ccw/src/core/server.ts                         | 4 ++--
 3 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/.claude/commands/workflow/analyze-with-file.md b/.claude/commands/workflow/analyze-with-file.md
index c9520da5..0d927cd9 100644
--- a/.claude/commands/workflow/analyze-with-file.md
+++ b/.claude/commands/workflow/analyze-with-file.md
@@ -83,7 +83,7 @@ When `--yes` or `-y`: Auto-confirm exploration decisions, use recommended analys
 
 Codebase exploration FIRST, then CLI analysis.
 
-**Step 1: Codebase Exploration** (cli-explore-agent, parallel up to 4)
+**Step 1: Codebase Exploration** (cli-explore-agent, parallel up to 6)
 
 - **Single**: General codebase analysis → `{sessionFolder}/exploration-codebase.json`
 - **Multi-perspective**: Parallel per-perspective → `{sessionFolder}/explorations/{perspective}.json`
diff --git a/ccw/frontend/vite.config.ts b/ccw/frontend/vite.config.ts
index 682075aa..473ea53d 100644
--- a/ccw/frontend/vite.config.ts
+++ b/ccw/frontend/vite.config.ts
@@ -14,7 +14,8 @@ const basePath = process.env.VITE_BASE_URL || '/'
 
 // Backend target for Vite proxy (used when directly opening the Vite dev server port).
 // In `ccw view`, this is set to the dashboard server port so /api and /ws route correctly.
-const backendHost = process.env.VITE_BACKEND_HOST || 'localhost'
+// Use 127.0.0.1 instead of localhost to ensure IPv4 connection (avoid IPv6 resolution issues)
+const backendHost = process.env.VITE_BACKEND_HOST || '127.0.0.1'
 const backendPort = Number(process.env.VITE_BACKEND_PORT || '3456')
 const backendHttpTarget = `http://${backendHost}:${backendPort}`
 const backendWsTarget = `ws://${backendHost}:${backendPort}`
diff --git a/ccw/src/core/server.ts b/ccw/src/core/server.ts
index c75634bd..b346c0e5 100644
--- a/ccw/src/core/server.ts
+++ b/ccw/src/core/server.ts
@@ -771,7 +771,7 @@ export async function startServer(options: ServerOptions = {}): Promise<http.Ser
         }
 
         // Otherwise, proxy to Vite dev server
-        const reactUrl = `http://localhost:${reactPort}${pathname}${url.search}`;
+        const reactUrl = `http://127.0.0.1:${reactPort}${pathname}${url.search}`;
 
         try {
           // Convert headers to plain object for fetch
@@ -783,7 +783,7 @@ export async function startServer(options: ServerOptions = {}): Promise<http.Ser
               proxyHeaders[key] = value.join(', ');
             }
           }
-          proxyHeaders['host'] = `localhost:${reactPort}`;
+          proxyHeaders['host'] = `127.0.0.1:${reactPort}`;
 
           const reactResponse = await fetch(reactUrl, {
             method: req.method,