# @ccsk/cli 中文文档

规范地址：https://npmcn.com/package/%40ccsk/cli/

版本：1\.2\.4
npm 元数据更新时间：2026-07-01T09:12:35.765Z
中文译文更新时间：2026-11-09T10:52:26.390Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：354 kB，96 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20\.0\.0
- 运行依赖：6 个
- 首次发布：2026-05-28T15:02:40.971Z
- 最新版本发布：2026-07-01T09:12:35.417Z
- 近 30 天下载量：2872（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 21 个）

## 中文简介

Claude Code Starter Kit CLI——一个命令中的脚手架Claude准备项目

## 安装

```sh
npm install @ccsk/cli
```

也可以使用：`pnpm add @ccsk/cli`、`yarn add @ccsk/cli`、`bun add @ccsk/cli`

## README

# @ccsk/ cli (中文(简体) )

**在一个命令中安装完整的 Claude 码包——并选择版本 .**

`ccsk init`

[![npm version](https://img.shields.io/npm/v/@ccsk/cli.svg?color=D97757)](https://www.npmjs.com/package/@ccsk/cli) [![downloads](https://img.shields.io/npm/dm/@ccsk/cli.svg?color=3F9B6B)](https://www.npmjs.com/package/@ccsk/cli) [![node](https://img.shields.io/node/v/@ccsk/cli.svg)](https://nodejs.org/) [![license](https://img.shields.io/npm/l/@ccsk/cli.svg?color=1A1A1A)](https://npmcn.com/package/%40ccsk/cli/#readme-license) [![platforms](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-6B7280.svg)](https://npmcn.com/package/%40ccsk/cli/#)

> 停止手工滚动 `CLAUDE.md`代理,规则,和文件 每回. `ccsk init` 安装 [**ccsk-kit (英语)**](https://github.com/ccsk-org/ccsk-kit) Claude Code 调用为一种 **插件** 并实现了合同 与您的项目 **版本拾取器** 所以,你选择稳定包 或选择进入一个β.

* * *

## 要点

-   🚀 **一个命令到生产** —— 说 `ccsk init` 你的退款已经准备好.
-   🎚️ **选择您的套装版本** ——交互式取取器列出可用的版本;默认情况下稳定,预发取取入(`--pre` 编号 : `--version`) (中文(简体) ). 发现 `ccsk versions`。 。 。 .
-   🧩 **插件+已实现的合同** - 安装 `ccsk@ccsk-kit` Claude 代码插件 `/ccsk:` 命令、代理、技能)和副本 `CLAUDE.md`, (中文(简体) ), `.claude/rules`, (中文(简体) ), `docs/`,以及 `.ccsk/` 进入你的项目.
-   📦 **获取缓存( S)** - 浅层的包并缓存到 `~/.ccsk/kit/<version>` 为快速重新安装.
-   🔐 **意识** 探测SSH/ `gh` CLI 并引导您, 如果访问缺失( 工具箱是私人的 ) .
-   🛟 **无损再动** —— 从不默默地覆盖: 已有文件被备份到 `.bak` (或保留,同时附上ccsk副本为: `.ccsk.bak`) (中文(简体) ).  `.ccsk/` 记忆始终得到保存; `uninstall` 默认保存( 在任何清洗前备份) .
-   🎨 **可选额外项目** 工具设置(gh- RTK- 上下文模式- Serena MCP),ADD方法,以及设计参考文献—— 全部可跳出.
-   💻 **跨平台 & CI 友好** • macOS/Linux/Windows; `-y` 非交互运行.

* * *

## 快开始

> 全球CLI工具,而非项目依赖. 要求数 **节点 20**。 。 。 .

```bash
npm i -g @ccsk/cli
# or: pnpm add -g @ccsk/cli · yarn global add @ccsk/cli · bun add -g @ccsk/cli

ccsk auth          # verify GitHub access (kit repo is private)
ccsk versions      # see available kit versions (stable + beta)
ccsk init          # install — pick a version when prompted
claude             # open Claude Code
/ccsk:plan <goal>  # start the Build Cadence (v2 kit)
```

![ccsk init terminal walkthrough with the version picker](https://raw.githubusercontent.com/ccsk-org/ccsk-cli/main/.github/assets/terminal-init.png)

* * *

## 如何运作

`ccsk init` 已意识到并缓存 **非破坏性** ——它从不默默地覆盖您编辑过的文件(它问如何处理冲突并总是保存副本——见 [安全重点备份( S)](https://npmcn.com/package/%40ccsk/cli/#readme-safe-re-init--backups), (中文(简体) ), **保护你 `.ccsk/` 内存**永远不要碰你的密码 上面还写了一条栅栏 `.gitignore` (默认忽略了AI的文物)并安装了克洛德代码插件.

![ccsk init pipeline: confirm, auth, version, fetch, materialize, plugin, ready](https://raw.githubusercontent.com/ccsk-org/ccsk-cli/main/.github/assets/install-flow.png)

有两件事: **插件** 提供 `/ccsk:` 指挥、代理和技能 **合同** (单位:千美元)`CLAUDE.md`, (中文(简体) ), `.claude/rules`, (中文(简体) ), `docs/`, (中文(简体) ), `.ccsk/`) 被实现到您的工程中(一个插件不能拥有工程根文件):

![Before and after: a bare project versus a ccsk-equipped one](https://raw.githubusercontent.com/ccsk-org/ccsk-cli/main/.github/assets/whats-installed.png)

见 [**ccsk-kit (英语)**](https://github.com/ccsk-org/ccsk-kit) 建 Cadence 的重置( R)`Frame → Forge → Prove → Sign-off`)和全方法.

* * *

## 安全重点备份( S)

重运行 `ccsk init` 在现有项目中是安全的: **从不默默地覆盖** 你碰过的文件 当工具包文件已经存在时,您会得到一个 **三方选择** 适用于每个相冲突文件,安装总是进行(它从未在中途中止):

![Safe re-init: Overwrite backs your file up to .bak then writes the ccsk version; Keep mine leaves yours live and writes the ccsk version alongside as .ccsk.bak; Cancel aborts](https://raw.githubusercontent.com/ccsk-org/ccsk-cli/main/.github/assets/init-safe-backup.png)

-   **覆盖** - 您的现有文件已备份到 `<name>.<ext>.bak`,那么ccsk版本就用它来写. 您的编辑可以恢复 .
-   **留着我的** – 您的文件没有被更改, ccsk 版本被同时写入为 `<name>.<ext>.ccsk.bak`,可以自行调整或合并.
-   **取消** —— 中止安装( 逃生舱口) ; 您的工程完全留在原地 .

非交互式运行( E)`--yes`, (中文(简体) ), `--force`,或 CI)默认为保险箱 **覆盖备份** 行为——没有文件就永远不会被销毁 `.bak` 先抄过来  `.ccsk/` 内存(计划、日记、发展成果评估、回顾、里程碑)是 **总是保留** 永远不要过份,永远不要退缩.

* * *

## Kit 版本频道( C)

CLI的版本意识: **默认情况下稳定,预放出可选入.** 一个平地 `ccsk init` (或 `--yes`/CI)安装最新的 **稳定** 工具包; 您只能通过交互式拾取器达到一个β, `--pre`,或精确 `--version`。 。 。 .

![Stable (default) vs beta (opt-in) kit channels](https://raw.githubusercontent.com/ccsk-org/ccsk-cli/main/.github/assets/kit-channels.png)

```bash
ccsk versions                       # list available (remote) + cached + current
ccsk versions --all --pre           # include every prerelease
ccsk init                           # interactive: pick a version (default = latest stable)
ccsk init --pre                     # newest prerelease (e.g. the v2 beta)
ccsk init --version 2.0.0-beta-01   # an exact version (a leading v is fine too)
```

> **头( 当前状态) :** v2 套装 (`/ccsk:` 结肠命令)作为先发制人的船只 **`2.0.0-beta-01`**; 最新数据 **稳定** 实值 **页:1** (老年人) `/ccsk-plan` 连字符命令). 所以,默认 `ccsk init` 安装 v1.1.0 — 使用 `--pre` 编号 : `--version 2.0.0-beta-01` /取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取 一个赤裸的 `ccsk update` 从来没有自动降级: 如果你在更新的β上,它就留在原地.

* * *

## 命令参考

| 命令 | 它会做什么 | 密钥旗 |
| --- | --- | --- |
| `ccsk init [path]` | 安装套件( 拾取器 + 插件 + 实现) | `--version <v>` • 妇女 `--pre` • 妇女 `--force` • 妇女 `--no-plugin` • 妇女 `--plugin-scope <project|user>` • 妇女 `--no-setup` • 妇女 `--no-add` • 妇女 `-y, --yes` |
| `ccsk versions` | 列出可用的 + 缓存 + 当前套件版本 | `--all` • 妇女 `--pre` • 妇女 `--json` |
| `ccsk auth` | 请检查gitHub auth (kit repo 是私有的) | —— 说 |
| `ccsk update [version]` | 更新 **CLI + 工具包模板+插件** 一起行动 | `--path <dir>` • 妇女 `--force` • 妇女 `--kit-version <v>` • 妇女 `--pre` • 妇女 `--plugin-scope <…>` • 妇女 `--no-templates` • 妇女 `--no-plugin` |
| `ccsk cache` | 管理缓存套件版本( 注释当前/( β)/ cached) | `-l, --list` • 妇女 `--version <v>` • 妇女 `--clear` • 妇女 `--clear-all` |
| `ccsk uninstall [path]` | 删除套件( 默认保存内存) | `--purge-memory` (回击至) `.ccsk.bak-<ts>/` · 第1类 `-y, --yes` |
| `ccsk doctor` | 诊断节点 / git / auth / 缓存 | —— 说 |
| `ccsk design [path]` | 添加一个 `DESIGN.md` 参考(70+设计系统) | —— 说 |
| `ccsk donate` | 通过VietQR支持维护者 | —— 说 |

全球: `-h, --help` • 妇女 `-v, --version`。信封: `CCSK_DEBUG=1` · (刺痕) `CI=1` (残疾提示).

```bash
ccsk init --version 1.2.0 --no-add -y   # pin a kit version, skip ADD, non-interactive
ccsk init --pre                          # opt into the newest prerelease kit
ccsk update --no-plugin                  # refresh CLI + templates, leave the plugin
ccsk uninstall --purge-memory            # remove everything (memory backed up first)
```

`update` 是一个三层非吸收操作: 它自更新 CLI, 将工具包模板( 保存您的内存) 重新物质化, 并运行 `claude plugin update ccsk` ——全部被固定在一个已解析的版本上,所以插件和模板永远不会漂移. 这个 **CLI 自我更新总是运行**,但套件层(templates + 插件)已实现 **仅在已有的 ccsk 工程中** (目录为 `.ccsk/` 或已实现 `.claude/skills/ccsk-*`)——如此地跑动 `ccsk update` 在一个无关的目录里 不会分散文件包 要安装到新目录中, 请用 `--path <dir>` 或通过 `--force`。 。 。 .

* * *

## 工具设置

`ccsk init` 提供可选设置通道( 使用 `--no-setup`电线,一意孤行,不因故障而中断:

-   **`gh` 国 际** 如果缺少,则安装(用于 GitHub auth 到私人工具包回波) .
-   **东帝汶** - 安装 `rtk` 运行 `rtk init` 以启用它的克洛德密码钩.
-   **上下文模式** 登记 `context-mode` MCP服务器(+打印手动插件步骤).
-   **瑟琳娜** 登记Serena MCP服务器(如果 `uv`编号 :`uvx` ) (第3条).

这个 `ccsk` 插件本身安装于 `init` (与 `--no-plugin`);如果 `claude` CLI没有找到,它印出一个提示,你以后可以重新运行.

* * *

## 与 ADD 相关的工作

[**AI-驱动开发**](https://github.com/pilotspace/ADD) 这是人工智能写代码的方法 而人类自己 方向和核实 **说明 情况 合同 试验 建立 核查**。 。 。 . `ccsk init` 可以安装它( a)`npx @pilotspace/add`; 跳过 `--no-add`:

-   **页:1** 脚手架 Claude 代码插件(命令/代理人/技能) + 规则、文件 `.ccsk/` 记忆.
-   **异常值** 在上方添加规格第一,测试驱动的回路.

* * *

## 隐私

-   `init` 给您的工程写一个有栅栏的块 `.gitignore` 无视人工智能文物的`.ccsk/`,循环日志,.)默认情况下,有被评论的选入行来承诺团队共享的合同/备忘录.
-   `init` 本地记录已安装的版本( e)`~/.ccsk/install.json`发送 **选项**,fire-和-forgets 安装遥测(GitHub 用户名+您可能拒绝的电子邮件). 没有读取或上传代码 .

* * *

## 解决问题

| 问题 | 修补 |
| --- | --- |
| `command not found: ccsk` | 将您的全球垃圾桶添加到 PATH 中 。 无 : `$(npm prefix -g)/bin`. 包头: `~/.bun/bin`。 。 。 . |
| `Permission denied (publickey)` 编号 : `GitHub authentication required` | 运行 `ccsk auth` 并遵循步骤(SSH 键,或 `gh auth login`) (中文(简体) ). |
| 插件步骤已跳过 | 这个 `claude` 找不到 CLI —— 安装 Claude 代码, 然后重新运行 `ccsk init`。 。 。 . |
| `No stable kit release yet` 在 CI 语句中 | 非交互跑步不能自动选择预放——通过 `--version <v>` 或者说 `--pre`。 。 。 . |
| Spinner 显示原始文本 | 在CI或被管入时——动画优雅地降解. |
| 还有其他事要办 | 运行 `ccsk doctor`,或 `CCSK_DEBUG=1 ccsk <cmd>` 为堆积痕迹. |

* * *

## 捐款

发言是值得欢迎的——首先就小问题提出一个问题.

-   **常规承诺**数字 : `feat:`, (中文(简体) ), `fix:`, (中文(简体) ), `docs:`, (中文(简体) ), `refactor:`, (中文(简体) ), `test:`, (中文(简体) ), `chore:`
-   **跨平台**:尽可能在macOS / Linux / Windows上进行测试.
-   **紧紧的**:未经讨论,没有新的全球工具.

见 [文件/建筑图](https://npmcn.com/package/%40ccsk/cli/docs/architecture.md) 模块级细节和 [相关内容](https://npmcn.com/package/%40ccsk/cli/RELEASING.md) 释放流.

* * *

## 支持项目

```bash
ccsk donate    # buy the maintainer a coffee via VietQR
```

* * *

## 链接许可( L)

-   齐克特 [**ccsk-kit (英语)**](https://github.com/ccsk-org/ccsk-kit) · 问题 [ccsk-cli/问题](https://github.com/ccsk-org/ccsk-cli/issues) · 讨论 [ccsk-cli/讨论](https://github.com/ccsk-org/ccsk-cli/discussions)
-   许可证 + **麻省理工学院** (见 [自由主义](https://npmcn.com/package/%40ccsk/cli/LICENSE)(中文(简体) )

## 常见问题

### @ccsk/cli 是什么？

Claude Code Starter Kit CLI——一个命令中的脚手架Claude准备项目

### 如何安装 @ccsk/cli？

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

### @ccsk/cli 支持 TypeScript 吗？

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

### @ccsk/cli 支持 ESM 还是 CommonJS？

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

### @ccsk/cli 需要什么版本的 Node\.js？

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

### @ccsk/cli 可以商用吗？

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

### @ccsk/cli 的下载量有多少？

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

### @ccsk/cli 还在维护吗？

最新版本 1\.2\.4 发布于 2026/07/01（4 个月前）；至今共发布 21 个版本，其中过去 12 个月发布了 21 个；首次发布于 2026/05/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。