เปิดเซสชันจาก Links
เปิดเซสชัน terminal ของ Claude Code จาก URL ฝัง
claude-cli://links ใน runbooks, alerts และ dashboards เพื่อให้การคลิกเปิด Claude Code ใน repo ที่ถูกต้องพร้อม prompt ที่ถูกต้อง
Deep link คือ URL claude-cli:// ที่เปิด Claude Code ในหน้าต่าง terminal ใหม่ URL สามารถนำ working directory และ prompt ที่จะป้อนล่วงหน้าได้
ทำให้คุณสามารถแบ่งปันจุดเริ่มต้นแบบคลิกเดียวสำหรับงาน: ทุกคนที่ติดตั้ง Claude Code และคลิก link จะเห็นเซสชันเปิดพร้อม prompt ที่พิมพ์ไว้แล้ว Prompt ถูกป้อนล่วงหน้าแต่ไม่ถูกส่งจนกว่าคุณจะกด Enter
Deep links ต้องใช้ Claude Code v2.1.91 หรือใหม่กว่า
วิธีการทำงาน
Prefix claude-cli:// คือ URL scheme แบบกำหนดเองที่ Claude Code ลงทะเบียนกับระบบปฏิบัติการของคุณ คล้ายกับที่ link mailto: เปิดไคลเอนต์อีเมลของคุณ เมื่อคุณคลิก:
- เบราว์เซอร์หรือแอปส่งมอบ URL ให้กับระบบปฏิบัติการของคุณ
- ระบบปฏิบัติการจดจำ prefix
claude-cli://และเริ่ม Claude Code บนเครื่องของคุณ - หน้าต่าง terminal ใหม่เปิดขึ้นพร้อม Claude Code ทำงานในไดเรกทอรีที่ link ระบุ และข้อความ prompt ของ link อยู่ใน input box แล้ว
- คุณอ่าน prompt แก้ไขถ้าต้องการ และกด Enter เพื่อส่ง
สร้าง Link
Deep link ทุกอันเริ่มต้นด้วย claude-cli://open ซึ่งเป็นเส้นทางเดียวที่ handler รับ ตามด้วย query parameters ที่เป็นทางเลือก รูปแบบขั้นต่ำเปิด Claude Code ในไดเรกทอรีบ้านของคุณพร้อม prompt ว่าง:
claude-cli://open
เพิ่ม parameters เพื่อควบคุมที่ที่เซสชันเริ่มและเนื้อหาใน prompt box:
| Parameter | คำอธิบาย |
|---|---|
q | ข้อความที่จะป้อนล่วงหน้าใน prompt box URL-encode ค่า ใช้ %0A สำหรับการขึ้นบรรทัดใหม่ใน prompt หลายบรรทัด สูงสุด 5,000 ตัวอักษร |
cwd | เส้นทางสัมบูรณ์ที่ใช้เป็น working directory เส้นทางเครือข่ายและ UNC จะถูกปฏิเสธ |
repo | slug owner/name ของ GitHub Claude Code จะค้นหา clone ในเครื่องที่เคยเห็นและเริ่มจากที่นั่น |
Link ต่อไปนี้ชี้ไปที่ repository ชื่อ acme/payments พร้อม prompt วินิจฉัยสองบรรทัด:
claude-cli://open?repo=acme/payments&q=Investigate%20the%20failed%20deploy%20of%20payments-api.%0ACheck%20recent%20commits%20to%20main%20and%20the%20last%20successful%20build.
ตัวอย่าง
ฝัง Link ใน Runbook
## High 5xx rate on web-gateway
1. ยืนยันการแจ้งเตือนใน PagerDuty
2. [เปิด Claude Code ใน gateway repo](claude-cli://open?repo=acme/web-gateway&q=5xx%20rate%20is%20elevated%20on%20web-gateway.)
3. โพสต์ผลการค้นพบเบื้องต้นใน #incident
เปิด Link จาก Shell
macOS:
open "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
Linux:
xdg-open "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
Windows:
Start-Process "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"
การลงทะเบียนและแพลตฟอร์มที่รองรับ
Claude Code ลงทะเบียน handler claude-cli:// กับระบบปฏิบัติการของคุณครั้งแรกที่คุณเริ่มเซสชัน interactive บน macOS, Linux และ Windows
| แพลตฟอร์ม | ตำแหน่ง Handler |
|---|---|
| macOS | ~/Applications/Claude Code URL Handler.app |
| Linux | claude-code-url-handler.desktop ภายใต้ $XDG_DATA_HOME/applications |
| Windows | HKEY_CURRENT_USER\Software\Classes\claude-cli |
การแก้ไขปัญหา
คลิก Link แล้วไม่มีอะไรเกิดขึ้น
Handler อาจยังไม่ได้ลงทะเบียน เริ่มเซสชัน claude interactive ครั้งหนึ่งบนเครื่องนั้น ออก และลองลิงก์อีกครั้ง
Link แสดงเป็นข้อความธรรมดาแทนที่จะเป็นลิงก์ที่คลิกได้
บาง Markdown renderer อนุญาตเฉพาะ link http และ https และลบ URL scheme อื่น GitHub ทำสิ่งนี้ใน READMEs, issues, pull requests และ wikis บนแพลตฟอร์มเหล่านี้ ใส่ deep link ใน code block เพื่อให้ผู้อ่านเห็น URL และวางใน address bar ของเบราว์เซอร์
เซสชันเปิดในไดเรกทอรีบ้านแทนที่จะเป็น repo
Parameter repo ค้นหาเฉพาะ clones ที่ Claude Code เคยเห็น รัน claude ภายใน clone ครั้งหนึ่งเพื่อให้บันทึกเส้นทาง หรือเปลี่ยน link เพื่อใช้ cwd พร้อมเส้นทางสัมบูรณ์