# @babelize/cli 中文文档

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

版本：1\.3\.17
npm 元数据更新时间：2026-11-01T20:50:34.254Z
中文译文更新时间：2026-11-07T17:01:00.562Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40babelize/cli
原文对照：https://npmcn.com/package/%40babelize/cli/?lang=original
项目主页：https://babelize.co/

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

- 包体积（解压后）：785 kB，219 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：16 个
- 首次发布：2026-07-02T13:51:45.807Z
- 最新版本发布：2026-11-01T20:50:34.109Z
- 近 30 天下载量：4152（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：41（近 12 个月 41 个）

## 中文简介

Babelize AI-powered i18n 平台的官方CLI

## 安装

```sh
npm install @babelize/cli
```

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

## README

# @babelize/ cli (英语)

**以贝贝化CLI** ——AI-动力i18n平台管理您终端的翻译.

## 安装

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

## 快开始

在您的工程文件夹中 :

```bash
npx babelize        # or: npx @babelize/cli
```

它检查出价 `git init` 在您的机器上找到您的框架, i18n 库和源语言, 并在需要时在您签名( GitHub 或 Google 在浏览器中, 或电子邮件和密码), 询问您想要哪种语言( 记得在 `.babelize/config.json`),然后写出地方文件和i18n代码,以便与 `git diff`。签名后,不需要 API 密钥: 翻译用 Babelize 信用记账,摘要显示使用了多少.

