Claude Code: Cara Mengonfigurasi Ulang Plugin yang Sudah Terpasang Tanpa Menginstal Ulang (2.1.285)

Panduan ini ditujukan bagi pengguna yang sudah memasang plugin Claude Code yang mendeklarasikan pengaturan userConfig, seperti alamat, token, atau jalur folder. Anda perlu memperbaiki nilai yang salah dimasukkan atau mengganti token tanpa menginstal ulang plugin. Semua informasi di bawah ini berdasarkan dokumentasi dan changelog resmi Claude Code. Artikel ini tidak mencakup pengujian langsung.

Informasi tentang penggunaan Ailoot tersedia di dokumentasi.

Yang ditambahkan pada versi 2.1.285#

Entri changelog Claude Code untuk versi 2.1.285 (commit tertanggal 29 September 2026) memuat beberapa baris tentang plugin. Dua di antaranya relevan untuk artikel ini:

Added claude plugin configure <plugin> to show a plugin's options and which are unset, or save new values read from stdin with --values-stdin

Artinya, perintah baru claude plugin configure <plugin> menampilkan pengaturan plugin dan mana yang belum diisi, atau menyimpan nilai baru yang dibaca dari input standar jika digunakan dengan --values-stdin.

Added <server>.<key>=<value> to claude plugin install --config, so a bundled .mcpb MCP server's own settings can be set at install time and it starts without visiting /plugin → Configure

Artinya, claude plugin install --config kini mendukung bentuk <server>.<key>=<value>, sehingga pengaturan server MCP yang dibundel dengan plugin dalam file .mcpb dapat diberikan saat instalasi. Dengan demikian, server dapat berjalan tanpa membuka /plugin → Configure.

Referensi perintah mengonfirmasi persyaratan versinya: claude plugin configure memerlukan Claude Code v2.1.285 atau yang lebih baru. Perintah ini tidak tersedia di versi sebelumnya.

Perbedaannya dengan /plugin configure#

Perintah /plugin configure <plugin> (dengan alias config) sudah tersedia di dalam sesi Claude Code interaktif. Perintah ini membuka dialog untuk pengaturan userConfig dan memerlukan v2.1.147 atau yang lebih baru. Namun, /plugin hanya berfungsi dalam sesi interaktif: dalam pemanggilan noninteraktif seperti claude -p, Claude Code merespons bahwa /plugin tidak tersedia di lingkungan tersebut.

Menurut dokumentasi, perintah claude plugin dijalankan dari shell atau skrip, di luar sesi Claude Code. Ini juga memungkinkan Anda menjalankan claude plugin configure tanpa membuka dialog. Dokumentasi tidak menjelaskan perilaku perintah ini tanpa terminal interaktif atau lokasi penyimpanan nilai rahasia pada server tanpa lingkungan grafis. Periksa hal ini di lingkungan Anda sendiri sebelum menggunakannya di CI.

Langkah 1. Lihat pengaturan mana yang sudah diisi#

Dokumentasi mensyaratkan ID plugin lengkap dalam bentuk name@marketplace, seperti yang ditampilkan oleh claude plugin list. Perintah configure tidak menerima nama tanpa @marketplace.

claude plugin list
claude plugin configure formatter@my-marketplace

Ganti formatter@my-marketplace dengan ID plugin Anda. Tanpa flag, perintah ini mencantumkan setiap pengaturan dengan label: required atau optional, lalu sensitive untuk kolom rahasia, diikuti set atau not set. Nilai yang tersimpan tidak dicetak.

Jika Anda memerlukan keluaran yang dapat dibaca mesin, tambahkan --json. Keluaran tersebut akan menyertakan nilai tersimpan untuk kolom biasa, tetapi isi kolom rahasia tidak pernah dicetak.

Langkah 2. Ubah nilai menggunakan file#

Nilai diberikan sebagai objek JSON, dengan setiap kunci berupa nama pengaturan dari manifest dan setiap nilai berupa string tanpa jeda baris. Dokumentasi menunjukkan metode berbasis file: tulis objek ke values.json, lalu berikan file tersebut ke input standar perintah. Di sini, api_url adalah kunci yang digunakan dalam contoh dokumentasi. Untuk plugin Anda sendiri, gunakan nama pengaturan yang diperlukan dari manifest atau dari keluaran pada langkah 1.

{"api_url": "NEW_ADDRESS"}

claude plugin configure formatter@my-marketplace --values-stdin < values.json

Saat menyimpan, berlaku aturan berikut:

