{"name":"--tmux","slug":"tmux","family":"cli","title":"CLI flags","noun":"CLI flag","description":"Create a tmux session for the worktree. Requires `--worktree`. Uses iTerm2 native panes when available; pass `--tmux=classic` for traditional tmux","description_source":"docs","described_by":{"doc":"claude-code\/cli-reference","title":"CLI reference"},"presence":{"first_seen":"2.1.138","removed_in":null,"in_current_build":true,"newest_mined":"2.1.308","builds":149,"mined_builds":149,"first_cited":{"version":"2.1.285","released_at":"2026-09-29 17:32:09","spans":1}},"aliases":[],"entries":[{"version":"2.1.285","anchor":"desktop-flag-rejected-when-combined-with-background-or-wor","heading":"New --desktop flag, and background commands now accept options in front of them","line":"`--desktop` opens the Claude Desktop app and now errors when combined with background or worktree options","released_at":"2026-09-29 17:32:09","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"tmux-worktree-relaunch-absolutizes-path-arguments","heading":"--tmux worktree relaunch absolutizes path arguments","line":"When --tmux relaunches Claude Code for a worktree, relative file paths in flags are now turned into full paths","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text, named in this entry"},{"version":"2.1.281","anchor":"tmux-worktree-fast-path-now-enforces-managed-policy","heading":"tmux worktree fast path now enforces managed policy","line":"Starting Claude Code with `--tmux` and `--worktree` now applies your organisation's managed policy and exits if the policy refuses","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text, named in this entry"},{"version":"2.1.281","anchor":"claude-tmux-worktree-passes-a-sanitized-env-to-tmux-s","heading":"claude --tmux --worktree passes a sanitized env to tmux, stops parsing at -- , and forwards args differently","line":"claude --tmux --worktree now gives tmux an explicit environment, stops reading its flags at --, and forwards arguments differently","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text, named in this entry"},{"version":"2.1.48","anchor":"notes","heading":"","line":null,"released_at":"2026-02-19 20:50:30","reason":"found in this entry's text"},{"version":"2.1.48","anchor":"tmux-integration-for-worktrees","heading":"Tmux Integration for Worktrees","line":null,"released_at":"2026-02-19 20:50:30","reason":"found in this entry's text"}],"entries_total":6,"docs":[{"source":"claude-code","path":"cli-reference","title":"CLI reference","documented":true},{"source":"claude-code","path":"changelog","title":"Claude Code changelog","documented":false},{"source":"claude-code","path":"corporate-launcher","title":"Run Claude Code behind a corporate launcher","documented":false}],"docs_total":3,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/cli\/tmux","family_url":"https:\/\/changelogs.core-directive.com\/reference\/cli.json"}