Claude Desktop/code-session

Start a Claude Code session

Launches Claude Code from the desktop app, with a prompt and working directory.

macos · windows · linux · sign-in required · updated 2026-07-12

Format

claude://code/new?q={prompt}&folder={folder}

Try it

claude://code/new?q=Fix%20the%20failing%20test&folder=%2FUsers%2Fme%2FrepoOpen

What you supply

{prompt}optional

Text to place in the composer.

prompt is accepted as an alias for q.

{folder}optional

Absolute path to use as the working directory.

URL-encode the path — the slashes become %2F.

Note there is no claude.ai host on this one. Chat links have it, the agent surfaces do not.

The folder confirmation always appears. Folders arriving by link are treated as untrusted every time, even ones you have trusted before, so this link cannot silently drop an agent into a directory.

A file parameter is accepted but does nothing today.

This is the desktop app's route into Claude Code. For a link that opens Claude Code directly in a terminal instead, see claude-code.