Claude Code 安装 LSP：让 AI 终于"看懂"代码

Sebagai seorang pengembang yang telah menggunakan Claude Code untuk jangka waktu yang lama, saya selalu merasakan satu hal: ia terlalu pintar, tetapi juga terlalu buta. Pintar karena ia dapat menghasilkan kode yang terstruktur dengan baik; buta karena ia tidak tahu bagaimana bentuk nyata kode Anda.

Dan LSP —— Language Server Protocol, adalah langkah kunci untuk membuatnya "memiliki penglihatan".

LSP adalah apa? Satu kalimat untuk menjelaskan

LSP, kepanjangan dari Language Server Protocol. Untuk menjelaskan dengan lebih sederhana:

Ia adalah "antarmuka seragam" yang memungkinkan editor dan AI memiliki kemampuan pemahaman kode.

Fungsi yang Anda anggap biasa di VS Code:

• Ctrl klik nama fungsi untuk melompat ke definisi
• Hover pada variabel untuk melihat tipe
• Mencari referensi

Semua ini ditangani oleh LSP.

Tanpa LSP, Claude Code hanya dapat melakukan pencarian dengan "Grep pencocokan string global"; dengan LSP, Claude Code dapat langsung meminta jawaban dari server bahasa — akurat, cepat, dan dengan konsumsi Token yang rendah.

Mengapa Anda harus peduli tentang LSP?

Tahun lalu, pengalaman paling menyakitkan saat menulis kode dengan Claude Code adalah:

Konsumsi Token terlalu berlebihan.

Jika Anda memintanya untuk membantu mengubah sebuah fungsi, ia akan:

• Grep seluruh proyek
• Kemudian Grep referensi
• Kemudian Grep definisi
• Kemudian Grep rantai panggilan

Setiap kali adalah "pembersihan besar-besaran", sehingga biayanya tentu tinggi.

Data pengujian dari tim Milvus sangat menunjukkan masalah ini:

Setelah mengaktifkan LSP, konsumsi Token dapat berkurang lebih dari 40%.

Bagi tim dengan proyek besar dan sering melakukan refactoring, ini adalah penghematan biaya yang langsung.

Apa yang dapat dilakukan LSP? 7 kemampuan inti yang bergantung pada Claude Code

Mulai dari 2.0.74, Claude Code secara resmi mengaktifkan LSP, yang akan secara otomatis memanggil kemampuan berikut di latar belakang:

• goToDefinition: melompat ke definisi
• findReferences: mencari referensi
• hover: hover untuk melihat tipe dan dokumentasi
• documentSymbol: mencantumkan fungsi/kelas/variabel dalam dokumen saat ini
• workspaceSymbol: pencarian simbol di seluruh proyek
• goToImplementation: melompat ke implementasi antarmuka
• incomingCalls / outgoingCalls: analisis rantai panggilan

Pentingnya kemampuan ini tidak perlu dijelaskan lagi, siapa pun yang melakukan refactoring tahu betapa bergunanya mereka.

Yang lebih penting adalah:

Anda tidak perlu memicu secara manual. Claude Code akan secara otomatis lebih memilih menggunakan LSP, bukan Grep.

Tiga cara menggunakan LSP (urutkan berdasarkan rekomendasi)

Metode 1: Integrasi VS Code (yang paling sederhana dan stabil)

Jika Anda sudah menggunakan VS Code, hampir tanpa biaya:

• Mulai Claude Code di terminal VS Code
• Ketik /config
• Atur: - Diff tool = auto
• Auto-install IDE extension = true

Claude Code akan secara otomatis mendeteksi VS Code dan secara otomatis menginstal ekstensi untuk berkomunikasi dengan LSP.

Cocok untuk: sebagian besar pengembang.

Metode 2: cclsp (solusi MCP komunitas)

Jika Anda tidak menggunakan VS Code, atau jika LSP resmi mengalami berbagai kesalahan, Anda dapat menggunakan ini:

npx cclsp@latest setupKeunggulan terbesar cclsp adalah:

• Memperbaiki nomor baris dan kolom secara otomatis
• Cocok untuk banyak bahasa
• Pemeliharaan komunitas yang aktif

Cocok untuk orang yang menggunakan Claude Code di lingkungan terminal murni, Neovim, JetBrains, dll.

Metode 3: Konfigurasi manual .lsp.json (khusus untuk penggemar tinkering)

Buat .lsp.json baru di direktori akar proyek:

{ "typescript": { "command": "typescript-language-server", "args": ["--stdio"], "extensionToLanguage": { ".ts": "typescript", ".tsx": "typescriptreact" } }, "python": { "command": "pylsp" } }Server bahasa perlu diinstal secara terpisah, misalnya:

npm install -g typescript-language-server pip install python-lsp-serverCocok untuk: insinyur yang sangat menyesuaikan lingkungan dan memiliki sifat perfeksionis.

Bagaimana cara menentukan apakah LSP benar-benar berfungsi?

Saat ini, Anthropic tidak menyediakan indikasi status UI yang jelas, tetapi Anda dapat menilai seperti ini:

• Biarkan Claude Code melompat ke definisi: "Di mana fungsi X didefinisikan?" Mengembalikan file + nomor baris yang tepat = normal; mengembalikan banyak hasil Grep = tidak berhasil
• Gunakan perintah pengujian cclsp
• Amati konsumsi Token: dari puluhan ribu Token turun menjadi seribu atau dua ribu, adalah perbedaan yang paling jelas.

Siapa yang benar-benar perlu mengonfigurasi LSP?

Rekomendasi untuk mengonfigurasi dalam situasi:

• Proyek lebih dari 10.000 baris
• Sering melakukan refactoring
• Sensitif terhadap biaya Token
• Ingin Claude Code memiliki kemampuan pemahaman kode tingkat IDE

Tidak disarankan untuk tinkering dalam situasi:

• Proyek kecil, pencarian sangat cepat
• Utamanya menulis kode baru, tidak membaca kode lama
• Menunggu versi resmi yang lebih stabil

Masalah utama yang dihadapi saat ini (situasi Desember 2025)

• No LSP server available: biasanya berarti server bahasa tidak terinstal dengan baik.
• Tidak ada visualisasi status: tidak dapat melihat di UI apakah LSP sudah terhubung.
• Operasi seperti rantai panggilan kadang-kadang gagal: referensi lintas file tidak lengkap.

Kinerja keseluruhan: dapat digunakan, tetapi masih dalam iterasi cepat.

Penutup: LSP adalah "paket peningkatan penglihatan" untuk Claude Code

Dulu AI menulis kode lebih mirip dengan "pemahaman yang menjelajah", pada dasarnya hanya dapat bergantung pada pencarian dan pencocokan pola. Dengan adanya LSP, untuk pertama kalinya ia benar-benar memiliki:

Memahami struktur proyek → Penentuan lokasi yang akurat → Penanganan kode dengan biaya rendah

Jika bahasa yang Anda gunakan adalah TypeScript atau Python, sangat disarankan untuk mencoba versi integrasi VS Code terlebih dahulu. Ini adalah langkah penting untuk membuat Claude Code benar-benar menjadi "asisten pengembangan yang berguna".

Jika Anda mengalami masalah, forum diskusi di GitHub dan solusi komunitas sangat aktif, dapat menyelesaikan dengan cepat.