一条消息只有一段纯文字，不含对话历史和文件

这是最容易误解的一点，得先说清楚。

一条消息就是一个 Claude 写给另一个 Claude 的一段纯文字。不是对话历史，不是文件，不带上下文。接收方看到的只有发送方的名字和那段文字，对方聊过什么、动过哪些文件，它一概看不见。

文档给的示例消息长这样：

数据库迁移做完了，新字段叫 tenant_id，现在 rebase 到 main 是安全的。

官方文档中的示例消息

就这么一句话。

所以边界也清楚了：如果你想搬的是整个对话，比如换台电脑接着聊，或者让新会话继承现在的上下文，那不该用消息，该用恢复会话（resume）把整个会话续过去。

两个工具由 Claude 自己调用，不用你手动发

这件事背后是两个工具：ListAgents 负责发现能够到哪些会话，SendMessage 负责按名字把消息送过去。

这两个工具你都不用管。Claude 自己判断该不该发、发给谁，连措辞也是它自己写的。你要做的只是给一句提示，比如告诉它「问问另一个终端里那个会话，迁移跑完了没有」，或者「把我们刚才干的事告诉那个在做支付接口的会话」，具体发出去的是什么话，由它决定。

想自己看一眼能够到哪些会话，敲 /list-agents。列表里会有三类：

NAMING会话的名字从哪来

消息是按名字投递的，名字有三个来源：你用 /rename 改的、启动时用 --name 指定的，或者都没有的话 Claude Code 自己起一个，拿工作目录的文件夹名派生，像 myapp-3f 这样。

两个会话可能重名。/list-agents 的输出会带上各自的工作目录来区分，Claude 自己那份列表还会给每行加一个短标识，撞名的时候就用它来定位。

消息在工具调用间隙送达，有三种结果

消息到了对面，不会打断人家手上的活。接收方的 Claude 是在两次工具调用的间隙读消息的，所以一个正在执行的命令绝不会被打断。如果那个会话当时正闲着，消息会直接开启新的一轮。

至于能不能送到，有三种结果：

消息一旦送达，就按你自己敲的一条提示词计费。送达之后接收方也能同样回复过来，只有跨机器那种单向情况例外。

另一个会话发来的消息不算用户授权

这是整套设计里最讲究的地方。

当 A 会话给 B 会话发消息时，Claude Code 会明确告诉 B：这条消息来自另一个会话，不是来自你的人类用户。然后限制它能干什么，四条限制，每条挡的都是一种具体的坏情况：

发送这一侧同样有约束：Claude 被要求绝不去请另一个会话做那些在自己这边已经被拒绝、被拦下、或者按自己权限设置本来就做不了的事。碰上这种情况，它得把活退回给你，而不是绕道从别的会话干成。

这两侧加起来是同一个意思：跨会话消息是一条传话的通道，不是一条提权的通道。

没配置时按两个会话的权限模式决定送不送

你什么都没设的时候，Claude Code 会看两个会话各自的权限模式来决定。它把会话分成两类：一类会弹提示问你，另一类跳过权限提示直接执行。

（plan 模式在有跳过能力的会话里算「跳过」那一类；auto、acceptEdits、dontAsk 都算「会弹提示」那一类。）

规则是这样的：

乍看有点绕，但背后的逻辑很顺：一个能不问自明就直接执行的会话，最不能随便被外面喂消息，因为它收到什么就会去做什么。所以权限越松的会话，入站反而卡得越严。

DIALOG被扣住之后会发生什么

消息被扣住时，接收方会弹一个审批框，显示发送方和消息预览。三条出路：

• 批准，这一条送给 Claude
• 拒绝，或者把框关掉，这条就丢了
• 放着不管，超过 dialogExpiry 期限（默认五分钟）框会自己关掉，消息丢弃

扣住的消息最多存 100 条，超了丢最老的。如果扣住期间这个会话的权限模式变了，规则会重新过一遍，该放行的放行；要是变成了拒收，扣住的全丢掉，并且给每个够得着的发送方回一个拒绝通知。

发送方那边也看得到动静：消息被扣住时那边会收到通知，后来是送达、拒绝还是过期，也会有个跟进消息。只有一上来就被拒收的，发送方那边没有任何提示。

同机器走本地 socket，跨机器只能回复

消息走哪条路、这边能发什么，全看对方会话在哪儿：

「只能回复」的意思是：必须对方先开口，你这边才能搭话。想主动联系另一台机器上的会话，这条路走不通。

VISIBILITY同机器互通的前提是「看得见同一批文件」

每个会话把自己登记在磁盘上的文件里，并在那儿绑收件箱 socket。Claude 要列出或联系本机会话时，读的就是这些文件，所以两个会话能互相够到的前提，是它们看得见同一批文件。

这条推论很实际：容器有自己的文件系统，所以容器里的会话和宿主机上的会话互相够不着；但同一个容器里的两个会话可以互通，自托管 runner 上也一样。

还有个细节容易踩：跨机器的回复，如果发出时你这边没连着 Remote Control，消息仍然能送到（走对 Anthropic 服务器的直接请求），但不带回信地址，对方没法再回你。Claude 在发的时候会被告知这一点。

想让所有跨出这台机器的消息都要你点头，把 isolatePeerMachines 设成 true。设了之后，哪怕在跳过所有权限提示的模式下，回复要发出本机之前也会问你。任何一个设置层级里写了 true 都算数，所以一个提交进仓库的项目配置能打开这个要求，但关不掉它。同机器之间的消息不受影响。

