claude-ss - macOSで cmd+shift+2 を一度押すだけで Claude Code にスクリーンショットをさっと貼り付けられるツール。

claude-ss

macOSで cmd+shift+2 を一度押すだけで Claude Code にスクリーンショットをさっと貼り付けられるツールを作りました。

背景

Claude Code にスクリーンショットを1枚貼り付けるのは、思ったより面倒です。cmd+shift+4 で撮るとデスクトップにファイルが保存され、それを探してドラッグしなければなりません。ctrl+cmd+shift+4 でクリップボードにコピーしても、タブを切り替えて cmd+v を押す必要があります。
1ターンで3枚貼り付けたくても、クリップボードが覚えているのは最後の1枚だけです。claude-ss はこの作業を "ショートカット → ドラッグ → 完了" にまで減らしました。

動作の仕組み

1. どこからでも cmd+shift+2 → 範囲をドラッグ
2. 複数枚を連続キャプチャ（マルチショットキューに蓄積）
3. Claude Code のターミナルに戻ると、撮った順に自動で貼り付け

claude-ss デーモンがターミナルフォーカスを検知してキューをフラッシュします。画面のちらつきなし、クリップボードの上書きなし、アプリ切り替え地獄なし。韓国語/日本語/中国語 IME の状態でも Swift ヘルパーが ABC に切り替え → 貼り付け → 元の IME を復元まで自動で処理します。

特徴

• マルチショットキュー: 複数枚撮っても順番どおりにすべて貼り付け
• IME-safe: 韓国語入力状態でも安全に貼り付け
• tmux / iTerm2 / cmux 対応: セッション ID ベースでターゲットを固定 (claude-ss target set)
• Claude Code スラッシュコマンド: /ss, /ss-all, /ss-clear で手動制御も可能
• オープンソース MIT、無料

インストール

npm install -g @jidohyun/claude-ss  
claude-ss setup    # macOS の3種類の権限ガイド  
claude-ss start  

または Claude Code プラグインとして:

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

リンク

• GitHub: https://github.com/jidohyun/claude-ss
• npm: https://www.npmjs.com/package/@jidohyun/claude-ss

Claude Code を使っている方はぜひ共有してください！ フィードバックや Linux・Windows への移植 PR も歓迎します。