# Claude Code: Cách cấu hình lại plugin đã cài đặt mà không cần cài đặt lại (2.1.285)

> Claude Code 2.1.285 đã bổ sung lệnh claude plugin configure. Cách kiểm tra cài đặt plugin trong tài liệu và thay đổi token hoặc địa chỉ mà không cần cài đặt lại.

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


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Điểm chính của phần này">

Điểm chính

Claude Code 2.1.285 đã bổ sung lệnh terminal `claude plugin configure <plugin>`. Khi không có cờ, lệnh này cho biết những cài đặt nào của plugin đã được thiết lập và những cài đặt nào chưa được thiết lập, mà không hiển thị giá trị. Với `--values-stdin`, lệnh lưu các giá trị mới từ một tệp JSON được cung cấp làm đầu vào, mà không cần cài đặt lại plugin. Các giá trị thông thường được lưu trong `settings.json` dưới `pluginConfigs`, còn giá trị của các trường được đánh dấu `sensitive: true` được lưu trong kho thông tin xác thực bảo mật của hệ thống.

</div>

Hướng dẫn này dành cho người dùng đã cài đặt plugin Claude Code khai báo các cài đặt `userConfig`, chẳng hạn như địa chỉ, token hoặc đường dẫn thư mục. Bạn cần sửa giá trị đã nhập sai hoặc thay token mà không phải cài đặt lại plugin. Toàn bộ nội dung dưới đây dựa trên tài liệu chính thức và nhật ký thay đổi của Claude Code. Bài viết không bao gồm lần chạy kiểm thử do tác giả tự thực hiện.