完成后,添加一个语言切换器(即: [https://elements.babelize.co 互联网档案馆的存檔,存档日期2013-12-02](https://elements.babelize.co/),或建立自己的)。 运行 `npx babelize` 更改后再次:只翻译新文本或已修改文本。 对于拉动请求,请在 [https://app.babelize.co (英语)](https://app.babelize.co/) 运行 `babelize run start`。 。 。 .

没有终端,通过语言: `babelize start --to fr,de --yes`. (交互式命令菜单现在 `babelize shell`. ) (中文(简体) )

### 用你自己的 LLM 键,或者在 CI

`babelize translate` 是同一地方译名,带有旗帜而不是问题。 使用您自己的 LLM 密钥( 不需要账户) , 您的签名会话, 或 Babelize API 密钥 :

```bash
export ANTHROPIC_API_KEY=sk-ant-...   # or OPENAI_API_KEY, GEMINI_API_KEY, GROQ_API_KEY, OPENROUTER_API_KEY
npx babelize translate --to fr,de,ja
git diff
```

或使用 Babelize 托管翻译: 在 [https://app.babelize.co/api-keys (英语)](https://app.babelize.co/api-keys) (包括自由等级),然后

```bash
export BABELIZE_API_KEY=bblz_sk_...
npx babelize translate --to fr,de,ja
```

-   **框架:** React, Next.js (App Router), Django和静态 HTML 支持. Vue和React Independent(Expo和裸体)属于β.
-   **键 :** 使用上面顺序中发现的第一个 LLM 键; 无, `BABELIZE_API_KEY` 选择 Babelize 托管的翻译, 并且没有键入您的签名会话会做( 字符串, 从未编码; 在 Babelize 中计费) 。 再选一个 `--provider` (单位:千美元)`babelize` ),或与 `--model`。 。 。 .
-   **输出 :** `--json` 打印 QA 报告,此报告也写到 `.babelize/local/report.json` (单位:千美元)`--report <path>` 移动它。 一些密钥退出失败的运行 `6` 除非 `--allow-partial`。 。 。 .
-   **安全性:** 需要用一棵干净的工作树来回收`--force` (原始内容存档于2017-03-25). overse. 如果运行失败,它只能做一个临时的复制件,没有任何触摸. `--dry-run` 打印 diff 不写.
-   **重运行 :** 承诺 `.babelize/local/babelize-lock.json` 而后运行只翻译出新的或已更改的字符串.

全向导 : [https://docs.babelize.co/cli/ translate (中文(简体) )](https://docs.babelize.co/cli/translate)

## 快速启动( 平台)

```bash
# Log in to your Babelize account
babelize auth login

# Initialize a new project
babelize init

# Start a translation run
babelize run start
```

## 图标

| 命令 | 说明 |
| --- | --- |
| _(无命令)_ 编号 : `start` | 在此文件夹中逐个翻译工程( git, sign- in, languages) |
| `translate --to <locales>` | 本地翻译此重播: 已签名, 您自己的 LLM 密钥, 或 `BABELIZE_API_KEY` (写到工作树上) |
| `check [path]` | QA 本地端文件( 丢失密钥、 占位符、 ICU、 复数); 出错 1, 用于 CI |
| `shell` | 交互命令菜单 |
| `init` | 启动新的 Babelize 项目 |
| `auth login` 编号 : `signup` 编号 : `logout` 编号 : `whoami` | 认证管理 |
| `auth reset-password` | 发送密码重置电子邮件 |
| `auth provider-tokens` | 管理 OAuth 提供者令牌( GitHub等) |
| `status` | 请检查API 健康及您的账户状况 |
| `scan [directory]` | 扫描硬编码可转换字符串的本地目录 |
| `projects` | CRUD,同步,洞察,元数据,下载,品牌语音,存档 |
| `run start` 编号 : `status` 编号 : `analyze` | 翻译管道引擎(`start` 支持 `--no-poll`, (中文(简体) ), `--no-pr`, (中文(简体) ), `--json`(中文(简体) ) |
| `babels` | 查看翻译工作历史 |
| `pr` | GitHub 公关一体化 |
| `billing` | 计划、使用、发票 |
| `subscriptions` | 列出计划, 显示默认计划和当前计划 |
| `checkout` | 购买计划 |
| `languages` | 系统和项目一级语言管理,ISO QQ FLORES-200代码转换 |
| `members` | 小组成员管理 |
| `tm` | 翻译内存(所有者范围,在您的项目中共享:视图、添加、更新、导出为TMX、清晰) |
| `glossary` | 翻译词汇表(列表、添加、更新、删除、导入、导出) |
| `api-keys byok` | BYOK 提供者密钥( OpenAI、 Anthropic、 Groq等) |
| `api-keys babelize` | Babelize API 密钥 (bblz sk MCP/ 外部访问的前缀) |
| `comments` | 翻译评论和讨论 |
| `notifications` | 通知收件箱 |
| `analytics` | 使用历史、活动记录、审计记录 |
| `account` | 外交部、会议、删除账户 |
| `privacy` | GDPR 数据输出和去除 |
| `admin` | 平台管理(仅所有者) |
| `invitations` | 团队邀请 |
| `roles` | 角色管理 |
| `users` | 用户列表 |

运行 `babelize <command> --help` 用于子命令细节.

## 贝壳补全

生成 bash 或 zsh 补全脚本 :

```bash
babelize completion bash > /usr/local/etc/bash_completion.d/babelize
babelize completion zsh > /usr/local/share/zsh/site-functions/_babelize
```

脚本动态地反映了生成时所有已注册的命令.

## 配置

全权证书和首选权存放于:

-   **马可斯:** `~/Library/Preferences/@babelize/cli-nodejs/config.json`
-   **林纳:** `~/.config/@babelize/cli-nodejs/config.json`
-   **窗口 :** `%APPDATA%\@babelize\cli-nodejs\Config\config.json`

API URL按此顺序解决 :

-   **`--api-url` 旗帜** ——每个命令覆盖
-   **`BABELIZE_API_URL` 环境 var** - 比如说. `http://localhost:3001/api` 用于本地 dev
-   **存储配置** —— 由 : `babelize auth login --api-url <url>` 或“自行托管的”登录选择(包括本地主机 URL) 。 URL只有在您要求时才被存储 .
-   **默认 :** `https://api.babelize.co/api`

## 环境变量

| 变量 | 说明 |
| --- | --- |
| `BABELIZE_API_URL` | 覆盖 API URL |
| `BABELIZE_TOKEN` | 认证符( 选项为 `babelize auth login` 或者说 `--token`)——建议为CI. 也用于签名翻译 |
| `BABELIZE_NON_INTERACTIVE` | 强制非交互模式( N)`1` 或者说 `true`(中文(简体) ) |
| `CI` | 设定时( 非) `"false"`),CLI从不提示——缺少旗下退出并出现使用错误 |
| `NO_COLOR` | 禁用彩色输出( 任何非空值) |
| `ANTHROPIC_API_KEY`, (中文(简体) ), `OPENAI_API_KEY`, (中文(简体) ), `GEMINI_API_KEY`, (中文(简体) ), `GROQ_API_KEY`, (中文(简体) ), `OPENROUTER_API_KEY` | 您的 LLM 密钥用于 `babelize translate` (第一组胜出; `--provider` 选择) |
| `BABELIZE_API_KEY` | Babliize API 密钥 (`bblz_sk_…`),用于主机翻译 `babelize start` 编号 : `babelize translate` 当没有设置 LLM 密钥时 |
| `BABELIZE_TELEMETRY` | `0` 关闭匿名使用数据( e)`DO_NOT_TRACK=1` 工作也一样。 见 [遥测](https://npmcn.com/package/%40babelize/cli/#readme-telemetry) |

## CI / 非交互模式

CLI是CI安全。 设定 `CI=true` (大部分管道是自动的),设置 `BABELIZE_NON_INTERACTIVE=1`,或通过 `--non-interactive` 编号 : `--yes`并且CLI 永远不会阻止一个迅速. `--yes` 也回答“ 是” 到删除等确认; 没有它, 非交互模式的确认失败 退出代码 `2`数字 :

```bash
CI=true babelize run start -p <project-id> -l es,fr --no-poll --json
```

在非交互模式下,缺少所需的旗帜退出 `2` (使用)和可操作的信息而不是提示。 闭塞stdin(非TTY)也被视为非互动.

在 CI 中以符号而不是存储会话认证 :

```bash
export BABELIZE_TOKEN=bblz_sk_xxxxxxxx
```

CI 本地翻译, 设置 `BABELIZE_API_KEY` (或你自己的 LLM 密钥)并运行 `npx babelize start --to fr,de --yes`。 。 。 .

见 [CI/CD 文档](https://docs.babelize.co/integrations/ci-cd) gitHub 动作秘方.

## 退出代码

| 代码 | 含义 | 当它发生时 |
| --- | --- | --- |
| `0` | 成绩 | 命令完成 |
| `1` | 内部错误 | 意外失败 |
| `2` | 使用错误 | 未知的命令、 不好的旗帜、 缺少或无效的参数( 如 ID) , 或在非交互模式下无法回答的提示 |
| `3` | Auth 错误 | 未登录、 会话已过期、 登录失败、 符号被拒绝 |
| `4` | 配置错误 | 无法翻译( 没有密钥且没有签名), 没有支持的工程, 没有本地文件 `check` |
| `5` | 网络错误 | API 无法获取, 速度有限, DNS 失败, 超时 |
| `6` | API 错误 | 服务器返回 4xx/5xx; 失败的运行( N)`run start`, (中文(简体) ), `run status --watch`(中文(简体) ) |
| `128` | 已取消 | 交互提示已取消, 或未完成的运行已取消 |

> 已取消的快速退出 `128`, (中文(简体) ), **永远** `0` ——当缺少必要的输入时,管道步骤不能默默地通过.

脚本可以为条件逻辑使用这些代码 :

```bash
babelize run start --no-poll || exit_code=$?
if [ $exit_code -eq 3 ]; then
  babelize auth login
fi
```

## JSON 模式

附录 `--json` 用于机器可读 JSON 输出的命令 。 覆盖率为每 子命令:如果子命令不执行, `--json` 被忽略 普通可读输出被打印出(例如:. `babelize projects list --json` 返回 JSON,但有些 `members` 财务报告和审定财务报表 `notifications` 子行动不).

与 `--json`,旋转器和其他进步输出从不触摸出出(错误和 通知会到stderr,所以 `babelize --json auth whoami | jq` 工作时 当stdout是 不是终点站,旋转器被平板线路所取代.

## 遥测

CLI发送匿名使用数据:命令,CLI/Node/OS版本,框架,翻译类型,目标地盘,计数以及运行是否成功. 永远不要你的代码,字符串,文件名或账户细节. `babelize check` 财务报告和审定财务报表 `--provider pseudo` 发送什么。 通知是第一次打印的.

把它关掉 `babelize telemetry disable`, (中文(简体) ), `BABELIZE_TELEMETRY=0` 或者说 `DO_NOT_TRACK=1`细节 : [docs.babelize.co/cli/遥测](https://docs.babelize.co/cli/telemetry)。 。 。 .

## 更新通知

CLI每会话检查 npm 注册一次新版本(非屏蔽). 更新:

```bash
npm update -g @babelize/cli
```

## 解决问题

| 问题 | 解决方案 |
| --- | --- |
| `Not authenticated` | 运行 `babelize auth login` |
| `Directory not found` 打开 `scan` | 确保路径存在并且是一个目录 |
| `EPERM` 安装时 | 使用 `sudo npm install -g @babelize/cli` |
| 完成不工作 | 确保脚本来源: `source /usr/local/etc/bash_completion.d/babelize` |
| 费率有限 | 等60秒再试 |
| `BABELIZE_API_URL` 没有被尊重 | 运行命令前, 要确保 env var 设置 |

## 链接

-   [网站](https://babelize.co/)
-   [文档](https://docs.babelize.co/)

## 常见问题

### @babelize/cli 是什么？

Babelize AI-powered i18n 平台的官方CLI

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

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

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

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

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

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

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

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

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

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

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

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

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

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