# @cdkd/cli 中文文档

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

版本：0\.335\.0
npm 元数据更新时间：2026-11-09T03:27:35.499Z
中文译文更新时间：2026-11-09T07:06:58.943Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40cdkd/cli
原文对照：https://npmcn.com/package/%40cdkd/cli/?lang=original
项目主页：https://cdkd.dev/
源码仓库：https://github.com/go-to-k/cdkd

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

- 包体积（解压后）：13 MB，39 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.12\.0
- 运行依赖：75 个
- 首次发布：2026-11-03T14:00:38.039Z
- 最新版本发布：2026-11-09T03:27:35.194Z
- 近 30 天下载量：4410（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：24（近 12 个月 24 个）

## 中文简介

已存在的 CDK 应用程序的 CDK CLI - 最多 15x 通过直接的 AWS SDK 调用以更快的部署

## 安装

```sh
npm install @cdkd/cli
```

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

## README

![cdkd logo](https://raw.githubusercontent.com/go-to-k/cdkd/main/docs/_site/public/brand/logo-light.svg)

# cdkd (CDK 直接) (中文(简体) )

 [![npm version](https://img.shields.io/npm/v/@cdkd/cli.svg)](https://www.npmjs.com/package/@cdkd/cli)[![Downloads](https://img.shields.io/npm/dw/@cdkd/cli.svg) ](https://www.npmjs.com/package/@cdkd/cli)[![License: Apache-2.0](https://img.shields.io/npm/l/@cdkd/cli.svg)](https://npmcn.com/package/%40cdkd/cli/LICENSE)

### AWS CDK的部署速度最快.

已存在的 CCDK apps 的 Drop-in CDK CLI——通过直接的 AWS SDK 调用,而不是 CloudFormation , 最高可有15x的更快部署.

\* 文档: [**cdkd.dev (英语)**](https://cdkd.dev/)

* * *

-   **CDK 下放兼容性**: 您现有的 CDK app 代码按- 运行; 只替换 `cdk deploy` 与 `cdkd deploy`。 。 。 .
-   **最多15个快速部署**:直接SDK呼叫,主动平行,以及 `--no-wait` 避免缓慢稳定等待; **比Terraform 和 Cloud Formation 快捷模式更快** 也 (参见 [基准](https://npmcn.com/package/%40cdkd/cli/#readme-benchmark)) (中文(简体) ).

![cdk deploy vs cdkd deploy — side-by-side, 35s recording, real AWS deploy. cdkd finishes while cdk is still creating its CloudFormation changeset.](https://raw.githubusercontent.com/go-to-k/cdkd/main/assets/cdk-vs-cdkd.gif)

**cdkd补充了AWS CDK CLI,而不是替换.** 在dev/测试中使用cdkd进行快速迭代;在生产中使用AWS CDK CLI用于全云格式工具. 将 cdkd 安装在已有的旁边 `cdk deploy` 工作流程:不需要迁移。 你也可以这样 [导入](https://cdkd.dev/import/) 已存在堆栈为 cdkd 或 [导出](https://cdkd.dev/export/) 随时回云阵.

**自然适合AI驱动的发展.** AI编码代理器在紧凑的自旋/被撕裂的回路中相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相 `cdkd destroy` 直接删除 SDK 的电话 而不是投票的 Cloud Formation 堆叠删除.

**从你部署的堆栈处死.** `cdkd local` 运行您的函数、 API 和 ECS 任务。 它能从您实际部署的堆栈中解析 Env vars, 秘密和资源引用: 无手写 `.env` 文件,没有手播测试数据(参见 [当地执行](https://cdkd.dev/local-emulation/)) (中文(简体) ).

> \[大 cdkd只用于dev/测试工作流程——开发初期,尚未做好生产准备.

## 安装

```bash
npm i -g @cdkd/cli            # latest release
npm i -g @cdkd/cli@<version>  # pin to a specific version
```

安装的二进制是 `cdkd`它需要节点js 22.12 或以后.

cdkd 先前作为 `@go-to-k/cdkd`; 该软件包已贬值 不得再被释放。 两个软件包都安装相同 `cdkd` 二进制,在安装新元前删除旧元:

```bash
npm rm -g @go-to-k/cdkd && npm i -g @cdkd/cli
```

## 快速启动

> **第一次设置**: 运行 `cdkd bootstrap` 每个 AWS 账户在任何账户之前一次 其他命令; 替换 `cdk bootstrap`,则cdkd不需要 (详见 [开始](https://cdkd.dev/getting-started/)) (中文(简体) ).

```bash
# Bootstrap (creates S3 state bucket + asset storage — one-time setup per AWS account)
cdkd bootstrap

# List stacks in the CDK app
cdkd list

# Deploy your CDK app
cdkd deploy

# Deploy at maximum speed: skip slow stabilization waits
cdkd deploy --no-wait

# Check what would change
cdkd diff

# Tear down
cdkd destroy
```

## 使用 AI 编码代理

这个寄存器是 [`cdkd` 技能](https://github.com/go-to-k/cdkd/blob/main/plugins/cdkd-skills/skills/cdkd/SKILL.md) 教AI编码代理安全使用cdkd([AI 代理指南](https://cdkd.dev/ai-agents/)) (中文(简体) ).

### 克劳德代码

通过在 Claude 代码会话中运行这些设备, 将其安装为插件( 一次性设置) :

```text
/plugin marketplace add go-to-k/cdkd
/plugin install cdkd-skills@cdkd
```

然后请克洛德部署一个带有 cdkd 的 dev/test CDK 堆栈——技能 自动触发——或直接以 `/cdkd`。 。 。 .

### 其他剂(Codex、光标等)

任何支持 SKILL.md 格式的代理可以使用该技能. 安装它 与 [GitHub 缩写](https://github.blog/changelog/2026-04-16-manage-agent-skills-with-github-cli/) (v2.90+)或 (v [`npx skills`](https://github.com/vercel-labs/agent-skills)数字 :

```bash
gh skill install go-to-k/cdkd cdkd
# or
npx skills add go-to-k/cdkd --skill cdkd
```

### 贡献者

要测试当前对另一个 CDK 项目的检出, 请复制此选项 存储并添加到 Claude 代码会话中—— 工程范围 [`/use-cdkd`](https://npmcn.com/package/%40cdkd/cli/.claude/skills/use-cdkd/SKILL.md) 技术覆盖建筑和 连接检出 :

```bash
claude --add-dir /path/to/cdkd
```

## 文档

完整文档生活于 **[cdkd.dev (英语)](https://cdkd.dev/)**数字 :

-   [开始](https://cdkd.dev/getting-started/)
-   [CLI 参考](https://cdkd.dev/cli-reference/)
-   [本地执行](https://cdkd.dev/local-emulation/)
-   [进口/出口-云层迁移](https://cdkd.dev/import/)
-   [解决问题](https://cdkd.dev/troubleshooting/)

## 基准

**cdkd 部署最多 15 个比 AWS CDK 更快( CloudFormation)** 在SDK-Provider处理的堆栈上;每堆速度随大小和平行性而扩大.

![Deploy race on a VPC + CloudFront + Lambda stack: AWS CDK (CloudFormation) 599 s, cdkd 96 s (~6x faster), cdkd --no-wait 40 s (15.0x faster). Deploy phase only.](https://raw.githubusercontent.com/go-to-k/cdkd/main/assets/benchmark-race-light.gif)

### vs CloudFormation 快捷模式: 最多9x更快

云阵 [快捷模式](https://aws.amazon.com/about-aws/whats-new/2026/06/aws-cloudformation-cdk/) 是一个快速部署选项, 它跳过资源稳定等待, 在精神上类似于 cdkd's `--no-wait`即使如此,Cdkd的速度 也比快 几乎每堆,还有 `--no-wait` 它在以合成资源为主的堆栈上 大幅领先.

| 堆栈 | 正常( CFn) | 快递 | (简体中文) | (简体中文) `--no-wait` |
| --- | --- | --: | --: | --: |
| VPC + Lambda + SQS + 云纹 | 562 (韩语) | 366 (韩语) | 96 (韩语) | **第40条** |
| 迪纳摩DB | 页:1 | 页:1 | 第 19 条 | 15个 |
| 迪纳摩DB + KMS | 页:1 | 第55条 | 27个 | 27个 |
| 欧共体2 | 第44条 | 31个 | 27个 | 第 26 条 |
| 兰布达 | 第55条 | 页:1 | 第23条 | 22个 |
| 第3条 | 页:1 | 22个 | 第23条 | 24个 |
| 质量 | 83个 | 22个 | **第9条** | 第9条 |
| SQS + 云表 | 第87条 | 第44条 | 30个 | 31个 |

最佳3跑,部署阶段 仅秒, `us-west-2`。 。 。 .

### vs Terraform: cdkd 部署更快

我们还对Terraform进行了cdkd比赛:同样的逻辑堆栈既表现为CDK应用,也表现为Terraform HCL,被部署在了真正的AWS上. **cdkd在四种情景中明显更快——1.23x至2.31x,完全分离运行分布——其余则在统计上捆绑.**

| 假设 | 堆栈 | (简体中文) | 地形 | 云阵 | (简体中文) `--no-wait` |
| --- | --- | --: | --: | --: | --: |
| 宽 | 48个独立资源(S3 / DynamoDB / SQS / SNS / SSM / Logs,各有8个) | **20.0 (韩语)** | 第46.1条 | 89.1 国家 | 21.1 国家 |
| 无服务器 | Lambda×3 + HTTP API + DynamoDB + SNS / SQS + EventBridge | **25.9 国家** | 57.5 (中文(简体) ) | 127.1 国家 | 24.6 联合国 |
| ec2 数字 | VPC+子网+SG+IAM角色+EC2实例×3 | **29.1 (中文(简体) )** | 35.9 联合国 | 193.9 联合国 | 22.0 |
| 网络应用 | VPC + NAT + 子网 + DynamoDB + SQS + S3 + Lambda ×2 + HTTP API | 第109.7条 | 127.3 请检查date=中的日期值 (帮助) | 166.1 (中文(简体) ) | 23.4 联合国 |
| ecs——稳定状态 | VPC x2 AZ + 远门集群/任务/服务 + ALB | **176.2 (中文(简体) )** | 228.9 (中文(简体) )`wait_for_steady_state = true`(中文(简体) ) | 276.7 (英语) | 34.5 国家 |
| 云锋-所创造(火与忘) | S3 原产地 + CloudFront + OAC | 第11.1条 | 10.3 (中文(简体) )`wait_for_deployment = false`(中文(简体) ) | 无此模式 | 10.4 国家 |
| 云锋- `Deployed` | S3 原产地 + CloudFront + OAC | 174.0 (中文(简体) )`--full-wait`(中文(简体) ) | 166.4 联合国 | 232.3 (中文(简体) ) | 无 |

冷的端到端的墙钟 包括合成 / 计划,中位数为7跑,秒, `us-east-1`. ecs cdkd 和 Terraform 的细胞来自晚于其他表的圆.

完整的方法,分布分析,每个运行的数据,以及完整的套件(SDK Proferver路径,Cloud Control回落路径,15x头行堆栈): **[cdkd.dev/基准/标](https://cdkd.dev/benchmarks/)**。 。 。 .

## 许可证

Apache 2.0 (英语)

## 常见问题

### @cdkd/cli 是什么？

已存在的 CDK 应用程序的 CDK CLI - 最多 15x 通过直接的 AWS SDK 调用以更快的部署

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

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

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

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

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

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

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

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

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

@cdkd/cli 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

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

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

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

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