Anthropic bulan ini merilis pratinjau desktop Claude Code — aplikasi desktop native yang membawa alur kerja pengodean berbasis agen dari Anthropic keluar dari terminal ke lingkungan grafis dengan dukungan bawaan untuk menjalankan beberapa sesi pengodean terisolasi secara paralel. Pratinjau desktop ini dirancang untuk berdampingan dengan versi web dan seluler Claude Code dan berfokus pada dua masalah praktis bagi pengembang: menjalankan beberapa agen AI pada repositori yang sama tanpa saling mengganggu, serta mempermudah memulai sesi lokal atau cloud dari satu GUI.
Apa itu Claude Code di Desktop?
Claude Code di Desktop adalah aplikasi desktop native (pratinjau) yang memungkinkan pengembang menjalankan sesi Claude Code secara lokal atau pada infrastruktur cloud aman milik Anthropic menggunakan GUI, bukan hanya CLI. Aplikasi ini menggabungkan kemampuan inti pengodean berbasis agen dari Claude Code dengan kepraktisan desktop: manajemen sesi, integrasi lingkungan lokal, dan peluncuran sesi web dengan sekali klik. Aplikasi ini secara eksplisit diposisikan sebagai pendamping CLI dan penawaran web Claude Code; ia menyertakan runtime Claude Code yang stabil dan mengelola versinya untuk Anda guna menjaga pengalaman yang konsisten dan stabil.
Mengapa ini penting? Secara historis, alat pengodean AI berjalan murni di terminal (pengembang yang nyaman dengan alur kerja CLI) atau murni di cloud (UI peramban). Aplikasi desktop menjembatani celah itu dengan memungkinkan eksekusi lokal berlatensi rendah dan memungkinkan Anda beralih mulus ke sesi (web) yang dihosting Anthropic saat Anda memerlukan komputasi cloud terisolasi atau kontrol enterprise. Pratinjau desktop ini khususnya menonjol karena mendukung paralelisme multi-sesi — Anda dapat menjalankan beberapa agen Claude Code independen pada repositori yang sama secara bersamaan, masing-masing di worktree Git-nya sendiri (ruang kerja cabang terisolasi) sehingga para agen tidak saling bertentangan. Itulah fitur utama yang langsung berguna bagi banyak tim.
Bagaimana edisi desktop terkait dengan versi web dan CLI?
Claude Code bermula sebagai alat baris perintah dan kemudian berkembang ke antarmuka web dan seluler; pratinjau desktop dibangun di atas fondasi tersebut. Aplikasi desktop mencerminkan banyak kemampuan yang tersedia di web (meluncurkan sesi, koneksi repositori, progres yang dapat dilihat) tetapi berfokus pada ergonomi alur kerja lokal—UX desktop, instalasi native, dan integrasi yang lebih erat dengan repositori Git lokal melalui worktree—agar sesi dapat berjalan secara bersamaan tanpa saling mengganggu status file.
Lihat juga Claude Code Web: Apa itu dan cara menggunakannya
7 fitur unggulan Claude Code di Desktop
1) Paralelisme multi-sesi
Claude Code untuk Desktop mendukung menjalankan beberapa sesi Claude independen pada waktu yang sama. Artinya Anda dapat memiliki satu sesi fokus pada perbaikan bug, sesi lain menulis pengujian, dan sesi ketiga membuat dokumentasi — semuanya dieksekusi secara bersamaan alih-alih mengantre dalam satu sesi. Paralelisme ini mempercepat alur kerja dan memungkinkan Anda mendelegasikan berbagai tugas secara konkuren.
Contoh:
Misalkan Anda memiliki proyek bernama my-app, dan Anda ingin:
- Membiarkan Claude mengubah beranda di satu jendela;
- Membiarkan Claude mengoptimalkan logika basis data di jendela lain.
Claude Desktop akan otomatis membuatkan untuk Anda:
~/.claude-worktrees/my-app/homepage/
~/.claude-worktrees/my-app/database/
Dua salinan independen (tanpa konflik). Ini seperti menjalankan dua cabang pengembangan secara bersamaan, dengan Claude menangani masing-masing untuk Anda.
2. .worktreeinclude: Membuat Claude menyadari file yang diabaikan
Terkadang proyek Anda memiliki file seperti .env atau .local, yang biasanya diabaikan oleh .gitignore dan tidak akan disalin ke direktori kerja Claude. File yang terdaftar dalam .gitignore tidak otomatis disalin ke worktree baru. Claude menyediakan mekanisme baru: Anda dapat membuat file .worktreeinclude di direktori root proyek, untuk memberi tahu file mana yang perlu disalin — daftar bergaya .gitignore yang menetapkan file terabaikan mana yang harus disalin ke worktree yang baru dibuat (misalnya, file .env lokal atau pengaturan spesifik pengembang). Hanya file yang muncul di .worktreeinclude dan .gitignore yang disalin, yang mencegah secara tidak sengaja menduplikasi file yang dilacak. Ini sangat penting untuk mempertahankan file rahasia atau lingkungan per sesi tanpa memasukkannya ke Git.
Sebagai contoh:
.env
.env.local
.env.production
**/.claude/settings.local.json
Artinya: Saat Claude membuat direktori kerja, file-file ini juga akan disalin.
Catatan:
- Hanya file yang ada di .gitignore dan .worktreeinclude yang akan disalin;
- Hindari menyalin secara tidak sengaja file penting yang dilacak.
3) Meluncurkan dan menyinkronkan dengan sesi web/cloud
Aplikasi desktop dapat bertindak sebagai peluncur untuk sesi web/cloud—artinya Anda dapat memulai sesi Claude Code berbasis cloud dari UI desktop dan memantau atau mengarahkannya secara lokal. Mode hibrida ini berguna jika Anda menginginkan kenyamanan kontrol lokal dengan skala atau model perizinan dari eksekusi yang dihosting di cloud.
Catatan:
- Saat berjalan di cloud, tugas Claude akan dieksekusi di server keamanan Anthropic.
- Peralihan antara lingkungan lokal dan cloud berlangsung mulus.
- Untuk membuat sesi, cukup pilih "remote environment".
4) Meluncurkan dan menyinkronkan dengan sesi web/cloud
Aplikasi desktop dapat bertindak sebagai peluncur untuk sesi web/cloud—artinya Anda dapat memulai sesi Claude Code berbasis cloud dari UI desktop dan memantau atau mengarahkannya secara lokal. Mode hibrida ini berguna jika Anda menginginkan kenyamanan kontrol lokal dengan skala atau model perizinan dari eksekusi yang dihosting di cloud (lokal untuk tugas cepat, cloud untuk tugas berisiko atau berat sumber daya).
5) Versi Bundel dan Konfigurasi Enterprise
Desktop menyertakan runtime Claude Code yang stabil dalam bundel yang diunduh saat peluncuran pertama dan dikelola secara otomatis. Admin enterprise dapat menonaktifkan penggunaan Claude Code lokal jika diperlukan (kebijakan enterprise isClaudeCodeForDesktopEnabled). Penginstal desktop mendukung format penyebaran enterprise umum (MSIX untuk Windows, PKG untuk macOS), dan administrator dapat mengontrol pembaruan serta akses ekstensi. Kontrol ini dirancang untuk memudahkan adopsi oleh tim besar.
Catatan:
- Aplikasi akan diunduh secara otomatis saat pertama kali dibuka;
- Aplikasi desktop mengelola pembaruan versi secara otomatis;
- Secara otomatis membersihkan versi lama agar sistem tetap bersih;
- Meski Anda telah menginstal versi CLI di komputer, aplikasi ini tetap akan menggunakan versinya sendiri (untuk stabilitas yang lebih tinggi).
- Versi desktop memprioritaskan stabilitas dan kompatibilitas; CLI (versi baris perintah) mungkin diperbarui lebih cepat, tetapi fitur baru belum tentu segera tersinkron dengan versi desktop.
6) Variabel Lingkungan Kustom
Claude Desktop memungkinkan Anda mengatur variabel seperti file .env.
Variabel ini hanya berlaku di dalam sesi Claude, ideal untuk konfigurasi proyek.
Sebagai contoh:
API_KEY=abcd123
DEBUG=true
CERT="-----BEGIN CERT-----
MIIE...
-----END CERT-----"
7) Integrasi dengan alat dan lingkungan lokal
Saat menjalankan sesi lokal, aplikasi desktop mengekstrak $PATH shell Anda sehingga proses sesi dapat menggunakan node, npm, yarn, Python, atau alat CLI lain yang Anda gunakan. Aplikasi ini juga menyediakan UI untuk menambahkan variabel lingkungan kustom (dalam format .env), dengan nilai yang disamarkan demi keamanan. Ini membuat menjalankan pengujian atau build di dalam sesi berbasis agen menjadi lebih mulus karena agen dapat memanggil toolchain yang sama seperti di terminal Anda.
Bagaimana cara menginstal Claude Code di Desktop?
Bagian ini memandu proses instalasi dengan gesekan minimal. Instruksi berikut berlaku untuk pratinjau desktop dan mengarahkan Anda ke penginstal resmi.
Prasyarat dan penyiapan akun
- Akun dan workspace Anthropic: Claude Code terhubung ke Anthropic Console. Anda perlu menyelesaikan alur OAuth di Claude Console dan memiliki penagihan aktif atau akses pratinjau riset sesuai model workspace Anthropic. Claude Code menggunakan workspace internal di konsol untuk melacak penggunaan; Anda tidak dapat membuat kunci API untuk workspace tersebut — itu dikelola untuk penggunaan Claude Code.
- Git dan kesiapan repo: Pastikan Git terpasang dan proyek yang ingin Anda operasikan adalah repositori Git (atau inisialisasi Git). Aplikasi desktop mengharapkan repo yang valid untuk fitur seperti worktree; jika Anda membuka folder tanpa Git diinisialisasi, worktree tidak akan dibuat.
- Spesifik OS: Instalasi macOS dan Linux umumnya berupa biner native; pengguna Windows disarankan menggunakan WSL untuk kompatibilitas perintah penuh di banyak alur kerja. Beberapa panduan komunitas membahas penyiapan Windows/WSL tingkat lanjut jika Anda mengalami masalah PATH atau distribusi.
Langkah-langkah instalasi (singkat)
- Buka halaman unduhan Claude dan pilih penginstal yang sesuai untuk platform Anda.
- Jalankan penginstal (PKG di macOS, MSIX atau EXE di Windows). Untuk armada enterprise, gunakan paket MSIX/PKG yang disediakan untuk penyebaran terpusat.
- Luncurkan aplikasi Claude Desktop dan masuk dengan akun Anthropic/Claude Anda. Percakapan dan preferensi Anda akan tersinkron di desktop, web, dan seluler.
- Saat pertama kali diluncurkan, aplikasi akan mengunduh runtime Claude Code yang dibundel. Biarkan unduhan selesai; ini diperlukan dan memastikan versi yang stabil serta terkelola digunakan.
Pemeriksaan pasca-instalasi
• Buka Settings > Environments dan konfirmasi aplikasi desktop telah mengekstrak $PATH shell Anda.
• Pilih apakah Anda ingin mengaktifkan sesi lokal (jika mesin dan kebijakan Anda mengizinkan) atau apakah alur kerja Anda akan membuat sesi web.
Metode instalasi opsional yang dapat saya pilih
- Penginstal native (disarankan): Gunakan penginstal OS native untuk pengalaman paling sederhana dan terintegrasi.
- Homebrew (macOS): Nyaman bagi pengguna macOS yang mengelola aplikasi dengan Homebrew.
- NPM atau penginstal berbasis skrip: Berguna untuk penyiapan yang lebih otomatis atau terskrip (CI atau provisioning), atau untuk distribusi Linux yang lebih cocok dengan skrip penginstal sederhana.
Instalasi: macOS, Linux, WSL (alur yang disarankan)
- Unduh penginstal pratinjau desktop dari halaman unduhan Claude Code (dokumentasi dalam produk menyediakan tautan penginstal).
- Jalankan penginstal dan buka aplikasi desktop Claude.
- Selesaikan masuk OAuth melalui alur Claude Console di dalam aplikasi.
- Konfigurasikan lokasi worktree default serta preferensi eksekusi lokal/jarak jauh di pengaturan desktop.
- Buka folder proyek atau klon repo dari UI untuk memulai.
Buka terminal dan, jika Anda memercayai sumbernya, jalankan skrip instal yang disediakan oleh Anthropic (ini opsi kemudahan yang umumnya disarankan). Contoh (diparafrasekan):
# macOS / Linux / WSL (example convenience installer)
curl -fsSL https://claude.ai/install.sh | bash
Atau, jika Anda lebih suka Homebrew di macOS:
brew install --cask claude-code
Instalasi: Windows
WSL：
- Instal WSL (Ubuntu umum digunakan) dan siapkan lingkungan WSL yang bersih. Selesaikan masalah PATH dan interop agar integrasi WSL aplikasi desktop dapat mengakses distro.
- Instal Git dan runtime bahasa apa pun di WSL yang mungkin dibutuhkan Claude untuk eksekusi lokal (node, python, dll.).
- Instal atau jalankan aplikasi desktop di Windows, arahkan ke direktori proyek WSL Anda (atau luncurkan aplikasi desktop di dalam WSL jika didukung), dan ikuti alur OAuth yang sama.
Contoh PowerShell (diparafrasekan):
# PowerShell (example convenience installer)
irm https://claude.ai/install.ps1 | iex
Contoh CMD (diparafrasekan):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Bagaimana cara menggunakan Claude Code di Desktop dalam praktik harian?
Pola pembuatan sesi yang direkomendasikan?
Tugas pendek independen vs refactor jangka panjang
- Untuk tugas singkat dan terukur (perbaikan bug, perubahan satu file, refactor kecil), buat satu sesi per tugas dan biarkan Claude menghasilkan commit yang terfokus. Tinjau dan gabungkan segera.
- Untuk upaya jangka panjang (refactor besar, pengembangan fitur), pertimbangkan membuat sesi yang membuat checkpoint secara sering dan menggunakan kontrol progres UI desktop untuk mengarahkan atau menjeda pekerjaan. Pertahankan sesi pada cabang fitur untuk menghindari penggabungan yang tidak disengaja.
Pelihara CLAUDE.md atau templat prompt di repo Anda untuk menstandarkan cara sesi harus diprompt (konteks, pengujian yang dijalankan, aturan gaya). Praktik ini mengurangi variabilitas dan membantu Claude menghasilkan hasil yang konsisten di seluruh sesi. Banyak tim menyimpan prompt standar atau guardrail dalam metadata repo untuk memastikan perilaku agen yang dapat diprediksi.
Meluncurkan dan menamai sesi
- Buka aplikasi desktop dan pilih atau klon repositori.
- Klik “New Session” (atau yang setara) dan beri nama sesi yang deskriptif (misalnya,
bugfix/cs-142atauadd-tests-login). Penamaan membantu Anda membedakan sesi simultan di UI. - Pilih mode eksekusi lokal atau jarak jauh, pilih cabang target (atau biarkan agen membuat cabang di worktree baru), lalu mulai sesi. Aplikasi akan membuat worktree Git khusus untuk sesi tersebut secara otomatis.
Mengarahkan agen: prompt dan tugas
- Gunakan prompt yang jelas dan terfokus. Contoh: “Temukan unit test yang gagal untuk
AuthServicedan buat perbaikan yang mempertahankan API publik yang ada; jalankan pengujian dan laporkan hasilnya.” - Untuk tugas inkremental, minta Claude membuat rencana terlebih dahulu (daftar periksa singkat), lalu minta perubahan kode spesifik langkah demi langkah. Progres inkremental mengurangi risiko halusinasi dan membuat diff lebih mudah ditinjau. Anthropic merekomendasikan pendekatan ini sebagai praktik terbaik.
Memantau progres dan berinteraksi
UI desktop menampilkan log aksi dan diff saat agen bekerja. Anda dapat menjeda sesi, mengubah instruksi, atau membatalkan pekerjaan yang sedang berjalan. Saat agen mengusulkan edit, UI menampilkan diff file dan penjelasan tentang apa yang berubah. Setujui, edit, atau tolak diff yang diusulkan sebelum commit.
Alur commit, branch, dan PR
Setelah Anda menyetujui perubahan, aplikasi desktop dapat melakukan commit ke cabang worktree sesi. Dari sana Anda dapat push ke origin dan membuka pull request melalui UI (jika Anda telah mengotorisasi akses GitHub). Setiap cabang sesi tetap terisolasi hingga Anda melakukan merge, yang membuat tinjauan manusia tetap sederhana.
Bagaimana isolasi Git dan paralelisme multi-sesi sebenarnya bekerja?
Worktree Git: mekanisme isolasi
Desktop Anthropic menggunakan worktree Git untuk membuat salinan working tree per sesi yang terikat ke cabang terpisah. Worktree lebih ringan daripada klon penuh — mereka berbagi metadata .git yang sesuai namun menyediakan direktori kerja independen sehingga edit konkuren tidak saling bertentangan atau bocor antar sesi. Aplikasi desktop menempatkan worktree yang dibuat otomatis ini di direktori yang dapat dikonfigurasi (default ~/.claude-worktrees). Desain ini memungkinkan konkurensi yang aman untuk operasi berbasis agen.
Mengapa worktree vs clone
Worktree lebih cepat dibuat dan lebih mudah dikorelasikan dengan riwayat Git yang sama, sekaligus tetap menyediakan pemisahan sistem berkas yang diperlukan untuk menghindari kontaminasi lintas sesi. Untuk sebagian besar alur kerja, ini lebih disukai daripada banyak klon penuh; namun, jika Anda memerlukan lingkungan runtime yang sepenuhnya terisolasi dengan dependensi berbeda, klon terpisah atau container mungkin tetap diinginkan.
Koordinasi dan penanganan konflik
Karena setiap sesi bekerja di cabang/worktree terisolasi, konflik diminimalkan. Jika dua sesi secara independen mengubah kode yang sama secara logis dan keduanya digabungkan ke cabang target yang sama nanti, penanganan konflik merge Git normal akan berlaku — yang merupakan titik yang tepat untuk tinjauan dan resolusi oleh manusia. Model Anthropic secara sengaja menampilkan commit sebagai PR yang dapat ditinjau, menjaga manusia tetap dalam loop penggabungan.
Langkah pemecahan masalah umum dan keterbatasan
Jika sesi gagal dimulai atau macet
- Pastikan token akses repositori valid dan tidak terkena batasan laju.
- Periksa ruang disk lokal dan izin untuk direktori worktree (misalnya,
~/.claude-worktrees). - Tinjau log aplikasi desktop untuk pesan kesalahan; aplikasi biasanya menyediakan tampilan diagnostik atau berkas log.
Jika sesi saling mencemari
- Pastikan aplikasi desktop membuat worktree terpisah (periksa direktori
~/.claude-worktreesatau lokasi worktree yang ditetapkan di preferensi aplikasi). - Jika Anda melihat status bersama, pastikan Anda menggunakan pratinjau desktop terbaru atau lihat dokumentasi Anthropic—rilis ini secara khusus membahas isolasi sesi.
Jika file yang diabaikan tidak tersedia untuk sesi
Tambahkan nama file ke konfigurasi .worktreeinclude (atau padanan di UI desktop) agar aplikasi menyalin file terabaikan yang diperlukan (misalnya, .env) ke setiap worktree secara aman. Hindari menyimpan rahasia di worktree, atau mengeksposnya, tanpa manajemen rahasia yang tepat.
Kesimpulan
Pratinjau desktop Claude Code merepresentasikan evolusi bermakna tentang bagaimana alat pengodean berbasis agen masuk ke alur kerja pengembang: tetap mempertahankan kecepatan dan ekspresivitas agen AI sekaligus menyelesaikan beberapa masalah koordinasi praktis yang dihadapi pengembang ketika banyak agen perlu beroperasi pada basis kode yang sama. Baik Anda mengadopsinya untuk produktivitas pengembang tunggal atau untuk mengoordinasikan beberapa tugas agen di seluruh tim, memahami worktree Git, .worktreeinclude, dan perbedaan antara sesi lokal vs. web akan membuat minggu pertama Anda dengan pratinjau desktop jauh lebih produktif.
Siap menggunakan Claude Code CLI? lihat panduan API untuk instruksi terperinci.
Pengembang dapat mengakses Claude Opus 4.5 API dan lainnya melalui CometAPI, versi model terbaru selalu diperbarui mengikuti situs resmi. Untuk memulai, jelajahi kemampuan model di Playground dan lihat panduan API untuk instruksi terperinci. Sebelum mengakses, pastikan Anda telah masuk ke CometAPI dan memperoleh kunci API. CometAPI menawarkan harga yang jauh lebih rendah daripada harga resmi untuk membantu Anda melakukan integrasi.
Siap mulai?→ Uji coba gratis Claude Opus 4.5 !
Jika Anda ingin mengetahui lebih banyak tips, panduan, dan berita seputar AI, ikuti kami di VK, X dan Discord!