[BUG] Quick Entry global hotkey cannot be configured on GNOME Wayland (Ubuntu) — shortcut always reported as "already in use"

Open 💬 0 comments Opened Jul 15, 2026 by renan-mc

Preflight Checklist

  • [x] I have searched existing issues and this hasn't been reported yet
  • [x] This is a single bug report
  • [x] I am using the latest version of Claude Desktop

What's Wrong?

On Ubuntu with GNOME (Wayland session), Settings → General → Quick Entry keyboard shortcut refuses every combination I try, always reporting it as "already in use" — including several complex/uncommon combos that are definitely not bound to anything else on the system.

What Should Happen?

Either the shortcut should register successfully, or the app should surface the real error instead of a misleading "already in use" message.

Steps to Reproduce

  1. Install Claude Desktop via the official apt repo on Ubuntu (GNOME, Wayland session).
  2. Go to Settings → General → Quick Entry keyboard shortcut.
  3. Try to set any shortcut, including uncommon key combinations.
  4. Observe: every attempt is rejected as "already in use", even combos with no real conflict.

Additional Information

The official docs (code.claude.com/docs/en/desktop-linux) already list "Quick Entry global hotkey: works on X11. On native Wayland it requires your desktop environment's GlobalShortcuts portal" under "What's not in the Linux beta yet" — but the current UX (a generic "already in use" message) is confusing since it doesn't reflect the actual underlying failure.

Claude Model

N/A (Desktop app UI issue, not model-related)

Operating System

Ubuntu/Debian Linux (GNOME, Wayland)

View original on GitHub ↗