--- source: https://code.claude.com/docs/en/interactive-mode title: Interactive mode --- ## [​](#keyboard-shortcuts) Keyboard shortcuts Keyboard shortcuts may vary by platform and terminal. Press `?` to see available shortcuts for your environment.**macOS users**: Option/Alt key shortcuts (`Alt+B`, `Alt+F`, `Alt+Y`, `Alt+M`, `Alt+P`) require configuring Option as Meta in your terminal: - **iTerm2**: Settings → Profiles → Keys → Set Left/Right Option key to “Esc+” - **Terminal.app**: Settings → Profiles → Keyboard → Check “Use Option as Meta Key” - **VS Code**: Settings → Profiles → Keys → Set Left/Right Option key to “Esc+” See [Terminal configuration](/docs/en/terminal-config) for details. ### [​](#general-controls) General controls | Shortcut | Description | Context | | --- | --- | --- | | `Ctrl+C` | Cancel current input or generation | Standard interrupt | | `Ctrl+D` | Exit Claude Code session | EOF signal | | `Ctrl+G` | Open in default text editor | Edit your prompt or custom response in your default text editor | | `Ctrl+L` | Clear terminal screen | Keeps conversation history | | `Ctrl+O` | Toggle verbose output | Shows detailed tool usage and execution | | `Ctrl+R` | Reverse search command history | Search through previous commands interactively | | `Ctrl+V` or `Cmd+V` (iTerm2) or `Alt+V` (Windows) | Paste image from clipboard | Pastes an image or path to an image file | | `Ctrl+B` | Background running tasks | Backgrounds bash commands and agents. Tmux users press twice | | `Left/Right arrows` | Cycle through dialog tabs | Navigate between tabs in permission dialogs and menus | | `Up/Down arrows` | Navigate command history | Recall previous inputs | | `Esc` + `Esc` | Rewind the code/conversation | Restore the code and/or conversation to a previous point | | `Shift+Tab` or `Alt+M` (some configurations) | Toggle permission modes | Switch between Auto-Accept Mode, Plan Mode, and normal mode | | `Option+P` (macOS) or `Alt+P` (Windows/Linux) | Switch model | Switch models without clearing your prompt | | `Option+T` (macOS) or `Alt+T` (Windows/Linux) | Toggle extended thinking | Enable or disable extended thinking mode. Run `/terminal-setup` first to enable this shortcut | ### [​](#text-editing) Text editing | Shortcut | Description | Context | | --- | --- | --- | | `Ctrl+K` | Delete to end of line | Stores deleted text for pasting | | `Ctrl+U` | Delete entire line | Stores deleted text for pasting | | `Ctrl+Y` | Paste deleted text | Paste text deleted with `Ctrl+K` or `Ctrl+U` | | `Alt+Y` (after `Ctrl+Y`) | Cycle paste history | After pasting, cycle through previously deleted text. Requires [Option as Meta](#keyboard-shortcuts) on macOS | | `Alt+B` | Move cursor back one word | Word navigation. Requires [Option as Meta](#keyboard-shortcuts) on macOS | | `Alt+F` | Move cursor forward one word | Word navigation. Requires [Option as Meta](#keyboard-shortcuts) on macOS | ### [​](#theme-and-display) Theme and display | Shortcut | Description | Context | | --- | --- | --- | | `Ctrl+T` | Toggle syntax highlighting for code blocks | Only works inside the `/theme` picker menu. Controls whether code in Claude’s responses uses syntax coloring | Syntax highlighting is only available in the native build of Claude Code. ### [​](#multiline-input) Multiline input | Method | Shortcut | Context | | --- | --- | --- | | Quick escape | `\` + `Enter` | Works in all terminals | | macOS default | `Option+Enter` | Default on macOS | | Shift+Enter | `Shift+Enter` | Works out of the box in iTerm2, WezTerm, Ghostty, Kitty | | Control sequence | `Ctrl+J` | Line feed character for multiline | | Paste mode | Paste directly | For code blocks, logs | Shift+Enter works without configuration in iTerm2, WezTerm, Ghostty, and Kitty. For other terminals (VS Code, Alacritty, Zed, Warp), run `/terminal-setup` to install the binding. ### [​](#quick-commands) Quick commands | Shortcut | Description | Notes | | --- | --- | --- | | `/` at start | Slash command | See [slash commands](/docs/en/slash-commands) | | `!` at start | Bash mode | Run commands directly and add execution output to the session | | `@` | File path mention | Trigger file path autocomplete | ## [​](#vim-editor-mode) Vim editor mode Enable vim-style editing with `/vim` command or configure permanently via `/config`. ### [​](#mode-switching) Mode switching | Command | Action | From mode | | --- | --- | --- | | `Esc` | Enter NORMAL mode | INSERT | | `i` | Insert before cursor | NORMAL | | `I` | Insert at beginning of line | NORMAL | | `a` | Insert after cursor | NORMAL | | `A` | Insert at end of line | NORMAL | | `o` | Open line below | NORMAL | | `O` | Open line above | NORMAL | ### [​](#navigation-normal-mode) Navigation (NORMAL mode) | Command | Action | | --- | --- | | `h`/`j`/`k`/`l` | Move left/down/up/right | | `w` | Next word | | `e` | End of word | | `b` | Previous word | | `0` | Beginning of line | | `$` | End of line | | `^` | First non-blank character | | `gg` | Beginning of input | | `G` | End of input | | `f{char}` | Jump to next occurrence of character | | `F{char}` | Jump to previous occurrence of character | | `t{char}` | Jump to just before next occurrence of character | | `T{char}` | Jump to just after previous occurrence of character | | `;` | Repeat last f/F/t/T motion | | `,` | Repeat last f/F/t/T motion in reverse | ### [​](#editing-normal-mode) Editing (NORMAL mode) | Command | Action | | --- | --- | | `x` | Delete character | | `dd` | Delete line | | `D` | Delete to end of line | | `dw`/`de`/`db` | Delete word/to end/back | | `cc` | Change line | | `C` | Change to end of line | | `cw`/`ce`/`cb` | Change word/to end/back | | `yy`/`Y` | Yank (copy) line | | `yw`/`ye`/`yb` | Yank word/to end/back | | `p` | Paste after cursor | | `P` | Paste before cursor | | `>>` | Indent line | | `<<` | Dedent line | | `J` | Join lines | | `.` | Repeat last change | ### [​](#text-objects-normal-mode) Text objects (NORMAL mode) Text objects work with operators like `d`, `c`, and `y`: | Command | Action | | --- | --- | | `iw`/`aw` | Inner/around word | | `iW`/`aW` | Inner/around WORD (whitespace-delimited) | | `i"`/`a"` | Inner/around double quotes | | `i'`/`a'` | Inner/around single quotes | | `i(`/`a(` | Inner/around parentheses | | `i[`/`a[` | Inner/around brackets | | `i{`/`a{` | Inner/around braces | ## [​](#command-history) Command history Claude Code maintains command history for the current session: - History is stored per working directory - Cleared with `/clear` command - Use Up/Down arrows to navigate (see keyboard shortcuts above) - **Note**: History expansion (`!`) is disabled by default ### [​](#reverse-search-with-ctrl+r) Reverse search with Ctrl+R Press `Ctrl+R` to interactively search through your command history: 1. **Start search**: Press `Ctrl+R` to activate reverse history search 2. **Type query**: Enter text to search for in previous commands - the search term will be highlighted in matching results 3. **Navigate matches**: Press `Ctrl+R` again to cycle through older matches 4. **Accept match**: - Press `Tab` or `Esc` to accept the current match and continue editing - Press `Enter` to accept and execute the command immediately 5. **Cancel search**: - Press `Ctrl+C` to cancel and restore your original input - Press `Backspace` on empty search to cancel The search displays matching commands with the search term highlighted, making it easy to find and reuse previous inputs. ## [​](#background-bash-commands) Background bash commands Claude Code supports running bash commands in the background, allowing you to continue working while long-running processes execute. ### [​](#how-backgrounding-works) How backgrounding works When Claude Code runs a command in the background, it runs the command asynchronously and immediately returns a background task ID. Claude Code can respond to new prompts while the command continues executing in the background. To run commands in the background, you can either: - Prompt Claude Code to run a command in the background - Press Ctrl+B to move a regular Bash tool invocation to the background. (Tmux users must press Ctrl+B twice due to tmux’s prefix key.) **Key features:** - Output is buffered and Claude can retrieve it using the TaskOutput tool - Background tasks have unique IDs for tracking and output retrieval - Background tasks are automatically cleaned up when Claude Code exits To disable all background task functionality, set the `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` environment variable to `1`. See [Environment variables](/docs/en/settings#environment-variables) for details. **Common backgrounded commands:** - Build tools (webpack, vite, make) - Package managers (npm, yarn, pnpm) - Test runners (jest, pytest) - Development servers - Long-running processes (docker, terraform) ### [​](#bash-mode-with-prefix) Bash mode with `!` prefix Run bash commands directly without going through Claude by prefixing your input with `!`: ```bash ! npm test ! git status ! ls -la ``` Bash mode: - Adds the command and its output to the conversation context - Shows real-time progress and output - Supports the same `Ctrl+B` backgrounding for long-running commands - Does not require Claude to interpret or approve the command This is useful for quick shell operations while maintaining conversation context. ## [​](#see-also) See also - [Slash commands](/docs/en/slash-commands) - Interactive session commands - [Checkpointing](/docs/en/checkpointing) - Rewind Claude’s edits and restore previous states - [CLI reference](/docs/en/cli-reference) - Command-line flags and options - [Settings](/docs/en/settings) - Configuration options - [Memory management](/docs/en/memory) - Managing CLAUDE.md files