Launch sessions from links changeddeep-links
Nearest release: v2.1.314, published 4 hours after upstream edited the page. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Upstream edited this page at 29 Oct 2026 19:47 UTC, give or take a minute or two: the time comes from Anthropic’s own sitemap rather than from a commit. This site recorded the change at 30 Oct 2026 18:07 UTC.
Upstream edited
Recorded here
Lines+33added
Lines−33removed
From line
106
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits18to this page, all time
The whole hunk
from line 106, old and new numbered
/
from line 106
106106
107107You can also open a deep link from a shell script, alias, or automation rather than by clicking it. Call your operating system's URL-opening command with the link as the argument. These commands rely on the handler that Claude Code [registers](#registration-and-supported-platforms) on the machine.
108108
109**macOS**
109> [tab] macOS
110>
111> The built-in `open` command passes the URL to the registered `claude-cli://` handler:
112>
113> ```bash theme={null}
114> open "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
115> ```
116>
117> On success, a new terminal window opens with Claude Code running and the prompt pre-filled.
110118
111The built-in `open` command passes the URL to the registered `claude-cli://` handler:
119> [tab] Linux
120>
121> Most desktop environments provide `xdg-open`, which passes the URL to the registered handler:
122>
123> ```bash theme={null}
124> xdg-open "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
125> ```
126>
127> On success, a new terminal window opens with Claude Code running and the prompt pre-filled. If the shell reports that `xdg-open` isn't found, see [Troubleshooting](#xdg-open-is-not-found-on-linux).
112128
113```bash theme={null}
114open "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
115```
116
117On success, a new terminal window opens with Claude Code running and the prompt pre-filled.
118
119**Linux**
120
121Most desktop environments provide `xdg-open`, which passes the URL to the registered handler:
122
123```bash theme={null}
124xdg-open "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
125```
126
127On success, a new terminal window opens with Claude Code running and the prompt pre-filled. If the shell reports that `xdg-open` isn't found, see [Troubleshooting](#xdg-open-is-not-found-on-linux).
128
129**Windows**
130
131In PowerShell, `Start-Process` passes the URL to the registered handler:
132
133```powershell theme={null}
134Start-Process "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
135```
136
137In `cmd.exe`, `start` treats its first quoted argument as a window title, so pass an empty title before the URL:
138
139```cmd theme={null}
140start "" "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
141```
142
143On success, a new terminal window opens with Claude Code running and the prompt pre-filled.
129> [tab] Windows
130>
131> In PowerShell, `Start-Process` passes the URL to the registered handler:
132>
133> ```powershell theme={null}
134> Start-Process "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
135> ```
136>
137> In `cmd.exe`, `start` treats its first quoted argument as a window title, so pass an empty title before the URL:
138>
139> ```cmd theme={null}
140> start "" "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
141> ```
142>
143> On success, a new terminal window opens with Claude Code running and the prompt pre-filled.
144144
145145## Registration and supported platforms
146146
No line in this hunk matches that.