Claude Code on Veno's Blog

在 SSH + tmux 里给 Claude Code 粘贴 Mac 剪贴板里的图片

Sat, 26 Sep 2026 21:04:29 +0800

我的环境：MacBook 上 kitty → tmux → ssh → Fedora homelab 上的 tmux → Claude Code。截图后按 Ctrl+V，什么都贴不进去。

原因

Claude Code 在 Linux 上贴图，是在它自己所在的机器上调用这些命令：

1
2


xclip -selection clipboard -t TARGETS -o | grep -E "image/(png|jpeg|...)" || wl-paste -l | grep ...
xclip -selection clipboard -t image/png -o > file || wl-paste --type image/png > file

它读的是远端机器的 X11/Wayland 剪贴板，而 homelab 是 headless 的。kitty、tmux、SSH 之间只传字节流，OSC 52 也只管文本，所以不管这几层怎么配都没用。能下手的地方只有这个 xclip。

思路

每条 SSH 连接都把远端的 127.0.0.1:47851 反向转发到 Mac 自己的 sshd。
远端放一个假的 xclip，通过这条隧道 ssh 回 Mac，在 Mac 上执行 pngpaste -。

绕一圈走 sshd，而不是在 Mac 上开一个吐剪贴板的小服务，原因是远端有好几个账号，回环端口谁都能连。走 sshd 的话，只有 Mac 授权过的 key 能进来；再把 host key 钉死，别的账号就算抢先占了这个端口，也收不到这条连接。这样 Mac 上也不需要常驻任何进程。

用 TCP 而不用 Unix socket 转发，是因为 socket 在连接断开后会留下残留文件，下次绑定会失败，除非服务端开了 StreamLocalBindUnlink。

Mac 端

打开「远程登录」，把远端账号的公钥加进 ~/.ssh/authorized_keys，再装上 pngpaste（brew 或 nixpkgs 都有）。

~/.ssh/config：

1
2


Host thinkpad thinkpad-local
 RemoteForward 127.0.0.1:47851 localhost:22

同时开多条连接时，后连上的那条会报 remote port forwarding failed。这不影响使用，先连上的那条仍在提供同一个剪贴板。

远端

单独准备一份 known_hosts，里面只放 Mac 的 host key：

1
2


# ~/.config/clipbridge/known_hosts
[127.0.0.1]:47851 ssh-ed25519 AAAA...

再放一个 xclip 到 PATH 里，要排在真正的 xclip 前面（headless 机器上一般本来就没装），比如 ~/.local/bin/xclip：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34


#!/usr/bin/env bash
selection=clipboard target="" output=""
while [ $# -gt 0 ]; do
 case "$1" in
 -selection|-sel) selection=$2; shift ;;
 -t|-target) target=$2; shift ;;
 -o|-out) output=1 ;;
 esac
 shift
done

# 只桥接"读 clipboard"
if [ "$selection" != clipboard ] || [ -z "$output" ]; then
 echo "xclip: only 'xclip -selection clipboard [-t ...] -o' is bridged to the Mac" >&2
 exit 1
fi

mac() {
 ssh -p 47851 \
 -o BatchMode=yes -o ConnectTimeout=3 \
 -o UserKnownHostsFile="$HOME/.config/clipbridge/known_hosts" -o StrictHostKeyChecking=yes \
 -o ClearAllForwardings=yes \
 -o ControlMaster=auto -o ControlPersist=60 \
 -o ControlPath="$HOME/.cache/clipbridge-%C" \
 you@127.0.0.1 "$@"
}

# ~ 由 Mac 那边的 shell 展开
case "$target" in
 TARGETS) mac '~/.nix-profile/bin/pngpaste - >/dev/null 2>&1' && echo image/png ;;
 image/png) mac '~/.nix-profile/bin/pngpaste -' ;;
 ""|text/plain|UTF8_STRING|STRING) mac pbpaste ;;
 *) exit 1 ;;
esac

补充几点：

pngpaste 的路径要按你在 Mac 上的实际安装位置改：brew 装的是 /opt/homebrew/bin/pngpaste。
贴一次图会调用两次（先查 TARGETS，再取 image/png），ControlMaster 让这两次复用同一条连接。
剪贴板里没有图片时脚本返回非零，Claude Code 会自己退回到别的处理方式。

