# @datadog/ai-setup-cli 中文文档

规范地址：https://npmcn.com/package/%40datadog/ai-setup-cli/

版本：2\.0\.37
npm 元数据更新时间：2026-11-05T21:13:11.228Z
中文译文更新时间：2026-11-11T14:05:33.802Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：2.2 MB，582 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：15 个
- 首次发布：2026-04-07T16:35:03.783Z
- 最新版本发布：2026-11-05T21:13:11.082Z
- 近 30 天下载量：2987（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：49（近 12 个月 49 个）

## 中文简介

用于 Datadog 设置的互动工具

## 安装

```sh
npm install @datadog/ai-setup-cli
```

也可以使用：`pnpm add @datadog/ai-setup-cli`、`yarn add @datadog/ai-setup-cli`、`bun add @datadog/ai-setup-cli`

## README

# AI 设置 CLI

一个交互式的CLI,它使用AI代理自动与Datadog的仪器项目. 这个工具不是手工的SDK集成,而是利用克洛德来检测你的工程结构,修改你的代码库,并设置了Datadog产品——前端,后端,基础设施,AI,安全,以及CI测试.

## 快速启动

以交互方式运行 —— CLI 将您通过登录 / 注册, 选择一个产品组, 确认工作空间, 以及您的代码 :

```bash
npx @datadog/ai-setup-cli --site datadoghq.com
```

或者通过路过跳过采摘者 `--product`数字 :

```bash
npx @datadog/ai-setup-cli --site datadoghq.com --product rum
```

### 无头模式

使用 `--headless` 用于自动运行(CI、代理、脚本)。 它跳过 交互 UI 并需要两者 `--site` 财务报告和审定财务报表 `--product`数字 :

```bash
DD_API_KEY=... DD_APP_KEY=... \
  npx @datadog/ai-setup-cli \
  --headless \
  --site datadoghq.com \
  --product rum
```

