---
title: "작업 세션 문제 해결"
description: "작업 세션 요청 거부, 승인 대기, 작업 중 만료, CLI 진입 오류, 서버 계정 누락, 연장 실패에 대처하는 방법을 안내합니다. 화면과 CLI에 표시되는 메시지로 원인을 구분하고 필요한 조치를 확인하세요. 승인자에게 문의할 경우와 다른 세션을 요청해야 하는 경우도 설명합니다."
---

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

# 작업 세션 문제 해결

아래에서 화면이나 CLI에 표시된 메시지를 찾아보세요. 제출 시 거부된 요청, 승인을 기다리는 요청, 만료된 세션은 각각 조치 방법이 다릅니다.

## 요청이 거부된 경우

제출 전에 요청 폼의 결과 카드와 서버별 계정 안내를 확인하세요. 세션을 시작할 수 없다면 선택한 서버, 계정, 기능을 다시 살펴보세요.

제출에 실패했다면 오류 코드와 메시지에 따라 조치하세요.

CLI에서도 에이전트가 `websh`를 요청하면 `"websh" is not allowed for agent sessions`가 표시됩니다. `command`를 요청하고 `alpacon exec`로 명령어를 실행하세요.

승인자가 반려하면 페이지에 "요청이 거절됐어요"와 반려된 시각이 표시되며, 작업이 아직 필요하면 다시 요청하라는 안내가 나옵니다. 사유는 페이지에 표시되지 않으므로 다시 요청하기 전에 승인자에게 문의하세요. [접근 규칙](/use/approvals/#접근-규칙)을 참고하세요.

## 요청이 승인을 기다리는 경우

"승인을 기다리고 있어요"는 세션이 아직  상태라는 뜻입니다. 페이지에는 승인자에게 알린 시각과 "승인되면 바로 작업할 수 있어요."라는 안내가 표시됩니다. [승인 권한이 있는 사람](/use/approvals/#요청을-승인할-수-있는-사람)의 결정을 기다리세요. 시작을 예약한 세션은 시작 시각까지 기다려야 합니다.

CLI에서 `work-session create --wait`를 실행하면 `Waiting for approval...`이 표시됩니다. `timed out waiting for approval after 5m0s`는 CLI가 대기를 멈췄다는 뜻이며, 요청이 반려됐다는 뜻은 아닙니다. 다시 제출하기 전에 세션 상태를 확인하세요. 요청을 생성할 때 `--wait-approval DURATION`을 지정하면 더 오래 기다릴 수 있습니다.

다음 메시지와 함께 대기가 끝날 수도 있습니다.

| CLI 메시지 | 조치 |
| --- | --- |
| `work session was rejected` | 승인자에게 사유를 문의하세요. |
| `work session expired while waiting for approval` | 다른 세션을 요청하세요. |
| `work session was revoked` | 다시 접근을 요청하기 전에 관리자에게 문의하세요. |
| `work session was cancelled` | 접근이 필요하면 다시 요청하세요. |

대기 중인 요청을 취소하려면 "요청 취소"를 선택하거나 [`alpacon work-session cancel`](/reference/cli/work-session/cancel/)을 실행하세요. 요청자 또는 Superuser만 취소할 수 있습니다. 검토 전에 요청이 만료되거나 요청한 종료 시각이 지나도 자동으로 취소됩니다.

## 작업 중에 세션이 만료된 경우

웹 터미널에는 **작업 세션이 만료되어 세션이 끝났어요.**가 표시됩니다. API 오류 `work_session_expired`의 메시지는 **작업 세션이 만료돼서 세션으로 받은 권한이 사라졌어요. 계속하려면 새 작업 세션을 시작해 주세요.**입니다.

명령어를 실행하면 CLI에 다음 메시지가 표시될 수 있습니다.

```text
Error: the command operation requires an active WorkSession on this authentication.
```

사유는 `selected session has expired`이며, 종료 코드는 `3`입니다.

다른 세션을 요청하고 필요한 승인을 받은 뒤 다시 접속하세요. 만료된 세션은 연장할 수 없습니다. 세션의 터미널, 파일 전송, 포트 포워딩, 에디터 연결은 닫히며, 연장 요청이 대기 중이어도 연결이 유지되지는 않습니다. 작업을 계속하기 전에 [세션 이력](/use/audit/sessions/)을 확인하세요.

이후에는 만료까지 남은 시간이 10분 이내라는 경고를 받으면 세션이 끝나기 전에 [연장을 요청](/use/work-sessions/detail/#승인을-통한-연장)하세요.

## CLI에서 세션에 연결할 수 없는 경우

다음 메시지로 진입에 실패한 원인을 구분할 수 있습니다.

| CLI 출력 | 조치 |
| --- | --- |
| `work-session  is in '<status>' state and cannot be used` | 상태를 확인하고 승인 또는 활성화를 기다리세요. 끝난 세션이라면 다른 세션을 요청하세요. |
| `work-session  is an agent session and is not workspace-attachable; agent sessions run non-interactively via their assigned token` | `work-session use`나 `--use` 대신 에이전트 명령어마다 `--work-session ID`를 지정하세요. |
| `this CLI runs under an AI agent, and the work session is a user session—create an agent session with 'alpacon work-session create' and pass its ID with --work-session` | 에이전트 세션을 생성하고 명령어마다 ID를 지정하세요. |
| `no WorkSession selected for this shell` | 사람의 활성 세션은 `alpacon work-session use ID`로 진입하세요. 에이전트 세션은 `--work-session ID`를 지정하세요. |

`work_session_required`처럼 접근이 거부되면 종료 코드 `3`을 반환합니다. Websh를 쓰려면 `-t` 없이 `alpacon login`으로 사용자 로그인을 해야 합니다. [`work-session use`](/reference/cli/work-session/use/)를 참고하세요.

## 서버에 계정이 없는 경우

세션 페이지에 “`{account}` 계정 없음”이나 “본인 계정 없음”이 표시되면 실행할 수 없습니다. 어떤 기능도 실행할 수 없으면 **이 세션의 서버와 연결 계정 조합으로는 실행할 수 있는 작업이 없어요. 관리자에게 계정 생성을 요청하거나 연결 계정을 바꿔주세요.**가 표시됩니다.

접속할 때 `server_username_groupname_invalid` 오류가 발생하면 메시지는 **username 또는 그룹명이 등록되지 않았거나 권한이 없어요.**입니다. `exec`에 `-u`를 지정하지 않았다면 CLI에 `no execution user was resolved for '<server>' server`와 함께 `-u USERNAME`을 지정하라는 안내가 표시될 수도 있습니다.

**접속 계정**에서 선택한 계정을 확인하세요. 관리자에게 그 서버에 계정을 만들어 달라고 요청하거나, 세션 페이지의 "접속 계정 변경"에서 다른 계정을 요청하세요. 계정 변경 요청은 승인을 받아야 적용됩니다. `-u USERNAME`은 실행할 계정을 선택할 뿐이며, 계정을 만들거나 사용 권한을 부여하지 않습니다.

Linux에서는 첫 접속 때 본인 계정이 자동으로 생성될 수 있습니다. macOS와 Windows에서는 자동으로 생성되지 않습니다. [사용자명](/use/iam/users/username/)을 아직 설정하지 않았다면 먼저 설정하고, 관리자에게 서버 계정을 확인해 달라고 요청하세요. [계정 또는 권한 문제](/use/work-sessions/troubleshoot-connections/#계정이-존재하지-않거나-권한이-없는-경우)를 참고하세요.

## 연장이 거부된 경우

연장하려면 사유가 필요하며, 세션이 시작됐고 아직 만료되지 않아야 합니다. 요청한 종료 시각도 워크스페이스 한도 이내여야 합니다. 조건을 충족하지 못하면 다음 오류가 표시됩니다.

CLI에서는 다음 세 오류에 구체적인 조치 방법을 안내합니다.

| 오류 | CLI 메시지 |
| --- | --- |
| `work_session_extension_reason_required` | `Pass --reason "..." describing why you need more time, and retry.` |
| `work_session_extension_already_pending` | `Work session  already has an extension request pending approval; wait for it to be decided before asking again. Find its id with 'alpacon work-session describe  --output json' (field pending_extension_request.id).` |
| `work_session_admission_denied` | `This workspace refuses this extension outright; ask an admin to adjust the work-session admission policy.` |

승인 큐에 들어간 연장 요청도 다음과 같은 이유로 적용되지 않을 수 있습니다.

- 승인자가 반려했습니다. 알림 제목은 `{target}에 대한 {request_type} 요청이 거절됐어요`이며, 요청 유형은 `작업 세션 연장`입니다. 세션 페이지에 사유가 표시되지 않으므로 승인자에게 문의하세요.
- 결정 전에 요청이 만료되거나 세션이 끝났습니다. 기존 종료 시각이 유지됩니다. 세션이 만료되지 않았다면 다시 연장을 요청하고, 만료됐다면 다른 세션을 요청하세요.
- 접속 계정이 다른 사람에게 연결됐습니다. 그 계정으로 추가 셸 접속과 명령어 실행이 거부되며 세션도 연장할 수 없습니다. 관리자에게 계정 연결 상태를 확인해 달라고 요청하세요.

[승인을 통한 연장](/use/work-sessions/detail/#승인을-통한-연장)과 [오류 메시지](/reference/error-messages/)를 참고하세요.

## 관련 문서

- [세션 요청하기](/use/work-sessions/create/)
- [세션 사용하기](/use/work-sessions/detail/)
- [실시간 활동](/use/live-activity/)
- [세션 이력](/use/audit/sessions/)

Source: https://docs.alpacax.com/ko/use/work-sessions/troubleshooting/