# @claudinite/setup 中文文档

规范地址：https://npmcn.com/package/%40claudinite/setup/

版本：1\.1\.0
npm 元数据更新时间：2026-10-22T18:53:40.028Z
中文译文更新时间：2026-11-10T00:16:54.508Z
软件包许可：UNLICENSED

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40claudinite/setup
原文对照：https://npmcn.com/package/%40claudinite/setup/?lang=original
项目主页：https://github.com/Claudinite/Installer#readme
源码仓库：https://github.com/Claudinite/Installer

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：39 kB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-10-19T18:50:39.708Z
- 最新版本发布：2026-10-22T18:53:39.554Z
- 近 30 天下载量：2013（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：6（近 12 个月 6 个）

## 中文简介

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

## 安装

```sh
npm install @claudinite/setup
```

也可以使用：`pnpm add @claudinite/setup`、`yarn add @claudinite/setup`、`bun add @claudinite/setup`

## README

# @ claudinite/ 设置

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

```sh
npx --yes @claudinite/setup@1.0.1
```

在仓库中运行( 或通过) `--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 领养 从它:

```sh
npx --yes @claudinite/setup@1.0.1 && .claudinite/bin/cn adopt <packs>
```

## 在 GitHub 动作

```yaml
      - 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/setup@1.0.1
```

## 更新

```sh
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 是什么？

安装 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 和提交记录判断。