SpyBara
Go Premium

desktop.md 2026-09-13 21:00 UTC to 2026-09-14 22:58 UTC

This page contains 7 additions and 7 deletions.

2026
Wed 9 22:58 Sat 12 03:02 Mon 14 22:58 Fri 18 23:58 Mon 21 22:59 Tue 22 23:59 Fri 25 23:58

Aplikasi desktop

Dapatkan lebih banyak dari Claude Code Desktop: sesi paralel dengan isolasi Git, tata letak pane drag-and-drop, terminal terintegrasi dan editor file, side chats, computer use, Dispatch sessions dari ponsel Anda, tinjauan diff visual, pratinjau aplikasi, pemantauan PR, konektor, dan konfigurasi enterprise.

Aplikasi Claude Desktop memiliki tiga tab: Chat untuk percakapan, Cowork untuk Dispatch dan pekerjaan agentic yang lebih panjang, dan Code untuk pengembangan perangkat lunak. Halaman ini adalah referensi untuk tab Code.

Untuk Windows ARM64, unduh penginstal ARM64. Di Linux, instal dengan apt; lihat Claude Desktop di Linux.

Setelah menginstal, luncurkan Claude, masuk, dan klik tab Code. Untuk panduan sesi pertama Anda, lihat panduan Memulai.

Di tab Code, setiap percakapan adalah sebuah sesi: ia memiliki riwayat chat sendiri dan folder proyek, independen dari sesi lainnya. Bilah sisi mencantumkan sesi Anda dan memungkinkan Anda menjalankan beberapa secara paralel. Dalam sesi Anda dapat:

Untuk pekerjaan berulang terjadwal, pintasan keyboard, atau mengirim tugas dari ponsel Anda, lihat halaman dan bagian yang ditautkan. Jika Anda sudah menggunakan CLI berbasis terminal, lihat perbandingan CLI untuk apa yang berlanjut.

Mulai sesi

Sebelum Anda mengirim pesan pertama, konfigurasikan empat hal di area prompt:

  • Environment: pilih di mana Claude berjalan. Pilih Local untuk mesin Anda, Cloud untuk sesi cloud yang berlanjut setelah Anda menutup aplikasi, koneksi SSH untuk mesin jarak jauh yang Anda kelola, atau di Windows distribusi WSL. Lihat konfigurasi lingkungan.
  • Project folder: pilih folder atau repositori tempat Claude bekerja. Untuk sesi cloud, Anda dapat menambahkan beberapa repositori.
  • Model: pilih model dari dropdown di sebelah tombol kirim. Anda dapat mengubah ini selama sesi.
  • Permission mode: pilih berapa banyak otonomi yang dimiliki Claude dari pemilih mode. Anda dapat mengubah ini selama sesi.

Ketik tugas Anda dan tekan Enter untuk memulai. Setiap sesi melacak konteksnya sendiri dan perubahan secara independen.

Bekerja dengan kode

Berikan Claude konteks yang tepat, kontrol berapa banyak yang dilakukannya sendiri, dan tinjau apa yang diubahnya.

Gunakan kotak prompt

Ketik apa yang ingin Anda lakukan Claude dan tekan Enter untuk mengirim. Claude membaca file proyek Anda, membuat perubahan, dan menjalankan perintah berdasarkan permission mode Anda. Anda dapat mengarahkan ulang Claude kapan saja: klik tombol stop untuk menghentikan segera, atau ketik koreksi dan tekan Enter untuk mengirimnya tanpa menghentikan tindakan yang sedang berjalan. Claude membaca koreksi segera setelah tindakan saat ini selesai dan menyesuaikan sebelum langkah berikutnya.

Tombol + di sebelah kotak prompt memberi Anda akses ke lampiran file, skills, connectors, dan plugins.

Tambahkan file dan konteks ke prompt

Kotak prompt mendukung dua cara untuk membawa konteks eksternal:

  • @mention files: ketik @ diikuti dengan nama file untuk menambahkan file ke konteks percakapan. Claude kemudian dapat membaca dan mereferensikan file tersebut. @mention tidak tersedia di sesi cloud atau WSL.
  • Attach files: lampirkan gambar, PDF, dan file lainnya ke prompt Anda menggunakan tombol lampiran, atau seret dan lepas file langsung ke prompt. Ini berguna untuk berbagi tangkapan layar bug, mockup desain, atau dokumen referensi.

Pilih permission mode

Permission modes mengontrol berapa banyak otonomi yang dimiliki Claude selama sesi: apakah itu meminta izin sebelum mengedit file, menjalankan perintah, atau keduanya. Anda dapat beralih permission modes kapan saja menggunakan pemilih mode di sebelah tombol kirim. Untuk menyetujui setiap perubahan sendiri, beralih ke Manual.

Untuk menetapkan mode default untuk sesi lokal baru, tambahkan permissions.defaultMode ke file pengaturan Anda. Aplikasi desktop membaca file pengaturan yang sama dengan CLI. Mode yang Anda pilih di pemilih diingat per folder dan mengambil alih defaultMode untuk folder itu, kecuali Plan, yang berlaku hanya untuk sesi saat ini.

Mode Settings key Behavior
Manual default Claude meminta izin sebelum mengedit file atau menjalankan perintah. Anda melihat diff dan dapat menerima atau menolak setiap perubahan.
Accept edits acceptEdits Claude secara otomatis menerima edit file dan perintah filesystem umum seperti mkdir, touch, dan mv, tetapi masih meminta izin sebelum menjalankan perintah terminal lainnya. Gunakan ini ketika Anda mempercayai perubahan file dan menginginkan iterasi yang lebih cepat.
Plan plan Claude membaca file dan menjalankan perintah untuk menjelajahi, kemudian mengusulkan rencana tanpa mengedit kode sumber Anda. Bagus untuk tugas kompleks di mana Anda ingin meninjau pendekatan terlebih dahulu.
Auto auto Claude mengeksekusi semua tindakan dengan pemeriksaan keamanan latar belakang yang memverifikasi keselarasan dengan permintaan Anda. Mengurangi prompt izin sambil mempertahankan pengawasan. Muncul ketika auto mode tersedia; tidak ada toggle Settings terpisah untuk itu.
Bypass permissions bypassPermissions Claude berjalan tanpa prompt izin, kecuali untuk tindakan yang tidak ada mode auto-approve, safety classifiers ketika Claude bertindak di situs eksternal, atau tindakan desktop di mana Claude selalu meminta terlebih dahulu, seperti mengarsipkan sesi. Setara dengan --dangerously-skip-permissions di CLI. Di paket Pro dan Max, aktifkan di Settings → Claude Code Anda di bawah "Allow bypass permissions mode"; di paket Team dan Enterprise tidak ada toggle Settings, dan kebijakan organisasi mengontrolnya sebagai gantinya. Hanya gunakan ini di kontainer atau VM yang disandbox.

Versi sebelumnya dari tab Code memberi label pada mode ini sebagai Ask permissions, Auto accept edits, dan Plan mode.

Permission mode dontAsk hanya tersedia di CLI.

Auto mode tersedia untuk semua pengguna di Anthropic API dan memerlukan Claude Opus 4.6 atau lebih baru, Sonnet 4.6 atau lebih baru, atau model Fable. Administrator organisasi dapat menonaktifkan auto mode dengan kunci disableAutoMode di managed settings.

Dalam penyebaran Enterprise yang merutekan Desktop ke Google Cloud's Agent Platform, auto mode juga tersedia secara default; lihat Auto mode on Bedrock, Agent Platform, or Foundry untuk model yang didukung.

Sesi cloud mendukung Accept edits, Plan, dan Auto. Accept edits sesuai dengan mode default: sesi cloud secara otomatis menyetujui edit file, jadi pemilih menampilkan Accept edits alih-alih Manual. Bypass permissions tidak tersedia di sesi cloud, termasuk sesi di lingkungan self-hosted.

Admin enterprise dapat membatasi permission modes mana yang tersedia. Lihat enterprise configuration untuk detail.

Pratinjau aplikasi Anda

Claude dapat memulai dev server dan membukanya di pane Browser untuk memverifikasi perubahannya. Ini berfungsi untuk aplikasi web frontend serta server backend: Claude dapat menguji endpoint API, melihat log server, dan mengulangi masalah yang ditemukannya. Dalam kebanyakan kasus, Claude memulai server secara otomatis setelah mengedit file proyek. Anda juga dapat meminta Claude untuk pratinjau kapan saja. Secara default, Claude auto-verifies perubahan setelah setiap edit.

Pane Browser juga dapat membuka file HTML statis, PDF, gambar, dan video dari proyek Anda. Klik path HTML, PDF, gambar, atau video di chat untuk membukanya di sana.

Dari pane Browser, Anda dapat:

  • Berinteraksi dengan aplikasi yang sedang berjalan langsung di pane Browser
  • Tonton Claude memverifikasi perubahannya sendiri secara otomatis: mengambil tangkapan layar, memeriksa DOM, mengklik elemen, mengisi formulir, dan memperbaiki masalah yang ditemukannya
  • Mulai atau hentikan server dari dropdown server di toolbar sesi
  • Pertahankan cookie dan penyimpanan lokal di seluruh restart server dengan memilih Persist sessions di dropdown, sehingga Anda tidak perlu masuk kembali selama pengembangan
  • Edit konfigurasi server atau hentikan semua server sekaligus

Claude membuat konfigurasi server awal berdasarkan proyek Anda. Jika aplikasi Anda menggunakan perintah dev kustom, edit .claude/launch.json agar sesuai dengan setup Anda. Lihat Configure preview servers untuk referensi lengkap.

Untuk menghapus data sesi yang disimpan, atau untuk menonaktifkan Browser sepenuhnya, gunakan toggle di Settings → Claude Code.

Jelajahi situs eksternal

