Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Tautan mendalam adalah URL claude-cli:// yang membuka Claude Code di jendela terminal baru. URL dapat membawa direktori kerja dan prompt untuk diisi sebelumnya. Ini memungkinkan Anda berbagi titik awal satu klik untuk tugas: siapa pun dengan Claude Code terinstal yang mengklik tautan akan melihat sesi terbuka dengan prompt sudah diketik. Prompt diisi tetapi tidak dikirim sampai Anda menekan Enter. Karena tautan mendalam adalah URL, Anda dapat menempatkannya di mana pun tautan dapat ditempatkan:
  • Langkah runbook insiden yang membuka repo layanan yang terpengaruh dengan prompt diagnostik
  • Peringatan pemantauan atau dasbor yang menautkan ke prompt investigasi untuk metrik tertentu
  • Halaman README atau wiki yang membuka proyek dengan prompt onboarding
  • Notifikasi kegagalan CI yang mengisi sebelumnya nama pekerjaan yang gagal
Halaman ini mencakup cara membangun tautan, menyematkannya dalam runbook atau memicunya dari shell, dan mengelola atau menonaktifkan pendaftaran handler di setiap platform.
Tautan mendalam memerlukan Claude Code v2.1.91 atau lebih baru.

​
Cara kerjanya

Awalan claude-cli:// adalah skema URL khusus yang Claude Code daftarkan dengan sistem operasi Anda, mirip dengan cara tautan mailto: membuka klien email Anda. Tautan dapat berada di halaman web, di wiki, di pesan Slack, atau di aplikasi apa pun yang merender tautan. Ketika Anda mengkliknya:
  1. Browser atau aplikasi menyerahkan URL ke sistem operasi Anda.
  2. Sistem operasi mengenali awalan claude-cli:// dan memulai Claude Code di mesin Anda.
  3. Jendela terminal baru terbuka dengan Claude Code berjalan di direktori yang ditentukan tautan, dan teks prompt tautan sudah ada di kotak input.
  4. Anda membaca prompt, mengeditnya jika mau, dan menekan Enter untuk mengirimnya.
Tautan itu sendiri dapat dihosting di mana saja, tetapi sesi selalu terbuka secara lokal di komputer tempat Anda mengklik. Lihat Pendaftaran dan platform yang didukung untuk emulator terminal mana yang terbuka di setiap sistem operasi.
Platform yang menampilkan tautan harus memungkinkan skema URL khusus. Markdown yang dirender GitHub memungkinkan http dan https tetapi menghapus skema seperti claude-cli:// di README, masalah, permintaan tarik, dan wiki. Hanya teks tautan yang ditampilkan, tanpa tautan di belakangnya dan URL tersembunyi. Lihat Troubleshooting untuk solusi.

​
Apa yang ditampilkan sesi yang diluncurkan

Tautan mendalam tidak pernah mengeksekusi apa pun dengan sendirinya. Tautan hanya memilih direktori dan mengisi kotak prompt. Jika Anda mengklik tautan dari halaman yang tidak Anda percayai, prompt masih inert: tidak ada yang mencapai model sampai Anda membaca apa yang diisi dan menekan Enter. Ketika sesi terbuka, spanduk di atas input menunjukkan bahwa tautan eksternal meluncurkannya dan direktori mana yang dipilihnya. Untuk prompt lebih dari 1.000 karakter, spanduk memberi tahu Anda untuk menggulir dan meninjau teks lengkap sebelum menekan Enter, karena prompt panjang dapat mendorong instruksi keluar layar. Aturan izin, CLAUDE.md, dan prompt kepercayaan untuk direktori yang dipilih berlaku dengan cara yang sama seperti untuk sesi lainnya.

​
Bangun tautan

