Skip to main content

What are Background Commands in Claude Code

Background commands in Claude Code allow you to run bash processes in the background using Ctrl-b, enabling Claude to continue working on other tasks while long-running processes execute. This feature was introduced in v1.0.71 to eliminate the need for managing development servers across multiple terminal instances or tabs, dramatically improving developer experience by allowing seamless process management from a single Claude Code session.

How to Use Background Commands

Claude Code's background command system transforms any bash command into a non-blocking background process. Instead of waiting for commands to complete, Claude can immediately continue with other work while processes run independently.

Traditional blocking command (Claude waits):

npm run dev

Background command (Claude continues working):

Press Ctrl+b when Claude suggests running a command:

npm run dev
Manual Process Management

Background processes continue running independently and need to be manually shut down when no longer needed. Use ps aux | grep node to find running processes and kill -9 <process_id> to terminate them.

Claude Can Help

You can ask Claude to shut down background processes for you: "Please stop the development server running in the background" and Claude will find and terminate the appropriate processes.

See Also: Bash Mode|Claude Code Changelog|Bash Scripts|Terminal Setup