CLAUDE_CODE_TMUX_SESSION
Updated by Alex Sorokoletov
CLAUDE_CODE_TMUX_SESSION is a Claude Code environment variable: Tmux session name shown in UI header. Present since v2.1.69 or earlier and still present in v2.1.294. It is not in the official reference.
| Status | Present in v2.1.294 |
|---|---|
| Added | Present since v2.1.69 or earlier |
| Category | Terminal and UI |
| Official docs | Not listed |
How to set it
For one session, export it in the shell that starts Claude Code:
export CLAUDE_CODE_TMUX_SESSION=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_CODE_TMUX_SESSION": "<value>"
}
}Release notes that mention it
Related variables
CLAUDE_CODE_TMUX_PREFIX: Tmux prefix key shown in detach instructions.CLAUDE_CODE_TMUX_PREFIX_CONFLICTS: Show prefix twice when key conflicts in tmux.CLAUDE_CODE_TMUX_TRUECOLOR: Controls truecolor (24-bit) rendering when running inside tmux.CLAUDE_AX_PREPARK_MSCLAUDE_AX_SCREEN_READERCLAUDE_AX_STARTUP_QUIET_MS: Startup quiet window (milliseconds) for screen-reader mode.CLAUDE_CODE_ACCESSIBILITY: Enable accessibility mode; disables cursor hiding.CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT
Frequently asked questions
What does CLAUDE_CODE_TMUX_SESSION do?
Tmux session name shown in UI header
Which Claude Code version has CLAUDE_CODE_TMUX_SESSION?
Present since v2.1.69 or earlier and still present in v2.1.294.
How do I set CLAUDE_CODE_TMUX_SESSION?
Export it before starting Claude Code (export CLAUDE_CODE_TMUX_SESSION=value), or add it to the "env" object in ~/.claude/settings.json to apply it to every session.
All variables, searchable: Claude Code environment variables.