Setiap tautan mendalam dimulai dengan claude-cli://open, yang merupakan satu-satunya jalur yang diterima handler, diikuti oleh parameter kueri opsional. Bentuk minimal membuka Claude Code di direktori home Anda dengan prompt kosong: 
claude-cli://open
Tambahkan parameter untuk mengontrol di mana sesi dimulai dan apa yang dimuat kotak prompt:
ParameterDeskripsi
qTeks untuk diisi sebelumnya di kotak prompt. URL-encode nilainya. Gunakan %0A untuk jeda baris dalam prompt multi-baris. Maksimal 5.000 karakter.
cwdJalur absolut untuk digunakan sebagai direktori kerja. Jalur jaringan dan UNC ditolak.
repoSlug owner/name GitHub. Claude Code menyelesaikannya ke klon lokal yang telah dilihatnya sebelumnya dan dimulai di sana. Jika Anda tidak memiliki klon yang cocok, sesi terbuka di direktori home Anda.
cwd dan repo adalah dua cara untuk mengatur direktori kerja. Jika Anda melewatkan keduanya, cwd memiliki prioritas dan repo diabaikan, bahkan jika jalur cwd tidak ada. Tautan berikut menunjuk ke repositori bernama acme/payments dengan prompt diagnostik dua baris. Ganti acme/payments dengan slug owner/name repositori Anda saat Anda membangun milik Anda sendiri: 
claude-cli://open?repo=acme/payments&q=Investigate%20the%20failed%20deploy%20of%20payments-api.%0ACheck%20recent%20commits%20to%20main%20and%20the%20last%20successful%20build.
Mengkliknya membuka jendela terminal baru, memulai Claude Code di klon lokal Anda dari acme/payments, dan mengisi kotak prompt dengan teks yang didekode: 
Investigate the failed deploy of payments-api.
Check recent commits to main and the last successful build.
Anda dapat mengedit prompt sebelum menekan Enter untuk mengirimnya. Jika Anda tidak memiliki klon lokal repositori, sesi terbuka di direktori home Anda. Lihat Pilih antara cwd dan repo untuk cara jalur lokal dipilih ketika Anda memiliki beberapa klon atau worktrees.

​
Pilih antara cwd dan repo

Gunakan cwd ketika semua orang yang mengklik tautan memiliki proyek di jalur absolut yang sama, seperti devcontainer standar atau citra VM. Gunakan repo ketika tautan dibagikan dan setiap orang mengklon ke lokasi yang berbeda. Claude Code menyelesaikan slug ke jalur lokal sebagai berikut:
  • Setiap kali Anda menjalankan claude di repositori Git, jalur sistem file direktori itu dicatat terhadap slug owner/name GitHub repositori.
  • Ketika tautan mendalam tiba, repo membuka jalur yang cocok apa pun yang Anda gunakan paling baru. Beberapa klon dan worktrees dilacak secara terpisah, jadi ia memilih yang Anda kerjakan terakhir.
  • Pencarian hanya menemukan jalur di mana Anda telah menjalankan Claude Code setidaknya sekali.
  • Tautan tidak mengubah cabang mana yang diperiksa. Sesi terbuka dalam keadaan apa pun direktori itu saat ini.
Sesi yang diluncurkan menunjukkan jalur mana yang dipilihnya dan kapan klon itu terakhir diambil dari remote, sehingga Anda dapat mengetahui apakah Anda melihat kode yang sudah usang.

​
Contoh

Bagian di bawah menunjukkan dua cara umum untuk menggunakan tautan mendalam: sebagai tautan Markdown dalam dokumen dan sebagai perintah dalam skrip atau alias shell.

​
Sematkan tautan dalam runbook

Tautan mendalam dalam runbook memberikan siapa pun yang melakukan triase cara satu klik untuk mulai menyelidiki di repositori yang tepat dengan prompt yang disiapkan. Platform yang merender runbook harus memungkinkan skema URL khusus. Markdown yang dirender GitHub tidak memungkinkan claude-cli://, jadi tautan mendalam di README, masalah, atau wiki GitHub hanya menampilkan labelnya tanpa tautan yang dapat diklik. Lihat catatan troubleshooting untuk solusi. Prompt adalah bagian dari URL dan harus dikodekan URL. Untuk menghasilkan nilai yang dikodekan, teruskan teks prompt Anda melalui encodeURIComponent di konsol browser atau encoder URL apa pun. Contoh di bawah menambahkan titik masuk investigasi ke runbook insiden untuk layanan bernama web-gateway: 
## High 5xx rate on web-gateway

