Claude Image View là gì?
Claude Image View là một mod của Claude Code, hiển thị hình thu nhỏ cho các hình ảnh được dán vào lời nhắc. Thay vì chỉ làm việc với các thẻ đơn như [Image #1], bạn có thể xem các hình ảnh tương ứng theo một hàng ngay phía trên khu vực nhập.
Mod này đặc biệt hữu ích khi so sánh ảnh chụp màn hình, ảnh chụp hoặc các trạng thái giao diện. Mỗi hình thu nhỏ được gắn nhãn bằng số của thẻ hình ảnh tương ứng, giúp bạn dễ tham chiếu đúng hình ảnh trong lời nhắc.
Tính năng chính
- Xem trước ngay lập tức: Hình thu nhỏ xuất hiện ngay khi bạn dán hình ảnh. Bạn không cần nhấn thêm phím nào.
- Hỗ trợ nhiều hình ảnh: Dán nhiều hình ảnh sẽ tạo một hàng hình thu nhỏ được đánh số.
- Giữ nguyên tỷ lệ: Ảnh chụp màn hình rộng vẫn giữ chiều rộng, trong khi ảnh dọc vẫn giữ chiều cao.
- Tự động điều chỉnh: Các ô thu nhỏ tự co lại để vừa không gian khả dụng, tránh việc hàng hình thu nhỏ phải cuộn hoặc bị cắt.
- Tự động dọn dẹp: Hàng hình ảnh biến mất sau khi bạn gửi lời nhắc hoặc xóa các thẻ hình ảnh tương ứng.
- Hoạt động hoàn toàn cục bộ: Mod không thực hiện yêu cầu mạng và không ghi tệp.
Yêu cầu
Trước khi cài đặt mod, hãy xác nhận môi trường của bạn đáp ứng các yêu cầu sau:
- Claude Code phiên bản
2.1.287trở lên, có hỗ trợ mod. - macOS hoặc Linux.
- Thiết bị đầu cuối hỗ trợ giao thức đồ họa kitty, chẳng hạn như Ghostty hoặc kitty.
Nếu thiết bị đầu cuối của bạn không hỗ trợ giao thức đồ họa kitty, các ô sẽ hiển thị văn bản như
[Image #1]thay vì hình ảnh thực tế. Ứng dụng Claude Desktop đã có sẵn tính năng xem trước hình ảnh được dán, vì vậy mod này không vẽ gì trong ứng dụng đó.
Cài đặt Claude Image View
Cài đặt từ bên trong Claude Code
Mở một phiên Claude Code và chạy lần lượt các lệnh sau:
/plugin marketplace add jarrodwatts/claude-image-view
/plugin install image-view
/reload-pluginsLệnh đầu tiên thêm marketplace plugin của dự án, lệnh thứ hai cài đặt mod, còn lệnh thứ ba tải lại các plugin đã cài đặt cho phiên hiện tại.
Cài đặt từ thiết bị đầu cuối
Nếu muốn sử dụng shell, hãy thêm marketplace và cài đặt plugin bằng:
claude plugin marketplace add jarrodwatts/claude-image-view
claude plugin install image-view@claude-image-viewSau khi cài đặt, chạy /reload-plugins bên trong một phiên Claude Code đang hoạt động. Ngoài ra, bạn có thể bắt đầu một phiên mới.
Cách sử dụng cơ bản
- Mở Claude Code trong một thiết bị đầu cuối tương thích.
- Dán hình ảnh vào lời nhắc.
- Tìm hình thu nhỏ được đánh số ở phía trên khu vực nhập.
- Viết yêu cầu và tham chiếu thẻ được tạo, chẳng hạn như
[Image #1]. - Gửi lời nhắc. Hàng hình thu nhỏ sẽ tự động được xóa.
Ví dụ, sau khi dán hai hình ảnh, bạn có thể nhập:
Why is the header misaligned in [Image #1] compared with [Image #2]?Hàng xem trước hiển thị cả hai hình ảnh với nhãn #1 và #2, giúp bạn xác minh rằng lời nhắc tham chiếu chúng theo đúng thứ tự mong muốn.
Xóa bản xem trước trước khi gửi
Nếu bạn xóa một thẻ hình ảnh khỏi lời nhắc, ô tương ứng sẽ bị xóa. Xóa tất cả thẻ hình ảnh sẽ xóa toàn bộ hàng.
Cách mod hoạt động
Claude Code lưu các hình ảnh được dán vào bộ nhớ đệm của phiên với đường dẫn có dạng:
<tmp>/<project>/<session>/images/<n>.pngSau đó, ứng dụng chèn một thẻ [Image #n] tương ứng vào lời nhắc. Claude Image View liên kết các thẻ này với các tệp trong bộ nhớ đệm thông qua quy trình sau:
- Cứ mỗi 200 mili giây, mod đọc hộp nhập lời nhắc và tìm các thẻ
[Image #n]. Cần có bộ hẹn giờ vì việc dán hình ảnh không kích hoạt sự kiện chỉnh sửa. - Với mỗi thẻ được phát hiện, mod tìm tệp PNG trong bộ nhớ đệm và đọc kích thước hình ảnh từ phần đầu tệp PNG.
- Mod vẽ các hình thu nhỏ có kích thước phù hợp phía trên lời nhắc bằng phần tử
Imagecủa Claude Code.
Thiết bị đầu cuối đọc trực tiếp từng tệp hình ảnh, vì vậy dữ liệu hình ảnh không đi qua chính mod.
Bảo mật và xác thực
Claude Image View hoạt động cục bộ. Mod không thực hiện yêu cầu mạng và không ghi tệp. Quyền truy cập của mod chỉ giới hạn ở việc đọc hộp nhập lời nhắc, liệt kê thư mục tạm của Claude Code để tìm bộ nhớ đệm của phiên hiện tại và đọc các byte ban đầu của hình ảnh được dán.
Nếu CLAUDE_CODE_TMPDIR chưa được cấu hình, mod sẽ chạy id -u một lần để xác định thư mục tạm mặc định. Bạn có thể kiểm tra các hook và lệnh gọi của mod bằng cách xác thực repository:
claude plugin validate .Khắc phục sự cố
Không xuất hiện hàng hình thu nhỏ
Chạy /plugin trong Claude Code và kiểm tra dòng trạng thái mờ bên dưới các tab. Dòng này phải liệt kê image-view là mod đang hoạt động. Nếu không thấy, hãy chạy:
/reload-pluginsMột ô hiển thị “no preview”
Thông báo này có nghĩa là mod không thể tìm thấy tệp hình ảnh trong bộ nhớ đệm. Claude Code có thể đã thay đổi vị trí lưu hình ảnh được dán. Hãy ghi lại phiên bản Claude Code của bạn và mở một issue trong repository của dự án.
Ô hiển thị thẻ hình ảnh thay vì hình ảnh
Nếu một ô hiển thị [Image #1] thay vì hình thu nhỏ, thiết bị đầu cuối của bạn không hỗ trợ giao thức đồ họa kitty. Hãy chuyển sang một thiết bị đầu cuối tương thích như Ghostty hoặc kitty.
Mẹo nâng cao và phát triển
Kiểm tra phiên bản Claude Code
Nếu mod không tải, hãy xác minh rằng bạn đang sử dụng Claude Code 2.1.287 hoặc mới hơn. Các bản phát hành cũ hơn không cung cấp tính năng hỗ trợ mod cần thiết.
Kiểm thử mà không cần cài đặt
Cộng tác viên có thể sao chép kho lưu trữ và tải mod cho một phiên duy nhất:
git clone https://github.com/jarrodwatts/claude-image-view
cd claude-image-view
claude --plugin-dir .Cách này hữu ích để kiểm thử các thay đổi cục bộ mà không cần cài đặt mod vĩnh viễn.
Xác thực và chạy kiểm thử
Từ kho lưu trữ đã sao chép, hãy xác thực plugin và chạy bộ kiểm thử:
claude plugin validate .
claude plugin test .Lần đầu Claude Code tải mod, chương trình sẽ ghi các định nghĩa kiểu API vào .claude-plugin/types/. Sau đó, bạn có thể kiểm tra kiểu của dự án bằng:
tsc -p .Kết luận
Claude Image View giúp các phiên Claude Code sử dụng hình ảnh dễ theo dõi hơn bằng cách đặt các hình thu nhỏ được đánh số và tự điều chỉnh phía trên lời nhắc. Quá trình cài đặt chỉ cần vài lệnh, bản xem trước xuất hiện ngay lập tức và mọi hoạt động xử lý đều được thực hiện cục bộ. Với phiên bản Claude Code được hỗ trợ và thiết bị đầu cuối tương thích với kitty, bạn có thể so sánh và tham chiếu các hình ảnh đã dán mà không phải chỉ dựa vào các thẻ hình ảnh không rõ ràng.