CLI flags issues on Linux
Issues the maintainers labelled both platform:linux and area:cli.
187 issues · 38 open · 149 resolved (80%) · first seen Feb 24, 2026
Is this getting better or worse?
This class of problem is converging. 65 new reports in the last 90 days vs 109 in the 90 before — -40%. The open backlog peaked at 38 in 2026-08 and sits at 38 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
156 of these reports name the Claude Code build they were running, spanning 91 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 30 days across 149 closures. Of the 149 closures with a recorded reason, 25% were closed as completed and 112 as not-planned or duplicate. The most recent completed fix landed in 2026-08.
Workarounds reported by the community
54 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)
- --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
- /clear creates a new session instead of clearing current context — misleading command semantics
- Remote Control: stale environment registrations cannot be removed from claude.ai/code picker
- 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
- [BUG] `--resume` drops the session's `--effort` level, invalidating the prompt cache
- 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
- UKH is not a function: crash on --resume when onSessionRestored callback is undefined
- [BUG] '--bg' is not enabled. If this is unexpected, retry in a moment.
- 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
- /doctor falsely flags native installer as 'Leftover npm global installation'
- [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
- [BUG] `claude rc` / `claude remote-control` crashes with `node: bad option: --sdk-url`
- bypassPermissions defaultMode and --permission-mode flag ignored; session stays in auto mode (since 2026-08-14 auto-mode rollout)
- [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
- claude --resume does not find sessions renamed with /rename by custom title
- [BUG] CLI truncates a >~146 KB user message line on stdin when preceded by another NDJSON line (`--input-format stream-json`)
- [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
- [Feature Request] Allow /feedback command without including private session data!
- `claude -p` does not exit after final text when session used `run_in_background=True` Bash tools, even after those processes complete naturally
- [BUG] -p mode sessions write valid .jsonl but never get registered in sessions-index.json (invisible to --resume picker / title resume)
- [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
- CLI discards logical symlink path, uses realpath — degrades usability in deep directory trees
- 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
- /auto-mode-setup always fails: "removeFromPermissionsAllow[0] is not a rule string the removal offer could have produced"
- [BUG] /web-setup slash command silently absent if Claude Code is run with CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=true
- [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
- [Bug] CLI initialization fails on Linux Arch with Hyprland/Wayland
- Headless -p session exits when a turn ends while a background task is the only pending wake signal
- 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)
- `--permission-mode dontAsk` denies Write/Edit regardless of --allowedTools/permissions.allow, with no working scoped-write option for headless agents
- [Regression] /remote-control slash command missing in v2.1.196
- Background-job sessions unrecoverable via --resume despite intact transcripts (no signal they exist)
- [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
- Remote Control "not yet enabled" on Max plan — v2.1.126 (Arch Linux)
- [BUG] The claude for /resume broke following links
- remote-control vs --rc: different session visibility and app access behavior
- [Bug] /goal command loops indefinitely despite user approval override
- No path to full autonomy when running as root (uid=0)
- [BUG] claude hangs silently when ~/.claude/ is unwritable
- claude -p silent-freeze when spawned from a long-running orchestrator (no stdout, deterministic 100% from direct spawn, probabilistic with bash wrap)
- claude --resume crashes with 'UKH is not a function' on 2.1.120 (RW4 hook returns missing keys)
- Headless --print --output-format=stream-json mode hangs indefinitely on streaming response
- TypeError: onSessionRestored is undefined when resuming sessions in 2.1.120
- /resume command no longer filters conversations by current directory
- [BUG] CLI sets `minimumVersion` but it isn't honored
- Slash-prefixed input (e.g. `/something`) is silently ignored instead of returning an error
- [BUG] Session files deleted after --print exit, making --resume impossible
- Teleport silently fails on dirty git working tree instead of showing error
- [BUG] `claude -p --output-format json` omits 'result' field on --resume when session already has a last-prompt entry
- v2.1.78 regression: headless -p mode interrupted by tengu circuit breaker after 9-16 turns
- claude init does not create .claude directory or CLAUDE.md file
- /teleport triggers /remote-env which produces no output
- [Bug] Remote control functionality not working
- Remote Control fails at startup: Bridge environments are not available for this organization (Pro account)
- [BUG] `claude remote-control` works locally but fails in SSH environment for Max subscriber
- [BUG] Stacked slash-skill invocations load only the first skill on the SDK / --print path