Langsung ke konten utama
Tab Code dalam aplikasi Claude Desktop memungkinkan Anda menggunakan Claude Code melalui antarmuka grafis alih-alih terminal. Desktop menambahkan kemampuan ini di atas pengalaman Claude Code standar:
Baru di Desktop? Mulai dengan Memulai untuk memasang aplikasi dan membuat edit pertama Anda.
Halaman ini mencakup bekerja dengan kode, penggunaan komputer, mengelola sesi, memperluas Claude Code, tugas terjadwal, dan konfigurasi. Halaman ini juga mencakup perbandingan CLI dan pemecahan masalah.

Mulai sesi

Sebelum Anda mengirim pesan pertama, konfigurasikan empat hal di area prompt:
  • Lingkungan: pilih di mana Claude berjalan. Pilih Lokal untuk mesin Anda, Jarak Jauh untuk sesi cloud yang dihosting Anthropic, atau koneksi SSH untuk mesin jarak jauh yang Anda kelola. Lihat konfigurasi lingkungan.
  • Folder proyek: pilih folder atau repositori tempat Claude bekerja. Untuk sesi jarak jauh, Anda dapat menambahkan beberapa repositori.
  • Model: pilih model dari dropdown di sebelah tombol kirim. Model dikunci setelah sesi dimulai.
  • Mode izin: 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 mode izin Anda. Anda dapat menghentikan Claude kapan saja: klik tombol berhenti atau ketik koreksi Anda dan tekan Enter. Claude berhenti melakukan apa yang sedang dilakukannya dan menyesuaikan berdasarkan input Anda. Tombol + di sebelah kotak prompt memberi Anda akses ke lampiran file, skills, konektor, dan plugins.

Tambahkan file dan konteks ke prompt

Kotak prompt mendukung dua cara untuk membawa konteks eksternal:
  • File @mention: ketik @ diikuti dengan nama file untuk menambahkan file ke konteks percakapan. Claude kemudian dapat membaca dan mereferensikan file tersebut. @mention tidak tersedia di sesi jarak jauh.
  • Lampirkan file: 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 mode izin

Mode izin mengontrol berapa banyak otonomi yang dimiliki Claude selama sesi: apakah itu meminta izin sebelum mengedit file, menjalankan perintah, atau keduanya. Anda dapat beralih mode kapan saja menggunakan pemilih mode di sebelah tombol kirim. Mulai dengan Minta izin untuk melihat dengan tepat apa yang dilakukan Claude, kemudian pindah ke Terima edit otomatis atau Mode Rencana saat Anda merasa nyaman.
ModeKunci PengaturanPerilaku
Minta izindefaultClaude meminta izin sebelum mengedit file atau menjalankan perintah. Anda melihat diff dan dapat menerima atau menolak setiap perubahan. Direkomendasikan untuk pengguna baru.
Terima edit otomatisacceptEditsClaude secara otomatis menerima edit file tetapi masih meminta izin sebelum menjalankan perintah terminal. Gunakan ini ketika Anda mempercayai perubahan file dan menginginkan iterasi yang lebih cepat.
Mode RencanaplanClaude menganalisis kode Anda dan membuat rencana tanpa memodifikasi file atau menjalankan perintah. Bagus untuk tugas kompleks di mana Anda ingin meninjau pendekatan terlebih dahulu.
AutoautoClaude mengeksekusi semua tindakan dengan pemeriksaan keamanan latar belakang yang memverifikasi keselarasan dengan permintaan Anda. Mengurangi prompt izin sambil mempertahankan pengawasan. Saat ini pratinjau penelitian. Tersedia di rencana Team (Enterprise akan segera diluncurkan). Memerlukan Claude Sonnet 4.6 atau Opus 4.6. Aktifkan di Pengaturan Anda → Claude Code.
Lewati izinbypassPermissionsClaude berjalan tanpa prompt izin apa pun, setara dengan --dangerously-skip-permissions di CLI. Aktifkan di Pengaturan Anda → Claude Code di bawah “Izinkan mode lewati izin”. Hanya gunakan ini di kontainer atau VM yang disandbox. Admin enterprise dapat menonaktifkan opsi ini.
Mode izin dontAsk hanya tersedia di CLI.
Mulai tugas kompleks di Mode Rencana sehingga Claude memetakan pendekatan sebelum membuat perubahan. Setelah Anda menyetujui rencana, beralih ke Terima edit otomatis atau Minta izin untuk menjalankannya. Lihat jelajahi terlebih dahulu, kemudian rencanakan, kemudian kode untuk informasi lebih lanjut tentang alur kerja ini.
Sesi jarak jauh mendukung Terima edit otomatis dan Mode Rencana. Minta izin tidak tersedia karena sesi jarak jauh secara otomatis menerima edit file secara default, dan Lewati izin tidak tersedia karena lingkungan jarak jauh sudah disandbox. Admin enterprise dapat membatasi mode izin mana yang tersedia. Lihat konfigurasi enterprise untuk detail.

