claude-share README

项目的 README,来自 github.com/Paradigm-Study/claude-share。合并为一个 markdown 文件:README.md。

Shared Sessions for Claude Code

Install · Quick start · Commands · Full guide · Contribute

What you get

Share a Claude Code session with a link, and a teammate joins it from their own Claude Code. They see your prompts, replies and tool results live, and they can prompt Claude on the same code. Their prompts run on your machine, and by default each edit, command or network call asks you first.

A teammate's invitation above the composer in Claude Desktop

Watch the 90-second demo. Recorded with fictional teammates; credits. Works in Claude Desktop and the terminal, on a public server or your own.

Install

Both people need Claude Code 2.1.286 or later (claude --version) and this plugin:

claude plugin marketplace add Paradigm-Study/claude-share
claude plugin install shared-session@claude-share

Start a new session after you install. In Claude Desktop, quit and reopen the app.

Is your terminal claude older than the one Claude Desktop bundles? Run the setup script instead. It needs Git and Node 22.18+:

git clone https://github.com/Paradigm-Study/claude-share.git && cd claude-share
node scripts/setup.ts join

join installs the plugin for sharing and joining. If it prints NEEDS HUMAN, do that step and run it again. More install options.

Quick start

Before you share: anyone with the link can join. The session goes through the room server, encrypted in transit but not end to end. See Privacy. In a session that already has messages, Share asks whether to send them. Choose Only from now on to leave them out.

  1. Host: press Share above the prompt, or type /share-session. Copy the link.
  2. Teammate: paste the link into a new Claude Code session and send it.
  3. Teammate: ask Claude to read the README. The prompt runs on the host's machine, and both sessions show the reply and tool calls.
  4. Host: type /stop-sharing. The room ends for everyone.

Commands

Command Does
/share-session Share this session. Add watch so teammates can only watch, or new to leave out earlier messages
/stop-sharing Host: end the room for everyone. Guest: leave it
/room People, timeline, changed files, side chat, settings
/who Who is here, and what each person is doing
/share-preview <port> Host: let teammates open a local web server
/share-file <path> Host: show a file to everyone
/team Sign in, make a team, and see its shared sessions
/invite <name> Invite a teammate into this session. Needs sign-in and a shared team

Every command, previews and the cloud host.

How it works

Shared Sessions architecture: the host and guests talk to the room server on Cloudflare, a main Worker and a preview Worker in front of Durable Objects, with storage and external services

The host's machine does all the work. A guest's prompt goes through the room server to the host's Claude Code, which runs it as a turn of its own.

By default, every edit, command and network call that a guest's prompt makes asks the host first, agents included. A call the host does not answer is declined.

Guests see the host's tool calls replayed in their own Claude Code. A replay runs nothing on the guest's machine, and the guest's model is never called. Permissions, files and preview boundaries.

Privacy

The link is the key. Anyone with it can join, unless you limit the room to a team.

The room server receives the shared transcript, tool results, chat and files. Traffic is encrypted in transit, not end to end. The public server deletes a room and its files 24 hours after the host stops or was last seen. It keeps no analytics and no request logs.

Only a server that turns on traces keeps a session's turns for its team to search. The public server does not.

A browser signed in to the server's dashboard (/app) keeps its sign-in in a cookie. The server keeps only its hash. A browser sign-in lasts 30 days. Signing out, or deleting your account, ends it at once.

A preview page left open in a browser can reach the previews of a session that browser opens next. Close previews from a session you do not trust before you open another one's.

A session moved to the cloud sends your project files, conversation and Claude token to a container. The container is deleted when you bring the session home, the room ends, or a week passes.

What the server keeps, and for how long.

Troubleshooting

More troubleshooting · Known limits · Report a bug

Host your own server

node scripts/setup.ts deploy

This deploys the room server to your Cloudflare account. It needs Node 22.18+, and a person must approve the browser sign-in. To use a server that already exists: node scripts/setup.ts host --server https://your-server. Cloudflare and team sign-in setup.

Develop

The plugin is in plugin/. The room server is in server/. CONTRIBUTING.md covers tests. AGENTS.md records setup and the release steps. docs/rules/ records the rules the design keeps.

License

MIT. The Paradigm name, logo and Clover character are trademarks of Paradigm Study. Demo music has its own terms.

claude-share (Paradigm-Study/claude-share)

正在搜索数据库…

这是什么?Shared Sessions 可以让你和同事一起加入同一个 Claude Code 会话:你们能实时看到彼此的提示词、流式输出的回复、工具结果和预览,而所有运算都在主持人的电脑上完成。
它是 Claude Code 插件还是独立应用?它是一个运行在你现有 Claude Code 安装环境(桌面版或终端版)中的插件,外加一个用于转发共享会话的小型房间服务器;它不是独立应用。
我该如何安装并开始共享会话?在运行受支持 Claude Code 版本的终端中安装插件,并将分享服务器设置留空,默认使用公共服务器。然后点击 Share 或输入 /share-session 获取链接,同事将该链接粘贴到他们自己新开的 Claude Code 会话中。
除了 Claude Code,我还需要什么?双方都需要安装 2.1.286+ 版本的 Claude Code 以及该插件;如果你同时有桌面版自带的较新 Claude Code 和较旧的终端 CLI,安装脚本需要 Git 和 Node 20+ 才能在 macOS 上定位到它。
访客无法看到或做什么?访客只能看到每个工具结果的前 40 行,子代理的内部步骤完全不会同步;部分查看器和会话列表功能仅限桌面版使用;默认情况下,访客要求编辑文件、运行命令或使用网络,必须先经主持人批准。
我能否运行自己的服务器,而不使用公共服务器?可以。希望使用自有基础设施的团队可以将房间服务器部署为 Cloudflare Worker,或从仓库克隆中运行所附带的 Node 服务器。
共享会话的数据会流向哪里?所有共享内容都会经过房间服务器(默认为公共服务器),包括会话记录、工具结果、侧边聊天和文件;传输过程中的流量会加密,但并非端到端加密;主持人停止分享后 24 小时,房间会被删除。
主持人能否控制访客在其电脑上的操作?能。默认情况下,访客要求编辑文件、运行命令或访问网络时,会先征求主持人的同意;对于只需观看的访客,还可以使用仅观看模式。
公共房间服务器有大小限制吗?公共服务对每个房间的人数上限为 20 人,共享文件总量上限为 100 MB;主持人停止分享或最后一次在线后 24 小时,房间会被自动删除。
可选的团队功能在基础链接分享之上增加了什么?可选的团队功能增加了登录、进行中会话的实时列表,以及直接显示在 Claude Code 内的邀请。
访客能否看到主持人电脑上运行的本地开发服务器?主持人可以运行 /share-preview 将本地开发服务器共享出去,访客从房间中打开即可访问;不过,本地 TCP 预览需要 Node 20+ 和 POSIX sh,并且主持人必须保持会话和开发服务器处于运行状态。
大小
8.6 MB
星标
1.1K
时长
1个月
提交 · 90 天