Session Frozen or Stuck
What to do when Claude Code stops responding.
Recognizing a Frozen Session
Occasionally, a Claude Code session may stop producing output. You will notice the loading indicator spinning without any new text appearing. CodeMantis includes built-in stale connection detection — if no data is received for 60 seconds, the app flags the session as potentially stuck.
Step-by-Step Recovery
1. Wait briefly
Short pauses (10-30 seconds) are normal, especially when Claude is processing large files or complex requests. Give it a moment before taking action. The 60-second threshold exists specifically to distinguish normal processing delays from genuine stalls.
2. Use the Restart Session button
If the session has been unresponsive for more than a minute, click the Restart Session button in the chat toolbar. This terminates the current Claude Code process and starts a fresh one in the same project directory. Your previous messages will remain visible in the chat history.
3. Close and reopen the tab
If the Restart Session button does not resolve the issue, close the project tab entirely and reopen it. This reinitializes the connection and creates a new session from scratch.
4. Check your internet connection
Claude Code communicates with Anthropic's servers over the internet. A dropped or unstable connection will cause the session to hang. Verify that:
- Your Mac is connected to Wi-Fi or Ethernet.
- You can reach other websites in your browser.
- No VPN or firewall is blocking outbound connections to Anthropic's API.
Your Data Is Safe
Session history is preserved on Anthropic's servers, not just locally. If a session freezes and you restart, your conversation history is not lost — though the specific frozen response may not be recoverable. Any files Claude modified before the freeze remain saved on disk.
When to Restart vs. Wait
| Situation | Action |
|---|---|
| Loading indicator spinning for under 60 seconds | Wait |
| No output for over 60 seconds | Click Restart Session |
| Restart button does not help | Close and reopen the tab |
| Multiple sessions freezing repeatedly | Check your internet connection, then restart CodeMantis |
Persistent Freezing
If sessions freeze repeatedly across different projects, the issue is likely environmental. Try quitting CodeMantis entirely and relaunching it. If the problem continues, check Anthropic's status page for any ongoing service disruptions, or report the issue on GitHub Issues.