# @ciandt-flow/cli 中文文档

规范地址：https://npmcn.com/package/%40ciandt-flow/cli/

版本：2\.14\.1
npm 元数据更新时间：2026-11-04T23:26:49.546Z
中文译文更新时间：2026-11-09T15:52:18.675Z
软件包许可：SEE LICENSE IN LICENSE\.md

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

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

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

- 包体积（解压后）：335 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.12\.0
- 运行依赖：24 个
- 首次发布：2026-04-08T20:39:39.330Z
- 最新版本发布：2026-11-04T23:26:49.348Z
- 近 30 天下载量：4145（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：161（近 12 个月 161 个）

## 中文简介

浏览和安装流生态系统中的 Claude 代码插件的 TUI

## 安装

```sh
npm install @ciandt-flow/cli
```

也可以使用：`pnpm add @ciandt-flow/cli`、`yarn add @ciandt-flow/cli`、`bun add @ciandt-flow/cli`

## README

# 流量插件- cli

TUI用于浏览并安装来自流生态系统的克洛德代码插件.

## 安装

```bash
npm install -g @ciandt-flow/cli
```

## 快速启动

```bash
# Authenticate with your Flow credentials
flow auth login

# Launch the interactive plugin browser
flow
```

## 图标

### `flow` (无参数)

启动交互式TUI来浏览和管理插件.

* * *

### `auth`

认证命令 .

#### `auth login`

认证并保存证书 .

```bash
flow auth login [options]
```

| 选项 | 说明 |
| --- | --- |
| `--client-id <id>` | 客户身份 |
| `--client-secret <secret>` | 客户端机密 |
| `--tenant <tenant>` | 租户 |
| `--starter-kit <slug>` | 认证后要安装的启动工具箱 sattle |

当呼叫时 **无选项**,进入交互式模式——终端中每个字段的提示. 当呼叫时 **所有三个选项**,不交互运行,直接保存证书.

```bash
# interactive mode
flow auth login

# non-interactive mode
flow auth login --client-id <id> --client-secret <secret> --tenant <tenant>

# with starter kit selection
flow auth login --client-id <id> --client-secret <secret> --tenant <tenant> --starter-kit dev
```

#### `auth logout`

删除已保存的证书 .

```bash
flow auth logout [--force]
```

#### `auth status`

显示当前认证状态 .

```bash
flow auth status
```

* * *

### `plugin`

插件管理命令 .

#### `plugin list`

列表插件 .

```bash
flow plugin list [options]
```

| 选项 | 说明 |
| --- | --- |
| `--available` | 显示所有安装状态的目录插件 |
| `--outdated` | 显示已有更新的已安装插件 |
| `--json` | 输出为 JSON |

```bash
flow plugin list                  # list installed plugins
flow plugin list --available      # list all plugins from catalog
flow plugin list --outdated       # list plugins with updates available
flow plugin list --json           # output as JSON
```

#### `plugin install <name...>`

安装一个或多个插件 .

```bash
flow plugin install <name...> [options]
```

| 选项 | 说明 |
| --- | --- |
| `--force` | 即使已经安装了 Reinstall |
| `--verbose` | 显示每个安装步骤 |
| `--silent` | 仅作为 JSON 输出 |
| `--marketplace-source <source>` | 安装外部插件时自动添加市场的 GitHub 源( 拥有/ repo) |
| `--scope <scope>` | 安装范围: `user`, (中文(简体) ), `project`,或 `local` |

```bash
flow plugin install flow-adr-writer
flow plugin install flow-adr-writer --scope project
flow plugin install flow-adr-writer flow-prd-writer
flow plugin install flow-adr-writer --force
flow plugin install superpowers@claude-plugins-official
flow plugin install agent-sdk-dev@claude-code-plugins --marketplace-source anthropics/claude-code
```

#### `plugin uninstall <name>`

解开插件 .

```bash
flow plugin uninstall <name> [options]
```

| 选项 | 说明 |
| --- | --- |
| `--force` | 跳过交互式确认 |
| `--scope <scope>` | 从下列来源卸载的范围: `user`, (中文(简体) ), `project`,或 `local` |

```bash
flow plugin uninstall flow-adr-writer
flow plugin uninstall flow-adr-writer --scope project
flow plugin uninstall startup-pack-ai --force
```

#### `plugin enable <name>`

启用已安装的插件 .

```bash
flow plugin enable <name> [options]
```

| 选项 | 说明 |
| --- | --- |
| `--scope <scope>` | 实现以下目标的范围: `user`, (中文(简体) ), `project`,或 `local` |

```bash
flow plugin enable flow-adr-writer
flow plugin enable flow-adr-writer --scope project
```

#### `plugin disable <name>`

禁用已安装的插件 .

```bash
flow plugin disable <name> [options]
```

| 选项 | 说明 |
| --- | --- |
| `--scope <scope>` | 禁用范围 : `user`, (中文(简体) ), `project`,或 `local` |

```bash
flow plugin disable flow-adr-writer
flow plugin disable flow-adr-writer --scope project
```

#### `plugin marketplace add <source>`

在 Claude 代码中注册一个插件市场 .

```bash
flow plugin marketplace add <source> [options]
```

