Claude Code 상세 사용법 60: 딥링크로 런북에서 세션 열기 | DAKER 커뮤니티

Claude Code 상세 사용법 60: 딥링크로 런북에서 세션 열기

Claude Code 딥링크는 런북, 알림, 대시보드에서 로컬 클로드 코드 세션을 바로 여는 장치입니다. 공식 문서 기준 claude-cli://open 링크는 작업 디렉토리와 프롬프트를 채워 주지만, 프롬프트를 자동 전송하지는 않습니다. 사람이 내용을 읽고 Enter를 눌러야 시작됩니다.

Mermaid 흐름으로 보는 딥링크

아래 Mermaid source처럼 링크는 로컬 세션을 준비하고, 최종 실행은 사람이 결정합니다.

Mermaid source:
flowchart TD
  A[런북 링크] --> B[운영체제 핸들러]
  B --> C[Claude Code 터미널]
  C --> D[프롬프트 검토]
  D --> E{보내도 되는가}
  E --> F[Enter로 전송]
  E --> G[수정하거나 취소]

가장 작은 링크

최소 형식은 홈 디렉토리에서 빈 Claude Code 세션을 엽니다.

claude-cli://open

실무에서는 repo 또는 cwd와 q를 붙입니다. repo는 GitHub owner/name 기준으로 Claude Code가 이전에 본 로컬 clone을 찾고, cwd는 절대 경로를 직접 지정합니다.

claude-cli://open?repo=acme/payments&q=결제%20실패%20알림을%20조사해줘

팀 문서에는 repo가 낫고, 표준 devcontainer나 VM처럼 경로가 같으면 cwd가 낫습니다. 둘을 같이 넣으면 cwd가 우선합니다.

프롬프트는 URL 인코딩한다

딥링크의 q 값은 URL 인코딩해야 합니다. 줄바꿈은 %0A로 넣습니다.

node -e 'console.log(encodeURIComponent("최근 배포 이후 5xx 증가를 조사해줘\n로그와 마지막 성공 빌드를 비교해줘"))'

긴 절차를 전부 q에 넣지 마세요. 공식 문서는 긴 프롬프트도 경고를 보여 준다고 설명하지만, 운영 문서에서는 짧은 시작문과 repo의 /skill 또는 CLAUDE.md 런북을 조합하는 편이 안전합니다.

실패 모드

첫째, GitHub Markdown은 claude-cli:// 같은 커스텀 스킴을 링크로 남기지 않을 수 있습니다. 이때는 코드 블록에 URL을 보여 주고 복사하게 합니다. 둘째, repo는 Claude Code가 한 번도 실행된 적 없는 clone을 찾지 못합니다. 셋째, 링크가 현재 branch를 바꾸지 않습니다. 넷째, 외부에서 온 긴 프롬프트를 읽지 않고 바로 전송하면 숨은 지시를 놓칠 수 있습니다.

선임 엔지니어 takeaways

딥링크는 바이브코딩을 “바로 시작”하게 만들지만, 권한을 넘겨주는 버튼은 아닙니다. Claude Code, 클로드 코드, AI 코딩 런북에 딥링크를 넣을 때는 repo 선택, 짧은 프롬프트, 사람이 검토하는 단계, 실패 시 수동 경로를 같이 적으세요. 그러면 incident 대응, 코드 리뷰, 테스트 자동화가 재현 가능한 LLM 개발 워크플로우가 됩니다.

참고: Anthropic Claude Code deep links, CLI reference, skills, llms.txt 문서를 2026-06-15 Asia/Seoul 기준으로 확인했습니다.