Claude Code: Cara Mengkonfigurasi Semula Plugin yang Dipasang Tanpa Memasangnya Semula (2.1.285)

Panduan ini ditujukan kepada pengguna yang sudah memasang plugin Claude Code yang mengisytiharkan tetapan userConfig, seperti alamat, token atau laluan folder. Anda perlu membetulkan nilai yang dimasukkan secara salah atau menggantikan token tanpa memasang semula plugin. Semua yang berikut berdasarkan dokumentasi dan log perubahan rasmi Claude Code. Artikel ini tidak merangkumi ujian asal.

Maklumat tentang penggunaan Ailoot tersedia dalam dokumentasi.

Perkara baharu dalam versi 2.1.285#

Entri log perubahan Claude Code bagi versi 2.1.285 (commit bertarikh 29 September 2026) mengandungi beberapa baris tentang plugin. Dua daripadanya berkaitan dengan artikel ini:

Menambahkan claude plugin configure <plugin> untuk memaparkan pilihan plugin dan pilihan yang belum ditetapkan, atau menyimpan nilai baharu yang dibaca daripada stdin dengan --values-stdin

Ini bermakna arahan baharu claude plugin configure <plugin> memaparkan tetapan plugin dan tetapan yang belum ditetapkan, atau menyimpan nilai baharu yang dibaca daripada input standard apabila digunakan dengan --values-stdin.

Menambahkan <server>.<key>=<value> pada claude plugin install --config, supaya tetapan tersendiri pelayan MCP yang disertakan dalam .mcpb boleh ditetapkan semasa pemasangan dan pelayan itu bermula tanpa perlu melawati /plugin → Configure

Ini bermakna claude plugin install --config kini menyokong format <server>.<key>=<value>, yang membolehkan tetapan pelayan MCP yang disertakan bersama plugin dalam fail .mcpb diberikan semasa pemasangan, supaya pelayan bermula tanpa perlu melawati /plugin → Configure.

Rujukan arahan mengesahkan keperluan versi: claude plugin configure memerlukan Claude Code v2.1.285 atau lebih baharu. Arahan ini tiada dalam versi terdahulu.

Perbezaannya dengan /plugin configure#

Arahan /plugin configure <plugin> (dengan alias config) sudah tersedia dalam sesi Claude Code interaktif. Arahan ini membuka dialog untuk tetapan userConfig dan memerlukan v2.1.147 atau lebih baharu. Namun, /plugin hanya berfungsi dalam sesi interaktif: dalam seruan bukan interaktif seperti claude -p, Claude Code memberikan respons bahawa /plugin tidak tersedia dalam persekitaran itu.

Menurut dokumentasi, arahan claude plugin dijalankan daripada shell atau skrip, di luar sesi Claude Code. Ini juga membolehkan anda menjalankan claude plugin configure tanpa membuka dialog. Dokumentasi tidak menerangkan cara arahan ini berfungsi tanpa terminal interaktif atau tempat nilai rahsia disimpan pada pelayan tanpa persekitaran grafik. Semak perkara ini dalam persekitaran anda sendiri sebelum menggunakannya dalam CI.

Langkah 1. Lihat tetapan yang telah ditetapkan#

Dokumentasi memerlukan pengecam plugin penuh dalam format name@marketplace, seperti yang ditunjukkan oleh claude plugin list. Arahan configure tidak menerima nama tanpa @marketplace.

claude plugin list
claude plugin configure formatter@my-marketplace

Gantikan formatter@my-marketplace dengan pengecam plugin anda. Tanpa bendera, arahan ini menyenaraikan setiap tetapan dengan label: required atau optional, kemudian sensitive bagi medan rahsia, diikuti set atau not set. Nilai yang disimpan tidak dipaparkan.

Jika anda memerlukan output yang boleh dibaca mesin, tambahkan --json. Output itu akan menyertakan nilai tersimpan bagi medan biasa, tetapi kandungan medan rahsia tidak akan dipaparkan.

Langkah 2. Tukar nilai menggunakan fail#

Nilai diberikan sebagai objek JSON, dengan setiap kunci ialah nama tetapan daripada manifest dan setiap nilai ialah rentetan tanpa pemisah baris. Dokumentasi menunjukkan kaedah berasaskan fail: tulis objek itu ke values.json dan hantarkan fail tersebut kepada input standard arahan. Di sini, api_url ialah kunci yang digunakan dalam contoh dokumentasi. Untuk plugin anda sendiri, gunakan nama tetapan yang diperlukan daripada manifestnya atau daripada output dalam langkah 1.

{"api_url": "NEW_ADDRESS"}

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