Pratinjau aplikasi Anda

Claude dapat memulai dev server dan membuka browser tertanam 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 memverifikasi otomatis perubahan setelah setiap edit. Dari panel pratinjau, Anda dapat:
  • Berinteraksi dengan aplikasi yang sedang berjalan langsung di browser tertanam
  • 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 Pratinjau di toolbar sesi
  • Pertahankan cookie dan penyimpanan lokal di seluruh restart server dengan memilih Pertahankan sesi 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 Konfigurasi server pratinjau untuk referensi lengkap. Untuk menghapus data sesi yang disimpan, alihkan Pertahankan sesi pratinjau di Pengaturan → Claude Code. Untuk menonaktifkan pratinjau sepenuhnya, alihkan Pratinjau di Pengaturan → Claude Code.

Tinjau perubahan dengan tampilan diff

Setelah Claude membuat perubahan pada kode Anda, tampilan diff 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 penampil diff, 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 tampilan diff, klik Tinjau kode di toolbar kanan atas untuk meminta Claude mengevaluasi perubahan sebelum Anda melakukan commit. Claude memeriksa diff saat ini dan meninggalkan komentar langsung di tampilan diff. 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.
  • Perbaikan otomatis: ketika diaktifkan, Claude secara otomatis mencoba memperbaiki pemeriksaan CI yang gagal dengan membaca output kegagalan dan mengulangi.
  • Penggabungan otomatis: ketika diaktifkan, Claude menggabungkan PR setelah semua pemeriksaan lulus. Metode penggabungan adalah squash. Penggabungan otomatis harus diaktifkan di pengaturan repositori GitHub Anda agar ini berfungsi.
Gunakan toggle Perbaikan otomatis dan Penggabungan otomatis di bilah status CI untuk mengaktifkan salah satu opsi. Claude Code juga mengirim notifikasi desktop ketika CI selesai.
Pemantauan PR memerlukan GitHub CLI (gh) untuk diinstal dan diautentikasi di mesin Anda. Jika gh tidak diinstal, Desktop akan meminta Anda untuk memasangnya saat pertama kali Anda mencoba membuat PR.

Biarkan Claude menggunakan komputer Anda

Penggunaan komputer memungkinkan Claude membuka aplikasi Anda, mengontrol layar Anda, dan bekerja langsung di mesin Anda seperti yang Anda lakukan. Minta Claude untuk menguji aplikasi native di iOS simulator, berinteraksi dengan alat desktop yang tidak memiliki CLI, atau mengotomatisasi sesuatu yang hanya berfungsi melalui GUI.
Penggunaan komputer adalah pratinjau penelitian di macOS yang memerlukan rencana Pro atau Max. Ini tidak tersedia di rencana Team atau Enterprise. Aplikasi Claude Desktop harus berjalan.
Penggunaan komputer dimatikan secara default. Aktifkan di Pengaturan dan berikan izin macOS yang diperlukan sebelum Claude dapat mengontrol layar Anda.
Tidak seperti alat Bash yang disandbox, penggunaan komputer berjalan di desktop aktual Anda dengan akses ke apa pun yang Anda setujui. Claude memeriksa setiap tindakan dan menandai potensi prompt injection dari konten di layar, tetapi batas kepercayaan berbeda. Lihat panduan keamanan penggunaan komputer untuk praktik terbaik.

Kapan penggunaan komputer berlaku

Claude memiliki beberapa cara untuk berinteraksi dengan aplikasi atau layanan, dan penggunaan komputer 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 tidak ada yang berlaku, Claude menggunakan penggunaan komputer.
Tingkat akses per-aplikasi memperkuat ini: browser dibatasi hanya tampilan, dan terminal serta IDE dibatasi hanya klik, mengarahkan Claude ke alat khusus bahkan ketika penggunaan komputer aktif. Kontrol layar dicadangkan untuk hal-hal yang tidak dapat dijangkau oleh yang lain, seperti aplikasi native, panel kontrol perangkat keras, iOS simulator, atau alat proprietary tanpa API.

Aktifkan penggunaan komputer

Penggunaan komputer 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 penggunaan komputer di Pengaturan. Untuk mengaktifkannya, buka Pengaturan > Aplikasi Desktop > Umum dan alihkan Penggunaan komputer ke aktif. Sebelum toggle berlaku, Anda perlu memberikan dua izin sistem macOS:
  • Aksesibilitas: memungkinkan Claude mengklik, mengetik, dan menggulir
  • Perekaman Layar: memungkinkan Claude melihat apa yang ada di layar Anda
Halaman Pengaturan menunjukkan status saat ini dari setiap izin. Jika salah satu ditolak, klik badge untuk membuka pane System Settings yang relevan.

