Ghostty TUI: opening URLs needs Shift+⌘+click or Ctrl+click, not the documented ⌘-click (v2.1.181)
What happened
On Ghostty, opening a URL from Claude Code's fullscreen TUI requires Shift+⌘+click or Ctrl+click. The simpler/documented gestures don't work:
- plain click — nothing
- ⌘-click — nothing (even though the v2.1.181 changelog says "Fullscreen URL opening: Now requires Cmd+click (macOS) / Ctrl+click, matching native terminal behavior")
- Shift+click — nothing
- Shift+⌘+click — opens the URL ✅
- Ctrl+click — opens the URL ✅
Mechanics: since v2.1.89 Claude Code uses the alternate screen + mouse reporting, so Ghostty forwards mouse events (including ⌘-click) into the application instead of acting on them. The gestures that work are the ones that reach Ghostty's own link handler: Shift bypasses the app's mouse capture (so Shift+⌘+click = bypass + Ghostty's open modifier), and Ctrl+click likewise reaches the handler. The documented macOS ⌘-click gesture by itself never reaches the terminal's link handler under Ghostty.
Steps to reproduce
- macOS, Ghostty 1.3.1, Claude Code 2.1.181, default browser set.
- In a Claude Code session, produce output containing a URL (bare URL or markdown link).
- Try plain click, ⌘-click, Shift+click — none open the URL.
- Shift+⌘+click or Ctrl+click — opens it in the default browser.
Expected
The documented macOS ⌘-click gesture opens the URL in Ghostty as it does in a plain (non-Claude) shell — without needing Shift or Ctrl.
Confirmed NOT a macOS/browser-handler problem
open <url>from a plain shell routes correctly to the default browser.- ⌘-click on a URL works in a plain (non-Claude) Ghostty shell tab.
- Only inside Claude Code's TUI is Shift+⌘+click / Ctrl+click required. This isolates it to Claude Code's mouse-reporting interaction with Ghostty.
Environment
- Claude Code: 2.1.181
- Terminal: Ghostty 1.3.1 (stable)
- OS: macOS (Darwin 25.5.0)
Notes / workarounds
- Working gestures: Shift+⌘+click or Ctrl+click.
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1restores plain click-to-open but disables the fullscreen TUI; it's undocumented (#56881).- Possibly related mouse-reporting issues: #61936 (right-click/selection), #66056 (right-click paste; Shift+right-click bypass).
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