1. Acknowledge the page in PagerDuty.
2. [Open Claude Code in the gateway repo](claude-cli://open?repo=acme/web-gateway&q=5xx%20rate%20is%20elevated%20on%20web-gateway.%20Check%20recent%20deploys%2C%20error%20logs%20from%20the%20last%2030%20minutes%2C%20and%20open%20incidents%20in%20Linear.)
3. Post initial findings in #incident.
Untuk menggunakan ini dalam runbook Anda sendiri, ganti acme/web-gateway dengan slug repositori layanan Anda. Ini memungkinkan insinyur dengan Claude Code terinstal dan klon lokal repositori itu untuk mengklik langkah 2 dan mulai menyelidiki dengan prompt siap dikirim.

​
Buka tautan dari shell

Anda juga dapat membuka tautan mendalam dari skrip shell, alias, atau otomasi daripada dengan mengkliknya. Panggil perintah pembukaan URL sistem operasi Anda dengan tautan sebagai argumen.
Perintah open bawaan meneruskan URL ke handler claude-cli:// yang terdaftar:
open "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"

​
Pendaftaran dan platform yang didukung

Claude Code mendaftarkan handler claude-cli:// dengan sistem operasi Anda pertama kali Anda memulai sesi interaktif di macOS, Linux, dan Windows. Anda tidak menjalankan perintah install terpisah. Pendaftaran menulis ke lokasi tingkat pengguna saja:
PlatformLokasi Handler
macOS~/Applications/Claude Code URL Handler.app
Linuxclaude-code-url-handler.desktop di bawah $XDG_DATA_HOME/applications, defaultnya ~/.local/share/applications
WindowsHKEY_CURRENT_USER\Software\Classes\claude-cli
Handler meluncurkan Claude Code di emulator terminal yang terdeteksi. Di macOS, Claude Code mengingat terminal dari sesi interaktif terbaru Anda dan menggunakannya kembali, mendukung iTerm2, Ghostty, kitty, Alacritty, WezTerm, dan Terminal.app. Di Linux, ia menghormati variabel lingkungan $TERMINAL, kemudian x-terminal-emulator, kemudian daftar emulator umum. Di Windows, ia lebih suka Windows Terminal, kemudian PowerShell, kemudian cmd.exe. Untuk mencegah pendaftaran sepenuhnya, atur disableDeepLinkRegistration ke "disable" di settings.json. Untuk memberlakukan ini di seluruh organisasi sehingga pengguna tidak dapat mengaktifkannya kembali, atur di managed settings.

​
Buka tab VS Code alih-alih terminal

Ekstensi VS Code mendaftarkan handler sendiri di vscode://anthropic.claude-code/open, yang membuka tab editor Claude Code daripada jendela terminal. Lihat Luncurkan tab VS Code dari alat lain untuk parameter URL itu.

​
Troubleshooting

​
Mengklik tautan tidak melakukan apa pun

Handler mungkin belum terdaftar. Mulai sesi claude interaktif sekali di mesin itu, keluar, dan coba tautan lagi. Jika Anda berada di Linux tanpa lingkungan desktop, xdg-open mungkin tidak memiliki apa pun untuk dikirim.

​
Tautan dirender sebagai teks biasa alih-alih dapat diklik

Beberapa renderer Markdown hanya memungkinkan tautan http dan https dan menghapus skema URL lainnya. GitHub melakukan ini di README, masalah, permintaan tarik, dan wiki: [label](claude-cli://...) dirender sebagai hanya label, tanpa tautan dan URL dihapus. Di platform ini, letakkan tautan mendalam dalam blok kode sehingga pembaca dapat melihat URL dan menempel ke bilah alamat browser mereka.

​
Sesi terbuka di direktori home saya alih-alih repo

Parameter repo hanya menyelesaikan ke klon yang telah dilihat Claude Code. Jalankan claude di dalam klon sekali sehingga jalurnya dicatat, atau alihkan tautan untuk menggunakan cwd dengan jalur absolut.

​
Tautan membuka terminal yang salah

Di macOS, mulai claude di terminal pilihan Anda sekali dan tautan mendalam berikutnya akan menggunakannya. Di Linux, atur variabel lingkungan $TERMINAL ke nama perintah emulator pilihan Anda. Di Windows, urutannya tetap: instal Windows Terminal jika Anda ingin tautan terbuka di sana alih-alih jendela PowerShell atau cmd.exe.

​
Pelajari lebih lanjut

Halaman ini mencakup cara terkait untuk meluncurkan atau memperluas sesi Claude Code:
  • Skills: simpan prompt runbook panjang sebagai /skill di repo sehingga parameter q tautan mendalam hanya perlu menamainya
  • Non-interactive mode: jalankan Claude dari skrip dan tangkap output tanpa membuka terminal