Ctrl+B background command not working in interactive mode
Issue Summary
The Ctrl+B keyboard shortcut for running background commands is not functional in Claude Code interactive mode across multiple terminal environments.
Environment Details
System Information:
- OS: macOS 14.6.0 (Darwin 24.6.0)
- Claude Code: Interactive CLI mode
- Terminals Tested:
- Tabby terminal
- macOS standard Terminal.app
- Shell: zsh (/bin/zsh)
Problem Description
When attempting to use Ctrl+B to run commands in the background, the functionality does not work. Commands run normally (foreground) instead of being executed in the background.
Steps to Reproduce
- Open Claude Code in interactive mode
- Type a long-running command:
sleep 5 && echo "Background task completed" - Press Ctrl+B (instead of Enter)
- Expected: Command runs in background, can continue conversation
- Actual: Command runs in foreground, blocks interaction
Configuration Attempts
Attempted to resolve potential key binding conflicts by modifying shell configurations:
~/.zshrc:
bindkey '^B' beep
unset "key[^B]"
~/.config/powershell/Microsoft.PowerShell_profile.ps1:
Remove-PSReadLineKeyHandler -Key Ctrl+B
After reloading configurations (source ~/.zshrc), bindkey | grep "^B" returns no results, confirming the binding was removed.
Current Workaround
Using standard background syntax works correctly:
sleep 5 && echo "Background task completed" &
Documentation Status
The Ctrl+B background command feature is not documented in the official Claude Code interactive mode documentation at:
https://docs.anthropic.com/en/docs/claude-code/interactive-mode
Impact
This prevents users from running long-running commands in the background while continuing to interact with Claude Code, reducing productivity in development workflows.
Request
Please clarify if:
- Ctrl+B background commands are an intended feature
- Additional configuration is required
- This is a known limitation or bug
Thank you for investigating this issue!
This issue has 15 comments on GitHub. Read the full discussion on GitHub ↗