• Pengaturan yang tidak disertakan dalam JSON mempertahankan nilai sebelumnya. Anda hanya dapat memberikan kolom yang ingin diubah.
• Deskripsi flag tersebut merujuk pada pengaturan nilai secara umum dan tidak menyatakan aturan terpisah untuk kolom rahasia. Setelah menyimpan, gunakan langkah 1 untuk memeriksa bahwa kolom terkait ditandai set.
• Claude Code memeriksa setiap nilai berdasarkan tipe yang dideklarasikan dan mencetak Configuration saved. Restart Claude Code to apply it. Artinya, pengaturan telah disimpan dan akan berlaku setelah Claude Code dimulai ulang.
• Jika JSON berisi kunci yang tidak dideklarasikan dalam manifest, atau nilai gagal divalidasi, perintah tidak menyimpan apa pun, mencetak Failed to save configuration: diikuti alasannya, lalu keluar dengan kode 1.

Jika Anda menulis token ke values.json, ingat bahwa file itu tersimpan sebagai berkas biasa di disk. Hapus setelah menyimpan konfigurasi, dan jangan tambahkan file semacam itu ke repositori.

Lokasi penyimpanan nilai#

Menurut dokumentasi manifest plugin, nilai biasa disimpan di bawah pluginConfigs dalam settings.json milik pengguna. Nilai untuk kolom bertanda sensitive: true disimpan di penyimpanan kredensial aman sistem, bukan di settings.json; input untuk kolom tersebut disamarkan.

Tidak ada gunanya mencari nilai kolom rahasia di settings.json. claude plugin configure menampilkan statusnya dengan label sensitive dan set atau not set.

install --config: tetapkan nilai saat instalasi#

Untuk instalasi baru, claude plugin install menyediakan flag --config <key=value>. Flag ini menetapkan pengaturan userConfig yang dideklarasikan dalam manifest dan memerlukan v2.1.147 atau yang lebih baru. Ulangi flag untuk setiap pengaturan. Mulai versi 2.1.285, kunci dalam bentuk <server>.<key> menetapkan pengaturan server MCP yang dibundel, sebagaimana dideklarasikan dalam user_config milik server tersebut.

Pada contoh di bawah, ganti formatter@my-marketplace dengan ID plugin Anda, api_url dengan nama pengaturan dari manifest, dan seluruh placeholder NEW_ADDRESS dengan nilai Anda sendiri. Pertahankan tanda kutip di sekitar argumen.

claude plugin install formatter@my-marketplace --config 'api_url=NEW_ADDRESS'

Perintah yang digunakan bergantung pada apakah plugin sudah terpasang: install --config menetapkan nilai saat instalasi pertama, sedangkan plugin configure --values-stdin mengubah nilai untuk plugin yang sudah terpasang.

Untuk pengaturan milik server MCP yang dibundel, dokumentasi mencantumkan metode lain: plugin install --config atau Configure di /plugin. Dokumentasi tidak menyarankan perintah plugin configure untuk pengaturan tersebut.

Jika perintah tidak dapat menemukan plugin#

Jika claude plugin configure tidak dapat menemukan plugin yang dimuat dengan ID tersebut, perintah ini mencetak No installed plugin has the id "<plugin>". lalu keluar dengan kode 1. Pertama, periksa apakah Anda memberikan ID lengkap name@marketplace dari claude plugin list. Nama plugin saja tidak cukup.

Perintah dalam sesi memiliki pesannya sendiri. Jika Anda menyebut plugin yang tidak terpasang di proyek saat ini ketika menggunakan /plugin enable, disable, uninstall atau configure, Claude Code mencetak Plugin "<plugin>" is not installed in this project dan tidak melakukan apa pun.

Kesimpulan#

Untuk mengubah token atau alamat plugin yang sudah terpasang di Claude Code 2.1.285 atau yang lebih baru, cari ID-nya dengan claude plugin list, periksa status pengaturannya dengan claude plugin configure, berikan nilai baru dari file menggunakan --values-stdin, lalu mulai ulang Claude Code. Nilai kolom rahasia tidak disimpan dalam settings.json, jadi periksa statusnya dengan perintah yang sama.

Panduan tentang Skills, Subagents, MCP dan Plugins di Claude Code dapat membantu Anda memilih jenis ekstensi. Jika belum memilih plugin, Anda bisa memulai dengan 10 plugin Claude Code teratas. Ada panduan terpisah untuk bot Telegram: memasang plugin di agen Telegram berbeda dari memasang plugin di Claude Code.

Kenali Ailoot.