# @bitwarden/cli 中文文档

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

版本：2026\.10\.1
npm 元数据更新时间：2026-10-29T12:25:06.404Z
中文译文更新时间：2026-11-08T04:51:33.831Z
软件包许可：SEE LICENSE IN LICENSE\.txt

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

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

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

- 包体积（解压后）：19.3 MB，9 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：27 个
- 首次发布：2018-05-15T04:26:26.673Z
- 最新版本发布：2026-10-29T12:25:05.978Z
- 近 30 天下载量：295750（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：117（近 12 个月 17 个）

## 中文简介

您所有设备的安全免费密码管理器 .

## 安装

```sh
npm install @bitwarden/cli
```

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

## README

[![Github Workflow build on main](https://github.com/bitwarden/clients/actions/workflows/build-cli.yml/badge.svg?branch=main)](https://github.com/bitwarden/clients/actions/workflows/build-cli.yml?query=branch:main)

# Bitwarden 命令行接口

[![Platforms](https://imgur.com/AnTLX0S.png "Platforms")](https://help.bitwarden.com/article/cli/#download--install)

Bitwarden CLI是一个强大的,全能的指令行接口(CLI)工具来访问和管理一个Bitwarden金库. CLI使用TypeScript和Node.js来编写,可以在Windows,macOS,和Linux发行版上运行.

## 开发者文档

请参看 [CLI 节](https://contributing.bitwarden.com/getting-started/clients/cli/) 会 议 日 程 和 议 程 [提供文档](https://contributing.bitwarden.com/) 用于构建指令,推荐工具,代码样式提示, 以及很多其他的伟大信息 让你开始.

## 用户文档

### 下载/安装

您可以安装 Bitwarden CLI 多种不同方式:

**国家预防机制**

如果你的系统已经安装了节点.js运行时间,你可以使用国家防范机制安装CLI. 国家防范机制可以方便地不断更新您的安装,如果您已经使用Node.js,则应当成为首选的安装方法.

```bash
npm install -g @bitwarden/cli
```

**原生可执行文件**

我们为没有安装节点运行时间要求的每个平台提供本地包装的CLI版本. 你可以从 [下载区域](https://help.bitwarden.com/article/cli/#download--install) 在文档中.

**其他软件包管理器**

-   [巧克力质](https://chocolatey.org/packages/bitwarden-cli)
    
    ```powershell
    choco install bitwarden-cli
    ```
    
-   [土生土长](https://formulae.brew.sh/formula/bitwarden-cli)
    
    ```bash
    brew install bitwarden-cli
    ```
    
    > QQ 不推荐所有用户使用自制版本.
    > 
    > Homebrew拉动CLI的GPL构建,不包括企业SSO客户的设备审批命令.
    
-   [坐标](https://snapcraft.io/bw)
    
    ```bash
    sudo snap install bw
    ```
    

### 帮助命令

Bitwarden CLI 自行记录 `--help` 每个命令的内容和示例。 你应该开始探索CLI 通过全球 `--help` 选项 :

```bash
bw --help
```

此选项将列出您可用 CLI 的所有命令 .

此外,你可以运行 `--help` 选项:

```bash
bw list --help
bw create --help
```

### 解锁桌面生物鉴别技术

何时 `bw unlock` 在没有密码的情况下交互运行, CLI 第一次尝试解锁 bitwarden 桌面应用程序。 这需要 Bitwarden 桌面 2026.9.0 或更新的运行,并带有 启用同一账户的生物识别解锁 。 如果无法使用或正在使用桌面生物鉴别解锁 已取消, CLI 返回到主密码提示 .

传出密码, `--passwordenv`,或 `--passwordfile` 跳过生物识别尝试。 生物测量 解锁在 `BW_NOINTERACTION=true`。 。 。 .

其特征是门后 `biometrics-sdk-ipc` 特性旗,它也打开桌面 同一IPC的侧面。 当旗子不在CLI时,从未启动桌面代理.

如果桌面应用程序安装在一个非标准位置, 设置 `BITWARDEN_DESKTOP_PROXY_PATH` 一、导 言 `desktop_proxy` 可执行文件 .

### 帮助中心

我们提供详细的文件和实例,说明如何在我们的帮助中心使用国家综合倡议 [https://help.bitwarden.com/article/cli/ (中文(中国大陆) )](https://help.bitwarden.com/article/cli/)。 。 。 .

## 常见问题

### @bitwarden/cli 是什么？

您所有设备的安全免费密码管理器 \.

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

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

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

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

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

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

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

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

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

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

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

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