配好后在 Mac 上重新 ssh 一次，让转发生效。远端的 tmux 会话不受影响，重新 attach 就行。之后截图，在 Claude Code 里 Ctrl+V 即可。

我实际是用 Home Manager 管这两边的，见 dotfiles 里的 hosts/thinkpad-veno.nix 和 hosts/macbook-veno.nix。

用 Claude Code Hook 强制使用 rg 替代 grep

Sat, 28 Feb 2026 20:00:00 +0800

Claude Code 内置了专用的 grep 工具，但在某些场景下它仍会通过 Bash 工具直接调用 grep。ripgrep（rg）在速度、默认递归搜索、自动遵守 .gitignore 等方面都更优。通过配置 PreToolUse hook，可以让 Claude Code 在执行任何 grep 命令时自动切换为 rg。

想法来自于这篇视频

Claude Code Hooks 工作原理

Claude Code 支持在特定事件点注入用户脚本，称为 hooks。PreToolUse 事件在工具调用执行之前触发，可以检查、拦截即将执行的操作。

对于 Bash 工具，hook 脚本通过 stdin 接收如下 JSON：

1
2
3
4
5
6
7


{
 "session_id": "abc123",
 "tool_name": "Bash",
 "tool_input": {
 "command": "grep -r 'pattern' ."
 }
}

hook 脚本可以输出以下 JSON 来拦截命令：

1
2
3
4


{
 "decision": "block",
 "reason": "原因说明，Claude 会读取并据此调整"
}

关键机制：hook 无法直接修改命令本身，只能 block 并附带说明。Claude 读取 reason 后会自动纠正并重试——这已经足够实现目标。

实现步骤

1. 创建 hook 脚本

新建 ~/.claude/hooks/grep-to-rg.sh：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


#!/bin/bash
# 拦截 grep 命令，提示 Claude 改用 rg

INPUT=$(cat)
COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')

if echo "$COMMAND" | grep -qE '(^|[|;&]\s*|`\s*)grep\b'; then
 jq -n '{
 "decision": "block",
 "reason": "禁止使用 grep。请改用 ripgrep (rg)，例如将 grep -r 替换为 rg，grep -l 替换为 rg -l。rg 更快且默认递归搜索。"
 }'
 exit 0
fi

正则 (^|[|;&]\s*|`\s*)grep\b 覆盖了命令开头、管道、分号、反引号等各种 grep 出现的位置，避免误拦截含 “grep” 字符串的变量名等。

赋予执行权限：

1

chmod +x ~/.claude/hooks/grep-to-rg.sh

2. 注册到 settings.json

编辑 ~/.claude/settings.json，添加 hooks 配置：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


{
 "hooks": {
 "PreToolUse": [
 {
 "matcher": "Bash",
 "hooks": [
 {
 "type": "command",
 "command": "/Users/your-name/.claude/hooks/grep-to-rg.sh"
 }
 ]
 }
 ]
 }
}

matcher: "Bash" 表示仅对 Bash 工具调用触发此 hook。

验证

用 echo 模拟 stdin，测试脚本逻辑：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


# grep 命令应被拦截
echo '{"tool_input":{"command":"grep -r pattern ."}}' \
 | ~/.claude/hooks/grep-to-rg.sh

# 输出：
# {
# "decision": "block",
# "reason": "禁止使用 grep。..."
# }

# rg 命令应静默通过
echo '{"tool_input":{"command":"rg pattern ."}}' \
 | ~/.claude/hooks/grep-to-rg.sh; echo "exit: $?"

# 输出：
# exit: 0

重启 session 后，让 Claude 尝试执行一个 grep 命令，它会自动切换为 rg：

1
2
3
4
5
6
7


# 尝试 grep
grep -r "PluginList" Plugins/
# → hook 触发，被拦截

# Claude 自动改用 rg
rg "PluginList" Plugins/
# → 正常执行，返回结果

补充说明

作用范围：配置在 ~/.claude/ 为用户级，对所有项目生效。若只想对特定项目生效，将 hooks 配置放到项目的 .claude/settings.json 中即可。
hook 不能修改命令：PreToolUse hook 目前只支持 allow / block / ask 三种决策，无法直接改写即将执行的命令。依赖 Claude 读取 reason 后自动纠正，实际效果等价。
前提：系统中需要安装 rg 和 jq。macOS 上 brew install ripgrep jq，其他平台参考各自的包管理器。