设定 `DD_API_KEY` 财务报告和审定财务报表 `DD_APP_KEY` 环境变量(均为 )或设置 `DD_ACCESS_TOKEN` 用于预取的 OAuth 访问 符号(例如: `pup` 。 。 。 。 关闭所有三个 来使用浏览器 OAuth,是可能需要用户输入的唯一步骤。 远程或 完全未覆盖的环境, 请使用 env vars; 浏览器 OAuth 需要 a 本地主机召回。 钥匙和 `DD_ACCESS_TOKEN` 无法合并.

通过使用 `--headless`,您确认源代码上传和自动 命令执行被授权用于目标项目.

## 参数

| 参数 | 说明 | 需求 | 默认 |
| --- | --- | --- | --- |
| `--site` | 数据犬网站(参见 [支持的网站](https://npmcn.com/package/%40datadog/ai-setup-cli/#readme-supported-sites)(中文(简体) ) | 对 | —— 说 |
| `--product` | 产品到仪器(见 [支持产品](https://npmcn.com/package/%40datadog/ai-setup-cli/#readme-supported-products)) (中文(简体) ). 要求为 `--headless`;否则,CLI会显示一个交互取取器. | 没有 | —— 说 |
| `--auto-approve` | 自动批准所有未提示的 bash 命令 | 没有 | `false` |
| `--headless` | 不使用交互式终端 UI 运行 。 要求数 `--site` 财务报告和审定财务报表 `--product`。通过 `DD_API_KEY` 编号 : `DD_APP_KEY`, (中文(简体) ), `DD_ACCESS_TOKEN`,或浏览 OAuth. | 没有 | `false` |
| `-h`, (中文(简体) ), `--help` | 显示帮助( 包括所有产品专用旗帜) | —— 说 | —— 说 |

### 特定产品的论点

每种产品都可以在其 `products/<name>/config.yaml`。通过它们作为 `--flag=value`。完整集也由 `--help`。 。 。 .

| 产品 | 旗帜 | 说明 |
| --- | --- | --- |
| `rum` | `--app-id` 编号 : `--rum-application-id` | RUM 应用程序编号 |
| `rum` | `--rum-client-token` | RUM 客户端符号 |
| `rum` | `--rum-framework` | 框架(例如:. `react`, (中文(简体) ), `browser`(中文(简体) ) |
| `error-tracking` | `--app-id` | RUM 错误跟踪应用程序 ID |
| `product-analytics` | `--app-id` | RUM 应用程序编号 |
| `llm-obs` | `--api-key` | 数据犬 API 密钥 |
| `llm-obs` | `--llm-obs-app` | LLM 应用程序名称 (`DD_LLMOBS_ML_APP`(中文(简体) ) |
| `infra-monitoring` (库伯内特斯) | `--k8s-products` 编号 : `--enabled-products` | 以逗号分隔的产品使(`apm`, (中文(简体) ), `logs`, (中文(简体) ), `infrastructure`, (中文(简体) ), `otel`) (中文(简体) ). `--enabled-products` 如果两者都设定了,则胜出. |
| `infra-monitoring` | `--k8s-distro` | `gke`, (中文(简体) ), `eks`, (中文(简体) ), `minikube`, (中文(简体) ), `aks`,, , , , , , , , |
| `infra-monitoring` | `--k8s-cluster-name` | 组名 |
| `infra-monitoring` | `--k8s-env-name` | `DD_ENV` 价值 |
| `infra-monitoring` | `--k8s-library-versions` | 譬如说. `java:v1,python:v4,js:v5` |
| `infra-monitoring` | `--k8s-target-namespaces` | 要包含的命名空间 |
| `infra-monitoring` | `--k8s-disabled-namespaces` | 排除的命名空间 |
| `infra-monitoring` | `--k8s-registry` | 取代集装箱登记 |
| `docker` | `--products` | 以逗号分隔的产品(`infra`, (中文(简体) ), `apm`, (中文(简体) ), `logs`) (中文(简体) ). 默认 : `infra,apm,logs`。 。 。 . |
| `docker` | `--library-versions` | 语言跟踪/图书馆版本 |
| `docker` | `--env` | `DD_ENV` 价值 |
| `linux` | `--products` | 以逗号分隔的产品(`infra`, (中文(简体) ), `apm`, (中文(简体) ), `logs`, (中文(简体) ), `otel`) (中文(简体) ). 默认 : `infra,apm,logs`。 。 。 . |
| `linux` | `--env` | `DD_ENV` 价值 |
| `ecs` | `--ecs-launch-type` | ECS发射类型(`fargate`, (中文(简体) ), `ec2`。如果省略则提示. |
| `ecs` | `--ecs-deployment-method` | 部署方法`terraform`, (中文(简体) ), `cdk`, (中文(简体) ), `cloudformation`, (中文(简体) ), `cli`。如果省略则提示. |
| `serverless` | `--api-key` | 数据犬 API 密钥 |
| `serverless` | `--serverless-compute-type` | `aws-lambda`, (中文(简体) ), `gcp-cloud-run`, (中文(简体) ), `gcp-cloud-run-functions`, (中文(简体) ), `azure-container-apps` (如果省略则会被推断) |
| `serverless` | `--serverless-runtime` | `nodejs`, (中文(简体) ), `python`, (中文(简体) ), `java`, (中文(简体) ), `ruby`, (中文(简体) ), `dotnet`, (中文(简体) ), `go`, (中文(简体) ), `php` (如果省略,则予以省略; `php` 只在云跑/容器应用程序上) |
| `serverless` | `--development-framework` | `aws-cdk`, (中文(简体) ), `aws-sam`, (中文(简体) ), `serverless-framework`, (中文(简体) ), `terraform`, (中文(简体) ), `ci`, (中文(简体) ), `other` (如果省略则会被推断) |
| `test-optimization` | `--api-key` | 数据犬 API 密钥 |
| `ci_code_coverage` | `--api-key` | 数据犬 API 密钥 |

### 环境变量

| 变量 | 说明 | 数值 |
| --- | --- | --- |
| `COLOR_THEME` | 强制光/暗色主题( 默认: 自动检测通过) `COLORFGBG`,倒入黑暗中) | `light`, (中文(简体) ), `dark` |
| `COLOR_SCHEME` | 切换颜色方案 | `datadog` (违约), `high-contrast` |
| `DD_API_KEY` | 数据犬 API 密钥 `--headless`; 必须设置为 `DD_APP_KEY` | API 密钥 |
| `DD_APP_KEY` | 数据犬应用密钥 `--headless`; 必须设置为 `DD_API_KEY` | 应用程序密钥 |
| `DD_ACCESS_TOKEN` | OAuth 访问令牌 `--headless`; 无法与 `DD_API_KEY` 编号 : `DD_APP_KEY` | 访问令牌 |
| `AI_SETUP_CLI_PACKAGE_MANAGER` | 无法检测时在无头模式下使用的软件包管理器 | `npm`, (中文(简体) ), `yarn`, (中文(简体) ), `pnpm`, (中文(简体) ), `bun`, (中文(简体) ), `expo` |
| `AI_SETUP_CLI_CLAUDE_PERMISSION_MODE` | 克劳德权限模式( 默认为 `bypassPermissions`; 使用 `acceptEdits` 当运行为根时) | `bypassPermissions`, (中文(简体) ), `acceptEdits` |

## 支持的网站

| 站点 | 数值 |
| --- | --- |
| 美国1 | `datadoghq.com` |
| 美国3 | `us3.datadoghq.com` |
| 美国5 | `us5.datadoghq.com` |
| 欧盟1 | `datadoghq.eu` |
| 第1号附加议定书 | `ap1.datadoghq.com` |
| 第2号附加议定书 | `ap2.datadoghq.com` |
| 联合王国1 | `uk1.datadoghq.com` |

## 支持产品

在交互式拾取器中显示, 分类如下:

| 组 | 产品 | `--product` 价值 |
| --- | --- | --- |
| 基础设施(选一) | 库伯涅斯 | `infra-monitoring` |
| 基础设施 | 夹克 | `docker` |
| 基础设施 | 链接 | `linux` |
| 基础设施 | 无服务器 | `serverless` |
| 基础设施 | 亚马逊ECS | `ecs` |
| 前端监视 | 卢姆 | `rum` |
| 前端监视 | 跟踪错误 | `error-tracking` |
| 前端监视 | 产品分析 | `product-analytics` |
| 基于 LLM 的应用程序 | LLM 可观察性 | `llm-obs` |
| CI 测试 | 测试优化 | `test-optimization` |
| CI 测试 | 代码覆盖 | `ci_code_coverage` |

隐藏在拾取器中,但可以通过 `--product=<value>`数字 :

| 产品 | `--product` 价值 |
| --- | --- |
| App和API 保护 | `app_and_api_protection` |
| 打开几何 | `otel` |
| 工作室 | `studio` |

## 常见问题

### @datadog/ai-setup-cli 是什么？

用于 Datadog 设置的互动工具

### 如何安装 @datadog/ai-setup-cli？

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

### @datadog/ai-setup-cli 支持 TypeScript 吗？

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

### @datadog/ai-setup-cli 支持 ESM 还是 CommonJS？

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

### @datadog/ai-setup-cli 需要什么版本的 Node\.js？

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

### @datadog/ai-setup-cli 可以商用吗？

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

### @datadog/ai-setup-cli 的下载量有多少？

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

### @datadog/ai-setup-cli 还在维护吗？

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