Thông tin về cách sử dụng Ailoot có trong [tài liệu](https://ailoot.ai/docs/).



## Những gì được bổ sung trong phiên bản 2.1.285

Mục trong nhật ký thay đổi của Claude Code cho phiên bản 2.1.285 (một commit có ngày 29 tháng 9 năm 2026) có một số dòng về plugin. Hai dòng liên quan đến bài viết này là:

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

Điều này có nghĩa là lệnh mới `claude plugin configure <plugin>` hiển thị các cài đặt của plugin và những cài đặt chưa được thiết lập, hoặc lưu các giá trị mới đọc từ đầu vào tiêu chuẩn khi dùng với `--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

Điều này có nghĩa là `claude plugin install --config` hiện hỗ trợ định dạng `<server>.<key>=<value>`, cho phép cung cấp trong khi cài đặt các cài đặt riêng của máy chủ MCP được đóng gói trong plugin `.mcpb`, để máy chủ khởi chạy mà không cần truy cập `/plugin` → Configure.

Tài liệu tham khảo lệnh xác nhận yêu cầu về phiên bản: `claude plugin configure` cần Claude Code v2.1.285 trở lên. Lệnh này không có trong các phiên bản trước đó.

## Khác biệt so với /plugin configure

Lệnh `/plugin configure <plugin>` (có bí danh `config`) vốn đã có trong một phiên Claude Code tương tác. Lệnh này mở hộp thoại cho các cài đặt `userConfig` và yêu cầu v2.1.147 trở lên. Tuy nhiên, `/plugin` chỉ hoạt động trong một phiên tương tác: khi gọi không tương tác, chẳng hạn như `claude -p`, Claude Code trả lời rằng `/plugin` không khả dụng trong môi trường đó.

Theo tài liệu, các lệnh `claude plugin` được chạy từ shell hoặc tập lệnh, bên ngoài phiên Claude Code. Vì vậy, bạn cũng có thể chạy `claude plugin configure` mà không cần mở hộp thoại. Tài liệu không mô tả cách lệnh này hoạt động khi không có terminal tương tác, cũng không cho biết lệnh lưu các giá trị bí mật ở đâu trên máy chủ không có môi trường đồ họa. Hãy kiểm tra trong môi trường của bạn trước khi sử dụng lệnh trong CI.





## Bước 1. Xem cài đặt nào đã được thiết lập

Tài liệu yêu cầu dùng mã định danh đầy đủ của plugin theo định dạng `name@marketplace`, như hiển thị bởi `claude plugin list`. Lệnh `configure` không chấp nhận tên thiếu `@marketplace`.

```bash
claude plugin list
claude plugin configure formatter@my-marketplace
```

Thay `formatter@my-marketplace` bằng mã định danh plugin của bạn. Khi không có cờ, lệnh liệt kê từng cài đặt với nhãn `required` hoặc `optional`, tiếp theo là `sensitive` đối với trường bí mật, rồi đến `set` hoặc `not set`. Lệnh không hiển thị các giá trị đã lưu.

Nếu cần đầu ra có thể đọc bằng máy, hãy thêm `--json`. Khi đó, đầu ra sẽ bao gồm các giá trị đã lưu của trường thông thường, nhưng nội dung của trường bí mật sẽ không bao giờ được hiển thị.

## Bước 2. Thay đổi giá trị bằng tệp

Các giá trị được cung cấp dưới dạng một đối tượng JSON, trong đó mỗi khóa là tên cài đặt từ manifest và mỗi giá trị là một chuỗi không có ký tự xuống dòng. Tài liệu hướng dẫn cách dùng tệp: ghi đối tượng vào `values.json` rồi chuyển tệp đó vào đầu vào tiêu chuẩn của lệnh. Trong ví dụ của tài liệu, `api_url` là khóa được dùng. Với plugin của bạn, hãy dùng tên cài đặt cần thiết trong manifest hoặc trong đầu ra ở bước 1.

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

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

Khi lưu, các quy tắc sau được áp dụng:

- Những cài đặt không có trong JSON sẽ giữ nguyên giá trị trước đó. Bạn chỉ cần cung cấp trường đang thay đổi.
- Mô tả của cờ nói về việc thiết lập giá trị nói chung và không nêu quy tắc riêng cho các trường bí mật. Sau khi lưu, hãy dùng bước 1 để kiểm tra trường liên quan được đánh dấu `set`.
- Claude Code kiểm tra từng giá trị theo kiểu đã khai báo và in `Configuration saved. Restart Claude Code to apply it.` Điều này có nghĩa là cài đặt đã được lưu và sẽ có hiệu lực sau khi khởi động lại Claude Code.
- Nếu JSON chứa khóa không được khai báo trong manifest, hoặc giá trị không vượt qua bước xác thực, lệnh sẽ không lưu gì, in `Failed to save configuration:` kèm theo lý do, rồi thoát với mã `1`.

Nếu bạn ghi token vào `values.json`, hãy nhớ đây là một tệp thông thường trên đĩa. Hãy xóa tệp sau khi lưu cấu hình và đừng thêm tệp đó vào kho mã nguồn.

## Giá trị được lưu ở đâu

Theo tài liệu manifest plugin, các giá trị thông thường được lưu dưới `pluginConfigs` trong `settings.json` của người dùng. Giá trị của những trường được đánh dấu `sensitive: true` được lưu trong kho thông tin xác thực bảo mật của hệ thống thay vì `settings.json`; dữ liệu nhập cho các trường này sẽ được che đi.

Không cần tìm giá trị của trường bí mật trong `settings.json`. `claude plugin configure` hiển thị trạng thái của trường đó bằng nhãn `sensitive` và `set` hoặc `not set`.

## install --config: đặt giá trị trong khi cài đặt

Đối với một lần cài đặt mới, `claude plugin install` có cờ `--config <key=value>`. Cờ này thiết lập một cài đặt `userConfig` được khai báo trong manifest và yêu cầu v2.1.147 trở lên. Lặp lại cờ cho từng cài đặt. Từ phiên bản 2.1.285, một khóa theo định dạng `<server>.<key>` sẽ thiết lập cài đặt của máy chủ MCP được đóng gói trong plugin, nếu cài đặt đó được khai báo trong `user_config` riêng của máy chủ.

Trong ví dụ dưới đây, hãy thay `formatter@my-marketplace` bằng mã định danh plugin của bạn, thay `api_url` bằng tên cài đặt trong manifest, và thay toàn bộ phần giữ chỗ `NEW_ADDRESS` bằng giá trị của bạn. Giữ nguyên dấu nháy quanh đối số.

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

Lệnh nên dùng tùy thuộc vào việc plugin đã được cài đặt hay chưa: `install --config` đặt giá trị trong lần cài đặt đầu tiên, còn `plugin configure --values-stdin` thay đổi giá trị của plugin đã cài đặt.

Đối với các cài đặt thuộc về máy chủ MCP được đóng gói trong plugin, tài liệu liệt kê các cách khác: `plugin install --config` hoặc **Configure** trong `/plugin`. Tài liệu không đề xuất dùng lệnh `plugin configure` cho các cài đặt đó.

## Nếu lệnh không tìm thấy plugin

Nếu `claude plugin configure` không tìm thấy plugin đã tải có mã định danh đó, lệnh sẽ in `No installed plugin has the id "<plugin>".` và thoát với mã `1`. Trước tiên, hãy kiểm tra bạn đã cung cấp mã định danh đầy đủ theo định dạng `name@marketplace` từ `claude plugin list` chưa. Chỉ tên plugin thôi là chưa đủ.

Lệnh trong phiên có thông báo riêng. Nếu bạn nêu tên một plugin chưa được cài đặt trong dự án hiện tại khi dùng `/plugin enable`, `disable`, `uninstall` hoặc `configure`, Claude Code sẽ in `Plugin "<plugin>" is not installed in this project` và không thực hiện gì.

## Kết luận

Để thay token hoặc địa chỉ của plugin đã cài đặt trong Claude Code 2.1.285 trở lên, hãy tìm mã định danh bằng `claude plugin list`, kiểm tra trạng thái cài đặt bằng `claude plugin configure`, cung cấp giá trị mới từ tệp bằng `--values-stdin`, rồi khởi động lại Claude Code. Giá trị của trường bí mật không được lưu trong `settings.json`, vì vậy hãy kiểm tra trạng thái bằng chính lệnh đó.

Hướng dẫn về [Skills, Subagents, MCP and Plugins in Claude Code](https://ailoot.ai/blog/vi/skills-subagents-mcp-plugins-claude-code/) có thể giúp bạn chọn loại tiện ích mở rộng. Nếu chưa chọn plugin, bạn có thể bắt đầu với 10 plugin Claude Code hàng đầu. Có một hướng dẫn riêng cho bot Telegram: [cài plugin trong tác tử Telegram](https://ailoot.ai/blog/vi/telegram-ai-agent-plugins/) khác với cách cài plugin trong Claude Code.

<div class="section" role="doc-bibliography" aria-label="Nguồn">

### Nguồn

- [Claude Code CHANGELOG, mục 2.1.285](https://github.com/anthropics/claude-code/commit/ec44ca97dc86c33d934c8d55b24959aabf076871.patch)
- [Claude Code: tài liệu tham khảo lệnh plugin](https://code.claude.com/docs/en/plugins/cli-reference.md)
- [Claude Code: tài liệu tham khảo manifest plugin, cấu hình người dùng](https://code.claude.com/docs/en/plugins-reference.md)

</div>





Tìm hiểu [Ailoot](https://ailoot.ai/).

## Câu hỏi thường gặp

### Vì sao configure báo không tìm thấy plugin đã cài?

Dùng định danh đầy đủ name@marketplace từ `claude plugin list`, rồi kiểm tra plugin có trong đúng scope. Lệnh này không nhận riêng tên ngắn.

### Kiểm tra token đã đổi mà không in giá trị thế nào?

Chạy `claude plugin configure` với định danh đầy đủ và kiểm tra trường nhạy cảm được đánh dấu đã đặt. Khởi động lại Claude Code sau lưu; không commit tệp JSON đầu vào chứa token.


## Ailoot · Công ty và danh mục dự án của công ty

Ailoot dựa trên kinh nghiệm vận hành tích lũy, cơ sở khách hàng lớn, dịch vụ ổn định và việc kiểm soát KPI liên tục.

Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng.

Ailoot áp dụng kinh nghiệm vận hành này để cung cấp quyền truy cập API vào các tính năng AI trong sản phẩm của khách hàng, tác tử, ứng dụng và quy trình tự động hóa.