Send Messages to Other Claude Code Sessions

On macOS and Linux sessions running Claude Code v2.1.224 or later, inter-session messaging is available without additional configuration. You can pass changes, decisions, or work status discovered in one session to another, reducing conflicts and redundant explanations during parallel work.

Claude uses ListAgents to find connectable sessions and SendMessage to send messages. You do not need to manually invoke the tools; Claude can send messages based on context, or you can ask it to check the work status of a session in another terminal.

Key use cases include:

• Passing discoveries or breaking changes from one session to sessions working on related tasks
• Sharing changes with sessions working in parallel in separate worktrees
• Checking results of long-running migrations or tests
• Exchanging messages with sessions running on other machines or the web

This feature is suitable for communication between independent sessions that you start and coordinate manually. To move entire conversations or context, use session resumption; for session teams managed by Claude, use agent teams; to control multiple sessions from one place, use agent view; and for delivering external events, use channels. Choose the appropriate feature for each purpose.