46 46
47Sebelum Anda mengirim pesan pertama, konfigurasikan empat hal di area prompt:47Sebelum Anda mengirim pesan pertama, konfigurasikan empat hal di area prompt:
48 48
49* **Environment**: pilih di mana Claude berjalan. Pilih **Local** untuk mesin Anda, **Cloud** untuk [sesi cloud](#cloud-sessions) yang berlanjut setelah Anda menutup aplikasi, [**koneksi SSH**](#ssh-sessions) untuk mesin jarak jauh yang Anda kelola, atau di Windows [**distribusi WSL**](/docs/id/desktop-wsl). Lihat [konfigurasi lingkungan](#environment-configuration).49* **Environment**: pilih di mana Claude berjalan. Pilih **Local** untuk mesin Anda, **Cloud** untuk [sesi cloud](#cloud-sessions) yang berlanjut setelah Anda menutup aplikasi, [**koneksi SSH**](#ssh-sessions) untuk mesin jarak jauh yang Anda kelola, atau di Windows [**distribusi WSL**](/docs/id/desktop-wsl). Tugas dalam sesi SSH dapat [terus berjalan saat Desktop terputus](#keep-a-task-running-while-desktop-is-disconnected), tetapi dengan akun Claude tugas tersebut dapat berhenti ketika masa berlaku login-nya habis. Lihat [konfigurasi lingkungan](#environment-configuration).
50* **Project folder**: pilih folder atau repositori tempat Claude bekerja. Untuk sesi cloud, Anda dapat menambahkan [beberapa repositori](#run-long-running-tasks-in-the-cloud).50* **Project folder**: pilih folder atau repositori tempat Claude bekerja. Untuk sesi cloud, Anda dapat menambahkan [beberapa repositori](#run-long-running-tasks-in-the-cloud).
51* **Model**: pilih [model](/docs/id/model-config#available-models) dari dropdown di sebelah tombol kirim. Anda dapat mengubah ini selama sesi.51* **Model**: pilih [model](/docs/id/model-config#available-models) dari dropdown di sebelah tombol kirim. Anda dapat mengubah ini selama sesi.
52* **Permission mode**: pilih berapa banyak otonomi yang dimiliki Claude dari [pemilih mode](#choose-a-permission-mode). Anda dapat mengubah ini selama sesi.52* **Permission mode**: pilih berapa banyak otonomi yang dimiliki Claude dari [pemilih mode](#choose-a-permission-mode). Anda dapat mengubah ini selama sesi.
236 Jalankan perintah di terminal236 Jalankan perintah di terminal
237</h3>237</h3>
238 238
239Terminal terintegrasi memungkinkan Anda menjalankan perintah bersama sesi Anda tanpa beralih ke aplikasi lain. Klik **Terminal** di bilah judul sesi atau tekan **Ctrl+\`** di macOS atau Windows. Terminal terbuka di direktori kerja sesi Anda dan berbagi lingkungan yang sama dengan Claude, jadi perintah seperti `npm test` atau `git status` melihat file yang sama yang sedang diedit Claude. Untuk membuka tab terminal kedua, klik **+** di header pane terminal atau klik kanan folder di chat untuk memilih **Open in terminal**. Terminal tersedia di sesi lokal dan [SSH](#ssh-sessions).239Terminal terintegrasi memungkinkan Anda menjalankan perintah bersama sesi Anda tanpa beralih ke aplikasi lain. Klik **Terminal** di bilah judul sesi atau tekan **Ctrl+\`** di macOS atau Windows. Terminal terbuka di direktori kerja sesi Anda dan berbagi lingkungan yang sama dengan Claude, jadi perintah seperti `npm test` atau `git status` melihat file yang sama yang sedang diedit Claude. Untuk membuka tab terminal kedua, klik **+** di header pane terminal atau klik kanan folder di chat untuk memilih **Open in terminal**.
240
241Terminal tersedia di sesi lokal dan [SSH](#ssh-sessions), dengan batasan pada [mesin jarak jauh Windows](#windows-remote-machines).
240 242
241<h3 id="open-and-edit-files">243<h3 id="open-and-edit-files">
242 Buka dan edit file244 Buka dan edit file
468 470
469Lihat [Gunakan Claude Code di cloud](/docs/id/claude-code-on-the-web) untuk informasi lebih lanjut tentang cara kerja sesi cloud. Ketika satu badan pekerjaan memerlukan banyak sesi cloud, pilih **Projects** di sidebar untuk membuat [proyek](/docs/id/claude-projects), di mana Claude memulai dan melacak sesi untuk Anda dari satu percakapan.471Lihat [Gunakan Claude Code di cloud](/docs/id/claude-code-on-the-web) untuk informasi lebih lanjut tentang cara kerja sesi cloud. Ketika satu badan pekerjaan memerlukan banyak sesi cloud, pilih **Projects** di sidebar untuk membuat [proyek](/docs/id/claude-projects), di mana Claude memulai dan melacak sesi untuk Anda dari satu percakapan.
470 472
473<Note>
474 Tugas di [sesi SSH](#ssh-sessions) juga dapat [terus berjalan saat Desktop terputus](#keep-a-task-running-while-desktop-is-disconnected), tetapi dengan akun Claude, tugas tersebut dapat berhenti ketika sesi masuknya kedaluwarsa.
475</Note>
476
471<h3 id="continue-in-another-surface">477<h3 id="continue-in-another-surface">
472 Lanjutkan di surface lain478 Lanjutkan di surface lain
473</h3>479</h3>
772 778
773* **Local**: berjalan di mesin Anda dengan akses langsung ke file Anda779* **Local**: berjalan di mesin Anda dengan akses langsung ke file Anda
774* **Cloud**: berjalan pada infrastruktur yang dikelola Anthropic secara default. Sesi terus berlanjut bahkan jika Anda menutup aplikasi.780* **Cloud**: berjalan pada infrastruktur yang dikelola Anthropic secara default. Sesi terus berlanjut bahkan jika Anda menutup aplikasi.
775* **SSH**: berjalan di mesin jarak jauh yang Anda hubungkan melalui SSH, seperti server Anda sendiri, cloud VM, atau dev container781* **SSH**: berjalan di mesin jarak jauh yang Anda hubungkan melalui SSH, seperti server Anda sendiri, cloud VM, atau dev container. Tugas yang sedang berjalan dapat [terus berlanjut saat Desktop terputus](#keep-a-task-running-while-desktop-is-disconnected), tetapi dengan akun Claude, tugas tersebut dapat berhenti saat masa berlaku proses masuknya habis.
776* **WSL** (Windows): berjalan di dalam [distribusi WSL 2](/docs/id/desktop-wsl) di mesin Anda, menggunakan toolchain Linux dan path aslinya782* **WSL** (Windows): berjalan di dalam [distribusi WSL 2](/docs/id/desktop-wsl) di mesin Anda, menggunakan toolchain Linux dan path aslinya
777 783
778<h3 id="local-sessions">784<h3 id="local-sessions">
812 818
813Sesi SSH memungkinkan Anda menjalankan Claude Code di mesin jarak jauh sambil menggunakan aplikasi desktop sebagai antarmuka Anda. Ini berguna untuk bekerja dengan basis kode yang tinggal di cloud VM, dev container, atau server dengan perangkat keras atau dependensi tertentu.819Sesi SSH memungkinkan Anda menjalankan Claude Code di mesin jarak jauh sambil menggunakan aplikasi desktop sebagai antarmuka Anda. Ini berguna untuk bekerja dengan basis kode yang tinggal di cloud VM, dev container, atau server dengan perangkat keras atau dependensi tertentu.
814 820
821<Note>
822 Jika Anda menggunakan Desktop dengan [penyedia pihak ketiga](/docs/id/third-party-integrations), sesi SSH memerlukan penyiapan tersendiri. Lihat [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).
823</Note>
824
815Untuk menambahkan koneksi SSH, buka dropdown lingkungan di kotak prompt sebelum Anda memulai sesi, lalu pilih **SSH > Add SSH connection…** dan isi detail koneksi:825Untuk menambahkan koneksi SSH, buka dropdown lingkungan di kotak prompt sebelum Anda memulai sesi, lalu pilih **SSH > Add SSH connection…** dan isi detail koneksi:
816 826
817* **Name**: label ramah untuk koneksi ini827* **Name**: label ramah untuk koneksi ini
822 832
823Setelah ditambahkan, koneksi muncul di bawah **SSH** di dropdown lingkungan. Pilih untuk memulai sesi di mesin itu. Claude berjalan di mesin jarak jauh dengan akses ke file dan tool-nya.833Setelah ditambahkan, koneksi muncul di bawah **SSH** di dropdown lingkungan. Pilih untuk memulai sesi di mesin itu. Claude berjalan di mesin jarak jauh dengan akses ke file dan tool-nya.
824 834
825Mesin jarak jauh harus menjalankan Linux atau macOS. Desktop menginstal Claude Code di mesin jarak jauh secara otomatis saat pertama kali Anda terhubung. Setelah terhubung, sesi SSH mendukung permission modes, connectors, plugins, dan MCP servers.835Mesin jarak jauh dapat menjalankan Linux, macOS, atau [Windows](#windows-remote-machines). Desktop menginstal Claude Code di mesin jarak jauh secara otomatis saat pertama kali Anda terhubung. Setelah terhubung, sesi SSH mendukung permission modes, connectors, plugins, dan MCP servers.
836
837<h4 id="remote-machine-requirements-for-ssh-sessions">
838 Persyaratan mesin jarak jauh untuk sesi SSH
839</h4>
840
841Mesin jarak jauh Linux atau macOS memerlukan prosesor yang didukung, server SSH dengan SFTP, folder instalasi yang tidak di-mount dengan `noexec`, shell yang berfungsi, dan akses jaringan. Periksa setiap persyaratan sebelum Anda terhubung, atau ketika koneksi gagal setelah Anda masuk:
842
843* **Sistem**: prosesor x86\_64 atau arm64. Mesin juga harus memenuhi [persyaratan sistem](/docs/id/setup#system-requirements) Claude Code.
844* **SFTP**: server SSH harus menyediakan subsistem SFTP, yang diaktifkan oleh baris `Subsystem sftp` di `sshd_config`-nya. Untuk memeriksanya, hubungkan ke host dan port yang sama dengan `sftp` di terminal pada komputer Anda. Server yang berfungsi menampilkan prompt `sftp>`.
845* **Sesi per koneksi**: Desktop di macOS dan Linux membuka beberapa sesi pada satu koneksi SSH. Jika `sshd_config` server mengatur `MaxSessions 1`, naikkan nilainya, misalnya ke nilai default OpenSSH yaitu 10.
846* **Folder instalasi**: Desktop menginstal program pembantu dan Claude Code di bawah `~/.claude/remote/` di direktori home Anda. Desktop menjalankannya dari sana, sehingga folder tersebut tidak boleh berada di sistem file yang di-mount dengan `noexec`. Sediakan sekitar 1 GB ruang disk di direktori home setiap pengguna yang terhubung.
847* **Shell**: shell yang diatur untuk akun Anda di mesin jarak jauh harus dapat menjalankan perintah yang dikirim melalui SSH, seperti yang dilakukan Bash, Zsh, dan `sh`
848* **Jaringan**: Claude Code berjalan di mesin jarak jauh dan membuat permintaan jaringannya dari sana, sehingga mesin tersebut memerlukan [akses jaringan yang dibutuhkan Claude Code](/docs/id/network-config#network-access-requirements). Jika mesin tidak dapat mengunduh Claude Code, Desktop mengunduhnya di komputer Anda dan mengunggahnya. Permintaan Claude Code lainnya tetap dikirim dari mesin jarak jauh.
849
850<h4 id="use-your-ssh-configuration-on-macos-and-linux">
851 Menggunakan konfigurasi SSH Anda di macOS dan Linux
852</h4>
853
854Di macOS dan Linux, Desktop terhubung dengan menjalankan klien OpenSSH di komputer Anda, sehingga menggunakan `~/.ssh/config` Anda. Terhubung melalui klien OpenSSH memerlukan Claude Desktop v1.37937.0 atau yang lebih baru. Masukkan nama `Host` dari file tersebut di bidang **SSH host** untuk menggunakan pengaturan dari entrinya, seperti `HostName`, `User`, `IdentityFile`, `CertificateFile`, `ProxyJump`, dan `ProxyCommand`.
855
856Sebelum Anda menambahkan koneksi, periksa klien dan entri tersebut di terminal pada komputer Anda:
857
858* **Versi klien**: jalankan `ssh -V`. Klien harus OpenSSH 7.6 atau yang lebih baru.
859* **Entri**: jalankan `ssh` dengan nama `Host`, seperti `ssh devbox`. Jika gagal, perbaiki entri tersebut terlebih dahulu.
860
861Anda dapat membiarkan bidang **SSH port** dan **SSH key (optional)** kosong. Jika Anda mengisi salah satunya, Desktop menggunakannya bersama entri tersebut:
862
863* **SSH port**: nilai di sini menimpa `Port` milik entri
864* **SSH key (optional)**: Desktop menawarkan file kunci yang Anda pilih sebagai tambahan dari `IdentityFile` milik entri dan kunci-kunci di SSH agent Anda
865
866<h5 id="reach-a-machine-behind-a-jump-host">
867 Menjangkau mesin di balik jump host
868</h5>
869
870Untuk menjangkau mesin di balik jump host, yang juga disebut bastion, atur `ProxyJump` atau `ProxyCommand` di entri tersebut. Entri berikut menjangkau `devbox.internal.example.com` melalui `bastion.example.com`:
871
872```text ~/.ssh/config theme={null}
873Host devbox
874 HostName devbox.internal.example.com
875 User alice
876 ProxyJump bastion.example.com
877```
878
879Masukkan `devbox` di bidang **SSH host**.
880
881<h5 id="raise-the-ssh-connection-timeout">
882 Menaikkan timeout koneksi SSH
883</h5>
884
885Jika konfigurasi SSH Anda tidak mengatur `ConnectTimeout` untuk host tersebut, Desktop memberi `ssh` waktu 30 detik untuk terhubung. Melalui jump host atau `ProxyCommand`, waktu tersebut mencakup waktu yang dibutuhkan rute untuk terhubung. Jika rute Anda membutuhkan waktu lebih lama, tambahkan nilai yang lebih tinggi ke entri tersebut:
886
887```text ~/.ssh/config theme={null}
888Host devbox
889 HostName devbox.internal.example.com
890 User alice
891 ProxyJump bastion.example.com
892 ConnectTimeout 120
893```
894
895`ssh` menggunakan nilai pertama yang ditemukannya untuk sebuah host, jadi letakkan entri tersebut di atas entri `Host *` mana pun yang mengatur `ConnectTimeout`. Untuk memastikannya, jalankan `ssh -G devbox` di terminal pada komputer Anda. Output-nya mencakup `connecttimeout 120`. Setelah Anda mengubah nilainya, keluar dari Desktop dan buka kembali.
896
897<h4 id="windows-remote-machines">
898 Mesin jarak jauh Windows
899</h4>
900
901Mesin jarak jauh Windows memerlukan Claude Desktop v2.31226.0 atau yang lebih baru.
902
903Gunakan OpenSSH Server dari Microsoft. Mesin dapat berupa x64 atau ARM64. Shell yang dijalankan oleh server SSH dapat berupa `cmd.exe`, Windows PowerShell 5.1, atau Git Bash.
904
905Mesin jarak jauh Windows lebih sedikit diuji dibandingkan mesin Linux. Cobalah pekerjaan Anda sendiri di sana sebelum Anda mengandalkannya.
906
907Perkirakan batasan berikut, di antara yang lainnya, pada mesin jarak jauh Windows:
908
909* **Terminal**: [terminal](#run-commands-in-the-terminal) tidak terbuka dalam sesi yang foldernya berupa path Windows, seperti `C:/projects/app`
910* **Sandbox**: Claude Code berjalan di sana pada Windows native, tempat Claude Code menjalankan perintah tanpa sandbox. Lihat [tempat sandbox berjalan](/docs/id/sandboxing).
911* **Plugin**: Desktop tidak menyalin plugin yang memuat nama file atau folder yang tidak dapat disimpan oleh Windows, seperti nama yang mengandung `:`. Sesi mencantumkan plugin yang tidak disertakan oleh Desktop.
912* **Server MCP**: pada beberapa mesin jarak jauh Windows, panggilan Claude ke server MCP dari `claude_desktop_config.json` melewati Desktop, sehingga Claude tidak dapat memanggil tool-nya [saat Desktop terputus](#limits-while-desktop-is-disconnected). Sebelum Claude Desktop v2.37337.0, hal ini berlaku pada setiap mesin jarak jauh Windows.
913* **Worktree**: worktree ditempatkan di `<project-root>/.claude/worktrees/`. Jika Anda [memilih folder lain](#choose-where-ssh-session-worktrees-go), Desktop mengabaikannya.
914* **Pesan sebelumnya**: jika shell server SSH adalah `cmd.exe` atau Windows PowerShell, Anda mungkin harus terhubung terlebih dahulu sebelum dapat melihat pesan-pesan sebelumnya dari sebuah sesi
915* **Fork**: jika shell server SSH adalah `cmd.exe` atau Windows PowerShell, Anda hanya dapat melakukan fork sesi pada pesan pertamanya
916* **Berjalan saat terputus**: tugas [tetap berjalan saat Desktop terputus](#keep-a-task-running-while-desktop-is-disconnected) hanya jika server SSH mengizinkan program untuk tetap hidup setelah koneksi yang memulainya berakhir. Untuk mengetahuinya, [uji mesin jarak jauh](#prepare-a-long-task).
917* **Proses yang tersisa**: setelah sesi berakhir, periksa mesin untuk program-program yang dimulai oleh Claude Code, karena program tersebut dapat terus berjalan. [Program pembantu latar belakang](#keep-a-task-running-while-desktop-is-disconnected) yang diinstal Desktop tidak berhenti dengan sendirinya di sana.
918
919<h4 id="keep-a-task-running-while-desktop-is-disconnected">
920 Menjaga tugas tetap berjalan saat Desktop terputus
921</h4>
922
923Jika komputer Anda tertidur (sleep), Anda kehilangan jaringan, atau Anda keluar dari Desktop, tugas terus berjalan hingga selesai, membutuhkan Anda, atau mencapai salah satu [batasan](#limits-while-desktop-is-disconnected). Menutup lid laptop dihitung sebagai sleep. Memulai ulang Desktop atau komputer Anda, termasuk untuk pembaruan, dihitung sebagai keluar.
924
925Claude Code berjalan sebagai proses di mesin jarak jauh, di bawah program pembantu latar belakang yang diinstal Desktop di sana, sehingga tidak memerlukan koneksi SSH Anda untuk tetap berjalan. Perilaku di bagian ini memerlukan Claude Desktop v2.31226.0 atau yang lebih baru.
926
927<Warning>
928 Jika Anda masuk ke Desktop dengan akun Claude, jangan mengandalkan tugas untuk berjalan semalaman. Desktop memperbarui proses masuk tersebut untuk tugas hanya selama Desktop berjalan dan terhubung, sehingga masa berlaku proses masuk tugas dapat habis setelah Anda terputus, lalu tugas berhenti. Sisa waktu saat Anda terputus bervariasi.
929
930 Pekerjaan yang telah dilakukan sejauh ini tetap berada di mesin jarak jauh, dan Anda dapat melanjutkannya dengan mengirim pesan saat Anda kembali.
931
932 Jika tugas harus berjalan sepanjang malam:
933
934 * [Jaga komputer Anda tetap menyala](/docs/id/desktop-scheduled-tasks#how-scheduled-tasks-run) dan online, dengan lid terbuka dan Desktop berjalan
935 * Gunakan metode login yang berfungsi tanpa prompt, seperti kunci yang disimpan oleh SSH agent Anda, untuk mesin jarak jauh dan untuk jump host mana pun di sepanjang jalur. Dengan begitu, Desktop dapat terhubung kembali dengan sendirinya setelah koneksi terputus.
936
937 Untuk tugas yang harus berjalan saat komputer Anda sleep atau mati, mulai [sesi cloud](#run-long-running-tasks-in-the-cloud) sebagai gantinya.
938</Warning>
939
940* **Setelah sleep atau kehilangan jaringan**: Anda mendapatkan kembali tugas yang sedang berjalan jika prosesnya [masih berjalan](#limits-while-desktop-is-disconnected) dan Desktop dapat masuk tanpa prompt. Jika tidak bisa, [kirim pesan](#reconnect-after-sleep-or-a-network-loss).
941* **Setelah keluar, dengan Desktop di macOS atau Linux dan akun Claude**: Anda mendapatkan kembali tugas yang sedang berjalan jika Desktop dapat [bergabung kembali ke proses tersebut](#reopen-a-session-after-you-quit-desktop). Jika tidak bisa, tugas berhenti. Jika tugas tetap berhenti, kirim pesan.
942* **Setelah keluar, dengan Desktop di Windows atau [penyedia pihak ketiga](/docs/id/third-party-integrations)**: Anda kehilangan tugas yang sedang berjalan, karena Desktop mengakhiri proses saat sesi dibuka. Kirim pesan untuk melanjutkan.
943
944Saat Anda kembali dan tugas belum selesai, periksa apakah ada pemberitahuan bahwa Desktop tidak dapat terhubung kembali, error autentikasi, atau permintaan yang menunggu:
945
946* **Desktop tidak dapat terhubung kembali**: sesi menjelaskan alasannya, dan notifikasi mungkin juga menyebutkannya. Desktop mungkin [memerlukan Anda untuk masuk](#reconnect-after-sleep-or-a-network-loss).
947* **Error autentikasi**: [token atau kredensial masuk](#limits-while-desktop-is-disconnected) mungkin telah kedaluwarsa. Dengan akun Claude, kirim pesan untuk melanjutkan. Dengan penyedia pihak ketiga, lihat [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).
948* **Permintaan yang menunggu**: [jawab permintaan tersebut](#handle-requests-that-arrive-while-you-are-away)
949* **Tidak satu pun dari ini**: kirim pesan untuk melanjutkan
950
951<a id="prepare-a-long-task" />
952
953<h5 id="prepare-a-long-task">
954 Mempersiapkan tugas yang panjang
955</h5>
956
957* **Perbarui terlebih dahulu**: perbarui Desktop sebelum Anda memulai tugas yang panjang. Di macOS dan Windows, Desktop dapat memulai ulang dengan sendirinya untuk menginstal pembaruan yang telah diunduhnya. Restart tersebut menunggu selama Claude sedang mengerjakan tugas SSH. Di macOS dengan akun Claude, secara default restart tetap dapat dilakukan setelah pembaruan menunggu selama 72 jam.
958* **Jangan keluar dari Desktop**: jika Desktop berjalan di Windows atau menggunakan penyedia pihak ketiga, biarkan tetap terbuka selama tugas panjang berjalan. Setelah keluar, Desktop [mengakhiri tugas yang sedang berjalan](#reopen-a-session-after-you-quit-desktop) saat sesi dibuka. Membiarkannya terbuka tidak melindungi permintaan yang [menunggu Anda](#handle-requests-that-arrive-while-you-are-away).
959* **Kurangi permintaan**: pilih mode izin, aturan, atau hook yang [membuat tugas lebih jarang menunggu Anda](#handle-requests-that-arrive-while-you-are-away)
960* **Periksa jump host**: jika jump host Anda meminta proses masuk, misalnya push ke ponsel, beralihlah ke metode login yang berfungsi tanpa prompt. Jika tidak, Desktop dapat mengirim push lain setiap kali mencoba terhubung kembali.
961* **Uji mesin jarak jauh**: mulai tugas singkat, keluar dari Desktop saat tugas masih berjalan, lalu buka sesi lagi jauh setelah tugas seharusnya selesai. Jika tugas belum selesai dan sesi tidak menampilkan error autentikasi, periksa mesin jarak jauh untuk [hal-hal yang dapat mengakhiri tugas](#limits-while-desktop-is-disconnected).
962* **Jauhkan perintah dari terminal Desktop**: jika mesin jarak jauh [mengeluarkan terminal yang idle](#limits-while-desktop-is-disconnected), jalankan perintah Anda sendiri dari login SSH di luar Desktop
963
964<a id="limits-while-desktop-is-disconnected" />
965
966<h5 id="limits-while-desktop-is-disconnected">
967 Batasan saat Desktop terputus
968</h5>
969
970Tugas yang Anda biarkan berjalan dapat berakhir saat masa berlaku proses masuknya habis, saat mesin jarak jauh mengakhirinya, atau saat program pembantu berhenti atau diganti:
971
972* **Token atau kredensial masuk**: dengan akun Claude, tugas berhenti dengan error autentikasi saat token kedaluwarsa. Dengan penyedia pihak ketiga, hal yang sama berlaku untuk kredensial yang kedaluwarsa, seperti kredensial dari single sign-on atau credential helper. Lihat [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions). Dengan akun Claude, [biarkan Desktop tetap berjalan dan terhubung](#keep-a-task-running-while-desktop-is-disconnected) agar dapat memperbarui proses masuk.
973* **Mesin jarak jauh**: jika mesin jarak jauh dimulai ulang, atau mengakhiri proses Anda saat koneksi SSH Anda ditutup, tugas yang sedang berjalan berakhir. Tidak ada yang memulainya lagi selama Desktop terputus. Mesin Linux yang `KillUserProcesses` milik systemd-logind bernilai `yes` dan berlaku untuk pengguna Anda mengakhiri proses Anda dengan cara ini. Agar tugas tetap berjalan di sana, minta administrator untuk mengecualikan pengguna Anda, misalnya dengan `KillExcludeUsers`.
974* **Terminal idle**: beberapa mesin jarak jauh Linux mengeluarkan terminal yang tidak diketik siapa pun selama waktu tertentu (`StopIdleSessionSec` milik systemd-logind). Dengan Desktop di macOS atau Linux, [terminal](#run-commands-in-the-terminal) sebuah sesi dan perintah `!` berbagi koneksi SSH Desktop secara default. Logout tersebut kemudian mengakhiri koneksi saat Desktop terhubung, dan tugas yang sedang berjalan dapat ikut berakhir. Menutup panel terminal tidak mencegahnya, jadi [jauhkan perintah dari terminal tersebut](#prepare-a-long-task).
975* **Pembaruan Desktop**: jika pembaruan membawa program pembantu baru, Desktop mengganti program pembantu di mesin jarak jauh pada koneksi berikutnya, yang dapat mengakhiri tugas yang masih berjalan
976* **Ketidakhadiran yang lama**: pada mesin jarak jauh Linux atau macOS, jika Desktop tidak terhubung selama 30 hari, program pembantu berhenti dan mengakhiri setiap proses Claude Code yang berjalan di bawahnya. Hubungkan sebelum waktu tersebut.
977
978Pengeditan file dan beberapa tool dapat gagal saat Desktop terputus. Jika tugas memerlukannya, biarkan Desktop tetap terhubung:
979
980* **Worktree**: dalam sesi yang menggunakan [worktree](#work-in-parallel-with-sessions), Desktop memeriksa setiap pengeditan file sebelum Claude melakukannya. Saat Desktop terputus, setiap pengeditan menunggu sekitar 30 detik lalu gagal. Perintah shell tetap berjalan. Pada mesin jarak jauh Linux atau macOS, [pengeditan dapat tetap berfungsi](#worktree-edits-while-disconnected). Jika Anda tidak yakin, mulai sesi tanpa worktree.
981* **Pembatasan folder**: jika organisasi Anda membatasi folder mana yang boleh digunakan sesi, Desktop memeriksa setiap pembacaan, pencarian, dan pengeditan file, dengan atau tanpa worktree. Saat Desktop terputus, masing-masing menunggu hingga 10 menit lalu gagal.
982* **Konektor**: [konektor](#connect-external-tools) dan tool lain yang disediakan Desktop berjalan melalui Desktop, sehingga saat Desktop terputus setiap panggilan gagal setelah sekitar 30 detik
983* **Workflow**: Desktop memeriksa setiap [workflow](/docs/id/workflows) baru sebelum dimulai, sehingga saat Desktop terputus, workflow baru menunggu hingga 10 menit lalu gagal
984* **Server MCP**: server MCP yang dimulai Claude Code di mesin jarak jauh tidak berjalan melalui Desktop, sehingga Claude tetap dapat memanggil tool-nya. Server dari `claude_desktop_config.json` termasuk di antaranya hanya jika Desktop tidak menggunakan [klien SSH bawaannya](#worktree-edits-while-disconnected). Jika tidak demikian, dan pada [beberapa mesin jarak jauh Windows](#windows-remote-machines), Claude tidak dapat memanggil tool-nya saat Desktop terputus.
985
986<span id="worktree-edits-while-disconnected" />
987
988<Accordion title="Kapan pengeditan di worktree tetap berfungsi">
989 Pada mesin jarak jauh Linux atau macOS, pemeriksaan tidak melewati Desktop, sehingga pengeditan di dalam worktree tetap berfungsi saat Desktop terputus. Sebelum Claude Desktop v2.37337.0, hal ini hanya berlaku pada mesin jarak jauh Linux.
990
991 Pengeditan tetap gagal dalam beberapa kasus, termasuk kasus-kasus berikut:
992
993 * **Klien SSH bawaan**: Desktop menggunakannya, misalnya pada instalasi dari Microsoft Store, pada komputer Windows tanpa OpenSSH 9.4 atau yang lebih baru dari Microsoft, atau secara default di Windows dengan penyedia pihak ketiga
994 * **Lokasi repositori**: repositori adalah direktori home Anda, folder di atasnya, atau `~/.claude`
995 * **Path macOS**: pada mesin jarak jauh macOS, repositori berada di bawah `/Volumes`, atau nama folder dalam path repositori atau worktree mengandung `~` atau karakter non-ASCII
996 * **Pembatasan folder**: organisasi Anda membatasi folder mana yang boleh digunakan sesi
997 * **Corporate launcher**: sebelum Claude Desktop v2.37337.0, Anda masuk dengan akun Claude, dan organisasi Anda memulai Claude Code di mesin jarak jauh melalui [corporate launcher](/docs/id/corporate-launcher)
998
999 Sesi tanpa worktree tidak memiliki pemeriksaan seperti itu, kecuali organisasi Anda membatasi folder mana yang boleh digunakan sesi.
1000</Accordion>
1001
1002<a id="handle-requests-that-arrive-while-you-are-away" />
1003
1004<h5 id="handle-requests-that-arrive-while-you-are-away">
1005 Menangani permintaan yang datang saat Anda tidak ada
1006</h5>
1007
1008Jika Claude memerlukan persetujuan Anda atau mengajukan pertanyaan saat Desktop terputus, Claude menunggu di mesin jarak jauh. Penantian tersebut tidak memiliki batas waktu tersendiri. Saat Desktop bergabung kembali ke proses, Desktop menampilkan permintaan tersebut kepada Anda. Jika Desktop memulai proses baru sebagai gantinya, Anda kehilangan permintaan tersebut.
1009
1010Selama tugas menunggu Anda, Desktop dapat memulai ulang dengan sendirinya, misalnya untuk menginstal pembaruan. Jika Desktop berjalan di Windows atau menggunakan penyedia pihak ketiga, Anda kehilangan permintaan tersebut setelah restart itu.
1011
1012Jika Anda kehilangan permintaan, kirim pesan untuk melanjutkan.
1013
1014Untuk mengurangi seberapa sering tugas berhenti untuk menunggu Anda, dan untuk mendapatkan kabar darinya saat Anda tidak ada, siapkan salah satu dari berikut ini sebelum Anda pergi:
1015
1016* **Auto mode**: pilih [auto mode](#choose-a-permission-mode) jika [tersedia untuk Anda](#auto-mode-availability). Setelah pemblokiran berulang, Anda akan [ditanya lagi](/docs/id/permission-modes#when-auto-mode-falls-back).
1017* **Aturan allow**: di file pengaturan pengguna Anda di mesin jarak jauh, `~/.claude/settings.json`, tambahkan [aturan allow](/docs/id/permissions#manage-permissions) untuk perintah yang dibutuhkan tugas. Jika organisasi Anda [hanya menerima aturan izin dari pengaturan terkelola](/docs/id/settings-reference#allowmanagedpermissionrulesonly), minta administrator Anda untuk menambahkannya ke [pengaturan terkelola](#managed-settings) yang mencapai mesin jarak jauh. Untuk aturan allow di `.claude/settings.json` sebuah proyek, lihat [Project allow rules and workspace trust](/docs/id/permissions#project-allow-rules-and-workspace-trust).
1018* **Hook yang menjawab**: konfigurasikan [hook `PermissionRequest`](/docs/id/hooks#permissionrequest) di `~/.claude/settings.json` pada mesin jarak jauh untuk mengizinkan atau menolak permintaan atas nama Anda
1019* **Hook yang memberi tahu Anda**: konfigurasikan [hook `Notification`](/docs/id/hooks#notification) dengan matcher `permission_prompt` di file yang sama untuk mengirimi diri Anda pesan saat ada permintaan yang menunggu
1020* **Hook yang memberi tahu Anda saat Claude selesai**: konfigurasikan [hook `Stop`](/docs/id/hooks#stop) di file yang sama untuk mengirimi diri Anda pesan saat Claude selesai merespons. Hook ini tidak berjalan saat error API mengakhiri giliran. Untuk kasus tersebut, konfigurasikan [hook `StopFailure`](/docs/id/hooks#stopfailure).
1021
1022Jika organisasi Anda [hanya menjalankan hook terkelola](/docs/id/settings-reference#allowmanagedhooksonly), minta administrator Anda untuk menambahkan hook tersebut ke [pengaturan terkelola](#managed-settings) yang mencapai mesin jarak jauh.
1023
1024Claude Code tidak menyetujui secara otomatis [beberapa tindakan](/docs/id/permission-modes#actions-no-mode-auto-approves) dalam mode izin apa pun, termasuk Bypass permissions. Bergantung pada mode izin, Claude Code menolak tindakan tersebut atau menanyakannya kepada Anda, dan tugas kemudian menunggu jawaban Anda.
1025
1026<a id="reconnect-after-sleep-or-a-network-loss" />
1027
1028<h5 id="reconnect-after-sleep-or-a-network-loss">
1029 Terhubung kembali setelah sleep atau kehilangan jaringan
1030</h5>
1031
1032Jika Desktop belum terhubung kembali saat Anda kembali, kirim pesan di sesi tersebut. Desktop terhubung kembali dengan sendirinya hanya jika dapat masuk tanpa prompt, misalnya dengan kunci yang disimpan oleh SSH agent Anda.
1033
1034* **Kata sandi yang diingat**: kata sandi yang Anda izinkan untuk diingat oleh Desktop juga berfungsi tanpa prompt, tetapi untuk ketidakhadiran yang lama, lebih baik gunakan kunci yang disimpan oleh SSH agent Anda. Jika proses masuk dengan kata sandi tersebut terputus atau macet, Desktop dapat berhenti mencoba terhubung kembali dan menunggu Anda.
1035* **Prompt lainnya**: jika mesin jarak jauh meminta hal lain, seperti kode sekali pakai, Anda dapat menerima notifikasi di komputer Anda. Klik notifikasi tersebut, atau kirim pesan di sesi, dan Desktop akan menampilkan prompt-nya.
1036
1037<Accordion title="Jika jump host meminta proses masuk, gangguan berlangsung lama, output hilang, atau proses sudah tidak ada">
1038 - **Jump host, push berhenti saat Anda tidak ada**: hal ini dapat terjadi dengan Desktop di macOS atau Linux ketika tidak ada yang menjawab permintaan masuk dari jump host, misalnya push ke ponsel. Desktop kemudian berhenti mencoba terhubung kembali selama tidak ada orang di komputer Anda. Saat Anda membuka kunci atau menggunakan komputer, Anda dapat menerima push lain, karena Desktop dapat mencoba lagi. Setelah tiga upaya yang tidak dijawab, Desktop menunggu hingga Anda melakukan retry atau mengirim pesan.
1039 - **Jump host, push terus berdatangan**: jika Desktop tidak dapat mengetahui bahwa tidak ada yang menjawab, seperti pada Desktop di Windows, Desktop terus mencoba selama masih ada proses untuk digabungi kembali, baik proses tersebut masih berjalan maupun tidak. Anda dapat menerima push lain pada setiap upaya. Untuk menghentikan upaya tersebut, keluar dari Desktop, yang [dapat membuat Anda kehilangan tugas yang sedang berjalan](#reopen-a-session-after-you-quit-desktop).
1040 - **Gangguan yang lama**: Desktop melambat menjadi sekitar satu upaya setiap lima menit. Untuk terhubung kembali lebih cepat, coba lagi di sesi atau kirim pesan, yang akan dikirimkan Desktop setelah terhubung.
1041 - **Output yang hilang**: saat Desktop terputus, program pembantu menyimpan output Claude Code terbaru dari setiap sesi dalam buffer 16 MiB dan membuang output yang lebih lama. Setelah Desktop terhubung kembali, sesi dapat menampilkan `Loading recent output from <host>…`. Jika Desktop tidak dapat memuat seluruh output, Anda akan melihat baris `Some output produced while you were disconnected may be missing here.` Baris tersebut tidak berarti bahwa tugas berhenti.
1042 - **Proses sudah tidak ada**: jika proses sudah tidak ada saat Desktop terhubung kembali, Desktop dapat memulai proses baru dari riwayat percakapan yang tersimpan dan memberi tahu Claude untuk melanjutkan tugas. Desktop tidak melanjutkan tugas dengan sendirinya jika proses terus berakhir, atau jika Desktop menggunakan penyedia pihak ketiga. Kirim pesan untuk melanjutkan.
1043</Accordion>
1044
1045<a id="reopen-a-session-after-you-quit-desktop" />
1046
1047<h5 id="reopen-a-session-after-you-quit-desktop">
1048 Membuka kembali sesi setelah Anda keluar dari Desktop
1049</h5>
1050
1051Setelah Anda keluar dari Desktop, tugas terus berjalan di mesin jarak jauh hingga selesai, membutuhkan Anda, atau mencapai salah satu [batasan](#limits-while-desktop-is-disconnected).
1052
1053* **Desktop di macOS atau Linux, dengan akun Claude**: mulai Desktop dan buka sesi. Anda mendapatkan kembali tugas yang sedang berjalan saat Desktop dapat bergabung kembali ke proses. Desktop tidak selalu dapat bergabung kembali, misalnya setelah beberapa pembaruan Desktop atau setelah organisasi Anda mengubah pengaturan terkelolanya.
1054* **Di macOS atau Linux, saat Desktop tidak dapat bergabung kembali**: Desktop mengakhiri proses dan memulai proses baru dari riwayat percakapan yang tersimpan. Tugas Anda yang sedang berjalan berhenti, dan Anda kehilangan persetujuan atau pertanyaan apa pun yang sedang menunggu Anda. Setelah pembaruan, Desktop kemudian dapat memberi tahu Claude untuk melanjutkan. Jika tugas tetap berhenti, kirim pesan.
1055* **Desktop di Windows, atau dengan penyedia pihak ketiga di platform apa pun**: mulai Desktop lagi hanya saat Anda memperkirakan tugas sudah selesai. Anda tidak mendapatkan kembali tugas yang sedang berjalan, karena Desktop tidak pernah bergabung kembali setelah keluar. Desktop mengakhiri proses saat sesi dibuka, yang dapat terjadi ketika Desktop dimulai. Kirim pesan untuk melanjutkan.
1056
1057Untuk deployment pihak ketiga, lihat [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).
1058
1059<Warning>
1060 Selama proses Claude Code sebuah percakapan masih berjalan, jangan jalankan [`claude --resume`](/docs/id/cli-reference#cli-flags) untuk percakapan tersebut di mesin jarak jauh. Claude Code tidak mencegah Anda, dan kedua proses kemudian menulis ke percakapan yang sama. Jika Anda tidak yakin, tambahkan `--fork-session`, yang melanjutkan di salinan percakapan, tetapi kedua proses tetap bekerja pada file yang sama.
1061</Warning>
826 1062
827<h4 id="choose-where-ssh-session-worktrees-go">1063<h4 id="choose-where-ssh-session-worktrees-go">
828 Memilih lokasi worktree sesi SSH1064 Memilih lokasi worktree sesi SSH
8342. [`worktree.location`](/docs/id/settings-reference#worktree-location) di `~/.claude/settings.json` pada mesin jarak jauh10702. [`worktree.location`](/docs/id/settings-reference#worktree-location) di `~/.claude/settings.json` pada mesin jarak jauh
8353. `<project-root>/.claude/worktrees/`, default-nya10713. `<project-root>/.claude/worktrees/`, default-nya
836 1072
837Setiap proyek mendapatkan subfoldernya sendiri di folder yang Anda atur, sehingga dengan `~/worktrees`, path sebuah worktree adalah `~/worktrees/<project>-<id>/<worktree-name>`. Jika folder yang Anda atur berada di dalam proyek, Desktop mengabaikannya untuk proyek tersebut dan menggunakan default.1073Setiap proyek mendapatkan subfoldernya sendiri di folder yang Anda atur, sehingga dengan `~/worktrees`, path sebuah worktree adalah `~/worktrees/<project>-<id>/<worktree-name>`. Jika folder yang Anda atur berada di dalam proyek, Desktop mengabaikannya untuk proyek tersebut dan menggunakan default. Pada [mesin jarak jauh Windows](#windows-remote-machines), Desktop selalu menggunakan default.
838 1074
839Untuk mengatur **Worktree folder** pada koneksi yang Anda tambahkan sebelumnya atau koneksi yang dikelola organisasi Anda, arahkan ke koneksi tersebut di dropdown lingkungan dan klik ikon gear.1075Untuk mengatur **Worktree folder** pada koneksi yang Anda tambahkan sebelumnya atau koneksi yang dikelola organisasi Anda, arahkan ke koneksi tersebut di dropdown lingkungan dan klik ikon gear.
840 1076
