@edspencer/paddock

中文文档
0.83.1发布于 2026/11/05MITES Module构建来源已验证近 30 天下载 2175

Claude Code项目首个发射板:由服务器主持、持续、可恢复的会议,由项目组织.

中文使用文档
文档目录8 节
  1. 全权证书
  2. 帕多克还能做什么 也不会从你身上夺走 ~/.claude
  3. 打开您的项目
  4. 选项
  5. 警卫
  6. 所需资源
  7. 其他操作方法
  8. 链接

贴纸

Claude Code项目首发纸板 ——服务器托管,持续,可恢复 由项目组织,通过网络UI.

npx @edspencer/paddock

然后打开 http://127.0.0.1:7233 (中文(简体) )。 。 。 .

或者指点你已经做过的工作,看 打开自己的项目。 。 。 .

首跑下载~250MB. 帕多克驱动克洛德密码和克洛德密码 SDK特工每平面一个大小的二进制 无法跳过.. 安装方式 --omit=optional 制作一个帕多克,他的聊天都失败了. 后运行再使用 npm 缓存并立即启动 。 重复使用时, npm i -g @edspencer/paddock 比赤裸更亲切 npx。 。 。 .

全权证书

Paddock代表你运行Claude Code,所以它需要Claude的证明:

claude setup-token                  # Claude Max/Pro
export ANTHROPIC_API_KEY=sk-ant-…   # or API billing

如果你已经在这台机器上用克洛德密码了 那没什么可做的了. 贴纸 在数据目录下保留一个Claude自己的家园,但不是自己的登录:它使用 一个你已经拥有的 macOS 键链条目在Mac上,你的 ~/.claude/.credentials.json 其它处( 符号链接, 从未复制) 。 读取登录 写无所取,而别有所取也.

给帕多克自己的,设置 claude: { credentials: own } 内 <data-dir>/paddock.config.yaml登录是环境的标志, 或一次性 CLAUDE_CONFIG_DIR=<data-dir>/claude-home claude login不管怎么样, 帕多克在启动时说,如果它完全找不到证书的话.

帕多克还能做什么 也不会从你身上夺走 ~/.claude

除了登录: 没有,默认的.  CLAUDE.md, (中文(简体) ), agents/, (中文(简体) ), commands/ 财务报告和审定财务报表 plugins/ 未加载, 钩子是您的 settings.json 绑入工具 使用时不要运行,你的笔录没有被触动,你的 ~/.claude.json MCP 服务器 未附上。 每个都有一个关键 <data-dir>/paddock.config.yaml数字 :

claude:
  transcripts: host    # own | host, default own — whose session transcripts
  credentials: host    # own | host, default host — the one shared by default
  instructions: host   # own | host, default own — CLAUDE.md, agents, commands, plugins
  hooks: host          # own | host, default own — shell commands settings.json binds
  mcpServers: host     # own | host, default own — the servers in your ~/.claude.json

instructions: own 值得知道,如果你已经拥有一个 ~/.claude/CLAUDE.md数字 : 你的帕多克探员不会看到它 直到你准备好 host。每个项目本身 CLAUDE.md 总是适用. hooks 默认关闭是因为继承某人的 shell 命令是 事实发生后,你没有发现什么 settings.json - 授权, 模式,状态线——以两种方式适用.

要给这个实例一个 MCP 服务器 您的机器没有—— 案件 host 无法服务——在 兄长 mcpServers: 块,使用 env:VAR_NAME 任何字符串去的地方,令牌会留在已跟踪的文件之外 (保持状态) driveMode 默认值 session 对于持有证书的服务器 batch 将定义移到 claude 作为命令行参数,任何本地用户都可以使用 读取:

mcpServers:
  notion:
    command: npx
    args: ["-y", "@notionhq/notion-mcp-server"]
    env:
      NOTION_TOKEN: env:NOTION_TOKEN

打开您的项目

一个全新的实例是空的,所以它打开 发现读到你的克洛德 代码历史, 研究出您实际在机器上的目录 使用 claude 并将其作为项目提供,包括对话、最后使用 日期和遥控器,你可以分辨它们.