Peraturan berikut terpakai semasa menyimpan:

• Tetapan yang tidak disertakan dalam JSON mengekalkan nilai sebelumnya. Anda boleh memberikan hanya medan yang ingin diubah.
• Penerangan bendera merujuk kepada penetapan nilai secara umum dan tidak menyatakan peraturan berasingan untuk medan rahsia. Selepas menyimpan, gunakan langkah 1 untuk menyemak bahawa medan berkenaan ditandakan set.
• Claude Code menyemak setiap nilai berdasarkan jenis yang diisytiharkan dan memaparkan Configuration saved. Restart Claude Code to apply it. Ini bermakna tetapan telah disimpan dan akan berkuat kuasa selepas Claude Code dimulakan semula.
• Jika JSON mengandungi kunci yang tidak diisytiharkan dalam manifest, atau nilai gagal pengesahan, arahan tidak menyimpan apa-apa, memaparkan Failed to save configuration: diikuti sebabnya, dan keluar dengan kod 1.

Jika anda menulis token ke values.json, ingat bahawa fail itu ialah fail biasa pada cakera. Padamkannya selepas konfigurasi disimpan dan jangan masukkan fail itu ke dalam repositori.

Tempat nilai disimpan#

Menurut dokumentasi manifest plugin, nilai biasa disimpan di bawah pluginConfigs dalam settings.json pengguna. Nilai bagi medan yang ditandakan sensitive: true disimpan dalam stor kelayakan selamat sistem dan bukannya dalam settings.json; input untuk medan ini disamarkan.

Tidak ada gunanya mencari nilai medan rahsia dalam settings.json. claude plugin configure menunjukkan statusnya dengan label sensitive dan set atau not set.

install --config: tetapkan nilai semasa pemasangan#

Untuk pemasangan baharu, claude plugin install menyediakan bendera --config <key=value>. Bendera ini menetapkan tetapan userConfig yang diisytiharkan dalam manifest dan memerlukan v2.1.147 atau lebih baharu. Ulangi bendera itu untuk setiap tetapan. Mulai versi 2.1.285, kunci dalam format <server>.<key> menetapkan tetapan pelayan MCP yang disertakan, seperti yang diisytiharkan dalam user_config pelayan itu sendiri.

Dalam contoh di bawah, gantikan formatter@my-marketplace dengan pengecam plugin anda, api_url dengan nama tetapan daripada manifestnya, dan keseluruhan ruang letak NEW_ADDRESS dengan nilai anda sendiri. Kekalkan tanda petik di sekeliling argumen.

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

Arahan yang perlu digunakan bergantung pada sama ada plugin itu sudah dipasang: install --config menetapkan nilai semasa pemasangan pertama, manakala plugin configure --values-stdin menukar nilai bagi plugin yang sudah dipasang.

Untuk tetapan milik pelayan MCP yang disertakan, dokumentasi menyenaraikan kaedah lain: plugin install --config atau Configure dalam /plugin. Dokumentasi tidak mencadangkan arahan plugin configure untuk tetapan tersebut.

Jika arahan tidak dapat menemukan plugin#

Jika claude plugin configure tidak dapat menemukan plugin yang dimuatkan dengan pengecam itu, arahan tersebut memaparkan No installed plugin has the id "<plugin>". dan keluar dengan kod 1. Mula-mula, pastikan anda memberikan pengecam penuh name@marketplace daripada claude plugin list. Nama plugin sahaja tidak mencukupi.

Arahan dalam sesi mempunyai mesejnya sendiri. Jika anda menamakan plugin yang tidak dipasang dalam projek semasa apabila menggunakan /plugin enable, disable, uninstall atau configure, Claude Code memaparkan Plugin "<plugin>" is not installed in this project dan tidak melakukan apa-apa.

Kesimpulan#

Untuk menukar token atau alamat bagi plugin yang sudah dipasang dalam Claude Code 2.1.285 atau lebih baharu, cari pengecamnya dengan claude plugin list, semak status tetapan menggunakan claude plugin configure, berikan nilai baharu daripada fail dengan --values-stdin, kemudian mulakan semula Claude Code. Nilai medan rahsia tidak disimpan dalam settings.json, jadi semak statusnya menggunakan arahan yang sama.

Panduan Skills, Subagents, MCP dan Plugins dalam Claude Code boleh membantu anda memilih antara jenis sambungan. Jika anda belum memilih plugin, anda boleh bermula dengan 10 plugin Claude Code teratas. Terdapat panduan berasingan untuk bot Telegram: memasang plugin dalam ejen Telegram berbeza daripada memasangnya dalam Claude Code.

Kenali Ailoot.