[DOCS] Missing documentation for Suspend/Resume (Ctrl+Z) shortcuts in Interactive Mode

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/interactive-mode

Section/Topic

Keyboard shortcuts > General controls

Current Documentation

The "General controls" table currently lists shortcuts like Ctrl+C (Cancel), Ctrl+D (Exit), Ctrl+G (Editor), and Ctrl+L (Clear), but it jumps from Ctrl+B (Background tasks) to Left/Right arrows.

There is no mention of process suspension.

What's Wrong or Missing?

Standard CLI process suspension (Ctrl+Z) and the subsequent resumption command (fg) are fully supported by Claude Code and have been referenced as functional in recent changelogs (e.g., v1.0.44 and v2.1.9 regarding signal handling and TTY fixes).

However, these are not listed in the Interactive Mode documentation. Users who are not Unix power-users may not know they can suspend Claude Code to perform quick terminal tasks and return to their session without exiting or starting a new agentic background task.

Suggested Improvement

Add a row to the General controls table in docs/en/interactive-mode.md:

| Shortcut | Description | Context |
| :--- | :--- | :--- |
| Ctrl+Z | Suspend Claude Code | Suspends the current session and returns you to your shell. Use fg in your terminal to resume the session. |

Impact

High - Prevents users from using a feature

Additional Context

• Evidence of existence: The Claude Code changelog for v1.0.44 specifically mentions "Improved handling of Ctrl+Z suspension," and v2.1.9 notes "Fixed issue where Ctrl+Z would occasionally hang the TTY."
• Example of good documentation: Most CLI tool documentation (like Vim or Zsh guides) explicitly lists job control shortcuts to help users manage their terminal real estate effectively. Including this helps distinguish between Ctrl+B (which backgrounds a sub-task inside Claude) and Ctrl+Z (which backgrounds the entire Claude process).