Izin aplikasi

Pertama kali Claude perlu menggunakan aplikasi, prompt muncul di sesi Anda. Klik Izinkan untuk sesi ini atau Tolak. 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:
TingkatApa yang dapat dilakukan ClaudeBerlaku untuk
Hanya tampilanLihat aplikasi di tangkapan layarBrowser, platform perdagangan
Hanya klikKlik dan gulir, tetapi tidak mengetik atau menggunakan pintasan keyboardTerminal, IDE
Kontrol penuhKlik, ketik, seret, dan gunakan pintasan keyboardSemuanya yang lain
Aplikasi dengan jangkauan luas seperti Terminal, Finder, dan System Settings menampilkan peringatan tambahan di prompt sehingga Anda tahu apa yang disetujui. Anda dapat mengonfigurasi dua pengaturan di Pengaturan > Aplikasi Desktop > Umum:
  • Aplikasi yang ditolak: 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.
  • Tampilkan aplikasi ketika Claude selesai: 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, mengirim pekerjaan ke cloud, atau membiarkan Dispatch memulai sesi untuk Anda dari ponsel Anda.

Bekerja secara paralel dengan sesi

Klik + Sesi Baru di sidebar untuk bekerja pada beberapa tugas secara paralel. Untuk repositori Git, setiap sesi mendapatkan salinan proyek Anda yang terisolasi menggunakan Git worktrees, sehingga perubahan dalam satu sesi tidak mempengaruhi sesi lain sampai Anda melakukan commit. Worktrees disimpan di <project-root>/.claude/worktrees/ secara default. Anda dapat mengubah ini ke direktori kustom di Pengaturan → Claude Code di bawah “Lokasi Worktree”. 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 arsip.
Isolasi sesi memerlukan Git. Sebagian besar Mac menyertakan Git secara default. Jalankan git --version di Terminal untuk memeriksa. Di Windows, Git diperlukan agar tab Code berfungsi: unduh Git untuk Windows, pasang, dan mulai ulang aplikasi. Jika Anda mengalami kesalahan Git, coba sesi Cowork untuk membantu memecahkan masalah setup Anda.
Gunakan ikon filter di bagian atas sidebar untuk memfilter sesi berdasarkan status (Aktif, Diarsipkan) dan lingkungan (Lokal, Cloud). Untuk mengganti nama sesi atau memeriksa penggunaan konteks, klik judul sesi di toolbar di bagian atas sesi aktif. 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.

Jalankan tugas jangka panjang dari jarak jauh

Untuk refaktor besar, suite pengujian, migrasi, atau tugas jangka panjang lainnya, pilih Jarak Jauh alih-alih Lokal saat memulai sesi. Sesi jarak jauh berjalan pada infrastruktur cloud Anthropic 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 jarak jauh dari claude.ai/code atau aplikasi Claude iOS. Sesi jarak jauh 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 jarak jauh.

Lanjutkan di permukaan lain

Menu Lanjutkan di, dapat diakses dari ikon VS Code di kanan bawah toolbar sesi, memungkinkan Anda memindahkan sesi ke permukaan lain:
  • Claude Code di Web: mengirim sesi lokal Anda untuk terus berjalan dari jarak jauh. Desktop mendorong cabang Anda, menghasilkan ringkasan percakapan, dan membuat sesi jarak jauh 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.
  • IDE Anda: 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 penggunaan komputer 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. Lihat Platform dan integrasi untuk membandingkannya dengan Remote Control, Channels, Slack, dan tugas terjadwal.

Perluas Claude Code

Hubungkan layanan eksternal, tambahkan alur kerja yang dapat digunakan kembali, sesuaikan perilaku Claude, dan konfigurasikan server pratinjau.

Hubungkan alat eksternal

Untuk sesi lokal dan SSH, klik tombol + di sebelah kotak prompt dan pilih Konektor untuk menambahkan integrasi seperti Google Calendar, Slack, GitHub, Linear, Notion, dan lainnya. Anda dapat menambahkan konektor sebelum atau selama sesi. Tombol + tidak tersedia di sesi jarak jauh, tetapi tugas terjadwal mengonfigurasi konektor pada waktu pembuatan tugas. Untuk mengelola atau memutuskan konektor, buka Pengaturan → Konektor di aplikasi desktop, atau pilih Kelola konektor dari menu Konektor 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. Konektor adalah MCP servers dengan alur pengaturan grafis. Gunakan untuk integrasi cepat dengan layanan yang didukung. Untuk integrasi yang tidak tercantum di Konektor, tambahkan MCP servers secara manual melalui file pengaturan. Anda juga dapat membuat konektor kustom.

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 perintah bawaan, skills kustom Anda, skills proyek dari basis kode Anda, dan skills dari plugins yang diinstal apa pun. Pilih satu dan itu muncul disorot di bidang input. Ketik tugas Anda setelahnya dan kirim seperti biasa.

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 perintahnya. Untuk menambahkan plugin, pilih Tambah plugin dari submenu untuk membuka browser plugin, yang menampilkan plugins yang tersedia dari marketplaces yang dikonfigurasi termasuk marketplace Anthropic resmi. Pilih Kelola plugins untuk mengaktifkan, menonaktifkan, atau mencopot plugins. Plugins dapat dibatasi pada akun pengguna Anda, proyek tertentu, atau lokal saja. Plugins tidak tersedia untuk sesi jarak jauh. 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. Pratinjau 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 konfigurasi di dropdown Pratinjau 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 contoh di bawah.

