claude-code - 💡(How to fix) Fix [BUG] next dev freezes macOS (beachball) on 8GB Mac when Claude Code starts dev server [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#48163Fetched 2026-04-15 06:31:24
View on GitHub
Comments
1
Participants
2
Timeline
4
Reactions
0
Timeline (top)
labeled ×3commented ×1

Error Message

Error Messages/Logs

RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing issues and this hasn't been reported yet
  • This is a single bug report (please file separate reports for different bugs)
  • I am using the latest version of Claude Code

What's Wrong?

Title: next dev freezes macOS (beachball) on 8GB Mac when Claude Code starts dev server

Environment

Claude Code: 2.1.89 macOS: Darwin 25.3.0 (Apple Silicon / Intel — whichever you have) RAM: 8 GB Project: Next.js 16.2.3, React 19.2.4, Tailwind 4, TypeScript 5 What happened Claude Code started next dev (localhost:3000) for my project at /Users/KimAir/Documents/Claude/Jobber 2026/projects/nextjs/soboxai. Within seconds the machine locked up with a spinning beachball and I had to force-restart.

Expected The dev server should either start successfully or fail cleanly — it shouldn't take the OS down.

Impact Can't use Claude Code's preview/dev server on this project. Forced to run builds manually in a separate terminal where I can kill them.

Request

Add a memory check before Claude auto-starts next dev on low-RAM machines, OR Prompt the user before starting rather than auto-launching

What Should Happen?

next dev freezes macOS (beachball) on 8GB Mac when Claude Code starts dev server

Error Messages/Logs

Steps to Reproduce

next dev freezes macOS (beachball) on 8GB Mac when Claude Code starts dev server

Claude Model

None

Is this a regression?

Yes, this worked in a previous version

Last Working Version

No response

Claude Code Version

next dev freezes macOS (beachball) on 8GB Mac when Claude Code starts dev server

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

Additional Information

No response

extent analysis

TL;DR

Consider adding a manual prompt before starting the next dev server in Claude Code to prevent the system from freezing due to low RAM.

Guidance

  • The issue seems to be related to low RAM (8GB) on the Mac, causing the system to freeze when Claude Code starts the next dev server.
  • To mitigate this, a memory check before auto-starting next dev could be implemented, or a prompt could be added to warn the user about potential memory issues.
  • As a temporary workaround, the user could try running the next dev server manually in a separate terminal, allowing for easier termination if needed.
  • Investigating the project's dependencies and optimizing memory usage could also help prevent the system from freezing.

Example

No specific code example is provided, as the issue seems to be more related to system resources and configuration.

Notes

The exact cause of the issue is not explicitly stated, but it appears to be related to memory constraints. The suggested solutions are based on the information provided and may need to be adapted or refined based on further investigation.

Recommendation

Apply workaround: Add a manual prompt before starting the next dev server to prevent the system from freezing due to low RAM, as this seems to be a more immediate and feasible solution given the current information.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING