How to pause Claude Code on Mac
Claude Code runs in Terminal via Node or its local versioned binary and reads both user and project MCP configs. Here is how to inspect, stop, and pause it cleanly on macOS.
What AI Stopper detects for Claude Code
- CLI command:
claudeon PATH, Homebrew directories, or~/.local/bin - Node entry points:
bin/claudeandnode_modules/@anthropic-ai/claude-code/cli.js - Local binary path:
~/.local/share/claude/versions/<version> - Snapshotted config files:
~/.claude.json,~/.claude/settings.json, project.mcp.json, and.claude/settings.local.json
How to stop Claude Code manually on macOS
- Save open edits in your editor and let any destructive shell command or migration finish.
- In the active Claude Code terminal, press Control + C to interrupt the current turn, then exit the session.
- Check other Terminal tabs, tmux windows, and IDE integrated terminals where another
claudesession or background subagent may still be running.
Check for running processes in Terminal (read-only):
ps -eo pid,ppid,comm,args | grep -Ei "claude-code|/claude($| )" | grep -v grep
Check config / MCP entries:
claude mcp list
Why manual quitting misses edge cases: Because Claude Code can spawn background subagents and MCP server child processes, closing one terminal tab does not always clear every related process. Inspecting processes—or pausing via AI Stopper—prevents stray agents from touching files while you switch to a confidential repo.
What happens when you pause Claude Code with AI Stopper
- Terminates exact matching Claude Code CLI processes and their descendant helpers without touching unrelated commands like
less ~/.claude/settings.json. - Snapshots
~/.claude.json,~/.claude/settings.json, and recognized project.mcp.json/.claude/settings.local.jsonlocally under~/.aistopper/. - Enables Restart Guard while paused and restores every saved config byte-for-byte when you click Resume Tools.