Claude SSH Image Skill
AlexZeitler/claude-ssh-image-skill
Cole imagens da clipboard local em Claude Code remoto via SSH
Ver no GitHubSkill para Claude Code que permite colar imagens da clipboard local em sessões remotas via SSH, usando um daemon local e cliente remoto que se comunicam por túnel reverso. Resolve a limitação nativa do Claude Code de não suportar images sobre SSH.
Instalação
npx convez-ai AlexZeitler/claude-ssh-image-skill1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Colar screenshots em sessões de Claude Code em servidores remotos
- Compartilhar imagens de UI/UX para análise e debug remoto
- Integrar imagens em fluxos de trabalho de desenvolvimento servidor
Veredito

Solução engenhosa que preenche gap real do Claude Code sobre SSH com arquitetura cliente-daemon bem pensada. Exige setup manual e conhecimento de SSH/systemd, mas é robusto para quem trabalha em máquinas remotas regularmente.
README
A tradução para o português deste README ainda está na fila.
claude-ssh-image-skill
A Claude Code skill + local daemon that enables pasting clipboard images into a Claude Code session on a remote server over SSH.
Claude Code doesn't natively support pasting images over SSH. This project solves that with a similar approach to sshimg.nvim, but specifically for Claude Code.
How it works
Local Machine Remote Server (SSH)
┌──────────────────────┐ ┌──────────────────────────┐
│ Clipboard (PNG) │ │ Claude Code │
│ │ │ │ │ │
│ ▼ │ │ ▼ │
│ ccimgd (Port 9998) │◄────────────────│ /paste-image Skill │
│ - wl-paste │ SSH Reverse │ - TCP Request to ccimgd │
│ - Returns base64 │ Tunnel │ - Receives base64 image │
│ image in response │ (Port 9998) │ - Saves as temp file │
│ │ │ - Read → Claude sees │
└──────────────────────┘ │ the image │
└──────────────────────────┘
- The
/paste-imageskill runs theccimgclient on the remote server, which sends a TCP request to127.0.0.1:9998(forwarded through the SSH reverse tunnel to the local machine) ccimgdreads the PNG image from the local clipboard (wl-pasteon Wayland,xclipon X11,pngpasteon macOS)- The image is returned as base64-encoded JSON
ccimgsaves it as a temporary PNG file and prints the path- The skill uses Claude's
Readtool to display the image
Requirements
- Local machine (Linux):
wl-paste(Wayland, part ofwl-clipboard) orxclip(X11) - Local machine (macOS):
pngpaste(brew install pngpaste) - Remote server: Claude Code
- Building from source: Go
Building
Build both binaries (daemon + client):
./build.sh
This builds statically linked binaries for all supported platforms:
daemon/ccimgd-linux-amd64,daemon/ccimgd-darwin-amd64,daemon/ccimgd-darwin-arm64client/ccimg-linux-amd64,client/ccimg-darwin-amd64,client/ccimg-darwin-arm64
Setup
Local machine (Linux)
cp daemon/ccimgd-linux-amd64 ~/.local/bin/ccimgd
cp daemon/ccimgd.service ~/.config/systemd/user/
systemctl --user daemon-reload
systemctl --user enable --now ccimgd
Local machine (macOS)
cp daemon/ccimgd-darwin-arm64 /usr/local/bin/ccimgd # or ccimgd-darwin-amd64 for Intel
cp daemon/com.ccimgd.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.ccimgd.plist
Remote server
Copy the client binary and skill to the remote server:
scp client/ccimg-linux-amd64 your-server:~/.local/bin/ccimg
scp skill/paste-image.md your-server:~/.claude/commands/paste-image.md
To avoid permission prompts each time, add this to ~/.claude/settings.json:
{
"permissions": {
"allow": [
"Bash(ccimg)"
]
}
}
SSH connection
Connect with a reverse tunnel:
ssh -R 9998:localhost:9998 your-server
Or add to ~/.ssh/config:
Host your-server
RemoteForward 9998 localhost:9998
Usage
In Claude Code on the remote server, copy an image to the clipboard on your local machine and run:
/paste-image
Comparison with sshimg.nvim
| Aspect | sshimg.nvim | claude-ssh-image-skill |
|---|---|---|
| Client | Neovim plugin (Lua) | Claude Code skill |
| Daemon | imgd (Port 9999) | ccimgd (Port 9998) |
| Image transfer | Daemon → scp → Server | Daemon → base64 in TCP response → Client saves |
| Request needs | host + path | Nothing (empty object) |
| Coexistence | Port 9999 | Port 9998 — both can run simultaneously |
License
MIT