| 选项 | 说明 |
| --- | --- |
| `--force` | 跳过确认提示 |
| `--verbose` | 显示命令输出 |
| `--silent` | 仅作为 JSON 输出 |

```bash
flow plugin marketplace add anthropics/claude-code
flow plugin marketplace add https://github.com/owner/repo
flow plugin marketplace add anthropics/claude-code --force
```

#### `plugin update [name]`

更新插件到最新版本 。 关闭名称以更新所有已安装的插件 .

```bash
flow plugin update [name] [options]
```

| 选项 | 说明 |
| --- | --- |
| `--force` | 即使最新版本已经更新 |
| `--dry-run` | 预览在不做改动的情况下将更新的内容 |
| `--verbose` | 显示每个更新步骤 |
| `--silent` | 仅作为 JSON 输出 |
| `--scope <scope>` | 更新范围: `user`, (中文(简体) ), `project`,或 `local` |

```bash
flow plugin update flow-adr-writer
flow plugin update flow-adr-writer --scope project
flow plugin update                  # update all
flow plugin update --dry-run        # preview only
```

* * *

### `mcp`

MCP服务器管理命令.

#### `mcp add <name> [args...]`

在 Claude 代码中安装一个 MCP 服务器 .

```bash
flow mcp add <name> [args...] --transport <http|stdio> [options]
```

| 选项 | 说明 |
| --- | --- |
| `--transport <type>` | 运输类型 : `http` 或者说 `stdio` (必须) |
| `--scope <scope>` | 安装范围: `user`, (中文(简体) ), `project`,或 `local` |
| `--force` | 跳过确认提示 |
| `--verbose` | 显示命令输出 |
| `--silent` | 仅作为 JSON 输出 |

```bash
flow mcp add notion --transport http https://mcp.notion.com/mcp
flow mcp add mcp-chrome --transport stdio uvx mcp-chrome
flow mcp add playwright-mcp --transport stdio uvx playwright-mcp --force
flow mcp add notion --transport http https://mcp.notion.com/mcp --scope project
```

#### `mcp remove <name>`

从 Claude 代码中删除一个 MCP 服务器 .

```bash
flow mcp remove <name> [options]
```

| 选项 | 说明 |
| --- | --- |
| `--scope <scope>` | 从下列地点删除的范围: `user`, (中文(简体) ), `project`,或 `local` |
| `--force` | 跳过确认提示 |
| `--verbose` | 显示命令输出 |
| `--silent` | 仅作为 JSON 输出 |

```bash
flow mcp remove notion
flow mcp remove notion --scope project
flow mcp remove playwright-mcp --force
```

* * *

### `skills`

从 GitHub 寄存器或本地路径管理 Claude 代码的技能 .

#### `skills add <source>`

从 GitHub repo 或本地路径安装技能到 Claude 代码 .

```bash
flow skills add <source> [options]
```

| 选项 | 说明 |
| --- | --- |
| `-g, --global` | 全球安装`~/.claude/skills/`(中文(简体) ) |
| `-s, --skill <names...>` | 仅按名称安装特定技能 |
| `-y, --yes` | 跳过确认提示 |
| `--list` | 不安装而列出可用的技能 |

```bash
flow skills add vercel-labs/agent-skills
flow skills add owner/repo -g
flow skills add owner/repo -s my-skill
flow skills add owner/repo --list
flow skills add ./local/path
```

#### `skills list`

列出已安装的技能 .

```bash
flow skills list [options]
```

| 选项 | 说明 |
| --- | --- |
| `-g, --global` | 列出全球安装的技能 |
| `--json` | 输出为 JSON |

```bash
flow skills list
flow skills list --global
flow skills list --json
```

#### `skills remove [name]`

删除已安装的技能 .

```bash
flow skills remove [name] [options]
```

| 选项 | 说明 |
| --- | --- |
| `-g, --global` | 从全球范围删除 |
| `-f, --force` | 跳过确认提示 |

```bash
flow skills remove my-skill
flow skills remove my-skill --force
flow skills remove --global my-skill
```

* * *

### `bundle`

管理流程捆绑( Findr 使用大小写收藏) .

#### `bundle install <name>`

在一次操作中安装所有来自 Finder 捆绑的文物 。 按名称获取捆绑,显示其文物摘要,要求确认,然后按顺序安装每个可用的文物.

```bash
flow bundle install <name>
```

```bash
flow bundle install "My React Kit"
flow bundle install "Squad Setup Bundle"
```

* * *

### `health`

进行诊断检查.

```bash
flow health
```

* * *

## 许可证

版权(c)CI&T公司 版权所有。 详情见LICENSE.MD.

## 常见问题

### @ciandt-flow/cli 是什么？

浏览和安装流生态系统中的 Claude 代码插件的 TUI

### 如何安装 @ciandt-flow/cli？

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

### @ciandt-flow/cli 支持 TypeScript 吗？

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

### @ciandt-flow/cli 支持 ESM 还是 CommonJS？

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

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

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

### @ciandt-flow/cli 可以商用吗？

@ciandt-flow/cli 使用 SEE LICENSE IN LICENSE\.md 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @ciandt-flow/cli 的下载量有多少？

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

### @ciandt-flow/cli 还在维护吗？

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