Skip to content
BENIBIX Learn

--tmux Flag

Also known as claude --tmux, --tmux=classic

It opens a worktree session in its own tmux panes.

Think of it like

It is like you give each new job its own desk. It has its own lamp and chair.

Example

Lucy runs three tasks at once. Each starts with claude -w and --tmux, so each has its own branch and its own panes she can switch between.

Why it matters

Side-by-side tasks stay apart on screen as well as in the files.

Definition

--tmux opens a tmux session for a worktree, so the work gets its own panes in the terminal. It only works with --worktree, which gives the session its own copy of the files. On iTerm2 it uses iTerm2's own panes. Write --tmux=classic to get plain tmux instead.

Example code

bash
claude -w feature-auth --tmux
Start a worktree in its own tmux session.
--tmux puts each of these worktrees in its own panes.

Common mistake

Using --tmux alone. It needs --worktree too, or Claude Code will not start.

Key takeaways

  1. 1
    Needs --worktree. Always.
  2. 2
    Own panes. In the terminal.
  3. 3
    =classic. Plain tmux.

Learn it properly