링크로 Claude Desktop 열기 | Anthropic 지원 센터

macOS 및 Windows용 Claude는 브라우저가 https:// 스킴에 응답하는 것처럼 claude:// URL 스킴에 응답합니다. 웹사이트, 스크립트 또는 다른 앱의 이러한 링크를 사용하여 Claude Desktop을 열고 채팅, Cowork 세션 또는 Code 세션으로 바로 이동할 수 있습니다.

이 문서에서는 Claude Desktop이 지원하는 링크 형식과 각 형식이 허용하는 매개변수를 나열합니다.

딥 링크 작동 방식

운영 체제가 claude:// URL을 열면 Claude에 URL을 전달합니다. 앱이 실행 중이지 않으면 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를 포함하면 프롬프트 필드가 해당 텍스트로 미리 채워져 검토하고 전송할 수 있습니다.

매개변수	필수	설명
`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에서 열기" 버튼에 사용합니다.

매개변수	필수	설명
`q`	아니요	작성기에 미리 채울 텍스트입니다. prompt는 별칭으로 허용됩니다.
`folder`	아니요	작업 디렉터리로 사용할 절대 경로입니다. Claude Desktop은 폴더를 사용하기 전에 확인을 요청합니다. 현재는 첫 번째 폴더 값만 적용됩니다.
`file`	아니요	첨부할 파일의 절대 경로입니다. 허용되지만 현재 지원되지 않습니다.

참고: 링크를 통해 제공된 모든 폴더는 신뢰할 수 없는 것으로 취급됩니다. 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에서 열기" 버튼에 사용합니다.

매개변수	필수	설명
`q`	아니요	작성기에 미리 채울 텍스트입니다.
`folder`	아니요	첨부할 폴더의 절대 경로입니다. 매개변수를 반복하여 둘 이상을 첨부합니다. Claude Desktop은 각 폴더를 사용하기 전에 확인을 요청합니다.
`file`	아니요	첨부할 파일의 절대 경로입니다. 매개변수를 반복하여 둘 이상을 첨부합니다.

딥 링크 테스트

macOS에서

터미널을 열고 다음을 실행합니다:

open "claude://claude.ai/new?q=Hello"

Windows에서

명령 프롬프트를 열고 다음을 실행합니다:

start "" "claude://claude.ai/new?q=Hello"