cc-clip CLI
Мост буфера обмена по SSH: картинки из локального буфера попадают в Claude Code, Codex CLI и Cursor на удаленном сервере
- 182 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Ставит на сервер шим вместо xclip и wl-paste и дописывает хуки уведомлений в конфиги агентов, например в ~/.cursor/hooks.json
- Запускает локальный демон с доступом к вашему буферу обмена и добавляет RemoteForward в SSH-конфиг
- Loopback на сервере общий для всех его пользователей: от чужого процесса того же пользователя токен не защищает
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/ShunmeiCho/cc-clip/main/scripts/install.sh | shУстановщик из README. Перед запуском прочитайте скрипт. Дальше `cc-clip setup myserver` настраивает хост.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Ставит на сервер шим вместо xclip и wl-paste и дописывает хуки уведомлений в конфиги агентов, например в ~/.cursor/hooks.json
- Запускает локальный демон с доступом к вашему буферу обмена и добавляет RemoteForward в SSH-конфиг
- Loopback на сервере общий для всех его пользователей: от чужого процесса того же пользователя токен не защищает
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
cc-clip переносит буфер обмена вашей машины в удаленную SSH-сессию. После настройки Ctrl+V в Claude Code, opencode, Cursor или Kimi Code на сервере вставляет картинку, скопированную на Mac, а Codex CLI и Grok Build получают ее через виртуальный дисплей Xvfb. Без моста скриншот пришлось бы сохранять, отправлять через `scp` и вписывать путь к файлу. Локальный демон слушает только интерфейс `loopback`, SSH пробрасывает его порт на сервер через RemoteForward, а на сервере вместо `xclip` или `wl-paste` стоит шим. Доступ закрыт токеном со сроком 30 дней. Обратное направление тоже есть: `git diff | cc-clip copy` кладет текст в локальный буфер без переносов, которые добавляет терминал. Когда удаленный агент закончил ход или ждет подтверждения инструмента, на рабочем столе появляется уведомление. Команда `cc-clip doctor --host myserver` проверяет каждое звено цепочки и печатает `[pass]` или `[FAIL]` с причиной.
Для кого. Разработчикам, которые запускают Claude Code или Codex CLI на удаленном Linux-сервере с Mac и устали пересылать скриншоты вручную.
Подходит, если
- Агент на сервере должен увидеть скриншот ошибки интерфейса, который скопирован на вашем Mac
- Код живет на облачной машине или рабочем сервере, а Claude Code запущен там по SSH
- Длинные строки из терминала приходят в локальный буфер с лишними переносами, и нужен точный текст
- Вы переключаетесь между окнами и хотите получать сигнал, когда агент ждет подтверждения команды
- Вставка картинки перестала работать, и нужна диагностика всей цепочки одной командой
Не подходит, если
- Агент работает на вашей локальной машине: удаленный мост ему не нужен
- Сервер без доступа по SSH-ключам и без именованной записи Host в `~/.ssh/config`
- Рабочая станция на Windows и ожидание стабильности: поддержка там экспериментальная
- Политика безопасности запрещает ставить шимы и хуки в домашний каталог на общем сервере
Пример запроса к агенту
Я скопировал скриншот на Mac. Вставь его в запрос на удаленном сервере и объясни, почему кнопка на нем съехала.Ограничения
- Стабильный путь: macOS 13 и новее локально, Linux (amd64 или arm64) на сервере с `curl`, `bash` и `xclip` или `wl-paste`. Windows в README назван экспериментальным.
- Для Codex CLI нужен Xvfb. Без беспарольного sudo cc-clip печатает команду установки, и ее запускают вручную.
- После `cc-clip setup` откройте новую SSH-сессию: старая не держит обратный туннель. Для Cursor на сервере должна быть задана переменная DISPLAY или WAYLAND_DISPLAY.
- Интеграции с opencode и Antigravity проверены тестами генерации, но вживую не прогонялись.
Как отключить. На сервере выполните `cc-clip uninstall`, локально `cc-clip uninstall --host myserver`. Для Codex добавьте флаг `--codex`. Демон на своей машине снимает `cc-clip service uninstall`.
Частые вопросы
Как вставить картинку в Claude Code по SSH?
Выполните `cc-clip setup myserver`, откройте новую SSH-сессию и нажмите Ctrl+V в Claude Code на сервере. Агент прикрепит картинку из локального буфера, а на Mac появится уведомление с ее размером и форматом.
Почему Codex CLI требует отдельный флаг?
Codex читает буфер X11 напрямую и не вызывает `xclip`, поэтому обычный шим до него не достает. Флаг `--codex` добавляет на сервер Xvfb и мост `cc-clip x11-bridge`.
Открыт ли порт демона для других людей?
Нет, демон и проброшенный порт слушают только `loopback`, публичного слушателя нет. Общий `loopback` видят другие пользователи того же сервера, поэтому токен хранится в файле с правами 0600.
Что делать, если вставка не работает?
Скопируйте картинку локально и запустите `cc-clip doctor --host myserver`: команда проверит демон, форвардинг, токен и шим. Исправляйте первую строку с `[FAIL]`, остальные обычно тянутся за ней.
Работает ли cc-clip на Windows?
Поддержка Windows экспериментальная: основной путь в README описан для macOS, а для Windows есть отдельный быстрый старт с командами `send` и `hotkey`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыНативный терминал для macOS на базе Ghostty с вертикальными вкладками и уведомлениями, когда агенту нужен ответ
clawk, CLI виртуальных сред, сохраняет память и диск Linux-машины снимком, чтобы позже продолжить работу запущенных процессов.
MCP-сервер из SSH-менеджера purple: агент читает хосты из ~/.ssh/config и контейнеры на них, а команды и управление контейнерами включаются отдельно
MCP SSH Manager
mcp-ssh-manager
Управление несколькими SSH-подключениями из Claude Code и Codex: команды, перенос файлов, базы данных и бэкапы. Стабильная ветка в npm, в GitHub бета 4.0
Скилл SSH для Codex и Claude Code: команды на серверах, передача файлов и туннели с единым JSON-ответом и защитой от повторов.
Расход токенов и денег по Claude Code, Gemini CLI, Codex и Cursor в одном отчете: по локальным логам, без сети и ключей.
Коротко о README
README открывается быстрым стартом из трех шагов: установка, настройка хоста, новая SSH-сессия. Дальше идут таблица целей по агентам, разбор возможностей с блоками «что, зачем, как включить, что вы увидите», справочник команд, схема работы, модель безопасности и поиск неполадок.