findscripter iMessage 短信驱动 Claude 会话桥接
何时使用
- 用户说「text Claude」「用手机控制笔记本上的 Claude」「远程驱动 Claude」「想从手机敲代码」「给 Claude 发 iMessage」时。
- 人不在工位、想用短信/iMessage 启动、监督或打断一个长跑的 Claude 会话时。
- 搭一台常驻无头工作站，出差或离开键盘时仍要遥控时。
- 本质是
njerschow/textme守护进程，桥接「手机 iMessage（经 Sendblue）→ 本机 Claude Code 会话」，是入站方向。
不该用：
- 纯出站「任务跑完发短信通知我」——那是 sendblue-notify，靠 Stop 钩子即可，不需要守护进程。
- 想让 Claude 会话中途能主动发短信、但不需要入站遥控——用 Sendblue MCP（见示例 4）更轻。
- 共享机器或带敏感数据的目录——入站短信等于一个由手机号网守的远程命令执行面，慎之。
步骤
- 前置：macOS/Linux 常驻在线主机（守护进程持续轮询 Sendblue）、Node.js 18+、已装并登录的 Claude Code（
npm install -g @anthropic-ai/claude-code）、可用的 Sendblue 账号与已开通的 iMessage 号码（经 sendblue-clisendblue setup/sendblue show-keys拿到 API key/secret）；语音转写可选 OpenAI API key。 - 安装守护进程（git clone + build）。
- 写
~/.config/claude-imessage/config.json，填凭证并把白名单设为「仅本人手机号」。 - 先
npm start试运行，从手机发?确认有响应。 - 跑完验证清单（尤其确认非白名单号码被忽略），再用 pm2/launchd 持久化。
指令
安装：
git clone https://github.com/njerschow/textme.git
cd textme/daemon
npm install
npm run build
mkdir -p ~/.config/claude-imessage
配置 ~/.config/claude-imessage/config.json：
{
"sendblue": {
"apiKey": "YOUR_SENDBLUE_API_KEY",
"apiSecret": "YOUR_SENDBLUE_API_SECRET",
"phoneNumber": "+1SENDBLUE_NUMBER"
},
"whitelist": ["+1YOUR_PHONE"],
"pollIntervalMs": 5000,
"conversationWindowSize": 20
}
whitelist 是入站短信与本机命令执行之间「唯一」的授权闸门，按安全边界对待，绝不为「以防万一」加入共享/工作/家人号码。apiKey/apiSecret 取自 sendblue show-keys，与 CLI 本地的 bearer token（~/.sendblue/credentials.json）不是一回事。
语音转写（可选）在 daemon 目录 .env：
OPENAI_API_KEY=sk-...
运行（试跑）：
cd textme/daemon && npm start
持久化（验证通过后再做）：
pm2 start dist/index.js --name textme && pm2 save && pm2 startup
# 或 macOS：./scripts/install-launchd.sh
内置短信指令（白名单号码发给 Sendblue 号码）：
| 指令 | 作用 |
|---|---|
? |
列出可用指令 |
status |
当前守护进程状态与工作目录 |
queue |
待处理消息队列 |
history |
近期消息历史 |
home |
cd 回 home 目录 |
reset |
回 home 并清空会话历史 |
cd /path |
切换工作目录 |
stop |
取消当前 Claude 任务 |
yes / no |
批准 / 拒绝待确认的操作 |
其余任何内容都当作 Claude 提示词路由到活动会话。
启用前必须验证（任一失败就别开 launchd/pm2 自启）：
- 白名单手机发
status→ 应回目录 + 状态。 - 发
pwd/ls→ 确认输出送达。 - 用「非白名单」号码发消息 → 确认被「忽略」而非回显。
- 杀掉守护进程 → 确认消息停止被处理，无僵尸进程。
示例
初次搭建走查：
sendblue whoami # 1. 确认 sendblue CLI 凭证可用
sendblue show-keys # 2. 取 API key/secret（非 CLI bearer token）
git clone https://github.com/njerschow/textme.git
cd textme/daemon && npm install && npm run build # 3. 编译
# 4. 用 step2 的值填 config.json，白名单只放本人手机号
npm start # 5. 启动，从手机发 "?" 确认响应
与 sendblue-notify 组双向闭环（共用同一 Sendblue 账号，解决相反问题）：
- Claude 跑完长任务 → 经 sendblue-notify（Stop 钩子）发短信给用户。
- 用户回「看下 diff」→ textme 路由进 Claude → Claude 经 Sendblue 回信。
看守护进程日志：
pm2 logs textme # pm2
tail -f ~/.local/log/claude-imessage.log # 独立运行
MCP-only 替代（不要轮询守护进程，只想让 Claude 会话里有 Sendblue 出站工具）：
claude mcp add sendblue_api \
--env SENDBLUE_API_API_KEY=your-api-key \
--env SENDBLUE_API_API_SECRET=your-api-secret \
-- npx -y sendblue-api-mcp --client=claude-code --tools=all
MCP 只给 Claude 出站发送能力，不开入站「手机控制 Claude」通道。目标是「从任何地方 text Claude」选 textme；只是「Claude 会话中能发条短信」选 MCP。
注意事项
- 这是一个「仅靠手机号白名单网守的远程代码执行面」，按此对待。能冒用/劫持白名单号码者即可在主机上驱动 Claude；号码不再需要时及时移除，定期审计白名单漂移。
- 起步只放一个本人号码；以普通用户身份运行，绝不 root/sudo；首测在沙箱目录（
cd ~/textme-sandbox），别在~或真实仓库里跑——启动时的工作目录会被入站短信的ls/cat等暴露。 config.json含 API key/secret 与手机号：chmod 600，绝不入 dotfiles 仓库/云同步/日志/截图。pollIntervalMs保持 ≥ 5000，除非清楚 Sendblue 速率限制与费用；不要公开 Sendblue 号码（即便有白名单，未知发送方的洪水仍耗轮询周期与成本）。- 入站消息是不可信输入，按公网用户输入处理，别管道进
eval/shell 替换或绕过 Claude Code 审查的脚本。Claude Code 权限模型仍生效——破坏性操作仍弹确认，textme 把yes/no暴露给手机号，意味着「该号码」在批准破坏性操作，白名单信任级别必须与之匹配。 - 回信会未脱敏落在锁屏预览，别让 Claude 经短信回吐密钥/令牌/客户数据，改为链接到本地日志或 PR。
- 守护进程是轮询而非推送，消息到 Claude 响应有个位数秒级延迟；一机一会话，两个守护进程共用同一 Sendblue 号会都去处理每条入站消息。
- Sendblue 免费计划：用户手机须先给 Sendblue 号码发过一次短信，Claude 的出站回信才送达；可用
sendblue contacts核验，否则静默发送失败。 - 改白名单/轮换凭证/重启进不可信状态前，记得先停掉自启的 pm2/launchd 守护进程。
互见
- requires：
sendblue-cli—— 账号搭建、凭证管理与show-keys（取 textme 所需的 API key/secret）。 - related：
sendblue-api—— HTTP API 参考，供想自建入站处理器而非用 textme 守护进程者。 - combines_with：
sendblue-notify—— 出站对位（Claude → 手机），与 textme 组成双向闭环；update-config—— 配 Claude Code 的 Stop 钩子等 settings.json 改动。
本条采编自 sickn33/antigravity-awesome-skills（MIT）。