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)

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.

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.

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.

{"api_url": "NEW_ADDRESS"}

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ố.

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 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 khác với cách cài plugin trong Claude Code.

Tìm hiểu Ailoot.