Verifikasi otomatis perubahan

Ketika autoVerify diaktifkan, Claude secara otomatis memverifikasi perubahan kode setelah mengedit file. Mengambil tangkapan layar, memeriksa kesalahan, dan mengkonfirmasi perubahan berfungsi sebelum menyelesaikan responsnya. Verifikasi otomatis aktif secara default. Nonaktifkan per-proyek dengan menambahkan "autoVerify": false ke .claude/launch.json, atau alihkan dari menu dropdown Pratinjau.
{
  "version": "0.0.1",
  "autoVerify": false,
  "configurations": [...]
}
Ketika dinonaktifkan, alat pratinjau masih tersedia dan Anda dapat meminta Claude untuk memverifikasi kapan saja. Verifikasi otomatis membuatnya otomatis setelah setiap edit.

Bidang konfigurasi

Setiap entri dalam array configurations menerima bidang berikut:
BidangTipeDeskripsi
namestringPengidentifikasi unik untuk server ini
runtimeExecutablestringPerintah untuk dijalankan, seperti npm, yarn, atau node
runtimeArgsstring[]Argumen yang dilewatkan ke runtimeExecutable, seperti ["run", "dev"]
portnumberPort yang didengarkan server Anda. Default ke 3000
cwdstringDirektori kerja relatif terhadap root proyek Anda. Default ke root proyek. Gunakan ${workspaceFolder} untuk mereferensikan root proyek secara eksplisit
envobjectVariabel lingkungan tambahan sebagai pasangan kunci-nilai, seperti { "NODE_ENV": "development" }. Jangan letakkan rahasia di sini karena file ini dilakukan commit ke repo Anda. Rahasia yang ditetapkan di profil shell Anda diwariskan secara otomatis.
autoPortbooleanCara menangani konflik port. Lihat di bawah
programstringSkrip untuk dijalankan dengan node. Lihat kapan menggunakan program vs runtimeExecutable
argsstring[]Argumen yang dilewatkan ke program. Hanya digunakan ketika program diatur
Kapan menggunakan 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.

Konflik port

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.
  • Tidak diatur (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.

Contoh

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
    }
  ]
}

Jadwalkan tugas berulang

Secara default, tugas terjadwal memulai sesi lokal baru secara otomatis pada waktu dan frekuensi yang Anda pilih. Gunakan untuk pekerjaan berulang seperti tinjauan kode harian, pemeriksaan pembaruan dependensi, atau briefing pagi yang menarik dari kalender dan inbox Anda.

Bandingkan opsi penjadwalan

Claude Code offers three ways to schedule recurring work:
CloudDesktop/loop
Runs onAnthropic cloudYour machineYour machine
Requires machine onNoYesYes
Requires open sessionNoNoYes
Persistent across restartsYesYesNo (session-scoped)
Access to local filesNo (fresh clone)YesYes
MCP serversConnectors configured per taskConfig files and connectorsInherits from session
Permission promptsNo (runs autonomously)Configurable per taskInherits from session
Customizable scheduleVia /schedule in the CLIYesYes
Minimum interval1 hour1 minute1 minute
Use cloud tasks for work that should run reliably without your machine. Use Desktop tasks when you need access to local files and tools. Use /loop for quick polling during a session.
Halaman Jadwal mendukung dua jenis tugas:
  • Tugas lokal: berjalan di mesin Anda. Mereka memiliki akses langsung ke file dan alat lokal Anda, tetapi aplikasi desktop harus terbuka dan komputer Anda terjaga agar mereka dapat dijalankan.
  • Tugas jarak jauh: berjalan pada infrastruktur cloud yang dikelola Anthropic. Mereka terus berjalan bahkan ketika komputer Anda mati, tetapi bekerja terhadap klon segar repositori Anda daripada checkout lokal Anda.
