# gt: General Translation CLI tool: gt project create
URL: https://generaltranslation.com/zh/docs/cli/reference/commands/project-create.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 使用组织 API 密钥从命令行创建项目。gt project create 命令的 API 参考。

在尚不存在项目 ID 或项目层级 API 密钥时，可使用 `gt project create` 创建项目。

## 概览 [#overview]

```bash
npx gt project create \
  --org-id <orgId> \
  --name <name> \
  --default-locale <locale> \
  [options]
```

该命令需要组织 API 密钥，项目密钥无法创建项目。

## 工作原理 [#how-it-works]

1. 从 `--api-key` 或 `GT_API_KEY` 解析 API 密钥。
2. 对 default locale 进行标准化。
3. 在由 `--org-id` 指定的 组织 下创建项目。
4. 打印所创建项目的名称和 ID。

当缺少必需的选项或凭据、该 key 不是 组织 key，或 API 拒绝该 request 时，命令将以 status 1 退出。

## 选项 [#flags]

| 参数                          | 说明                    | 类型        | 可选 | 默认值                   |
| --------------------------- | --------------------- | --------- | -- | --------------------- |
| `--org-id <orgId>`          | 将拥有该项目的组织。            | `string`  | 否  | —                     |
| `--name <name>`             | 项目名称。                 | `string`  | 否  | —                     |
| `--default-locale <locale>` | 项目的源区域设置。             | `string`  | 否  | —                     |
| `--cdn-enabled`             | 为项目启用 CDN 分发。         | `boolean` | 是  | `false`               |
| `-c, --config <path>`       | `gt.config.json` 的路径。 | `string`  | 是  | 自动解析                  |
| `--api-key <key>`           | 覆盖组织 API 密钥。          | `string`  | 是  | `GT_API_KEY`          |
| `--project-id <id>`         | 覆盖共享项目 ID；创建项目时无需提供。  | `string`  | 是  | 配置文件或 `GT_PROJECT_ID` |

## 示例 [#example]

```bash
GT_API_KEY="gtx-org-..." npx gt project create \
  --org-id "your-organization-id" \
  --name "Storefront" \
  --default-locale en \
  --cdn-enabled
```

该命令会输出项目名称及其新的 ID。请将该 ID 保存为 `GT_PROJECT_ID`，供后续项目层级的命令使用。

## 其他说明 [#notes]

* API 密钥需要具备 `org:projects:create` 权限。

### 版本历史

| 版本       | 变更                                                              |
| -------- | --------------------------------------------------------------- |
| `2.21.1` | 新增必填的 `--org-id` 选项，并将项目创建迁移至 `POST /v2/orgs/{orgId}/projects`。 |
| `2.20.0` | 新增 `gt project create`，使用现已移除的 `POST /v2/projects` 路由。          |

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.