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

> Claude Code 2.1.285 memperkenalkan arahan claude plugin configure. Cara menyemak tetapan plugin dalam dokumentasi dan menukar token atau alamat tanpa memasang semula.

Source: https://ailoot.ai/blog/ms/claude-code-plugin-configure-2-1-285/
Canonical: https://ailoot.ai/blog/ms/claude-code-plugin-configure-2-1-285/
Language: ms
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-050
Revision: sha256-08ae8d1f47f7c741874e92a10f23624930f49ed5ecf09bdf89b78b7f0ee2cad2


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Inti pati untuk bahagian ini">

Inti pati

Claude Code 2.1.285 memperkenalkan arahan terminal `claude plugin configure <plugin>`. Tanpa sebarang bendera, arahan ini menunjukkan tetapan plugin yang telah ditetapkan dan yang belum ditetapkan, tanpa memaparkan nilainya. Dengan `--values-stdin`, arahan ini menyimpan nilai baharu daripada fail JSON yang diberikan sebagai input, tanpa memasang semula plugin. Nilai biasa disimpan dalam `settings.json` di bawah `pluginConfigs`, manakala nilai bagi medan yang ditandakan `sensitive: true` disimpan dalam stor kelayakan selamat sistem.

</div>

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](https://ailoot.ai/docs/).



## 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`.

```bash
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.

```json
{"api_url": "NEW_ADDRESS"}
```

```bash
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.

```bash
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](https://ailoot.ai/blog/ms/skills-subagen-mcp-pemalam-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](https://ailoot.ai/blog/ms/telegram-ai-agent-plugins/) berbeza daripada memasangnya dalam Claude Code.

<div class="section" role="doc-bibliography" aria-label="Sumber">

### Sumber

- [Claude Code CHANGELOG, entri 2.1.285](https://github.com/anthropics/claude-code/commit/ec44ca97dc86c33d934c8d55b24959aabf076871.patch)
- [Claude Code: rujukan arahan plugin](https://code.claude.com/docs/en/plugins/cli-reference.md)
- [Claude Code: rujukan manifest plugin, konfigurasi pengguna](https://code.claude.com/docs/en/plugins-reference.md)

</div>





Kenali [Ailoot](https://ailoot.ai/).

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

### Mengapakah configure mengatakan plugin dipasang tidak ditemui?

Gunakan pengecam name@marketplace lengkap daripada `claude plugin list` dan pastikan plugin dipasang dalam skop yang berkenaan. Nama pendek plugin sahaja tidak diterima oleh arahan ini.

### Bagaimanakah saya memeriksa token yang diubah tanpa mencetaknya?

Jalankan `claude plugin configure` dengan pengecam penuh plugin dan pastikan medan sensitif ditandai set. Mulakan semula Claude Code selepas menyimpan; jangan komit fail input JSON yang mengandungi token.


## Ailoot · Syarikat dan portfolio projeknya

Ailoot berteraskan pengalaman operasi yang mantap, pangkalan pelanggan yang besar, perkhidmatan yang stabil dan pemantauan KPI berterusan.

Syarikat dan portfolio projeknya: jutaan pelanggan; jualan bernilai berbilion setiap bulan.

Ailoot menggunakan pengalaman operasi ini untuk akses API kepada ciri AI dalam produk pelanggan, ejen, aplikasi dan automasi.