# gt: General Translation CLI tool: gt login
URL: https://generaltranslation.com/zh/docs/cli/reference/commands/login.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 登录你的账户以使用托管的 CLI 工作流。gt login 命令的 API 参考。

使用 login 为现有配置完成身份验证。如需引导式项目设置，请运行 [`gt init`](/docs/cli/reference/commands/init)；在创建项目或密钥时，如果没有可用的工具密钥或已保存的登录会话，它会自动为你登录。如需创建限定权限范围的密钥，请使用 [`gt api-key create`](/docs/cli/reference/commands/api-key-create)。

## 概览 [#overview]

需要 [Node.js 20 或更高版本](/docs/cli/quickstart#quickstart)；建议使用当前仍在维护的 LTS 版本。

```bash
npx gt login [options]
```

| 参数                              | 描述                               | 类型        | 可选 | 默认值              |
| ------------------------------- | -------------------------------- | --------- | -- | ---------------- |
| [`--no-browser`](#flags)        | 使用设备授权，而不是本地浏览器回调。               | `boolean` | 是  | `false`          |
| [`-c, --config <path>`](#flags) | 配置文件，其中的 `baseUrl` 用于指定要登录的 API。 | `string`  | 是  | `gt.config.json` |

<Callout type="info">
  **v2.22 变更：** 原有的 auth 命令及其密钥类型选项已被直接移除，不再作为别名保留。账户登录改由 login 完成；预配则由 init 和显式创建密钥负责。现有的 API Key 仍可继续使用。
</Callout>

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

* 打开浏览器，供你批准 CLI 访问你的账户。
* 你的账户权限决定了你可以访问哪些项目和执行哪些操作。
* 使用 `--no-browser` 时，或无法在本机监听浏览器回调时，将改用设备授权：CLI 会显示验证 URL 和验证码，供你在另一台设备上批准。
* 在 SSH 会话中会自动使用设备授权。仅仅是浏览器启动失败并不会切换模式；此时请自行打开显示的授权 URL，或使用 `--no-browser` 重新运行。
* 保存的是账户会话，而非所选项目。它不会创建 API Key，也不会写入 `.env.local`。运行时 SDK 不会加载 CLI 会话。

有关项目绑定、显式密钥优先级以及 CI 凭据，请参阅[配置 CLI](/docs/cli/guides/configuring#credentials)。

## 选项 [#flags]

**`--no-browser`** · **类型** `boolean` · **可选** · **默认值** `false`

使用设备授权流程，但不自动打开浏览器。此方式仍需人工批准，并不适用于无人值守的 CI 身份验证。

**`-c, --config <path>`** · **类型** `string` · **可选** · **默认值** `gt.config.json`

从指定的配置文件读取 [`baseUrl`](/docs/cli/reference/config#base-url)，而非自动发现的 `gt.config.json`。`GT_API_URL` 的优先级仍高于该值。需要 `gt` 2.23.0 或更高版本。

[全局选项](/docs/cli/reference/global-options)同样适用。

## 示例 [#examples]

```bash
# 使用本机浏览器登录
npx gt login

# 在其他设备上批准登录
npx gt login --no-browser
```

授权通过后，可使用 [`gt whoami`](/docs/cli/reference/commands/whoami) 查看当前登录的账户。如需清除已保存的会话，请使用 [`gt logout`](/docs/cli/reference/commands/logout)。

## 存储与故障排除 [#storage]

如果 `XDG_STATE_HOME` 为绝对路径，会话将存储在 `$XDG_STATE_HOME/gt/credentials.json`；否则存储在 `~/.local/state/gt/credentials.json`。相对路径形式的 XDG 值会被忽略。

在系统支持的情况下，凭据文件的权限仅限所有者访问；凭据不会被加密，也不会存储在操作系统钥匙串中。旧格式的已保存登录信息不会自动迁移。如果已保存的凭据已过期或无效，请重新登录。损坏的凭据文件会保留为 `.corrupt-<timestamp>` 备份。

CLI 会在不同命令之间保持你的登录状态。请避免多个 CLI 进程同时更新同一份已保存的登录信息。

## Sitemap

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