> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 账户

> 登录、登出并检查当前激活的 CLI 账户上下文

CLI 对需要认证的命令使用 API key。你可以通过 `youka login` 一次性保存它，或在 CI 等非交互环境中通过 `YOUKA_API_KEY` 提供。

`youka login` 会在保存前通过 API 验证该 key，然后将解析到的账户邮箱缓存到 `~/.youka/config.json` 中，用于诊断。

## `login`

将 API key 保存到 `~/.youka/config.json`。

```bash theme={null}
youka login [token]
```

<ParamField path="token" type="string">
  从 Youka dashboard 复制的 API key。如果省略，CLI 会在交互式终端中提示你输入。
</ParamField>

### 示例

<CodeGroup>
  ```bash token theme={null}
  youka login yk_live_abcd1234
  ```

  ```bash with-api theme={null}
  youka login yk_live_abcd1234 --api https://staging-api.youka.test --json
  ```
</CodeGroup>

<Tip>在 CI 中，建议优先使用 `YOUKA_API_KEY`，而不是写入配置文件。</Tip>

## `logout`

从 `~/.youka/config.json` 中移除已保存的 API key。

```bash theme={null}
youka logout
youka logout --json
```

## `whoami`

检查解析后的 key 来源、API URL 和账户身份。

```bash theme={null}
youka whoami
youka whoami --json
```

响应示例：

```json theme={null}
{
  "ok": true,
  "data": {
    "authenticated": true,
    "tokenPresent": true,
    "authStatus": "verified",
    "identitySource": "live",
    "keySource": "config",
    "apiUrl": "https://api.youka.io/zh/api/v1",
    "apiUrlSource": "default",
    "email": "user@example.com",
    "userId": "user_123",
    "apiKeyId": "key_123",
    "org": null,
    "configPath": "/Users/you/.youka/config.json",
    "apiKeyPreview": "yk_l...1234"
  }
}
```

### 解析顺序

| 字段      | 顺序                                                              |
| ------- | --------------------------------------------------------------- |
| API key | `YOUKA_API_KEY`，然后 `~/.youka/config.json`                       |
| API URL | `--api`，然后 `YOUKA_API_BASE_URL`，然后 `~/.youka/config.json`，然后默认值 |

当启用已保存的 config key 时，`whoami` 会通过 API 验证身份；只有在实时查询不可用时，才会回退到缓存的账户邮箱。对于 `YOUKA_API_KEY` token，它不会使用缓存的 config 身份。

## 下一步

* [全局选项](/zh/cli/global-options) - 每个命令共享的 flags
* [项目](/zh/cli/projects) - 创建并处理卡拉 OK 项目