CLI flags issues on Linux
Issues the maintainers labelled both platform:linux and area:cli.
226 issues · 54 open · 172 resolved (76%) · first seen Feb 24, 2026
Is this getting better or worse?
This class of problem is converging. 68 new reports in the last 90 days vs 91 in the 90 before — -25%. The open backlog peaked at 54 in 2026-10 and sits at 54 today.
Derived by counting each matching issue from its creation date until it closed. First-party
computation over the anthropics/claude-code tracker — the trend is not published
anywhere upstream.
Which builds report this
194 of these reports name the Claude Code build they were running, spanning 118 releases. Heaviest reporters:
- Claude Code v2.1.119
- Claude Code v2.1.81
- Claude Code v2.1.233
- Claude Code v2.1.112
- Claude Code v2.1.126
- Claude Code v2.1.139
- Claude Code v2.1.101
- Claude Code v2.1.85
Report volume, not a defect count: an issue can mention a build without that build having caused the failure. Versions come from the version string in the bug-report template, matched against real published tags.
Do these get fixed?
Median time to close is 31 days across 172 closures. Of the 172 closures with a recorded reason, 23% were closed as completed and 133 as not-planned or duplicate. The most recent completed fix landed in 2026-10.
Workarounds reported by the community
60 of these issues post a workaround someone says worked. The highest-engagement ones:
- /continue and /resume show all sessions across projects instead of current project only (regression in 2.1.101)
- …e --all to list sessions across all projects Happy to use a workaround in the meantime, but this is noticeably worse ergonomics than 2.1.100
Found in the thread of #46445 · resolved - /remote-control (/rc) not recognized as built-in command in existing session
- …, kernel 6.8.0-101-generic) - Authentication: logged in via Workaround Starting a new session with from the terminal works correctly.
Found in the description of #28322 · resolved - [BUG] Remote Control: AskUserQuestion selections made on mobile not received by CLI — causes infinite wait
- …o be affected, but AskUserQuestion is the confirmed case. - Workaround: Reject the tool call on the PC side manually, or type the response directly in the PC terminal.
Found in the description of #28508 · still open - [BUG] DISABLE_TELEMETRY=1 breaks remote-control with misleading "not yet enabled" error
- …not confirm it's one of the settings already mentioned. Two workarounds that worked: 1. Launch so that selecting Opus actually selects the 1M context variant. 2. Enable Extra Usage (in claude.ai settings) with any monthl…
Found in the thread of #29580 · still open - /resume shows sessions from all directories instead of current directory (regression in 2.1.98-2.1.101)
- …ktree fix introduced in v2.1.100 ("Fixed from worktrees") - Workaround: downgrade to 2.1.97 via
Found in the description of #46784 · resolved
Excerpts are quoted from the linked issue so you can judge relevance before opening it. Threads that only ask for a workaround, or report that there is none, are excluded. These are community suggestions, not official guidance from Anthropic — read the full thread before applying one.
Matching issues 1–100
Ranked by community engagement (reactions weighted over comments).
- /continue and /resume show all sessions across projects instead of current project only (regression in 2.1.101)
- /remote-control (/rc) not recognized as built-in command in existing session
- [BUG] Remote Control: AskUserQuestion selections made on mobile not received by CLI — causes infinite wait
- [BUG] DISABLE_TELEMETRY=1 breaks remote-control with misleading "not yet enabled" error
- /resume shows sessions from all directories instead of current directory (regression in 2.1.98-2.1.101)
- [BUG] `--resume` drops the session's `--effort` level, invalidating the prompt cache
- [BUG] Headless `claude -p` (entrypoint `sdk-cli`) uses ~1.8× more of the 5-hour window per token than interactive `cli`, same workload
- --channels flag suppresses plan mode tools (ExitPlanMode, AskUserQuestion, EnterPlanMode)
- `--continue` on 2.1.90 silently drops conversation context (regression from 2.1.89)
- Remote Control not enabled on Max plan account
- Remote Control: stale environment registrations cannot be removed from claude.ai/code picker
- /clear creates a new session instead of clearing current context — misleading command semantics
- Feature request: built-in, cross-platform way to list running Claude Code sessions and their state
- claude update bails out on false-positive npm-global detection when npm prefix == native install bin dir
- remote-control: resume/surface prior session for a directory on restart
- claude -p returns empty stdout despite generating output tokens
- [BUG] Use API key over the Claude Code Max Plan when API config is set to false in headless mode
- Guest passes link shows as invalid despite 2 passes remaining
- claude -p with OAuth (no API key) bills as API usage, not Max subscription
- [BUG] --output-format stream-json intermittently hangs — process stops producing output and never exits
- [Feature Request] Expose Remote Control connection status via state file or CLI flag for external tooling
- [BUG] Headless --json-schema: model serializes an array property as XML text inside a string property, then either retry-exhausts (error_max_structured_output_retries) or silently accepts a placeholder
- UKH is not a function: crash on --resume when onSessionRestored callback is undefined
- [BUG] Two built-in commands share the name /design: canvas skill vs Claude Design consent command
- [BUG] '--bg' is not enabled. If this is unexpected, retry in a moment.
- /doctor falsely flags native installer as 'Leftover npm global installation'
- CLI sessions missing from /resume list due to missing ai-title
- [Bug] Remote Control unavailable for Claude Max subscriber despite eligibility
- [BUG] `claude update` falsely reports leftover npm global install when native launcher is in npm global prefix directory
- [Bug] Session resume crashes: undefined onSessionRestored callback in v2.1.119
- [BUG] 2.1.120 interactive --resume crashes: `UKH is not a function` (RW4 stub missing onSessionRestored)
- --resume/--continue no longer renders previous conversation in terminal
- cli: --worktree silently hangs when name contains a slash
- /model displays effort from settings.json, ignoring CLAUDE_CODE_EFFORT_LEVEL env var override
- [BUG] remote-control: QR code not displayed on headless/non-GUI systems
- Feature request: --agents-file flag to read agents JSON from a file
- Headless -p session exits when a turn ends while a background task is the only pending wake signal
- bypassPermissions defaultMode and --permission-mode flag ignored; session stays in auto mode (since 2026-08-14 auto-mode rollout)
- claude --resume does not find sessions renamed with /rename by custom title
- [BUG] `claude rc` / `claude remote-control` crashes with `node: bad option: --sdk-url`
- Remote Control (--spawn=same-dir) sessions never appear in the --resume picker
- [Feature Request] Add command-line flag to set agent color when scheduling agents
- [BUG] Stacked slash-skill invocations load only the first skill on the SDK / --print path
- [Feature Request] Allow /feedback command without including private session data!
- [BUG] -p mode sessions write valid .jsonl but never get registered in sessions-index.json (invisible to --resume picker / title resume)
- [BUG] CLI truncates a >~146 KB user message line on stdin when preceded by another NDJSON line (`--input-format stream-json`)
- CLI discards logical symlink path, uses realpath — degrades usability in deep directory trees
- [BUG] /btw help output shows escaped HTML entities instead of angle brackets
- ExitPlanMode approval via --permission-prompt-tool stdio silently ignored — process hangs
- CLI crashes in headless/stream-json mode (Ink raw mode error) - breaks Desktop remote SSH" --body-file /path/to/the/file
- [BUG] Remote control not enabled when authenticating with CLAUDE_CODE_OAUTH_TOKEN
- [BUG] /init creates CLAUDE.md at git root instead of launch directory when launched from subdirectory
- /auto-mode-setup always fails: "removeFromPermissionsAllow[0] is not a rule string the removal offer could have produced"
- `--permission-mode dontAsk` denies Write/Edit regardless of --allowedTools/permissions.allow, with no working scoped-write option for headless agents
- [BUG] /web-setup slash command silently absent if Claude Code is run with CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=true
- `claude -p` does not exit after final text when session used `run_in_background=True` Bash tools, even after those processes complete naturally
- [Bug] `/status` command Config output does not match documentation regarding configuration layers and settings display
- [BUG] CLI tip suggests /install-slack-app which is an unknown command
- [FEATURE] DISABLE_NONESSENTIAL_TRAFFIC silently disables security updates — unbundle DISABLE_AUTOUPDATER
- [BUG]
- [BUG] claude -r crashes with "UKH is not a function" on session resume
- [BUG] Claude Code 2.1.119 silently switches you to claude-opus-4-7[1m] even if you pick claude-opus-4-7
- claude -p exits with stop_reason: tool_use and empty result mid-generation (stream interruption treated as success)
- /rename title lost on abnormal exit — stat-log index not synced from JSONL
- Remote Control: 'not yet enabled for your account' on Max 5x plan
- [Bug] CLI initialization fails on Linux Arch with Hyprland/Wayland
- /auto-mode-setup fails: removeFromPermissionsAllow[0] is not a rule string the removal offer could have produced
- Inline --agents 'tools: []' no longer denies tools in headless -p mode (2.1.214); no flag combination behaviorally denies all
- /remote-control fails silently on FIRST in-session invocation, succeeds on retry (v2.1.212, Linux)
- Feature: run `claude rc` as a background daemon (no open terminal, auto-restart on reboot, start/status/stop control)
- [Regression] /remote-control slash command missing in v2.1.196
- [Bug] `/status` command Config output does not match documentation regarding configuration layers and settings display (re-opening)
- [BUG] /plugin list returns empty output for plugins installed from third-party marketplace
- [BUG] Headless mode (`-p --output-format stream-json`) breaks AskUserQuestion handling — model continues on assumptions instead of stopping
- [BUG] --strict-mcp-config with empty --mcp-config still fetches MCP registry and attempts user-configured servers
- Expose `prefersReducedMotion` as a runtime toggle (slash command or `/config` entry)
- claude --continue "<prompt>" --dangerously-skip-permissions crashes with "UKH is not a function"
- [BUG] Remote control doesn't work after you hit your limit
- [BUG] `claude auth login` hangs after opening browser, while plain `claude` prompts for pasted auth code
- [Bug] Local directory permissions get copied into global settings.json on config update
- [BUG] `--print` mode returns empty output when API proxy returns content types in separate assistant messages
- [BUG] --append-system-prompt-file silently drops all but the last occurrence when specified multiple times
- Telegram channel plugin: --channels flag stalls SSH terminal session
- [BUG] /export overwrites existing files without warning
- [Feature Request] Auto-switch directory when resuming sessions from other projects
- [BUG] remote-control --name is ignored: picker labels every server by git root, so servers in one repo are indistinguishable (refiling #86328)
- --resume picker labels sessions with real prompts as "(session)" — title lookup only reads 64KB head/tail
- [BUG] claude -p returns session_id but writes no transcript; immediate --resume fails (2.1.209 and 2.1.210, Linux)
- [BUG] --teleport exits 1 with no stdout/stderr when run without a TTY
- [BUG] -p/--print: stdio MCP servers stay "pending" — tool snapshot races server startup and never refreshes (regression 2.1.143 → 2.1.162)
- [BUG] /doctor reports setup issue for Remote Control when CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC is set intentionally
- [Bug] Remote Control unavailable despite active Claude Max subscription
- Sessions started inside a git submodule are not listed by --resume
- --resume hangs silently when disk quota is exceeded (EDQUOT)
- [BUG] `claude install <channel>` removes working npm-global install even when the new native install isn't reachable on PATH (cleanup gated on PATH-detection that's already informational only)
- [BUG] /doctor PATH check is a false positive on Debian/Ubuntu systems with standard .bashrc guard
- Background-job sessions unrecoverable via --resume despite intact transcripts (no signal they exist)
- [FEATURE] Machine-readable hook I/O schemas shipped with the binary (`claude hooks schema --json`)
- [Bug] /remote-control ignores /rename session name, defaults to random name
- [Bug] Ultraplan ready notification fires before cloud agent completes execution