---
title: "alpacon whoami"
description: "Alpacon CLI에서 현재 로그인한 사용자와 워크스페이스, 권한을 확인합니다. 서버 명령을 실행하기 전에 인증 정보를 점검하고 작업 세션이 필요한지, 어떤 세션이 활성 상태인지 확인하세요. 명령 사용법과 JSON 출력 플래그, 현재 로그인한 사용자 조회 예제를 안내합니다."
---

> Full documentation index: https://docs.alpacax.com/llms.ko.txt

# alpacon whoami

현재 로그인한 사용자, 워크스페이스, 권한을 확인합니다.

## 사용법

`alpacon whoami [flags]`

## 핵심 사항

- 명령 실행 전 현재 인증된 사용자 확인
- 작업 세션 필요 여부와 활성 세션 확인
- 스크립트에서는 `--output json`으로 결과 조회

## 플래그

| 플래그 | 유형 | 설명 | 기본값 |
| --- | --- | --- | --- |
| `-h, --help` | `bool` | 명령 도움말 표시 | `false` |
| `--output` | `string` | 출력 형식: `table` 또는 `json` | `table` |

## 예제

현재 ID 표시

```bash
alpacon whoami
```

JSON으로 출력 (스크립팅 또는 AI 에이전트에 유용)

```bash
alpacon whoami --output json
```

## 출력 필드

| 필드 | 설명 |
|------|------|
| User | Alpacon 사용자명 |
| Email | 이메일 주소 |
| Workspace | 워크스페이스 이름 및 URL |
| Auth | 인증 방식 (브라우저 로그인 또는 API 토큰) |
| Expires | 토큰 만료 시간 (API 토큰 인증 시에만 표시) |
| UID | 서버의 시스템 사용자 ID |
| Shell | 기본 셸 |
| Home | 홈 디렉터리 |
| Role | user, staff, 또는 superuser |
| Groups | 그룹 멤버십 및 역할 |
| WS required | 현재 인증에 [alpacon work-session](/reference/cli/work-session/)이 필요한지 여부와 지정된 활성 세션 |

## JSON 출력의 작업 세션 필드

`--output json`을 사용하면 작업 세션 상태가 전용 필드로 보고됩니다. 게이트 대상 명령을 실행하기 전에 세션을 생성할지 판단하는 스크립트와 AI 에이전트에 유용합니다.

| 필드 | 설명 |
|------|------|
| `worksession_required_for_access` | 브라우저 로그인에 활성 작업 세션이 필요하면 `true` (`work_session_required`는 레거시 별칭) |
| `active_worksession` | 활성 세션 요약(`id`, `status`, `scopes`, `servers`, `expires_at`), 없으면 `null` (`active_work_session`은 레거시 별칭) |

```json
{
  "worksession_required_for_access": true,
  "active_worksession": {
    "id": "11111111-2222-3333-4444-555555555555",
    "status": "active",
    "scopes": ["command", "websh"],
    "servers": ["web-01"],
    "expires_at": "2027-01-15T12:00:00Z"
  }
}
```

작업 세션이 필요한데 활성 세션이 없다면 [alpacon work-session create](/reference/cli/work-session/create/)로 생성하세요.

Source: https://docs.alpacax.com/ko/reference/cli/whoami/