@claudinite/setup

中文文档
1.1.0发布于 2026/10/23UNLICENSEDES Module零依赖构建来源已验证近 30 天下载 2013

安装 Claudinite 引擎 一个寄存器针并链接 .claudinite/bin/cn .

中文使用文档
文档目录6 节
  1. 在通过的数据库中
  2. 采用存储器
  3. 在 GitHub 动作
  4. 更新
  5. 当它失败时
  6. 释放

@ claudinite/ 设置

安装 Claudinite 引擎一个寄存器针并链接 .claudinite/bin/cn 对它.

npx --yes @claudinite/[email protected]

在仓库中运行( 或通过) --repo DIR) (中文(简体) ). 然后运行 .claudinite/bin/cn。 。 。 .

在通过的数据库中

安装器读取 engine.version 财务报告和审定财务报表 engine.manifest 从 .claudinite/settings.yaml下载 释放 manifest.json 这个平台的二进制从npm。 若为 engine.releases 名称为 GitHub 存储器,它读取存储器的发布。 然后检查三件事:

  • 货单是sha512对 engine.manifest 针;
  • 克洛迪尼特关键仪式的根基 上 的签名 install.mjs· ;
  • 二进制的sha256与清单对齐.

已校验的文件被缓存为只读 ${XDG_CACHE_HOME:-~/.cache}/claudinite/<version>,则 缓存文件夹必须是模式 0700 。 每次运行再次检查缓存,所以热跑下载什么也没有.

引擎版本总是来自 settings.yaml。您名下的安装器版本 @ 仅限 修改下载和检查的代码。 指定确切的版本 : latest 会运行什么是 下册.

采用存储器

没有 settings.yaml,安装器安装最新 @claudinite/cli,或以 --version。下载时将对照 npm 的完整性和签名进行核对,以便您可以运行 cn 领养 从它:

npx --yes @claudinite/[email protected] && .claudinite/bin/cn adopt <packs>

在 GitHub 动作

      - uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
        with:
          path: |
            ~/.cache/claudinite
            ~/.npm/_cacache
          key: cn-${{ runner.os }}-${{ runner.arch }}-${{ hashFiles('.claudinite/settings.yaml') }}
          restore-keys: cn-${{ runner.os }}-${{ runner.arch }}-
      - run: npx --yes --prefer-offline @claudinite/[email protected]

更新

npx --yes @claudinite/setup@1 update [--to V] [--engine-only | --packs-only] [--dry-run] [--json] [--strict]

update 选择要移动的引擎 。 这是最新版本 寄存器的一格 engine.channel 点数( )latest 页:1 stable, (中文(简体) ), latest 财务报告和审定财务报表 staging 页:1 staging也就是说 较起针头,同为一等相干者,并不得贬值,持有或被撤销. 若为 engine.releases 命名一个寄存器,是寄存器的最新发布. --to 命名确切的版本 相反,这是更古老的版本或新的少校的唯一途径.

它下载和检查引擎 上面,运行它的 selftest --repo 里面没有标志 环境,然后运行它 cn update apply 和旗帜。 应用写出指针 设置、工作流程和包入工作树;审查diff并承诺。 与 没有什么新的,被钉住的引擎运行 update apply 单枪匹马.

退出代码是:0更新或更新,2更新但 --strict 找到一个屏蔽 寻找 当它拒绝时没有写字,而当它无法运行时则有3个.

当它失败时

它可以删除 .claudinite/bin/cn因此,没有其他引擎运行在它的位置。 它解释了为什么 Stderr, 在 Stdout 上打印一行,告诉一个 Claude 会话停止并询问那个人,然后退出 1 。 坏东西 参数出口 2.

HTTPS_PROXY 财务报告和审定财务报表 NO_PROXY 很荣幸. CLAUDINITE_REGISTRY, (中文(简体) ), CLAUDINITE_GITHUB 财务报告和审定财务报表 CLAUDINITE_MAX_DOWNLOAD_BYTES 更改注册,GitHub主机和下载封顶(64 MiB).

释放

提升 version 内 package.json,合并后发送 release 工作流程。 版本不可改变 并仅在安装逻辑时更改.

发送到 preview 发表 <version>-preview.<run> 下划线 preview 三角形,没有 git标签. @1 永远无法解析到预览,所以只能使用精确版本运行它的名称.

版本与发布记录

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

版本发布日期距今
1.1.0latest2026/10/2318 天前
1.1.0-preview.3preview2026/10/2318 天前
1.0.22026/10/2119 天前
1.0.12026/10/2021 天前
1.0.02026/10/2021 天前
0.0.0-stage2026/10/2021 天前

关于 @claudinite/setup 的常见问题

@claudinite/setup 是什么?

安装 Claudinite 引擎 一个寄存器针并链接 .claudinite/bin/cn .

如何安装 @claudinite/setup?

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

@claudinite/setup 支持 TypeScript 吗?

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

@claudinite/setup 支持 ESM 还是 CommonJS?

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

@claudinite/setup 需要什么版本的 Node.js?

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

@claudinite/setup 可以商用吗?

@claudinite/setup 使用 UNLICENSED 许可。作者声明为 UNLICENSED,即不授予公开使用许可(与公共领域的 Unlicense 不同)。使用前需获得作者授权。以上为概括,不构成法律意见,请以许可原文为准。

@claudinite/setup 的下载量有多少?

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

@claudinite/setup 还在维护吗?

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