Cải thiện khả năng đọc Claude Code với claude-mods

claude-mods thực hiện những gì

claude-mods là một bộ sưu tập plugin dành cho Claude Code, được thiết kế để các phiên làm việc trong terminal dễ theo dõi hơn. Hiện dự án cung cấp hai mod: glamour-dark và tool-lines.

• glamour-dark hiển thị phản hồi dạng văn bản của mô hình bằng kiểu tối mặc định của glamour.
• tool-lines hiển thị mỗi lệnh gọi công cụ trên một dòng gọn theo định dạng tool_call: Tool(input) - meta và ẩn khối kết quả của công cụ.

Sử dụng các mod này có thể giảm nhiễu trực quan và giúp bạn nhận thấy những chi tiết quan trọng trong phiên Claude Code.

Điều kiện tiên quyết

Bạn cần cài đặt Claude Code và có thể sử dụng thông qua lệnh claude. Quy trình cài đặt sử dụng marketplace plugin và các lệnh plugin của Claude Code.

Cài đặt plugin từ dòng lệnh

Trước tiên, thêm repository dưới dạng marketplace plugin của Claude Code:

claude plugin marketplace add Tickloop/claude-mods

Sau đó cài đặt một hoặc cả hai mod hiện có:

claude plugin install glamour-dark@claude-mods
claude plugin install tool-lines@claude-mods

Sau khi cài đặt, Claude Code có thể sử dụng các plugin theo cơ chế tải plugin thông thường.

Cài đặt từ bên trong phiên Claude Code

Bạn cũng có thể thêm marketplace khi đang mở một phiên Claude Code:

/plugin marketplace add Tickloop/claude-mods

Tiếp theo, mở /plugin và chọn các mod bạn muốn cài đặt. Cách này hữu ích khi bạn muốn quản lý plugin mà không rời khỏi phiên đang hoạt động.

Để áp dụng các plugin đã cài đặt hoặc đã thay đổi mà không cần khởi động lại Claude Code, hãy chạy:

/reload-plugins

Chọn mod phù hợp

Sử dụng glamour-dark cho phản hồi được định dạng

Cài đặt glamour-dark khi ưu tiên của bạn là giúp phản hồi văn bản của Claude dễ đọc hơn trong giao diện terminal tối. Mod này áp dụng kiểu tối mặc định của glamour cho phản hồi của mô hình.

Sử dụng tool-lines để hiển thị hoạt động công cụ gọn hơn

Cài đặt tool-lines khi bạn muốn hoạt động của công cụ được tóm tắt theo định dạng một dòng gọn. Mod này ẩn khối kết quả và hiển thị mỗi lệnh gọi như sau:

tool_call: Tool(input) - meta

Bạn có thể cài đặt cả hai mod nếu muốn phản hồi của mô hình được định dạng đẹp hơn và đầu ra công cụ ít dài dòng hơn trong cùng một phiên.

Cập nhật các mod

Khi một bản phát hành mới thay đổi phiên bản của mod trong plugin.json, trước tiên hãy cập nhật siêu dữ liệu marketplace:

claude plugin marketplace update claude-mods

Sau đó cập nhật plugin riêng lẻ mà bạn muốn làm mới:

claude plugin update glamour-dark@claude-mods

Thay tên plugin bằng tool-lines@claude-mods nếu bạn đang cập nhật mod tool-lines. Trong một phiên đang mở, chạy lệnh sau để chuyển sang phiên bản mới:

/reload-plugins

Phát triển hoặc kiểm thử các mod cục bộ

Để làm việc với dự án, hãy clone repository và khởi chạy Claude Code từ thư mục gốc với cả hai thư mục mod được tải:

claude --plugin-dir ./glamour-dark --plugin-dir ./tool-lines

Tùy chọn --plugin-dir chỉ tải một mod cho phiên hiện tại. Tùy chọn này hữu ích để kiểm thử các thay đổi cục bộ mà không cần cài đặt plugin trên toàn hệ thống.

Tải các mod cục bộ mỗi lần khởi chạy

Nếu đang tích cực phát triển các mod và muốn chúng được tải trong mọi phiên Claude Code, hãy thêm alias vào cấu hình shell. README đưa ra ví dụ này cho ~/.zshrc hoặc ~/.bashrc:

alias claude='command claude --plugin-dir ~/path/to/claude-mods/glamour-dark --plugin-dir ~/path/to/claude-mods/tool-lines'

Thay ~/path/to/claude-mods bằng vị trí bạn đã clone repository. Sau khi thêm alias, hãy tải lại cấu hình shell hoặc mở một phiên terminal mới để alias có hiệu lực.

Mẹo quy trình thực tế

• Chỉ cài đặt glamour-dark nếu bạn muốn cải thiện kiểu hiển thị phản hồi mà không thay đổi cách hiển thị công cụ.
• Chỉ cài đặt tool-lines nếu mục tiêu chính của bạn là hiển thị hoạt động công cụ gọn hơn.
• Cài đặt cả hai mod để có thiết lập đầy đủ, tập trung vào khả năng đọc.
• Sử dụng /reload-plugins sau khi cài đặt hoặc cập nhật plugin trong một phiên đang mở.
• Sử dụng --plugin-dir khi kiểm thử các thay đổi phát triển cục bộ trong một phiên.
• Sử dụng alias shell khi muốn các mod đã clone cục bộ được tự động tải.

Kết luận

claude-mods cung cấp hai plugin Claude Code chuyên biệt để cải thiện khả năng đọc trong terminal. Cài đặt glamour-dark cho phản hồi mô hình với kiểu tối, tool-lines cho các lệnh gọi công cụ gọn hơn, hoặc sử dụng cả hai. Các lệnh marketplace hỗ trợ cài đặt và cập nhật, trong khi các thư mục plugin cục bộ giúp việc phát triển và kiểm thử trở nên đơn giản.