Kedua jenis muncul di grid tugas yang sama. Klik Tugas Baru untuk memilih jenis mana yang akan dibuat. Sisa bagian ini mencakup tugas lokal; untuk tugas jarak jauh, lihat Tugas terjadwal cloud. Lihat Cara tugas terjadwal berjalan untuk detail tentang run yang terlewat dan perilaku catch-up untuk tugas lokal.
Secara default, tugas terjadwal lokal berjalan terhadap status apa pun yang ada di direktori kerja Anda, termasuk perubahan yang tidak dilakukan commit. Aktifkan toggle worktree di input prompt untuk memberikan setiap run worktree Git terisolasi sendiri, dengan cara yang sama sesi paralel bekerja.
Untuk membuat tugas terjadwal lokal, klik Jadwal di sidebar, klik Tugas Baru, dan pilih Tugas lokal baru. Konfigurasikan bidang ini:
BidangDeskripsi
NamaPengidentifikasi untuk tugas. Dikonversi ke kebab-case huruf kecil dan digunakan sebagai nama folder di disk. Harus unik di seluruh tugas Anda.
DeskripsiRingkasan singkat yang ditampilkan dalam daftar tugas.
PromptInstruksi yang dikirim ke Claude ketika tugas berjalan. Tulis ini dengan cara yang sama seperti Anda menulis pesan apa pun di kotak prompt. Input prompt juga mencakup kontrol untuk model, mode izin, folder kerja, dan worktree.
FrekuensiSeberapa sering tugas berjalan. Lihat opsi frekuensi di bawah.
Anda juga dapat membuat tugas dengan mendeskripsikan apa yang Anda inginkan di sesi apa pun. Misalnya, “atur tinjauan kode harian yang berjalan setiap pagi jam 9 pagi.”

Opsi frekuensi

  • Manual: tidak ada jadwal, hanya berjalan ketika Anda klik Jalankan sekarang. Berguna untuk menyimpan prompt yang Anda picu sesuai permintaan
  • Setiap jam: berjalan setiap jam. Setiap tugas mendapatkan offset tetap hingga 10 menit dari atas jam untuk membuat lalu lintas API berjenjang
  • Harian: menampilkan pemilih waktu, default ke 9:00 AM waktu lokal
  • Hari kerja: sama dengan Harian tetapi melewati Sabtu dan Minggu
  • Mingguan: menampilkan pemilih waktu dan pemilih hari
Untuk interval yang tidak ditawarkan pemilih (setiap 15 menit, hari pertama setiap bulan, dll.), minta Claude di sesi Desktop apa pun untuk mengatur jadwal. Gunakan bahasa biasa; misalnya, “jadwalkan tugas untuk menjalankan semua tes setiap 6 jam.”

Cara tugas terjadwal berjalan

Tugas terjadwal lokal berjalan di mesin Anda. Desktop memeriksa jadwal setiap menit saat aplikasi terbuka dan memulai sesi segar ketika tugas jatuh tempo, independen dari sesi manual apa pun yang Anda buka. Setiap tugas mendapatkan penundaan tetap hingga 10 menit setelah waktu terjadwal untuk membuat lalu lintas API berjenjang. Penundaan bersifat deterministik: tugas yang sama selalu dimulai pada offset yang sama. Ketika tugas dijalankan, Anda mendapatkan notifikasi desktop dan sesi baru muncul di bawah bagian Terjadwal di sidebar. Buka untuk melihat apa yang dilakukan Claude, tinjau perubahan, atau respons ke prompt izin. Sesi bekerja seperti yang lain: Claude dapat mengedit file, menjalankan perintah, membuat commit, dan membuka pull request. Tugas hanya berjalan saat aplikasi desktop berjalan dan komputer Anda terjaga. Jika komputer Anda tidur melalui waktu terjadwal, run dilewati. Untuk mencegah idle-sleep, aktifkan Jaga komputer tetap terjaga di Pengaturan di bawah Aplikasi desktop → Umum. Menutup tutup laptop masih membuatnya tidur. Untuk tugas yang perlu berjalan bahkan ketika komputer Anda mati, gunakan tugas jarak jauh sebagai gantinya.

Run yang terlewat

Ketika aplikasi dimulai atau komputer Anda bangun, Desktop memeriksa apakah setiap tugas melewatkan run apa pun dalam tujuh hari terakhir. Jika ya, Desktop memulai tepat satu run catch-up untuk waktu yang paling baru terlewat dan membuang apa pun yang lebih lama. Tugas harian yang melewatkan enam hari berjalan sekali saat bangun. Desktop menampilkan notifikasi ketika run catch-up dimulai. Ingat ini saat menulis prompt. Tugas yang dijadwalkan untuk 9 pagi mungkin berjalan pada 11 malam jika komputer Anda tidur sepanjang hari. Jika waktu penting, tambahkan penjaga ke prompt itu sendiri, misalnya: “Hanya tinjau commit hari ini. Jika sudah setelah jam 5 sore, lewati tinjauan dan hanya posting ringkasan apa yang terlewat.”