选中您想要的并按导入 。 每一个都成为一个项目 指向这一点 目录,其对话作为聊天复制后,您可以恢复——所以不用 您正在查看您自己的作品 。 请先展出一行 宁可挑个人谈话 也不要拿那么多 发现留在侧边栏 之后;它不仅仅是一流的屏幕.

您导入的目录中没有任何内容 . 没有 .paddock/,没有 .chats/, (中文(简体) ), 没有 .gitignore 编辑, 不 CLAUDE.md。项目记录和复制记录 两者都活在数据目录中,项目只是指向路径.

 ~/.claude 也没有触摸. 译名为 复制,与他们的 时间戳保留下来——原作从未被移动或删除,您的终端 claude 一直和以前一样工作 分享 一个 一组记录 Paddock和你的终端 而不是保存副本,设定 claude: { transcripts: host } 内 <data-dir>/paddock.config.yaml. (您的语言) 登录 实值 已共享,这就是为什么没有任何可登录的——见上文 " 全权证书 " 。 )

选项

  -p, --port <port>       HTTP/WS port (default 7233)
      --host <host>       Bind address (default 127.0.0.1)
  -d, --data-dir <path>   Projects + state (default ~/.paddock)
  -o, --open              Open the app in your browser once it is listening
      --verbose           Show the server's own logs (quiet by default)
  -v, --version           Print the version
  -h, --help              Show help

您的工程、 聊天和设置在运行之间持续存在 ~/.paddock,或在何处 --data-dir 点。 它是一个目录: 移动它来移动您的实例, 删除它到 重新开始。 你从哪里跑 paddock 从没有影响 你得到哪个实例.

警卫

贴纸绑定 只循环 无法认证, 右侧 笔记本电脑的默认值。 这个 拒绝开始 如果您绑定了可调节接口 当认证被关闭时——在网络上曝光,配置 PADDOCK_AUTH_MODE 先说 见 自动。 。 。 .

所需资源

节点.js 22或更新.

其他操作方法

在此套件旁发布多条形 Docker 图像, 效果更好 适合服务器部署 :

docker run -d -p 127.0.0.1:7233:7233 -v /srv/paddock-data:/data \
  -e CLAUDE_CODE_OAUTH_TOKEN=… \
  -e PADDOCK_DANGEROUSLY_ALLOW_OPEN=1 \
  ghcr.io/edspencer/paddock:latest

PADDOCK_DANGEROUSLY_ALLOW_OPEN=1 需要: 图像绑定 0.0.0.0 编辑 默认认证模式为 none,而 Paddock 拒绝绑定路由界面 除非被告知,否则不作认证。 出版时间: 127.0.0.1: 是什么让 安全 —— Paddock 运行代码并使用 Claude 令牌,所以设置一个认证模式或一个 在将端口暴露于网络之前,在它前面反向代理.

麻省理工学院 Ed Spencer

版本与发布记录

@edspencer/paddock 共发布 47 个版本,首次发布于 2026/08/03;过去 12 个月发布了 47 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.83.1latest2026/11/058 天前
0.83.02026/11/058 天前
0.82.12026/11/058 天前
0.82.02026/11/058 天前
0.81.02026/11/058 天前
0.80.02026/11/058 天前

其他发布通道:bootstrap → 0.0.1。

关于 @edspencer/paddock 的常见问题

@edspencer/paddock 是什么?

Claude Code项目首个发射板:由服务器主持、持续、可恢复的会议,由项目组织.

如何安装 @edspencer/paddock?

在项目目录运行 npm install @edspencer/paddock,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 paddock,可以用 npx paddock 直接运行。

@edspencer/paddock 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/edspencer__paddock 是否存在。

@edspencer/paddock 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@edspencer/paddock 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@edspencer/paddock 可以商用吗?

@edspencer/paddock 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@edspencer/paddock 的下载量有多少?

根据 npm 官方下载统计,@edspencer/paddock 在 2026/10/13 – 2026/11/11 这 30 天内被下载 2,175 次,日均约 73 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@edspencer/paddock 还在维护吗?

最新版本 0.83.1 发布于 2026/11/05(8 天前);至今共发布 47 个版本,其中过去 12 个月发布了 47 个;首次发布于 2026/08/03。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。