Ctrl+B background command not working in interactive mode

Resolved 💬 15 comments Opened Aug 12, 2025 by wangkanai Closed Jan 8, 2026

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

  1. Open Claude Code in interactive mode
  2. Type a long-running command: sleep 5 && echo "Background task completed"
  3. Press Ctrl+B (instead of Enter)
  4. Expected: Command runs in background, can continue conversation
  5. 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:

  1. Ctrl+B background commands are an intended feature
  2. Additional configuration is required
  3. This is a known limitation or bug

Thank you for investigating this issue!

View original on GitHub ↗

This issue has 15 comments on GitHub. Read the full discussion on GitHub ↗