Izin untuk tugas terjadwal

Setiap tugas memiliki mode izin sendiri, yang Anda atur saat membuat atau mengedit tugas. Aturan izin dari ~/.claude/settings.json juga berlaku untuk sesi tugas terjadwal. Jika tugas berjalan dalam mode Tanya dan perlu menjalankan alat yang tidak memiliki izin, run macet sampai Anda menyetujuinya. Sesi tetap terbuka di sidebar sehingga Anda dapat menjawab nanti. Untuk menghindari macet, klik Jalankan sekarang setelah membuat tugas, tonton prompt izin, dan pilih “selalu izinkan” untuk setiap satu. Run masa depan dari tugas itu secara otomatis menyetujui alat yang sama tanpa meminta. Anda dapat meninjau dan mencabut persetujuan ini dari halaman detail tugas.

Kelola tugas terjadwal

Klik tugas di daftar Jadwal untuk membuka halaman detailnya. Dari sini Anda dapat:
  • Jalankan sekarang: mulai tugas segera tanpa menunggu waktu terjadwal berikutnya
  • Toggle berulang: jeda atau lanjutkan run terjadwal tanpa menghapus tugas
  • Edit: ubah prompt, frekuensi, folder, atau pengaturan lainnya
  • Tinjau riwayat: lihat setiap run masa lalu, termasuk yang dilewati karena komputer Anda tidur
  • Tinjau izin yang diizinkan: lihat dan cabut persetujuan alat yang disimpan untuk tugas ini dari panel Selalu diizinkan
  • Hapus: hapus tugas dan arsipkan semua sesi yang dibuatnya
Anda juga dapat mengelola tugas dengan meminta Claude di sesi Desktop apa pun. Misalnya, “jeda tugas dependency-audit saya”, “hapus tugas standup-prep”, atau “tunjukkan tugas terjadwal saya.” Untuk mengedit prompt tugas di disk, buka ~/.claude/scheduled-tasks/<task-name>/SKILL.md (atau di bawah CLAUDE_CONFIG_DIR jika diatur). File menggunakan frontmatter YAML untuk name dan description, dengan prompt sebagai body. Perubahan berlaku pada run berikutnya. Jadwal, folder, model, dan status yang diaktifkan tidak ada dalam file ini: ubah melalui formulir Edit atau minta Claude.

Konfigurasi lingkungan

Lingkungan yang Anda pilih saat memulai sesi menentukan di mana Claude mengeksekusi dan cara Anda terhubung:
  • Lokal: berjalan di mesin Anda dengan akses langsung ke file Anda
  • Jarak Jauh: berjalan pada infrastruktur cloud Anthropic. 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

Sesi lokal

Sesi lokal mewarisi variabel lingkungan dari shell Anda. Jika Anda memerlukan variabel tambahan, atur di profil shell Anda, seperti ~/.zshrc atau ~/.bashrc, dan mulai ulang aplikasi desktop. Lihat variabel lingkungan untuk daftar lengkap variabel yang didukung. Extended thinking diaktifkan secara default, yang meningkatkan kinerja pada tugas penalaran kompleks tetapi menggunakan token tambahan. Untuk menonaktifkan pemikiran sepenuhnya, atur MAX_THINKING_TOKENS=0 di profil shell Anda. Di Opus, MAX_THINKING_TOKENS diabaikan kecuali untuk 0 karena penalaran adaptif mengontrol kedalaman pemikiran sebagai gantinya.

Sesi jarak jauh

Sesi jarak jauh 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. Pilih dropdown lingkungan saat memulai sesi jarak jauh dan pilih Tambah lingkungan. Lihat lingkungan cloud untuk detail tentang mengonfigurasi akses jaringan dan variabel lingkungan.

Sesi SSH

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 + Tambah koneksi SSH. Dialog menanyakan:
  • Nama: 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. Claude Code harus diinstal di mesin jarak jauh. Setelah terhubung, sesi SSH mendukung mode izin, konektor, plugins, dan MCP servers.

Konfigurasi enterprise

Organisasi pada rencana Teams 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 di desktop: kontrol apakah pengguna di organisasi Anda dapat mengakses Claude Code di aplikasi desktop
  • Code di web: aktifkan atau nonaktifkan sesi web untuk organisasi Anda
  • Remote Control: aktifkan atau nonaktifkan Remote Control untuk organisasi Anda
  • Nonaktifkan mode Lewati izin: cegah pengguna di organisasi Anda dari mengaktifkan mode lewati izin

Pengaturan yang dikelola

