claude-ss - Công cụ dán ảnh chụp màn hình vào Claude Code trên macOS chỉ với một lần nhấn cmd+shift+2.

(github.com/jidohyun)

2 điểm bởi map12345678 2026-04-24 | Chưa có bình luận nào. | Chia sẻ qua WhatsApp

claude-ss

Tôi đã tạo ra một công cụ cho phép dán ảnh chụp màn hình vào Claude Code trên macOS chỉ với một lần nhấn cmd+shift+2.

Bối cảnh

Việc dán một ảnh chụp màn hình vào Claude Code hóa ra lại phiền phức hơn tưởng tượng. Nếu chụp bằng cmd+shift+4 thì tệp sẽ rơi xuống màn hình Desktop, rồi phải đi tìm và kéo thả vào; còn nếu sao chép vào clipboard bằng ctrl+cmd+shift+4 thì vẫn phải chuyển tab và nhấn cmd+v.
Ngay cả khi muốn dán 3 ảnh trong một lượt, clipboard cũng chỉ nhớ tấm cuối cùng. claude-ss đã rút gọn quy trình này thành "phím tắt → kéo thả → xong".

Cách hoạt động

Ở bất kỳ đâu, nhấn cmd+shift+2 → kéo chọn vùng
Chụp liên tiếp nhiều ảnh (được xếp vào hàng đợi multi-shot)
Khi quay lại terminal Claude Code, ảnh sẽ tự động được dán theo đúng thứ tự đã chụp

Daemon của claude-ss phát hiện terminal được focus và flush hàng đợi. Không nháy màn hình, không ghi đè clipboard, không còn địa ngục chuyển ứng dụng qua lại. Dù đang ở trạng thái IME tiếng Hàn/tiếng Nhật/tiếng Trung, helper viết bằng Swift cũng sẽ tự động chuyển sang ABC → dán → khôi phục IME ban đầu.

Tính năng

Hàng đợi multi-shot: chụp nhiều ảnh vẫn được dán đầy đủ theo đúng thứ tự
IME-safe: dán an toàn ngay cả khi đang ở trạng thái nhập tiếng Hàn
Hỗ trợ tmux / iTerm2 / cmux: cố định target theo session ID (claude-ss target set)
Lệnh slash của Claude Code: có thể điều khiển thủ công bằng /ss, /ss-all, /ss-clear
Mã nguồn mở MIT, miễn phí

Cài đặt

npm install -g @jidohyun/claude-ss  
claude-ss setup    # hướng dẫn 3 quyền trên macOS  
claude-ss start

Hoặc dùng plugin Claude Code:

/plugin marketplace add jidohyun/claude-ss
/plugin install claude-ss@claude-ss

Liên kết

Nếu bạn đang dùng Claude Code, hãy chia sẻ cho mọi người nhé! Rất hoan nghênh feedback / PR port sang Linux·Windows.