Preview panel stuck on 'Awaiting server...' when app returns 302 redirect on root path
Status Fixed / completed
Maintainer reply None cached
Workaround ✓ Mentioned in description ↑
Activity 3 comments · opened May 8, 2026 · closed May 19, 2026
Bug Report
Summary
The Claude Code Desktop preview panel gets stuck on "Awaiting server..." indefinitely when the dev server returns a 302 redirect on the root path /, even though the server is fully up and healthy.
Steps to Reproduce
- Start a dev server that responds to
GET /with a302 redirect(e.g. Flask/Indico which redirects/→/bootstrap→/login) - Open the preview panel in Claude Code Desktop
- Observe that the panel shows "Awaiting server..." and never loads
Expected Behavior
The preview panel should:
- Follow
3xxredirects and render the final destination, or - Treat any
3xxresponse as "server is up" and load the page
Actual Behavior
The preview panel polls GET / and only proceeds on 200 OK. A 302 response is treated as "server not ready", causing it to loop forever.
Workaround
Open http://localhost:<port> directly in a browser — the server works fine there.
Environment
- Claude Code Desktop (macOS)
- Reproducible with any server that issues a redirect on the root path (Flask, Rails, Django, etc.)
Additional Context
Confirmed the server was fully healthy during reproduction:
curl http://localhost:8000/→HTTP 302(fast, ~9ms)curl http://localhost:8000/login/→HTTP 200- All backing services (PostgreSQL, Redis, SMTP) responding normally
The fix could be as simple as treating 3xx status codes as "server ready" in the health-check poll, or configuring the preview to follow redirects before rendering.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