Claude per macOS e Windows risponde allo schema URL claude://, proprio come un browser risponde allo schema https://. Puoi utilizzare questi collegamenti da un sito web, uno script o un'altra app per aprire Claude Desktop e passare direttamente a una chat, una sessione Cowork o una sessione Code.
Questo articolo elenca i formati di collegamento supportati da Claude Desktop e i parametri che ciascuno accetta.
Come funzionano i deep link
Quando il tuo sistema operativo apre un URL claude://, lo passa a Claude. Se l'app non è in esecuzione, sia macOS che Windows la avvieranno prima. Claude legge quindi il percorso e i parametri di query e naviga nel posto giusto all'interno dell'app.
Tutti i valori dei parametri devono essere codificati in URL. Il testo del prompt passato in q viene troncato a circa 14.000 caratteri.
Avvia una nuova chat
claude://claude.ai/new
claude://claude.ai/new?q=Summarize%20this%20week%27s%20release%20notes
Apre una nuova chat in Claude Desktop. Se includi q, il campo del prompt viene precompilato con quel testo in modo che tu possa rivederlo e inviarlo.
Parametro | Obbligatorio | Descrizione |
| No | Testo da precompilare nel campo del prompt. |
Aprire una chat o un progetto esistente
claude://claude.ai/chat/{conversation-id}
claude://claude.ai/project/{project-id}Apre una chat o un progetto specifico tramite il suo ID. L'ID è l'UUID che vedi alla fine dell'URL della chat o del progetto in Claude. Se l'ID è mancante o non valido, Claude apre le tue chat recenti o il tuo elenco di progetti.
Avvia una sessione Claude Code
claude://code/new
claude://code/new?q=Fix%20the%20failing%20test&folder=%2FUsers%2Fme%2Frepo
Apre Claude Code in Claude Desktop con il composer precompilato. Usalo per i pulsanti "Apri in Claude Code" nei tuoi strumenti.
Parametro | Obbligatorio | Descrizione |
| No | Testo da precompilare nel composer. prompt è accettato come alias. |
| No | Percorso assoluto da utilizzare come directory di lavoro. Claude Desktop ti chiede di confermare la cartella prima che venga utilizzata. Attualmente viene applicato solo il primo valore della cartella. |
| No | Percorso assoluto di un file da allegare. Accettato ma non attualmente supportato. |
Nota: Qualsiasi cartella fornita tramite un collegamento è considerata non attendibile. Claude Desktop mostra sempre una finestra di dialogo di conferma prima di adottarla come directory di lavoro, anche se hai già considerato attendibile quella cartella.
Avvia una sessione Claude Cowork
claude://cowork/new
claude://cowork/new?q=Draft%20the%20Q2%20update&folder=%2FUsers%2Fme%2Fdocs&file=%2FUsers%2Fme
%2Fdocs%2Fnotes.md
Apre una nuova sessione Cowork con il composer precompilato. Usalo per i pulsanti "Apri in Claude Cowork" nei tuoi strumenti.
Parametro | Obbligatorio | Descrizione |
| No | Testo da precompilare nel composer. |
| No | Percorso assoluto di una cartella da allegare. Ripeti il parametro per allegare più di uno. Claude Desktop ti chiede di confermare ogni cartella prima che venga utilizzata. |
| No | Percorso assoluto di un file da allegare. Ripeti il parametro per allegare più di uno. |
Nota: Qualsiasi cartella fornita tramite un collegamento è considerata non attendibile. Claude Desktop mostra sempre una finestra di dialogo di conferma prima di adottarla come directory di lavoro, anche se hai già considerato attendibile quella cartella.
Testare un deep link
Su macOS
Apri Terminal ed esegui:
open "claude://claude.ai/new?q=Hello"
Su Windows
Apri il Prompt dei comandi ed esegui:
start "" "claude://claude.ai/new?q=Hello"