Pane Browser adalah browser bertab, jadi Anda dapat membuka dokumentasi, pelacak masalah, atau situs lainnya di sebelah aplikasi yang sedang berjalan. Untuk membuka Browser, tekan Cmd+Shift+B di macOS atau Ctrl+Shift+B di Windows, atau pilih dari menu Views. Ketika Anda mengklik tautan eksternal di chat, pemilih menawarkan Open in app untuk menggunakan pane Browser atau Default browser untuk menggunakan browser Anda sendiri; Cmd-klik di macOS atau Ctrl-klik di Windows membuka tautan di browser sistem Anda secara langsung. Anda dapat masuk ke situs di pane, termasuk alur sign-in popup seperti Google OAuth.

Claude dapat membaca dan berinteraksi dengan halaman eksternal menggunakan alat yang sama yang digunakan untuk memverifikasi aplikasi Anda, dengan dua pemeriksaan keamanan tambahan:

  • Safety classifiers meninjau tindakan penulisan Claude di halaman eksternal, seperti mengklik dan mengetik, di setiap permission mode. Ini adalah classifier yang sama yang digunakan auto mode, dan ketika mereka menandai tindakan, Anda mendapatkan prompt izin terlepas dari mode.
  • Di permission modes selain Auto dan Bypass permissions, pemeriksaan domain allowlist juga berlaku sebelum Claude menavigasi ke situs baru.

Setujui tindakan Claude di situs

Pertama kali Claude bertindak di situs eksternal, kartu izin muncul dan Claude menunggu pilihan Anda: Allow once, Always allow, atau Deny. Allow once menyetujui tindakan tanpa menyimpan apa pun. Always allow menyimpan persetujuan untuk situs itu di perangkat Anda, dan Anda dapat mencabut di Settings. Setiap situs memerlukan persetujuannya sendiri, termasuk subdomain. Server dev lokal Anda dan file proyek tidak memerlukan persetujuan, jadi auto-verify terus bekerja tanpa prompt.

Bahkan di situs yang disetujui, Claude tidak akan membeli item, membuat akun, atau melewati CAPTCHA tanpa input Anda. Browsing di pane Browser menggunakan model keamanan yang sama dengan Claude in Chrome extension. Lihat Using Claude in Chrome safely untuk cara Claude menangani situs sensitif dan tindakan berisiko.

Pilih antara Browser dan Chrome extension

Pane Browser menggunakan profil browser yang bersih, terpisah dari browser pribadi Anda, tanpa login atau riwayat yang disimpan. Gunakan untuk membangun dan menguji aplikasi Anda dan untuk situs yang tidak memerlukan identitas Anda. Ketika Anda ingin Claude bertindak sebagai Anda dalam sesi login Anda, gunakan Claude in Chrome extension sebagai gantinya, yang berbagi status login browser Anda.

Batasi browsing eksternal untuk organisasi Anda

Browser mengikuti site allowlist dan blocklist controls yang sama dengan Claude in Chrome extension. Jika organisasi Anda sudah mengonfigurasi daftar tersebut untuk extension, Browser menghormatinya secara otomatis. Administrator juga dapat menonaktifkan alat Claude di halaman eksternal dengan managed setting browserExternalPageTools. Dengan alat dinonaktifkan, pengguna masih dapat menavigasi ke situs eksternal; alat Claude tidak dapat membaca atau bertindak pada mereka.

Untuk menonaktifkan browsing eksternal sepenuhnya, atur managed setting disableBrowserExternalNavigation ke true. Ini memblokir semua navigasi eksternal di Browser, termasuk situs di allowlist organisasi Anda; server dev localhost dan pratinjau file tetap berfungsi. Gunakan browserExternalPageTools untuk membiarkan pengguna terus menjelajahi situs eksternal tanpa alat Claude, dan disableBrowserExternalNavigation untuk memblokir situs eksternal untuk pengguna dan Claude.

Tinjau perubahan dengan diff view

Setelah Claude membuat perubahan pada kode Anda, diff view memungkinkan Anda meninjau modifikasi file demi file sebelum membuat pull request.

Ketika Claude mengubah file, indikator statistik diff muncul menunjukkan jumlah baris yang ditambahkan dan dihapus, seperti +12 -1. Klik indikator ini untuk membuka diff viewer, yang menampilkan daftar file di sebelah kiri dan perubahan untuk setiap file di sebelah kanan.

Untuk mengomentari baris tertentu, klik baris apa pun di diff untuk membuka kotak komentar. Ketik umpan balik Anda dan tekan Enter untuk menambahkan komentar. Setelah menambahkan komentar ke beberapa baris, kirimkan semua komentar sekaligus:

  • macOS: tekan Cmd+Enter
  • Windows: tekan Ctrl+Enter

Claude membaca komentar Anda dan membuat perubahan yang diminta, yang muncul sebagai diff baru yang dapat Anda tinjau.

Tinjau kode Anda

Di diff view, klik Review code di toolbar kanan atas untuk meminta Claude mengevaluasi perubahan sebelum Anda melakukan commit. Claude memeriksa diff saat ini dan meninggalkan komentar langsung di diff view. Anda dapat merespons komentar apa pun atau meminta Claude untuk merevisi.

Tinjauan berfokus pada masalah sinyal tinggi: kesalahan kompilasi, kesalahan logika pasti, kerentanan keamanan, dan bug yang jelas. Ini tidak menandai gaya, pemformatan, masalah yang sudah ada sebelumnya, atau apa pun yang akan ditangkap linter.

Pantau status pull request

Setelah Anda membuka pull request, bilah status CI muncul di sesi. Claude Code menggunakan GitHub CLI untuk menanyakan hasil pemeriksaan dan menampilkan kegagalan.

  • Auto-fix: ketika diaktifkan, Claude secara otomatis mencoba memperbaiki pemeriksaan CI yang gagal dengan membaca output kegagalan dan mengulangi.
  • Auto-merge: ketika diaktifkan, Claude menggabungkan PR setelah semua pemeriksaan lulus. Metode penggabungan adalah squash. Aktifkan auto-merge di pengaturan repositori GitHub Anda terlebih dahulu; tanpanya, Claude tidak dapat menggabungkan PR.

Gunakan toggle Auto-fix dan Auto-merge di bilah status CI untuk mengaktifkan salah satu opsi. Claude Code juga mengirim notifikasi desktop ketika CI selesai. Untuk mengarsipkan sesi secara otomatis setelah PR digabungkan atau ditutup, aktifkan auto-archive di Settings → Claude Code.

Atur workspace Anda

Tab Code dibangun di sekitar pane yang dapat Anda atur dalam tata letak apa pun: chat, diff, browser, terminal, file, plan, tasks, dan subagent, bersama dengan iOS Simulator di macOS. Seret pane dengan headernya untuk memposisikan ulang, atau seret tepi pane untuk mengubah ukurannya. Tekan Cmd+\ di macOS atau Ctrl+\ di Windows untuk menutup pane yang fokus. Buka pane tambahan dari menu Views di toolbar sesi.

Jalankan perintah di terminal

Terminal terintegrasi memungkinkan Anda menjalankan perintah bersama sesi Anda tanpa beralih ke aplikasi lain. Buka dari menu Views 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 hanya tersedia di sesi lokal.

Buka dan edit file

Klik path file di chat atau diff viewer untuk membukanya di pane file. Path HTML, PDF, gambar, dan video terbuka di pane Browser sebagai gantinya. Buat edit spot dan klik Save untuk menulisnya kembali. Jika file berubah di disk sejak Anda membukanya, pane memperingatkan Anda dan memungkinkan Anda menimpa atau membuang. Klik Discard untuk mengembalikan edit Anda, atau klik path di header pane untuk menyalin path absolut.

Pane file tersedia di sesi lokal dan SSH. Untuk sesi cloud, minta Claude untuk membuat perubahan.

Buka file di aplikasi lain

Klik kanan path file apa pun di chat, diff viewer, atau pane file untuk membuka menu konteks:

  • Attach as context: tambahkan file ke prompt berikutnya Anda
  • Open in: buka file di editor yang diinstal seperti VS Code, Cursor, atau Zed
  • Show in Finder di macOS, Show in Explorer di Windows: buka folder yang berisi
  • Copy path: salin path absolut ke clipboard Anda

Alihkan view modes

View modes mengontrol berapa banyak detail yang muncul di transkrip chat. Alihkan mode dari dropdown Transcript view di sebelah tombol kirim, atau tekan Ctrl+O di macOS atau Windows untuk bersiklus melaluinya.

Mode Apa yang ditampilkan
Normal Tool calls yang diciutkan menjadi ringkasan, dengan respons teks penuh
Verbose Setiap tool call, file read, dan langkah perantara yang diambil Claude
Summary Hanya respons final Claude dan perubahan yang dibuatnya

Gunakan Verbose saat men-debug mengapa Claude mengambil tindakan tertentu. Gunakan Summary ketika Anda menjalankan beberapa sesi dan ingin memindai hasil dengan cepat.

Keyboard shortcuts

Tekan Cmd+/ di macOS atau Ctrl+/ di Windows untuk melihat semua pintasan keyboard yang tersedia di tab Code. Di Windows, gunakan Ctrl sebagai pengganti Cmd untuk pintasan di bawah. Siklus sesi, toggle terminal, dan toggle view-mode menggunakan Ctrl di setiap platform.