claude -p 会话也能收消息，socket 给脚本用

无人值守的 claude -p 会话同样会绑收件箱 socket，能收消息，也会出现在列表里，所以一个长跑的 -p 工人可以接收指令。

但这里有个坑：-p 会话弹不出审批框。所以消息一旦被扣住，就一直扣在那儿，除非后来的设置变化把它放行。想让无人值守的工人能自己收消息，得在启动时的 --settings 里把 crossSessionInbound 设成 accept。（设在用户级设置里也行，但那会对你跑的每个会话都生效。）

另外还有一种叫 bare mode 的起法，那种不绑 socket，收不到消息，也不出现在列表里。

SOCKETsocket 在哪，怎么用

两个地方能找到路径：

• /status 里的 Peer address 那一行，路径带 uds: 前缀
• 环境变量 CLAUDE_CODE_MESSAGING_SOCKET，hook 和 Bash 命令都拿得到，而且在任何 hook 跑之前就已经导出了（包括 SessionStart）。每个会话导出的都是自己的，不会继承父会话的

这意味着你可以让一个脚本或者 hook 往自己的会话里投消息。本站实测时拿到的值是 /tmp/cc-socks/27983.sock，那串数字就是会话对应的进程号。

这条路上有个平台差异值得记一下。会话自己的子进程（比如一个 hook 或 Bash 命令）回投消息时，如果能验明来路就直接送达：Linux（包括 WSL 2 里的）连已经退出的子进程都能验；macOS 只能在那个进程还活着的时候验；容器里如果 Claude Code 是 1 号进程，完全没法验。验不了的时候按普通消息处理，于是一个跳过权限提示的会话会把它扣住等你批准。

至于沙箱里的 Bash 命令能不能够到 socket，由沙箱的 Unix socket 设置管（sandbox.network.allowAllUnixSockets 和 sandbox.network.allowUnixSockets）。

收和发分别关闭，各有一个副作用

收和发是两个独立的开关，你可以只关一边：

两个副作用得知道：

第一，拒绝 SendMessage 会连带干掉给子代理和团队成员发消息的能力。因为是同一个工具在服务这两件事，你本意可能只是不想让会话之间互相打扰，结果把会话内部的协作也一并关了。

第二，关掉之后从外面完全看不出来。Claude Code 仍然照常绑 socket，只是把到达的消息全丢掉。一个拒收的会话，在它自己的 /status 里和别人的列表里都没有任何标记，想确认，只能去查它的配置。

跟恢复会话、Agent teams 等的分工对照

Claude Code 里能「多开」的机制有好几套，最容易选错。文档专门列了一段对照，值得抄下来：

一句话区分：跨会话消息管的是「你自己开的、各自独立的会话」之间。由 Claude 生出来并指挥的那批，走的是团队自己的名册；要把上下文整个搬走，那是恢复会话的事。

系统版本服务商的限制，以及消息循环节流

TROUBLESHOOT发不出去时怎么查

敲 /list-agents，两种情况分开看：

命令不认识：这个会话根本没有跨会话消息，照上面那张表一条条对，先从 claude --version 开始。

命令认识，但消息没到：功能是开的，问题在更细的地方，可能是权限拒绝规则把这两个工具摘掉了，可能是接收方的入站控制把消息扣住或丢掉了，也可能对方在另一台机器上（那种只能回不能主动发起）。

LIMITS两条硬限制

只能发纯文本。Agent teams 内部那种结构化的协议消息，出不了团队。

消息循环会被自动掐断。同一个发送方有限流，短时间内到达的完全相同的重复消息会被丢掉，等着 Claude 读的消息每个会话最多堆 50 条。所以两个会话互相刷消息的死循环，会自己停下来，不用你去救。

传过去的只有一段纯文字

接收方看到的只有发送方的名字和一段话，比如「数据库迁移做完了，新字段叫 tenant_id，现在 rebase 安全」。对方聊过什么、动过哪些文件，一概看不到。

Claude 自己判断该不该发，你不用去调用工具

这背后是两个工具：一个负责找到能够到哪些会话，一个负责把话送过去。两个都不用你手动点，Claude 自己判断要不要发、发给谁、措辞怎么写，你能做的只是提一句「问问另一个终端里的会话，数据库迁移做完了没有」。

另一个会话说的话，不算你的同意

消息送到时，Claude Code 会把来源标清楚：这是另一个会话说的，不是你说的。然后被框死能干什么、不能干什么。

会话越敢自己拍板，外面递话进来卡得越严

没配置的情况下，Claude Code 按两边的权限松紧决定送不送：

这背后的道理：一个不问自明就直接执行的会话，外面递话进来的风险更大，所以权限越松的会话，入口反而卡得越紧。

不想要这条通道，收和发能分开关：crossSessionInbound 设成 refuse 关掉接收；加一条权限拒绝规则点名 SendMessage 和 ListAgents 关掉发送，但这会连带关掉会话内部叫子代理帮忙的能力。跑在 Bedrock、AWS、Google Cloud、Microsoft Foundry 上的版本目前都还没有这功能。这条通道只管你自己开的、各自独立的会话，恢复会话、Agent teams 那些其他「多开」机制走的是另一套。