Pengaturan yang dikelola menimpa pengaturan proyek dan pengguna dan berlaku ketika Desktop menjalankan sesi CLI. Anda dapat mengatur kunci ini di file pengaturan yang dikelola organisasi Anda atau mendorongnya dari jarak jauh melalui konsol admin.
KunciDeskripsi
permissions.disableBypassPermissionsModeatur ke "disable" untuk mencegah pengguna dari mengaktifkan mode lewati izin.
disableAutoModeatur ke "disable" untuk mencegah pengguna dari mengaktifkan mode Auto. Menghapus Auto dari pemilih mode. Juga diterima di bawah permissions.
autoModesesuaikan apa yang dipercaya dan diblokir oleh pengklasifikasi mode auto di seluruh organisasi Anda. Lihat Konfigurasikan pengklasifikasi mode auto.
permissions.disableBypassPermissionsMode dan disableAutoMode juga bekerja di pengaturan pengguna dan proyek, tetapi menempatkannya di pengaturan yang dikelola mencegah pengguna dari menimpanya. autoMode dibaca dari pengaturan pengguna, .claude/settings.local.json, dan pengaturan yang dikelola, tetapi bukan dari .claude/settings.json yang diperiksa: repositori yang diklon tidak dapat menyuntikkan aturan pengklasifikasinya sendiri. Untuk daftar lengkap pengaturan khusus yang dikelola termasuk allowManagedPermissionRulesOnly dan allowManagedHooksOnly, lihat pengaturan khusus yang dikelola. Pengaturan yang dikelola jarak jauh yang diunggah melalui konsol admin saat ini berlaku untuk sesi CLI dan IDE saja. Untuk pembatasan khusus Desktop, gunakan kontrol konsol admin di atas.

Kebijakan manajemen perangkat

Tim IT dapat mengelola aplikasi desktop melalui MDM di macOS atau kebijakan grup di Windows. Kebijakan yang tersedia termasuk mengaktifkan atau menonaktifkan fitur Claude Code, mengontrol pembaruan otomatis, dan menetapkan URL penyebaran kustom.
  • macOS: konfigurasikan melalui domain preferensi com.anthropic.Claude menggunakan alat seperti Jamf atau Kandji
  • Windows: konfigurasikan melalui registri di SOFTWARE\Policies\Claude

Autentikasi dan SSO

Organisasi enterprise dapat memerlukan SSO untuk semua pengguna. Lihat autentikasi untuk detail tingkat rencana dan Menyiapkan SSO untuk konfigurasi SAML dan OIDC.

Penanganan data

Claude Code memproses kode Anda secara lokal dalam sesi lokal atau pada infrastruktur cloud Anthropic dalam sesi jarak jauh. Percakapan dan konteks kode dikirim ke API Anthropic untuk diproses. Lihat penanganan data 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 atau installer .exe. Lihat Sebarkan Claude Desktop untuk Windows untuk opsi penyebaran enterprise termasuk instalasi senyap
Untuk konfigurasi jaringan seperti pengaturan proxy, allowlist firewall, dan gateway LLM, lihat konfigurasi jaringan. Untuk referensi konfigurasi enterprise lengkap, lihat panduan konfigurasi enterprise.

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 hanya tersedia di macOS dan Windows.
Kapan menggunakan Desktop vs CLI: gunakan Desktop ketika Anda menginginkan tinjauan diff visual, lampiran file, atau manajemen sesi di sidebar. Gunakan CLI ketika Anda memerlukan scripting, otomasi, penyedia pihak ketiga, atau lebih suka alur kerja terminal.

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.
CLISetara desktop
--model sonnetdropdown model di sebelah tombol kirim, sebelum memulai sesi
--resume, --continueklik sesi di sidebar
--permission-modepemilih mode di sebelah tombol kirim
--dangerously-skip-permissionsMode Lewati izin. Aktifkan di Pengaturan → Claude Code → “Izinkan mode lewati izin”. Admin enterprise dapat menonaktifkan pengaturan ini.
--add-dirtambahkan beberapa repo dengan tombol + di sesi jarak jauh
--allowedTools, --disallowedToolstidak tersedia di Desktop
--verbosetidak tersedia. Periksa log sistem: Console.app di macOS, Event Viewer → Windows Logs → Application di Windows
--print, --output-formattidak tersedia. Desktop hanya interaktif.
ANTHROPIC_MODEL env vardropdown model di sebelah tombol kirim
MAX_THINKING_TOKENS env varatur di profil shell; berlaku untuk sesi lokal. Lihat konfigurasi lingkungan.

Konfigurasi bersama

Desktop dan CLI membaca file konfigurasi yang sama, jadi setup Anda terbawa:
  • File CLAUDE.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
  • Pengaturan di ~/.claude.json dan ~/.claude/settings.json dibagikan. Aturan izin, alat yang diizinkan, dan pengaturan lainnya di settings.json berlaku untuk sesi Desktop.
  • Model: Sonnet, Opus, dan Haiku tersedia di keduanya. Di Desktop, pilih model dari dropdown di sebelah tombol kirim sebelum memulai sesi. Anda tidak dapat mengubah model selama sesi aktif.
