macOS 和 Windows 上的 Claude 支援 claude:// URL 配置,就像瀏覽器支援 https:// 配置一樣。您可以從網站、指令碼或其他應用程式使用這些連結來開啟 Claude Desktop,並直接跳轉到聊天、Cowork 工作階段或 Code 工作階段。
本文列出 Claude Desktop 支援的連結格式以及每種格式接受的參數。
深層連結的運作方式
當您的作業系統開啟 claude:// URL 時,它會將 URL 傳遞給 Claude。如果應用程式未執行,macOS 和 Windows 都會先啟動它。Claude 隨後會讀取路徑和查詢參數,並導覽到應用程式內的正確位置。
所有參數值必須進行 URL 編碼。在 q 中傳遞的提示文字會被截斷至大約 14,000 個字元。
開始新聊天
claude://claude.ai/new
claude://claude.ai/new?q=Summarize%20this%20week%27s%20release%20notes
在 Claude Desktop 中開啟新聊天。如果您包含 q,提示欄位會預先填入該文字,以便您可以檢閱並傳送。
參數 | 必需 | 說明 |
| 否 | 要在提示欄位中預先填入的文字。 |
開啟現有聊天或專案
claude://claude.ai/chat/{conversation-id}
claude://claude.ai/project/{project-id}按 ID 開啟特定聊天或專案。ID 是您在 Claude 中聊天或專案 URL 末尾看到的 UUID。如果 ID 遺失或無效,Claude 會改為開啟您最近的聊天或專案清單。
開始 Claude Code 工作階段
claude://code/new
claude://code/new?q=Fix%20the%20failing%20test&folder=%2FUsers%2Fme%2Frepo
在 Claude Desktop 中開啟 Claude Code,並預先填入編寫器。在您自己的工具中使用此功能來放置「在 Claude Code 中開啟」按鈕。
參數 | 必需 | 說明 |
| 否 | 要在編寫器中預先填入的文字。prompt 可作為別名接受。 |
| 否 | 要用作工作目錄的絕對路徑。Claude Desktop 會要求您在使用該資料夾之前確認。目前只套用第一個資料夾值。 |
| 否 | 要附加的檔案的絕對路徑。已接受但目前不支援。 |
注意:透過連結提供的任何資料夾都被視為不受信任。Claude Desktop 在將其採用為工作目錄之前,一律會顯示確認對話方塊,即使您之前已信任該資料夾。
開始 Claude Cowork 工作階段
claude://cowork/new
claude://cowork/new?q=Draft%20the%20Q2%20update&folder=%2FUsers%2Fme%2Fdocs&file=%2FUsers%2Fme
%2Fdocs%2Fnotes.md
開啟新的 Cowork 工作階段,並預先填入編寫器。在您自己的工具中使用此功能來放置「在 Claude Cowork 中開啟」按鈕。
參數 | 必需 | 說明 |
| 否 | 要在編寫器中預先填入的文字。 |
| 否 | 要附加的資料夾的絕對路徑。重複該參數以附加多個。Claude Desktop 會要求您在使用每個資料夾之前確認。 |
| 否 | 要附加的檔案的絕對路徑。重複該參數以附加多個。 |
注意:透過連結提供的任何資料夾都被視為不受信任。Claude Desktop 在將其採用為工作目錄之前,一律會顯示確認對話方塊,即使您之前已信任該資料夾。
測試深層連結
在 macOS 上
開啟終端機並執行:
open "claude://claude.ai/new?q=Hello"
在 Windows 上
開啟命令提示字元並執行:
start "" "claude://claude.ai/new?q=Hello"
