Launch sessions from links changeddeep-links
Nearest release: v2.1.293, published 3 hours before 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 7 Oct 2026 20:25 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 20 Oct 2026 18:37 UTC.
Upstream edited
Recorded here
Lines+25added
Lines−27removed
From line
106
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits12to 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 when you send your first prompt of an interactive session](#registration-and-supported-platforms) on the machine.
108108
109<Tabs>
110 <Tab title="macOS">
111 The built-in `open` command passes the URL to the registered `claude-cli://` handler:
109**macOS**
112110
113 ```bash theme={null}
114 open "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
115 ```
111The built-in `open` command passes the URL to the registered `claude-cli://` handler:
116112
117 On success, a new terminal window opens with Claude Code running and the prompt pre-filled.
118 </Tab>
113```bash theme={null}
114open "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
115```
119116
120 <Tab title="Linux">
121 Most desktop environments provide `xdg-open`, which passes the URL to the registered handler:
117On success, a new terminal window opens with Claude Code running and the prompt pre-filled.
122118
123 ```bash theme={null}
124 xdg-open "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
125 ```
119**Linux**
126120
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).
128 </Tab>
121Most desktop environments provide `xdg-open`, which passes the URL to the registered handler:
129122
130 <Tab title="Windows">
131 In PowerShell, `Start-Process` passes the URL to the registered handler:
123```bash theme={null}
124xdg-open "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
125```
132126
133 ```powershell theme={null}
134 Start-Process "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
135 ```
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).
136128
137 In `cmd.exe`, `start` treats its first quoted argument as a window title, so pass an empty title before the URL:
129**Windows**
138130
139 ```cmd theme={null}
140 start "" "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
141 ```
131In PowerShell, `Start-Process` passes the URL to the registered handler:
142132
143 On success, a new terminal window opens with Claude Code running and the prompt pre-filled.
144 </Tab>
145</Tabs>
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.
146144
147145## Registration and supported platforms
148146
No line in this hunk matches that.