MCP servers: aplikasi chat desktop vs Claude Code: MCP servers yang dikonfigurasi untuk aplikasi chat Claude Desktop di claude_desktop_config.json terpisah dari Claude Code dan tidak akan muncul di tab Code. Untuk menggunakan MCP servers di Claude Code, konfigurasikan di ~/.claude.json atau file .mcp.json proyek Anda. Lihat konfigurasi MCP untuk detail.

Perbandingan fitur

Tabel ini membandingkan kemampuan inti antara CLI dan Desktop. Untuk daftar lengkap flag CLI, lihat referensi CLI.
FiturCLIDesktop
Mode izinsemua mode termasuk dontAskMinta izin, Terima edit otomatis, Mode Rencana, Auto, dan Lewati izin melalui Pengaturan
--dangerously-skip-permissionsFlag CLIMode Lewati izin. Aktifkan di Pengaturan → Claude Code → “Izinkan mode lewati izin”
Penyedia pihak ketigaBedrock, Vertex, Foundrytidak tersedia. Desktop terhubung langsung ke API Anthropic.
MCP serverskonfigurasikan di file pengaturanUI Konektor untuk sesi lokal dan SSH, atau file pengaturan
Pluginsperintah /pluginUI pengelola plugin
File @mentionberbasis teksdengan autocomplete; sesi lokal dan SSH saja
Lampiran filetidak tersediagambar, PDF
Isolasi sesiflag --worktreeworktrees otomatis
Beberapa sesiterminal terpisahtab sidebar
Tugas berulangcron jobs, pipeline CItugas terjadwal
Penggunaan komputertidak tersediaKontrol aplikasi dan layar di macOS
Integrasi Dispatchtidak tersediaSesi Dispatch di sidebar
Scripting dan otomasi--print, Agent SDKtidak tersedia

Apa yang tidak tersedia di Desktop

Fitur berikut hanya tersedia di CLI atau ekstensi VS Code:
  • Penyedia pihak ketiga: Desktop terhubung langsung ke API Anthropic. Gunakan CLI dengan Bedrock, Vertex, atau Foundry sebagai gantinya.
  • Linux: aplikasi desktop hanya tersedia di macOS dan Windows.
  • Saran kode inline: Desktop tidak menyediakan saran gaya autocomplete. Ini bekerja melalui prompt percakapan dan perubahan kode eksplisit.
  • Tim agent: orkestrasi multi-agent tersedia melalui CLI dan Agent SDK, bukan di Desktop.

Pemecahan masalah

Periksa versi Anda

Untuk melihat versi aplikasi desktop yang Anda jalankan:
  • macOS: klik Claude di menu bar, kemudian Tentang Claude
  • Windows: klik Bantuan, kemudian Tentang
Klik nomor versi untuk menyalinnya ke clipboard Anda.

Kesalahan 403 atau autentikasi di tab Code

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, Teams, 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.

Layar kosong atau macet saat peluncuran

Jika aplikasi terbuka tetapi menampilkan layar kosong atau tidak responsif:
  1. Mulai ulang aplikasi.
  2. Periksa pembaruan yang tertunda. Aplikasi secara otomatis memperbarui saat peluncuran.
  3. Di Windows, periksa Event Viewer untuk log crash di bawah Windows Logs → Application.

”Gagal memuat sesi”

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.

Sesi tidak menemukan alat yang diinstal

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.

Kesalahan Git dan Git LFS

Di Windows, Git diperlukan agar tab Code memulai sesi lokal. Jika Anda melihat “Git diperlukan,” instal Git untuk Windows dan mulai ulang aplikasi. Jika Anda melihat “Git LFS diperlukan oleh repositori ini tetapi tidak diinstal,” instal Git LFS dari git-lfs.com, jalankan git lfs install, dan mulai ulang aplikasi.

MCP servers tidak bekerja di 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.

Aplikasi tidak akan keluar

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

Masalah khusus Windows

  • PATH tidak diperbarui setelah instalasi: buka jendela terminal baru. Pembaruan PATH hanya berlaku untuk sesi terminal baru.
  • Kesalahan instalasi bersamaan: jika Anda melihat kesalahan tentang instalasi lain sedang berlangsung tetapi tidak ada, coba jalankan installer sebagai Administrator.
  • ARM64: perangkat Windows ARM64 sepenuhnya didukung.

Tab Cowork tidak tersedia di Mac Intel

Tab Cowork memerlukan Apple Silicon (M1 atau lebih baru) di macOS. Di Windows, Cowork tersedia di semua perangkat keras yang didukung. Tab Chat dan Code berfungsi normal di Mac Intel.

”Cabang belum ada” saat membuka di CLI

Sesi jarak jauh 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>

Masih terjebak?

Saat melaporkan bug, 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.