# @edspencer/paddock 中文文档 规范地址：https://npmcn.com/package/%40edspencer/paddock/ 版本：0\.83\.1 npm 元数据更新时间：2026-11-05T11:07:32.155Z 中文译文更新时间：2026-11-13T07:25:12.330Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40edspencer/paddock 原文对照：https://npmcn.com/package/%40edspencer/paddock/?lang=original 项目主页：https://github.com/edspencer/paddock#readme 源码仓库：https://github.com/edspencer/paddock ## 关键信息（来自 npm 元数据） - 包体积（解压后）：7.9 MB，413 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=22 - 运行依赖：13 个 - 首次发布：2026-08-02T23:17:13.835Z - 最新版本发布：2026-11-05T11:07:31.815Z - 近 30 天下载量：2175（2026-10-13 至 2026-11-11，npm 官方下载统计） - 已发布版本数：47（近 12 个月 47 个） ## 中文简介 Claude Code项目首个发射板:由服务器主持、持续、可恢复的会议,由项目组织. ## 安装 ```sh npm install @edspencer/paddock ``` 也可以使用：`pnpm add @edspencer/paddock`、`yarn add @edspencer/paddock`、`bun add @edspencer/paddock` ## README # 贴纸 **Claude Code项目首发纸板** ——服务器托管,持续,可恢复 由项目组织,通过网络UI. ```sh npx @edspencer/paddock ``` 然后打开 [http://127.0.0.1:7233 (中文(简体) )](http://127.0.0.1:7233/)。 。 。 . 或者指点你已经做过的工作,看 [打开自己的项目](https://npmcn.com/package/%40edspencer/paddock/#readme-open-your-own-project)。 。 。 . > **首跑下载~250MB.** 帕多克驱动克洛德密码和克洛德密码 SDK特工每平面一个大小的二进制 无法跳过.. 安装方式 `--omit=optional` 制作一个帕多克,他的聊天都失败了. 后运行再使用 npm 缓存并立即启动 。 重复使用时, `npm i -g @edspencer/paddock` 比赤裸更亲切 `npx`。 。 。 . ## 全权证书 Paddock代表你运行Claude Code,所以它需要Claude的证明: ```sh claude setup-token # Claude Max/Pro export ANTHROPIC_API_KEY=sk-ant-… # or API billing ``` **如果你已经在这台机器上用克洛德密码了 那没什么可做的了.** 贴纸 在数据目录下保留一个Claude自己的家园,但不是自己的登录:它使用 一个你已经拥有的 macOS 键链条目在Mac上,你的 `~/.claude/.credentials.json` 其它处( 符号链接, 从未复制) 。 读取登录 写无所取,而别有所取也. 给帕多克自己的,设置 `claude: { credentials: own }` 内 `/paddock.config.yaml`登录是环境的标志, 或一次性 `CLAUDE_CONFIG_DIR=/claude-home claude login`不管怎么样, 帕多克在启动时说,如果它完全找不到证书的话. ## 帕多克还能做什么 也不会从你身上夺走 `~/.claude` 除了登录: **没有,默认的.**  `CLAUDE.md`, (中文(简体) ), `agents/`, (中文(简体) ), `commands/` 财务报告和审定财务报表 `plugins/` 未加载, 钩子是您的 `settings.json` 绑入工具 使用时不要运行,你的笔录没有被触动,你的 `~/.claude.json` MCP 服务器 未附上。 每个都有一个关键 `/paddock.config.yaml`数字 : ```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` 作为命令行参数,任何本地用户都可以使用 读取: ```yaml 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 }` 内 `/paddock.config.yaml`. (您的语言) _登录_ 实值 已共享,这就是为什么没有任何可登录的——见上文 " 全权证书 " 。 ) ## 选项 ``` -p, --port HTTP/WS port (default 7233) --host Bind address (default 127.0.0.1) -d, --data-dir 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` 先说 见 [自动](https://github.com/edspencer/paddock/blob/main/AUTH.md)。 。 。 . ## 所需资源 节点.js 22或更新. ## 其他操作方法 在此套件旁发布多条形 Docker 图像, 效果更好 适合服务器部署 : ```sh 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 令牌,所以设置一个认证模式或一个 在将端口暴露于网络之前,在它前面反向代理. ## 链接 - [文档](https://github.com/edspencer/paddock#readme) - [问题](https://github.com/edspencer/paddock/issues) - 建造在 [草药](https://github.com/edspencer/herdctl) 麻省理工学院 Ed Spencer ## 常见问题 ### @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 和提交记录判断。