Shortcut Action
Cmd / Tampilkan pintasan keyboard
Cmd N Sesi baru
Cmd W Tutup sesi
Ctrl Tab / Ctrl Shift Tab Sesi berikutnya atau sebelumnya
Cmd Shift ] / Cmd Shift [ Sesi berikutnya atau sebelumnya
Esc Hentikan respons Claude
Cmd Shift D Alihkan pane diff
Cmd Shift B Alihkan pane Browser
Cmd Shift S Pilih elemen di Browser
Ctrl ` Alihkan pane terminal
Cmd \ Tutup pane yang fokus
Cmd ; Buka side chat
Ctrl O Siklus view modes
Cmd Shift M Buka menu permission mode
Cmd Shift I Buka menu model
Cmd Shift E Buka menu effort
1–9 Pilih item di menu terbuka

Pintasan ini hanya berlaku untuk tab Code. Pintasan interactive mode berbasis terminal, seperti Shift+Tab untuk siklus mode, tidak berlaku di Desktop.

Periksa penggunaan

Klik cincin penggunaan di sebelah pemilih model untuk melihat penggunaan jendela konteks saat ini Anda dan penggunaan rencana Anda untuk periode tersebut. Penggunaan konteks per sesi; penggunaan rencana dibagikan di semua permukaan Claude Code Anda.

Biarkan Claude menggunakan komputer Anda

Computer use memungkinkan Claude membuka aplikasi Anda, mengontrol layar Anda, dan bekerja langsung di mesin Anda seperti yang Anda lakukan. Minta Claude untuk berinteraksi dengan alat desktop yang tidak memiliki CLI, atau mengotomatisasi sesuatu yang hanya berfungsi melalui GUI. Untuk menjalankan dan menguji aplikasi iOS, Desktop membuka pane iOS Simulator khusus sebagai gantinya mengontrol layar Anda; pane berfungsi tanpa mengaktifkan computer use.

Computer use dimatikan secara default. Aktifkan di Settings sebelum Claude dapat mengontrol layar Anda. Di macOS, Anda juga perlu memberikan izin Accessibility dan Screen Recording.

Kapan computer use berlaku

Claude memiliki beberapa cara untuk berinteraksi dengan aplikasi atau layanan, dan computer use adalah yang paling luas dan paling lambat. Ini mencoba alat yang paling presisi terlebih dahulu:

  • Jika Anda memiliki konektor untuk layanan, Claude menggunakan konektor.
  • Jika tugas adalah perintah shell, Claude menggunakan Bash.
  • Jika tugas adalah pekerjaan browser dan Anda memiliki Claude di Chrome yang disiapkan, Claude menggunakan itu.
  • Jika tugas adalah menjalankan atau menguji aplikasi iOS, Claude menggunakan pane iOS Simulator, yang tidak menggunakan kontrol layar.
  • Jika tidak ada yang berlaku, Claude menggunakan computer use.

Per-app access tiers memperkuat ini: browser dibatasi hanya tampilan, dan terminal serta IDE dibatasi hanya klik, mengarahkan Claude ke alat khusus bahkan ketika computer use aktif. Kontrol layar dicadangkan untuk hal-hal yang tidak dapat dijangkau oleh yang lain, seperti aplikasi native, panel kontrol perangkat keras, atau alat proprietary tanpa API.

Aktifkan computer use

Computer use dimatikan secara default. Jika Anda meminta Claude melakukan sesuatu yang membutuhkannya saat dimatikan, Claude memberi tahu Anda bahwa itu dapat melakukan tugas jika Anda mengaktifkan computer use di Settings.

1

Perbarui aplikasi desktop

Pastikan Anda memiliki versi terbaru Claude Desktop. Pada macOS dan Windows, unduh atau perbarui di claude.com/download; di Linux, perbarui melalui manajer paket Anda (instruksi). Kemudian mulai ulang aplikasi.

2

Aktifkan toggle

Di aplikasi desktop, buka Settings > General (di bawah Desktop app). Temukan toggle Computer use dan aktifkan. Di Windows, toggle berlaku segera dan setup selesai. Di macOS, lanjutkan ke langkah berikutnya.

Jika Anda tidak melihat toggle, konfirmasi Anda menggunakan macOS atau Windows dengan rencana Pro atau Max, kemudian perbarui dan mulai ulang aplikasi.

3

Berikan izin macOS

Di macOS, berikan dua izin sistem sebelum toggle berlaku:

  • Accessibility: memungkinkan Claude mengklik, mengetik, dan menggulir
  • Screen Recording: memungkinkan Claude melihat apa yang ada di layar Anda

Halaman Settings menunjukkan status saat ini dari setiap izin. Jika salah satu ditolak, klik badge untuk membuka pane System Settings yang relevan.

App permissions

Pertama kali Claude perlu menggunakan aplikasi, prompt muncul di sesi Anda. Klik Allow for this session atau Deny. Persetujuan berlaku untuk sesi saat ini, atau 30 menit di sesi yang dispawn Dispatch.

Prompt juga menunjukkan tingkat kontrol apa yang diperoleh Claude untuk aplikasi itu. Tingkat ini diperbaiki berdasarkan kategori aplikasi dan tidak dapat diubah:

Tier Apa yang dapat dilakukan Claude Berlaku untuk
View only Lihat aplikasi di tangkapan layar Browser, platform perdagangan
Click only Klik dan gulir, tetapi tidak mengetik atau menggunakan pintasan keyboard Terminal, IDE
Full control Klik, ketik, seret, dan gunakan pintasan keyboard Semuanya yang lain

Aplikasi dengan jangkauan luas, seperti terminal, Finder atau File Explorer, dan System Settings atau Settings, menampilkan peringatan tambahan di prompt sehingga Anda tahu apa yang disetujui.

Anda dapat mengonfigurasi dua pengaturan di Settings > General (di bawah Desktop app):

  • Denied apps: tambahkan aplikasi di sini untuk menolaknya tanpa meminta. Claude mungkin masih mempengaruhi aplikasi yang ditolak secara tidak langsung melalui tindakan di aplikasi yang diizinkan, tetapi tidak dapat berinteraksi dengan aplikasi yang ditolak secara langsung.
  • Unhide apps when Claude finishes: saat Claude bekerja, jendela lain Anda disembunyikan sehingga hanya berinteraksi dengan aplikasi yang disetujui. Ketika Claude selesai, jendela yang disembunyikan dipulihkan kecuali Anda mematikan pengaturan ini.

Kelola sesi

Setiap sesi adalah percakapan independen dengan konteks dan perubahannya sendiri. Anda dapat menjalankan beberapa sesi secara paralel, membuat side chat, membiarkan Claude memeriksa dan mengirim pesan ke sesi Anda yang lain, mengirim pekerjaan ke cloud, atau membiarkan Dispatch memulai sesi untuk Anda dari ponsel Anda.

Bekerja secara paralel dengan sesi

Klik + New session di sidebar, atau tekan Cmd+N di macOS atau Ctrl+N di Windows, untuk bekerja pada beberapa tugas secara paralel. Tekan Ctrl+Tab dan Ctrl+Shift+Tab untuk bersiklus melalui sesi di sidebar. Untuk repositori Git, pilih opsi worktree di sebelah nama cabang untuk memberikan sesi salinan proyek Anda yang terisolasi menggunakan Git worktrees, sehingga perubahan dalam satu sesi tidak mempengaruhi sesi lain sampai Anda melakukan commit.

Untuk melihat dua sesi sekaligus, tahan Cmd di macOS atau Ctrl di Windows dan klik sesi di sidebar. Sesi terbuka di pane kedua di samping yang sudah Anda buka. Saat split aktif, mengklik sesi sidebar lain mengganti pane mana pun yang memiliki fokus. Tekan Cmd+\ di macOS atau Ctrl+\ di Windows untuk menutup pane yang difokuskan dan kembali ke sesi tunggal.

Worktrees disimpan di <project-root>/.claude/worktrees/ secara default. Anda dapat mengubah ini ke direktori kustom di Settings → Claude Code di bawah "Worktree location". Anda juga dapat mengatur awalan cabang yang ditambahkan ke setiap nama cabang worktree, yang berguna untuk menjaga cabang yang dibuat Claude tetap terorganisir. Untuk menghapus worktree ketika selesai, arahkan ke sesi di sidebar dan klik ikon archive. Untuk memiliki sesi mengarsipkan diri mereka sendiri ketika pull request mereka digabungkan atau ditutup, aktifkan Auto-archive after PR merge or close di Settings → Claude Code. Auto-archive hanya berlaku untuk sesi lokal yang telah selesai berjalan.

Untuk menyertakan file yang diabaikan git seperti .env di worktree baru, buat file .worktreeinclude di root proyek Anda.

Gunakan kontrol di bagian atas sidebar untuk memfilter sesi berdasarkan status, proyek, atau lingkungan, dan untuk mengelompokkan sesi berdasarkan proyek. Untuk mengganti nama sesi, klik judul sesi di toolbar di bagian atas sesi aktif.

Untuk memeriksa penggunaan konteks, lihat Check usage. Ketika konteks penuh, Claude secara otomatis merangkum percakapan dan terus bekerja. Anda juga dapat mengetik /compact untuk memicu perangkuman lebih awal dan membebaskan ruang konteks. Lihat jendela konteks untuk detail tentang cara pemadatan bekerja.

Aplikasi desktop mengirimkan notifikasi OS ketika sesi Code menyelesaikan tugas dan Anda tidak sedang melihat sesi tersebut.

Tanyakan pertanyaan sampingan tanpa menggoyahkan sesi

Side chat memungkinkan Anda mengajukan pertanyaan kepada Claude yang menggunakan konteks sesi Anda tetapi tidak menambahkan apa pun kembali ke percakapan utama. Gunakan ketika Anda ingin memahami sepotong kode, memeriksa asumsi, atau menjelajahi ide tanpa mengarahkan sesi ke arah yang berbeda.

Tekan Cmd+; di macOS atau Ctrl+; di Windows untuk membuka side chat, atau ketik /btw di kotak prompt. Side chat dapat membaca semuanya di thread utama hingga titik itu. Ketika selesai, tutup side chat dan lanjutkan sesi utama di mana Anda tinggalkan.

Side chats tersedia di sesi lokal, SSH, dan WSL. Aplikasi desktop tidak menyimpan side chats ke disk, jadi Anda tidak dapat kembali ke satu setelah menutup aplikasi.

Tonton background tasks

Pane tasks menunjukkan pekerjaan latar belakang yang berjalan di dalam sesi saat ini: subagent, perintah shell latar belakang, dan dynamic workflows. Buka dari menu Views atau seret ke dalam tata letak Anda.

Klik entri apa pun untuk melihat outputnya di pane subagent atau hentikan. Untuk melihat apa yang dilakukan sesi lain, gunakan sidebar, atau tanyakan Claude untuk memeriksa mereka untuk Anda.

Bekerja lintas sesi

Claude dapat membuat daftar sesi Code Anda yang lain, membaca apa yang telah dilakukan masing-masing, dan mengirim pesan di antara mereka. Tanyakan dalam bahasa biasa: "sesi mana yang menyentuh refactor auth?", "apa yang disimpulkan sesi API?", atau "beritahu sesi pembayaran bahwa skema berubah". Anda juga dapat meminta Claude untuk mengganti nama atau mengarsipkan sesi. Claude mengarsipkan sesi dengan cara yang sama seperti ikon archive di sidebar, jadi minta untuk membersihkan sesi yang PR-nya telah digabungkan.

Melalui permukaan ini, Claude hanya melihat sesi yang dijalankan aplikasi desktop itu sendiri: lokal, SSH, dan sesi WSL di tab Code. Claude tidak melihat sesi cloud, atau sesi yang Anda mulai dari CLI terminal atau ekstensi VS Code, bahkan di worktrees dari proyek yang sama, jadi dengan sembilan worktrees terminal terbuka dan dua sesi desktop, Claude yang menjawab di salah satunya melaporkan satu sesi desktop lainnya. Claude tidak pernah membuat daftar sesi tempat Anda bertanya. Secara default, Claude melihat 20 sesi yang paling aktif baru-baru ini dan melewati sesi yang diarsipkan kecuali Anda memintanya. Cross-session messaging secara terpisah memungkinkan Claude mengirim pesan ke sesi Claude Code Anda yang lain, termasuk sesi terminal.

Ketika Claude mengirim pesan ke sesi lain melalui permukaan ini, Claude Code menampilkannya di sana sebagai kartu berlabel dengan judul sesi pengirim dan tautan kembali, sehingga Anda selalu dapat mengetahui dari mana pesan berasal. Jika sesi penerima sedang menjalankan tugas, Claude Code menahan pesan dan Claude membacanya setelah pekerjaan saat ini selesai. Claude penerima dapat membalas, dan Claude Code mengirimkan balasan kembali melalui permukaan ini. Claude tidak dapat mengirimkan ke sesi yang diarsipkan, dan memberi tahu Anda ketika pesan tidak tersampaikan.

Claude Code menerapkan empat perilaku keamanan lintas sesi:

  • Sebelum mengarsipkan sesi apa pun, Claude meminta Anda terlebih dahulu. Anda melihat kartu persetujuan di setiap mode izin, termasuk izin Auto dan Bypass.
  • Melalui permukaan ini, Claude tidak dapat mengirim pesan lintas sesi dari sesi yang tidak ada yang menonton, seperti jalankan tugas terjadwal, dan tidak dapat mengirimkan pesan ke satu.
  • Claude Code memeriksa setiap pesan dari permukaan ini terhadap kontrol inbound sesi penerima, bahkan ketika sesi penerima tidak memiliki cross-session messaging itu sendiri. Jika Anda mengatur crossSessionInbound ke refuse di sesi penerima, Claude Code menghapus pesan dari permukaan ini. Claude Code melaporkan penolakan ke aplikasi desktop Claude. Sebelum v2.1.234, Claude Code menghapus setiap pesan dari permukaan ini ke sesi penerima tanpa cross-session messaging.
  • Claude Code mengutip setiap pesan masuk dan mengatribusikannya ke sesi yang mengirimnya, dan Claude masih mengikuti pengaturan izin sesi penerima sendiri saat bertindak atas satu.

Claude juga dapat menyarankan sesi baru. Ketika Claude memperhatikan sesuatu yang layak diperbaiki yang berada di luar cakupan tugas saat ini, Claude menawarkan pekerjaan sebagai chip tugas di chat. Klik chip untuk memulai pekerjaan itu di sesi baru dengan worktree-nya sendiri; Claude melanjutkan sesi saat ini Anda tanpa gangguan.

Jalankan tugas jangka panjang dari jarak jauh

Untuk refaktor besar, suite pengujian, migrasi, atau tugas jangka panjang lainnya, pilih Cloud alih-alih Local saat memulai sesi. Sesi cloud berjalan pada infrastruktur yang dikelola Anthropic secara default dan terus berjalan bahkan jika Anda menutup aplikasi atau mematikan komputer. Periksa kembali kapan saja untuk melihat kemajuan atau mengarahkan Claude ke arah yang berbeda. Anda juga dapat memantau sesi cloud dari claude.ai/code atau aplikasi Claude mobile.

Sesi cloud juga mendukung beberapa repositori. Setelah memilih lingkungan cloud, klik tombol + di sebelah pil repo untuk menambahkan repositori tambahan ke sesi. Setiap repo mendapatkan pemilih cabang sendiri. Ini berguna untuk tugas yang mencakup beberapa basis kode, seperti memperbarui perpustakaan bersama dan konsumennya.

Lihat Claude Code di web untuk informasi lebih lanjut tentang cara kerja sesi cloud.

Lanjutkan di permukaan lain

Menu Continue in, dapat diakses dari ikon VS Code di kanan bawah toolbar sesi, memungkinkan Anda memindahkan sesi ke permukaan lain:

  • Claude Code on the Web: mengirim sesi lokal Anda untuk terus berjalan dari jarak jauh. Desktop mendorong cabang Anda, menghasilkan ringkasan percakapan, dan membuat sesi cloud baru dengan konteks lengkap. Anda kemudian dapat memilih untuk mengarsipkan sesi lokal atau menyimpannya. Ini memerlukan pohon kerja yang bersih, dan tidak tersedia untuk sesi SSH.
  • Your IDE: membuka proyek Anda di IDE yang didukung di direktori kerja saat ini.

Sesi dari Dispatch

Dispatch adalah percakapan persisten dengan Claude yang tinggal di tab Cowork. Anda mengirim pesan Dispatch dengan tugas, dan itu memutuskan cara menanganinya.

Tugas dapat berakhir sebagai sesi Code dengan dua cara: Anda meminta satu secara langsung, seperti "buka sesi Claude Code dan perbaiki bug login", atau Dispatch memutuskan tugas adalah pekerjaan pengembangan dan menspawn satu sendiri. Tugas yang biasanya diarahkan ke Code termasuk memperbaiki bug, memperbarui dependensi, menjalankan tes, atau membuka pull request. Penelitian, pengeditan dokumen, dan pekerjaan spreadsheet tetap di Cowork.

Bagaimanapun, sesi Code muncul di sidebar tab Code dengan badge Dispatch. Anda mendapatkan notifikasi push di ponsel Anda ketika selesai atau memerlukan persetujuan Anda.

Jika Anda memiliki computer use diaktifkan, sesi Code yang dispawn Dispatch juga dapat menggunakannya. Persetujuan aplikasi di sesi tersebut kedaluwarsa setelah 30 menit dan meminta kembali, daripada berlangsung untuk sesi penuh seperti sesi Code biasa.

Untuk setup, pairing, dan pengaturan Dispatch, lihat artikel bantuan Dispatch. Dispatch memerlukan rencana Pro atau Max dan tidak tersedia di rencana Team atau Enterprise.

Dispatch adalah salah satu dari beberapa cara untuk bekerja dengan Claude ketika Anda jauh dari terminal Anda. Untuk perbandingan dengan opsi lain, lihat Platforms and integrations.

Perluas Claude Code

Hubungkan layanan eksternal, tambahkan alur kerja yang dapat digunakan kembali, sesuaikan perilaku Claude, dan konfigurasikan server pratinjau. Untuk mengelola connectors, skills, dan plugins di satu tempat, klik Customize di sidebar. Tab Cowork di aplikasi Desktop bersumber skills, plugins, dan connectors dari konfigurasi Customize ini, yang disinkronkan melalui akun claude.ai Anda, bukan dari direktori ~/.claude CLI.

Hubungkan alat eksternal

Untuk sesi lokal dan SSH, klik tombol + di sebelah kotak prompt dan pilih Connectors untuk menambahkan integrasi seperti Google Calendar, Slack, GitHub, Linear, Notion, dan lainnya. Anda dapat menambahkan connectors sebelum atau selama sesi. Tombol + tidak tersedia di sesi cloud atau WSL, tetapi routines mengonfigurasi connectors pada waktu pembuatan routine.

Untuk mengelola atau memutuskan connectors, buka Settings → Connectors di aplikasi desktop, atau pilih Manage connectors dari menu Connectors di kotak prompt.

Setelah terhubung, Claude dapat membaca kalender Anda, mengirim pesan, membuat masalah, dan berinteraksi dengan alat Anda secara langsung. Anda dapat meminta Claude konektor apa yang dikonfigurasi di sesi Anda.

Connectors adalah MCP servers dengan alur pengaturan grafis. Gunakan untuk integrasi cepat dengan layanan yang didukung. Untuk integrasi yang tidak tercantum di Connectors, tambahkan MCP servers secara manual melalui file pengaturan. Anda juga dapat membuat custom connectors.

Gunakan skills

Skills memperluas apa yang dapat dilakukan Claude. Claude memuatnya secara otomatis ketika relevan, atau Anda dapat menginvokan satu secara langsung: ketik / di kotak prompt atau klik tombol + dan pilih Slash commands untuk melihat apa yang tersedia. Ini mencakup built-in commands, custom skills Anda, project skills dari basis kode Anda, dan skills dari installed plugins apa pun. Pilih satu dan itu muncul disorot di bidang input. Ketik tugas Anda setelahnya dan kirim seperti biasa.

Anda dapat mengirim perintah saat Claude sedang bekerja, sama seperti pesan lainnya, dan sesi kembali ke idle setelah giliran selesai. Sebelum v2.1.206, perintah yang dikirim di tengah giliran dapat membuat sesi tetap menampilkan sebagai berjalan dan pesan yang Anda kirim setelahnya tidak terkirim.

Personal skills di ~/.claude/skills/ berlaku untuk sesi lokal; sesi SSH membaca ~/.claude/skills/ dari direktori home host jarak jauh, bukan dari mesin Anda. Sesi cloud memuat skills yang diaktifkan untuk akun claude.ai Anda sebagai gantinya. Lihat Skills in Cowork and cloud sessions.

Instal plugins

Plugins adalah paket yang dapat digunakan kembali yang menambahkan skills, agents, hooks, MCP servers, dan konfigurasi LSP ke Claude Code. Anda dapat memasang plugins dari aplikasi desktop tanpa menggunakan terminal.

Untuk sesi lokal dan SSH, klik tombol + di sebelah kotak prompt dan pilih Plugins untuk melihat plugins yang diinstal dan skills mereka. Untuk menambahkan plugin, pilih Add plugin dari submenu untuk membuka plugin browser, yang menampilkan plugins yang tersedia dari marketplaces yang dikonfigurasi termasuk marketplace Anthropic resmi. Pilih Manage plugins untuk mengaktifkan, menonaktifkan, atau mencopot plugins.

Anda dapat membatasi plugins ke akun pengguna Anda, proyek tertentu, atau lokal saja. Jika organisasi Anda mengelola plugins secara terpusat, plugins tersebut tersedia di sesi desktop dengan cara yang sama seperti di CLI.

Plugin browser tidak tersedia di sesi cloud, dan plugins yang Anda instal dari aplikasi desktop tidak tersedia untuk sesi cloud. Untuk menggunakan plugin di sesi cloud, baik deklarasikan di .claude/settings.json repository di bawah enabledPlugins sehingga Claude Code memasangnya saat startup sesi, atau aktifkan untuk akun claude.ai Anda sehingga Claude Code memuatnya sebagai synced plugin. Plugins tidak tersedia di sesi WSL. Untuk referensi plugin lengkap termasuk membuat plugins Anda sendiri, lihat plugins.

Konfigurasikan server pratinjau

Claude secara otomatis mendeteksi setup dev server Anda dan menyimpan konfigurasi di .claude/launch.json di root folder yang Anda pilih saat memulai sesi. Preview menggunakan folder ini sebagai direktori kerjanya, jadi jika Anda memilih folder induk, subfolder dengan server dev mereka sendiri tidak akan terdeteksi secara otomatis. Untuk bekerja dengan server subfolder, mulai sesi di folder itu secara langsung atau tambahkan konfigurasi secara manual.

Untuk menyesuaikan cara server Anda dimulai, misalnya menggunakan yarn dev alih-alih npm run dev atau mengubah port, edit file secara manual atau klik Edit configuration di dropdown server untuk membukanya di editor kode Anda. File mendukung JSON dengan komentar.

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 3000
    }
  ]
}

Anda dapat menentukan beberapa konfigurasi untuk menjalankan server berbeda dari proyek yang sama, seperti frontend dan API. Lihat examples di bawah.

Auto-verify changes

Ketika autoVerify diaktifkan, Claude secara otomatis memverifikasi perubahan kode setelah mengedit file. Mengambil tangkapan layar, memeriksa kesalahan, dan mengkonfirmasi perubahan berfungsi sebelum menyelesaikan responsnya.

Auto-verify aktif secara default. Nonaktifkan per-proyek dengan menambahkan "autoVerify": false ke .claude/launch.json, atau alihkan dari menu dropdown server.

{
  "version": "0.0.1",
  "autoVerify": false,
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 3000
    }
  ]
}

Ketika dinonaktifkan, alat pratinjau masih tersedia dan Anda dapat meminta Claude untuk memverifikasi kapan saja. Auto-verify membuatnya otomatis setelah setiap edit.

Configuration fields

Setiap entri dalam array configurations menerima bidang berikut:

Field Type Description
name string Pengidentifikasi unik untuk server ini
runtimeExecutable string Perintah untuk dijalankan, seperti npm, yarn, atau node
runtimeArgs string[] Argumen yang dilewatkan ke runtimeExecutable, seperti ["run", "dev"]
port number Port yang didengarkan server Anda. Default ke 3000
cwd string Direktori kerja relatif terhadap root proyek Anda. Default ke root proyek. Gunakan ${workspaceFolder} untuk mereferensikan root proyek secara eksplisit
env object Variabel lingkungan tambahan sebagai pasangan kunci-nilai, seperti { "NODE_ENV": "development" }. Jangan letakkan rahasia di sini karena file ini dilakukan commit ke repo Anda. Untuk meneruskan rahasia ke dev server Anda, aturlah di local environment editor sebagai gantinya.
autoPort boolean Cara menangani konflik port. Lihat di bawah
program string Skrip untuk dijalankan dengan node. Lihat when to use program vs runtimeExecutable
args string[] Argumen yang dilewatkan ke program. Hanya digunakan ketika program diatur
url string Alamat yang dibuka pratinjau alih-alih http://localhost:<port>. Lihat open the preview at a specific URL
When to use `program` vs `runtimeExecutable`

Gunakan runtimeExecutable dengan runtimeArgs untuk memulai dev server melalui package manager. Misalnya, "runtimeExecutable": "npm" dengan "runtimeArgs": ["run", "dev"] menjalankan npm run dev.

Gunakan program ketika Anda memiliki skrip mandiri yang ingin Anda jalankan dengan node secara langsung. Misalnya, "program": "server.js" menjalankan node server.js. Lewatkan flag tambahan dengan args.

Open the preview at a specific URL

Secara default, pratinjau membuka http://localhost:<port>. Atur url ketika server Anda memerlukan alamat yang berbeda. Kasus umum adalah server yang memerlukan HTTPS lokal, aplikasi yang menggunakan subdomain *.localhost, dan aplikasi yang menandatangani Anda melalui pengalihan.

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 8443,
      "url": "https://localhost:8443"
    }
  ]
}

Alamat localhost membuka secara langsung, persis seperti alamat port default. Ini mencakup localhost, subdomain *.localhost apa pun, 127.0.0.1, dan ::1. Untuk keamanan, url localhost harus hanya asal server Anda — tanpa path atau query, dan port harus cocok dengan port entri. Untuk menampilkan halaman tertentu, minta Claude untuk menavigasi ke sana setelah pratinjau dibuka. url localhost dengan path, query, atau port yang tidak cocok dilaporkan sebagai kesalahan konfigurasi yang menamai url dan menunjukkan perbaikannya.

Untuk alamat lain apa pun, Desktop meminta izin Anda pertama kali pratinjau membukanya, sama seperti ketika Anda menjelajahi ke situs baru di pratinjau. Alamat eksternal dapat mencakup path. Pilih Always allow untuk melewati prompt untuk situs itu di masa depan. Kebijakan organisasi yang membatasi situs eksternal di pratinjau masih berlaku.

Untuk mempratinjau server yang sudah Anda jalankan sendiri, atur url tanpa perintah. Claude melampirkan pratinjau ke server yang berjalan Anda alih-alih memulai satu:

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "url": "https://app.localhost:3000"
    }
  ]
}

url harus http atau https, dan tidak boleh berisi nama pengguna atau kata sandi.

Port conflicts

Bidang autoPort mengontrol apa yang terjadi ketika port pilihan Anda sudah digunakan:

  • true: Claude menemukan dan menggunakan port gratis secara otomatis. Cocok untuk sebagian besar dev server.
  • false: Claude gagal dengan kesalahan. Gunakan ini ketika server Anda harus menggunakan port tertentu, seperti untuk callback OAuth atau allowlist CORS.
  • Not set (default): Claude menanyakan apakah server memerlukan port itu, kemudian menyimpan jawaban Anda.

Ketika Claude memilih port yang berbeda, itu melewatkan port yang ditugaskan ke server Anda melalui variabel lingkungan PORT.

Examples

Konfigurasi ini menunjukkan setup umum untuk tipe proyek berbeda:

Konfigurasi ini menjalankan aplikasi Next.js menggunakan Yarn di port 3000:

{
"version": "0.0.1",
"configurations": [
{
"name": "web",
"runtimeExecutable": "yarn",
"runtimeArgs": ["dev"],
"port": 3000
}
]
}

Konfigurasi lingkungan

Lingkungan yang Anda pilih saat memulai sesi menentukan di mana Claude mengeksekusi dan cara Anda terhubung:

  • Local: berjalan di mesin Anda dengan akses langsung ke file Anda
  • Cloud: berjalan pada infrastruktur yang dikelola Anthropic secara default. Sesi terus berlanjut bahkan jika Anda menutup aplikasi.
  • SSH: berjalan di mesin jarak jauh yang Anda hubungkan melalui SSH, seperti server Anda sendiri, cloud VM, atau dev container
  • WSL (Windows): berjalan di dalam distribusi WSL 2 di mesin Anda, menggunakan toolchain Linux dan path aslinya

Local sessions

Aplikasi desktop tidak selalu mewarisi lingkungan shell lengkap Anda. Di macOS, ketika Anda meluncurkan aplikasi dari Dock atau Finder, itu membaca profil shell Anda, seperti ~/.zshrc atau ~/.bashrc, untuk mengekstrak PATH dan set tetap variabel Claude Code, tetapi variabel lain yang Anda ekspor di sana tidak diambil. Di Windows, aplikasi mewarisi variabel lingkungan pengguna dan sistem tetapi tidak membaca profil PowerShell.

Untuk mengatur variabel lingkungan untuk sesi lokal dan dev server di platform apa pun, buka dropdown lingkungan di kotak prompt, arahkan ke Local, dan klik ikon gear untuk membuka editor lingkungan lokal. Variabel yang Anda simpan di sini disimpan terenkripsi di mesin Anda dan berlaku untuk setiap sesi lokal dan server pratinjau yang Anda mulai. Anda juga dapat menambahkan variabel ke kunci env di file ~/.claude/settings.json Anda, meskipun ini hanya mencapai sesi Claude dan bukan dev server. Lihat environment variables untuk daftar lengkap variabel yang didukung.

Extended thinking diaktifkan secara default, yang meningkatkan kinerja pada tugas penalaran kompleks tetapi menggunakan token tambahan. Pada Anthropic API, atur MAX_THINKING_TOKENS ke 0 di editor lingkungan lokal untuk mematikan pemikiran; ini tidak berpengaruh pada model Fable, yang selalu menggunakan extended thinking. Dengan pemikiran dimatikan pada Anthropic API, Claude Code mengirimkan effort high alih-alih level yang lebih tinggi ke model yang diketahui tidak menerima kombinasi itu, seperti Opus 5.

Pada model dengan adaptive reasoning, nilai MAX_THINKING_TOKENS selain 0 diabaikan karena adaptive reasoning mengontrol kedalaman pemikiran sebagai gantinya. Pada Opus 4.6 dan Sonnet 4.6, atur CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING ke 1 untuk menggunakan anggaran pemikiran tetap; model Fable, Sonnet 5, dan Opus 4.7 dan yang lebih baru selalu menggunakan adaptive reasoning dan tidak memiliki mode anggaran tetap.

Local sessions on managed devices

Administrator Anda dapat mematikan sesi lokal dengan pengaturan terkelola disableDesktopLocalSessions. Ketika mereka melakukannya, Local tetap berada di dropdown lingkungan tetapi berwarna abu-abu dan tidak dapat dipilih, dengan tooltip yang mengatakan organisasi Anda mematikannya, dan di Windows entri WSL, yang ketersediaannya pada perangkat terkelola diatur secara terpisah, berwarna abu-abu dengan cara yang sama. Sesi baru default ke koneksi SSH pertama jika satu dikonfigurasi, dan Desktop menampilkan pesan bahwa sesi lokal tidak tersedia di perangkat ini jika Anda mencoba melanjutkan sesi yang ada. Pilih lingkungan SSH atau cloud sebagai gantinya, atau hubungi tim IT Anda.

Cloud sessions

Sesi cloud terus berlanjut di latar belakang bahkan jika Anda menutup aplikasi. Penggunaan dihitung terhadap batas rencana langganan Anda tanpa biaya komputasi terpisah.

Anda dapat membuat lingkungan cloud kustom dengan tingkat akses jaringan dan variabel lingkungan yang berbeda. Ketika Anda memulai sesi cloud, buka dropdown lingkungan di kotak prompt untuk mengelolanya:

  • Add an environment: pilih Add cloud environment
  • Edit or archive one of your own environments: arahkan ke atasnya dan klik ikon gear

Lihat Configure cloud environments untuk detail tentang mengonfigurasi akses jaringan dan variabel lingkungan.

SSH sessions

Sesi 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.

Untuk menambahkan koneksi SSH, klik dropdown lingkungan sebelum memulai sesi dan pilih + Add SSH connection. Dialog menanyakan:

  • Name: label ramah untuk koneksi ini
  • SSH Host: user@hostname atau host yang ditentukan di ~/.ssh/config
  • SSH Port: default ke 22 jika dibiarkan kosong, atau menggunakan port dari konfigurasi SSH Anda
  • Identity File: path ke kunci pribadi Anda, seperti ~/.ssh/id_rsa. Biarkan kosong untuk menggunakan kunci default atau konfigurasi SSH Anda.

Setelah ditambahkan, koneksi muncul di dropdown lingkungan. Pilih untuk memulai sesi di mesin itu. Claude berjalan di mesin jarak jauh dengan akses ke file dan alatnya.

Mesin 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.

Pre-configure SSH connections for your team

Administrator dapat mendistribusikan koneksi SSH kepada anggota tim dengan menambahkan sshConfigs ke file managed settings. Koneksi yang ditentukan dengan cara ini muncul di dropdown lingkungan setiap pengguna secara otomatis dan ditampilkan sebagai terkelola, sehingga pengguna dapat memilihnya tetapi tidak dapat mengedit atau menghapusnya di aplikasi.

Contoh berikut pre-configure satu koneksi:

{
  "sshConfigs": [
    {
      "id": "shared-dev-vm",
      "name": "Shared Dev VM",
      "sshHost": "user@dev.example.com",
      "sshPort": 22,
      "sshIdentityFile": "~/.ssh/id_ed25519"
    }
  ]
}

Setiap entri memerlukan id, name, dan sshHost. Bidang sshPort dan sshIdentityFile bersifat opsional. Pengguna juga dapat menambahkan sshConfigs ke ~/.claude/settings.json mereka sendiri, yang merupakan tempat koneksi yang ditambahkan melalui dialog disimpan.

Restrict which SSH hosts users can connect to

Administrator dapat membatasi sesi SSH Desktop ke set host yang disetujui dengan menambahkan sshHostAllowlist ke file managed settings. Ketika diatur, pengguna hanya dapat terhubung ke host yang nama hostname terselesaikannya cocok dengan salah satu pola. Atur ke array kosong untuk menonaktifkan sesi SSH sepenuhnya.

Contoh berikut memungkinkan koneksi ke host apa pun di bawah devboxes.example.com dan ke satu host bastion bernama:

{
  "sshHostAllowlist": ["*.devboxes.example.com", "bastion.example.com"]
}

Pola tidak peka huruf besar-kecil. * cocok dengan host apa pun, dan *.example.com cocok dengan example.com dan subdomain apa pun. Apa pun yang lain adalah kecocokan yang tepat. Pemeriksaan berjalan terhadap hostname setelah resolusi ~/.ssh/config melalui ssh -G, sehingga alias Host dan entri ProxyCommand/ProxyJump diizinkan selama HostName yang terselesaikan cocok.

sshHostAllowlist dibaca dari managed settings saja; nilai dalam pengaturan pengguna atau proyek diabaikan. Hanya aplikasi Claude Desktop yang menghormati pengaturan ini; CLI Claude Code dan ekstensi IDE tidak membacanya, dan itu tidak membatasi perintah ssh yang dijalankan melalui alat Bash. Ini mengatur host mana yang terhubung oleh aplikasi Desktop, bukan egress jaringan, jadi pasangkan dengan kontrol jaringan organisasi Anda atau kontrol zero-trust jika Anda memerlukan batas yang keras.

Konfigurasi Enterprise

Organisasi pada rencana Team atau Enterprise dapat mengelola perilaku aplikasi desktop melalui kontrol konsol admin, file pengaturan yang dikelola, dan kebijakan manajemen perangkat.

Kontrol konsol admin

Pengaturan ini dikonfigurasi melalui konsol pengaturan admin:

  • Code in the desktop: kontrol apakah pengguna di organisasi Anda dapat mengakses Claude Code di aplikasi desktop
  • Code in the web: aktifkan atau nonaktifkan web sessions untuk organisasi Anda
  • Remote Control: aktifkan atau nonaktifkan Remote Control untuk organisasi Anda
  • Disable Bypass permissions mode: cegah pengguna di organisasi Anda dari mengaktifkan bypass permissions mode

Pengaturan yang dikelola

Pengaturan yang dikelola menimpa pengaturan proyek dan pengguna dan berlaku untuk sesi Claude Code di Desktop. Anda dapat mengatur kunci ini di file managed settings organisasi Anda atau mendorongnya dari jarak jauh melalui konsol admin.

Key Description
permissions.disableBypassPermissionsMode atur ke "disable" untuk mencegah pengguna dari mengaktifkan Bypass permissions mode.
disableAutoMode atur ke "disable" untuk menghapus mode Auto dari pemilih mode. Juga diterima di bawah permissions.
autoMode sesuaikan apa yang dipercaya dan diblokir oleh pengklasifikasi auto mode di seluruh organisasi Anda. Lihat Configure auto mode.
browserExternalPageTools atur ke "disabled" untuk mencegah Claude menggunakan tools untuk membaca atau bertindak pada halaman eksternal di Browser pane. Pengguna masih dapat menavigasi ke situs eksternal sendiri, dan pratinjau server dev lokal tidak terpengaruh.
disableMobileSimulatorTools atur ke true untuk memblokir tools Claude untuk mengontrol dan menangkap perangkat di iOS Simulator pane. Pane tetap dapat digunakan untuk ketukan pengguna sendiri; hanya akses Claude yang dihapus. Nilainya harus berupa boolean JSON true; string "true" diabaikan.
disableBrowserExternalNavigation atur ke true untuk mematikan penjelajahan eksternal di Browser pane sepenuhnya. Baik pengguna maupun Claude tidak dapat menavigasi ke situs eksternal, dan pratinjau server dev localhost tidak terpengaruh. Nilainya harus berupa boolean JSON true; string "true" diabaikan.
sshConfigs pre-configure SSH connections yang muncul di dropdown lingkungan. Pengguna tidak dapat mengedit atau menghapus koneksi yang dikelola.
sshHostAllowlist batasi SSH sessions ke host yang nama hostname yang diselesaikannya cocok dengan salah satu pola ini. Array kosong menonaktifkan sesi SSH. Dibaca dari pengaturan yang dikelola saja.
disableDesktopLocalSessions atur ke true untuk mematikan Code sessions yang berjalan di perangkat, meninggalkan sesi SSH ke host lain dan sesi cloud tersedia. Nilainya harus berupa boolean JSON true. Dibaca dari pengaturan yang dikelola saja. Memerlukan Claude Desktop v1.37937.0 atau lebih baru.
managedMcpServers dorong konfigurasi server MCP ke semua pengguna. Tersedia dalam penyebaran Desktop pihak ketiga (3P) saja. Di setiap entri, atur transport "http", "sse", atau "stdio", detail koneksi, dan secara opsional peta toolPolicy untuk membatasi tools mana dari server tersebut yang dapat dipanggil pengguna. Berikan melalui file pengaturan yang dikelola, MDM, atau kebijakan gateway aplikasi Claude desktop block, karena penyebaran 3P tidak menerima pengaturan konsol admin. Untuk memberikannya melalui gateway, Anda memerlukan Claude Code v2.1.232 atau lebih baru di server gateway. Ini adalah kunci aplikasi desktop itu sendiri; Claude Code membaca managed setting dengan nama yang sama miliknya sendiri, dengan bentuk entri yang berbeda.

Pengaturan yang dikelola mana yang mencapai sesi Desktop tergantung pada tempat sesi tersebut berjalan. Pembatasan model seperti availableModels diberlakukan dalam sesi Claude Code Desktop dengan cara yang sama seperti di CLI terminal; lihat surface coverage.

  • Sesi lokal di mesin ini: file pengaturan yang dikelola yang disebarkan ke disk berlaku. Pengaturan yang dikelola yang didorong dari jarak jauh melalui konsol admin juga mencapai sesi ini di API Anthropic ketika sesi mengautentikasi dengan login yang memenuhi syarat atau kunci, mengikuti settings precedence yang sama seperti CLI terminal.
  • Sesi cloud: menerima server-managed settings; file yang disebarkan perangkat tidak mencapainya, karena mereka berjalan pada VM yang dikelola Anthropic. Sesi yang dialihkan ke self-hosted environment juga membaca file pengaturan yang dikelola dalam gambar runner. Bagaimana Claude Code menggabungkan sumber yang dikelola mengatakan kapan file tersebut berlaku.
  • Sesi SSH: sesi membaca file pengaturan yang dikelola dari host jarak jauh. Desktop itu sendiri membaca sshConfigs, sshHostAllowlist, dan disableDesktopLocalSessions dari pengaturan yang dikelola mesin lokal.
  • Cowork sessions: dalam sesi Cowork di mesin ini, Claude Code tidak pernah mengambil pengaturan konsol admin, bahkan ketika pengguna masuk dengan akun Team atau Enterprise, dan membaca kebijakan yang disebarkan ke mesin kecuali konfigurasi Claude Desktop Anda menetapkan requireCoworkFullVmSandbox. Sesi Cowork jarak jauh tidak menerima keduanya. Lihat di mana dan kapan kebijakan berlaku untuk file perangkat mana yang mencapai Cowork, dan MCP permission rules untuk bagaimana aturan Bash dan WebFetch berlaku untuk tools Cowork.

Dalam sesi lokal dan SSH, aplikasi desktop mengirimkan setiap konektor claude.ai yang terhubung pengguna ke Claude Code secara langsung. Tidak ada pengaturan MCP atau managed-mcp.json yang mencapai konektor tersebut, sumber pengaturan atau lokasi file mana pun yang Anda gunakan. Untuk memblokir tools konektor dalam sesi ini, gunakan connector tool controls organisasi Anda. Bagaimana konektor mencapai Claude Code menunjukkan pengaturan mana yang mengatur konektor di setiap jenis sesi.

permissions.disableBypassPermissionsMode dan disableAutoMode juga bekerja di pengaturan pengguna dan proyek, tetapi menempatkannya di pengaturan yang dikelola mencegah pengguna dari menimpanya.

Untuk kunci izin, plugin, dan pengiriman yang hanya dapat diatur oleh sumber yang dikelola, lihat Keys only managed settings can set.

Kebijakan manajemen perangkat

Tim IT dapat mengelola aplikasi desktop melalui MDM di macOS atau group policy di Windows. Kebijakan yang tersedia termasuk mengaktifkan atau menonaktifkan fitur Claude Code, mengontrol auto-updates, dan menetapkan URL penyebaran kustom.

  • macOS: konfigurasikan melalui domain preferensi com.anthropic.claudefordesktop menggunakan alat seperti Jamf atau Kandji
  • Windows: konfigurasikan melalui registri di SOFTWARE\Policies\Claude

Persyaratan akses jaringan

Desktop memuat kode aplikasinya dan konten pengguna dari host CDN Anthropic.

anthropic.com
*.anthropic.com
claude.ai
*.claude.ai
claude.com
*.claude.com
claude.app
*.claude.app
*.claudeusercontent.com
*.claudemcpcontent.com

Lalu lintas adalah HTTPS pada port 443 kecuali Anda mengonfigurasi port kustom untuk OTLP, gateway LLM, atau server MCP.

Untuk server proxy, otoritas sertifikat kustom, mTLS, dan domain yang dibutuhkan CLI standalone, lihat network configuration.

Untuk mengurangi jumlah wildcard firewall, izinkan host Anthropic ini sebagai gantinya. Subdomain tertentu dihasilkan secara dinamis dan harus tetap sebagai wildcard.

anthropic.com
api.anthropic.com
a-api.anthropic.com
a-cdn.anthropic.com
s-cdn.anthropic.com
assets-proxy.anthropic.com
claude.ai
a.claude.ai
a-cdn.claude.ai
assets.claude.ai
downloads.claude.ai
*.livepreview.claude.ai
claude.com
platform.claude.com
*.livepreview.claude.app
*.claudeusercontent.com
*.claudemcpcontent.com

Jika organisasi Anda memiliki IP allowlisting diaktifkan untuk Claude, arahkan bridge.claudeusercontent.com melalui egress proxy yang sama dengan claude.ai dan api.anthropic.com. Jika Anda tidak dapat mengarahkannya dengan cara itu, tambahkan alamat egress yang digunakan proxy Anda untuk host tersebut ke allowlist IP organisasi Anda, tetapi hanya ketika alamat tersebut didedikasikan untuk organisasi Anda: rentang egress proxy bersama juga mengakui pelanggan lain dari vendor proxy.

Anthropic memeriksa koneksi ke host tersebut terhadap allowlist IP organisasi Anda menggunakan alamat yang mereka tiba. Jika proxy Anda mengirimkan lalu lintas untuk itu melalui alamat yang tidak ada di allowlist tersebut, Claude di Chrome dan fitur lain yang terhubung melalui bridge berhenti bekerja sementara sisa aplikasi terus bekerja.

Artifact yang memuat typeface dari Google Fonts juga meminta fonts.googleapis.com dan fonts.gstatic.com. Kedua host bersifat opsional. Jika Anda memblokir mereka, artifact merender dalam typeface fallback. Blokir dengan penolakan cepat daripada drop senyap sehingga permintaan font gagal segera daripada menunda render pertama halaman.

Artifact juga dapat memuat pustaka JavaScript, seperti React atau paket charting, dari cdnjs.cloudflare.com, cdn.jsdelivr.net, cdn.tailwindcss.com, dan code.jquery.com, dan dari tidak ada host eksternal lainnya. Jika Anda memblokir host tersebut, bagian artifact yang bergantung pada pustaka tidak berfungsi, dan tidak seperti font yang diblokir, pustaka yang diblokir tidak memiliki fallback. Blokir dengan penolakan cepat di sini juga, sehingga permintaan pustaka yang diblokir gagal sekaligus daripada menggantung sampai timeout.

Autentikasi dan SSO

Organisasi enterprise dapat memerlukan SSO untuk semua pengguna. Lihat authentication untuk detail tingkat rencana dan Setting up SSO untuk konfigurasi SAML; setup OIDC tercakup dalam Claude Enterprise Administrator Guide.

Penanganan data

Claude Code memproses kode Anda secara lokal dalam sesi lokal, atau dalam sesi cloud pada infrastruktur yang dikelola Anthropic, kecuali organisasi Anda mengarahkannya ke self-hosted environment. Sesi cloud, termasuk dalam self-hosted environment, mengirimkan percakapan dan konteks kode ke API Anthropic untuk diproses; sesi lokal dan SSH mengirimkannya ke model provider mana pun yang dikonfigurasi penyebaran Anda, API Anthropic secara default. Lihat data handling untuk detail tentang retensi data, privasi, dan kepatuhan.

Penyebaran

Desktop dapat didistribusikan melalui alat penyebaran enterprise:

  • macOS: distribusikan melalui MDM seperti Jamf atau Kandji menggunakan installer .dmg
  • Windows: sebarkan melalui paket MSIX. Lihat Deploy Claude Desktop for Windows untuk opsi penyebaran enterprise termasuk instalasi senyap

Untuk domain yang akan diizinkan dalam firewall Anda, lihat network access requirements di atas. Untuk pengaturan proxy, otoritas sertifikat kustom, dan gateway LLM, lihat network configuration.

Untuk referensi konfigurasi enterprise lengkap, lihat enterprise configuration guide.

Datang dari CLI?

Jika Anda sudah menggunakan CLI Claude Code, Desktop menjalankan mesin yang sama dengan antarmuka grafis. Anda dapat menjalankan keduanya secara bersamaan di mesin yang sama, bahkan di proyek yang sama. Masing-masing mempertahankan riwayat sesi terpisah, tetapi mereka berbagi konfigurasi dan memori proyek melalui file CLAUDE.md.

Untuk memindahkan sesi CLI ke Desktop, jalankan /desktop di terminal. Claude menyimpan sesi Anda dan membukanya di aplikasi desktop, kemudian keluar dari CLI. Perintah ini tersedia di macOS dan Windows x64 ketika Anda masuk dengan langganan Claude. Perintah ini tidak tersedia dengan autentikasi kunci API atau di Amazon Bedrock, Google Cloud's Agent Platform, atau Microsoft Foundry.

Setara flag CLI

Tabel ini menunjukkan setara aplikasi desktop untuk flag CLI umum. Flag yang tidak tercantum tidak memiliki setara desktop karena dirancang untuk scripting atau otomasi.

CLI Setara Desktop
--model sonnet Dropdown model di sebelah tombol kirim
--resume, --continue Klik sesi di sidebar
--permission-mode Pemilih mode di sebelah tombol kirim
--dangerously-skip-permissions Bypass permissions mode. Di paket Pro dan Max, aktifkan di Settings → Claude Code → "Allow bypass permissions mode"; di paket Team dan Enterprise, kebijakan organisasi mengontrolnya
--add-dir Tambahkan beberapa repo dengan tombol + di sesi cloud
--allowedTools, --disallowedTools Tidak ada setara per-sesi. Aturan izin di file pengaturan masih berlaku.
--verbose Mode tampilan verbose di dropdown tampilan Transcript
--print, --output-format Tidak tersedia. Desktop hanya interaktif.
ANTHROPIC_MODEL env var Dropdown model di sebelah tombol kirim
MAX_THINKING_TOKENS env var Atur di editor lingkungan lokal. Lihat konfigurasi lingkungan.

Konfigurasi bersama

Desktop dan CLI membaca file konfigurasi yang sama, jadi setup Anda terbawa:

  • CLAUDE.md dan file CLAUDE.local.md di proyek Anda digunakan oleh keduanya
  • MCP servers yang dikonfigurasi di ~/.claude.json atau .mcp.json bekerja di keduanya
  • Hooks dan skills yang ditentukan dalam pengaturan berlaku untuk keduanya
  • Settings di ~/.claude.json dan ~/.claude/settings.json dibagikan. Aturan izin, alat yang diizinkan, dan pengaturan lainnya di settings.json berlaku untuk sesi Desktop.
  • Models: model yang sama models tersedia di keduanya. Di Desktop, pilih model dari dropdown di sebelah tombol kirim. Anda dapat mengubah model selama sesi dari dropdown yang sama.

MCP servers dari aplikasi chat Claude Desktop

Aplikasi Desktop memuat MCP servers dari claude_desktop_config.json ke dalam sesi tab Code lokal, bersama dengan servers dari ~/.claude.json dan .mcp.json. Server yang Anda tentukan di claude_desktop_config.json tersedia di permukaan chat Desktop dan sesi tab Code lokal.

Jika Anda menentukan nama server yang sama di claude_desktop_config.json dan di ~/.claude.json atau .mcp.json, tab Code dalam sesi lokal terhubung sekali dan menggunakan definisi claude_desktop_config.json.

Aplikasi juga mengirimkan ulang stdio servers dari ~/.claude.json ke CLI yang tertanam dalam sesi lokal. Ketika tingkat atas ~/.claude.json (cakupan pengguna) dan .mcp.json menentukan nama stdio server yang sama, tab Code menggunakan definisi ~/.claude.json, menyimpang dari hierarki cakupan CLI.

Perbandingan fitur

Tabel ini membandingkan kemampuan inti antara CLI dan Desktop. Untuk daftar lengkap flag CLI, lihat referensi CLI.

Fitur CLI Desktop
Mode izin Semua mode termasuk dontAsk Manual, Terima edits, Plan, dan Auto. Bypass permissions muncul di pemilih mode setelah diaktifkan: melalui toggle Settings di paket Pro dan Max, atau melalui kebijakan organisasi di paket Team dan Enterprise
Penyedia pihak ketiga Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry API Anthropic secara default. Untuk perutean gateway, lihat hubungkan aplikasi desktop ke gateway. Untuk menjalankan tab Code di Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, atau gateway LLM yang di-host sendiri, lihat Claude Desktop on 3P.
MCP servers Konfigurasikan di file pengaturan UI Connectors untuk sesi lokal dan SSH, atau file pengaturan
Plugins Perintah /plugin UI plugin manager
File @mention Berbasis teks Dengan autocomplete; hanya sesi lokal dan SSH
Lampiran file Tidak tersedia Gambar, PDF
Isolasi sesi Flag --worktree Opsi worktree saat memulai sesi
Sesi ganda Terminal terpisah Tab sidebar
Tugas berulang Cron jobs, CI pipelines Tugas terjadwal
Penggunaan komputer Aktifkan via /mcp di macOS Kontrol aplikasi dan layar di macOS dan Windows
iOS simulator Jalankan simulator melalui computer use Pane iOS Simulator terbuka secara otomatis
Integrasi Dispatch Tidak tersedia Sesi Dispatch di sidebar
Scripting dan otomasi --print, Agent SDK Tidak tersedia

Apa yang tidak tersedia di Desktop

Fitur berikut tidak tersedia di Desktop, kecuali jika dicatat:

  • Penyedia pihak ketiga: Desktop terhubung ke API Anthropic secara default. Untuk merutekan Desktop melalui gateway, atau untuk menjalankan tab Code di Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, atau gateway LLM yang di-host sendiri, ikuti tautan di baris Penyedia pihak ketiga.
  • Linux (beta): Computer Use belum tersedia di aplikasi desktop Linux. Lihat Claude Desktop on Linux.
  • Saran kode inline: Desktop tidak menyediakan saran gaya autocomplete. Ini bekerja melalui prompt percakapan dan perubahan kode eksplisit.
  • Tim agent: tim terkoordinasi, di mana Claude sebagai pemimpin tim menugaskan tugas kepada rekan tim dari daftar tugas bersama, tersedia di CLI, bukan di Desktop. Untuk pekerjaan multi-agent di dalam satu sesi, gunakan dynamic workflows, yang berjalan di Desktop; Claude juga dapat mengirim pesan dan mengelola sesi Anda yang lain secara langsung.
  • Perintah terminal-dialog: perintah bawaan yang membuka panel interaktif di terminal berperilaku berbeda di tab Code. Edit file pengaturan secara langsung untuk mengelola aturan izin dan konfigurasi, atau jalankan perintah dari CLI mandiri.
    • Perintah tanpa bentuk argumen, seperti /permissions, membalas dengan isn't available in this environment.
    • /config membuka Settings → Claude Code. Teks setelah perintah diabaikan, jadi /config theme=dark tidak mengatur tema.

Troubleshooting

Bagian di bawah mencakup masalah khusus untuk aplikasi desktop. Untuk kesalahan API runtime yang muncul di chat seperti API Error: 500, 529 Overloaded, 429, atau Prompt is too long, lihat Error reference. Kesalahan tersebut dan perbaikannya sama di CLI, desktop, dan web.

Check your version

Untuk melihat versi aplikasi desktop yang Anda jalankan:

  • macOS: klik Claude di menu bar, kemudian About Claude
  • Windows: klik Help, kemudian About

Klik nomor versi untuk menyalinnya ke clipboard Anda.

403 or authentication errors in the Code tab

Jika Anda melihat Error 403: Forbidden atau kegagalan autentikasi lainnya saat menggunakan tab Code:

  1. Keluar dan masuk kembali dari menu aplikasi. Ini adalah perbaikan paling umum.
  2. Verifikasi Anda memiliki langganan berbayar aktif: Pro, Max, Team, atau Enterprise.
  3. Jika CLI berfungsi tetapi Desktop tidak, keluar dari aplikasi desktop sepenuhnya, bukan hanya tutup jendela, kemudian buka kembali dan masuk.
  4. Periksa koneksi internet dan pengaturan proxy Anda.

Blank or stuck screen on launch

Jika aplikasi terbuka tetapi menampilkan layar kosong atau tidak responsif:

  1. Mulai ulang aplikasi.
  2. Periksa pembaruan yang tertunda. Pada macOS dan Windows, aplikasi secara otomatis memperbarui saat peluncuran; di Linux, perbarui melalui apt seperti yang dijelaskan dalam Claude Desktop on Linux.
  3. Di jaringan yang dikelola, konfirmkan firewall Anda memungkinkan host CDN dalam network access requirements.
  4. Di Windows, periksa Event Viewer untuk log crash di bawah Windows Logs → Application.

"Failed to load session"

Jika Anda melihat Failed to load session, folder yang dipilih mungkin tidak lagi ada, repositori Git mungkin memerlukan Git LFS yang tidak diinstal, atau izin file mungkin mencegah akses. Coba pilih folder berbeda atau mulai ulang aplikasi.

Session not finding installed tools

Jika Claude tidak dapat menemukan alat seperti npm, node, atau perintah CLI lainnya, verifikasi alat bekerja di terminal biasa Anda, periksa bahwa profil shell Anda dengan benar menyiapkan PATH, dan mulai ulang aplikasi desktop untuk memuat ulang variabel lingkungan.

Git and Git LFS errors

Sesi yang berjalan di worktree mereka sendiri memerlukan Git. Jika Anda melihat "Git is required," instal Git, atau Git for Windows di Windows, dan coba lagi. Di Windows, versi Claude Desktop sebelum 1.49585.0 meminta Git sebelum memulai sesi lokal apa pun; jika Anda melihat prompt itu dan tidak menggunakan worktrees, perbarui aplikasi.

Jika Anda melihat "Git LFS is required by this repository but is not installed," instal Git LFS dari git-lfs.com, jalankan git lfs install, dan mulai ulang aplikasi.

MCP servers not working on Windows

Jika toggle MCP server tidak merespons atau server gagal terhubung di Windows, periksa bahwa server dikonfigurasi dengan benar di pengaturan Anda, mulai ulang aplikasi, verifikasi proses server berjalan di Task Manager, dan tinjau log server untuk kesalahan koneksi.

App won't quit

  • macOS: tekan Cmd+Q. Jika aplikasi tidak merespons, gunakan Force Quit dengan Cmd+Option+Esc, pilih Claude, dan klik Force Quit.
  • Windows: gunakan Task Manager dengan Ctrl+Shift+Esc untuk mengakhiri proses Claude.

Windows-specific issues

  • PATH not updated after install: buka jendela terminal baru. Pembaruan PATH hanya berlaku untuk sesi terminal baru.
  • Concurrent installation error: jika Anda melihat kesalahan tentang instalasi lain sedang berlangsung tetapi tidak ada, coba jalankan installer sebagai Administrator.

"Branch doesn't exist yet" when opening in CLI

Sesi cloud dapat membuat cabang yang tidak ada di mesin lokal Anda. Klik nama cabang di toolbar sesi untuk menyalinnya, kemudian ambil secara lokal:

git fetch origin <branch-name>
git checkout <branch-name>

Still stuck?

  • Buka Help → Get Support di aplikasi desktop, atau kunjungi Claude support center secara langsung
  • Untuk masalah yang juga muncul kembali di CLI claude standalone, cari atau laporkan bug di GitHub Issues

Saat melaporkan masalah, sertakan versi aplikasi desktop Anda, sistem operasi Anda, pesan kesalahan yang tepat, dan log yang relevan. Di macOS, periksa Console.app. Di Windows, periksa Event Viewer → Windows Logs → Application. Tinjau kutipan log sebelum mempostingnya ke masalah publik; mereka dapat menyertakan jalur file dan detail lainnya dari lingkungan Anda.