Claude para macOS e Windows responde ao esquema de URL claude://, assim como um navegador responde ao esquema https://. Você pode usar esses links de um site, um script ou outro aplicativo para abrir Claude Desktop e ir direto para um chat, uma sessão de Cowork ou uma sessão de Code.
Este artigo lista os formatos de link que Claude Desktop suporta e os parâmetros que cada um aceita.
Como os deep links funcionam
Quando seu sistema operacional abre uma URL claude://, ele passa a URL para Claude. Se o aplicativo não estiver em execução, macOS e Windows o iniciarão primeiro. Claude então lê o caminho e os parâmetros de consulta e navega para o local correto dentro do aplicativo.
Todos os valores de parâmetro devem ser codificados em URL. O texto do prompt passado em q é truncado para aproximadamente 14.000 caracteres.
Iniciar um novo chat
claude://claude.ai/new
claude://claude.ai/new?q=Summarize%20this%20week%27s%20release%20notes
Abre um novo chat em Claude Desktop. Se você incluir q, o campo de prompt é preenchido com esse texto para que você possa revisar e enviar.
Parâmetro | Obrigatório | Descrição |
| Não | Texto para preencher no campo de prompt. |
Abrir um chat ou projeto existente
claude://claude.ai/chat/{conversation-id}
claude://claude.ai/project/{project-id}Abre um chat ou projeto específico por seu ID. O ID é o UUID que você vê no final da URL do chat ou projeto em Claude. Se o ID estiver ausente ou inválido, Claude abre seus chats recentes ou sua lista de projetos.
Iniciar uma sessão de Claude Code
claude://code/new
claude://code/new?q=Fix%20the%20failing%20test&folder=%2FUsers%2Fme%2Frepo
Abre Claude Code em Claude Desktop com o composer preenchido. Use isso para botões "Abrir em Claude Code" em suas próprias ferramentas.
Parâmetro | Obrigatório | Descrição |
| Não | Texto para preencher no composer. prompt é aceito como um alias. |
| Não | Caminho absoluto para usar como diretório de trabalho. Claude Desktop pede que você confirme a pasta antes de usá-la. Apenas o primeiro valor de pasta é aplicado hoje. |
| Não | Caminho absoluto para um arquivo a anexar. Aceito, mas não suportado atualmente. |
Nota: Qualquer pasta fornecida através de um link é tratada como não confiável. Claude Desktop sempre mostra um diálogo de confirmação antes de adotá-la como diretório de trabalho, mesmo que você tenha confiado nessa pasta antes.
Iniciar uma sessão de Claude Cowork
claude://cowork/new
claude://cowork/new?q=Draft%20the%20Q2%20update&folder=%2FUsers%2Fme%2Fdocs&file=%2FUsers%2Fme
%2Fdocs%2Fnotes.md
Abre uma nova sessão de Cowork com o composer preenchido. Use isso para botões "Abrir em Claude Cowork" em suas próprias ferramentas.
Parâmetro | Obrigatório | Descrição |
| Não | Texto para preencher no composer. |
| Não | Caminho absoluto para uma pasta a anexar. Repita o parâmetro para anexar mais de um. Claude Desktop pede que você confirme cada pasta antes de usá-la. |
| Não | Caminho absoluto para um arquivo a anexar. Repita o parâmetro para anexar mais de um. |
Nota: Qualquer pasta fornecida através de um link é tratada como não confiável. Claude Desktop sempre mostra um diálogo de confirmação antes de adotá-la como diretório de trabalho, mesmo que você tenha confiado nessa pasta antes.
Testar um deep link
No macOS
Abra o Terminal e execute:
open "claude://claude.ai/new?q=Hello"
No Windows
Abra o Prompt de Comando e execute:
start "" "claude://claude.ai/new?q=Hello"