---
title: "alpacon edit"
description: "Alpacon CLI로 원격 파일을 내려받아 로컬 에디터에서 편집합니다. 에디터를 닫으면 수정한 파일을 서버의 원래 경로에 업로드합니다. 사용자 이름과 서버를 포함한 원격 경로 지정법, 에디터와 작업 세션 플래그, 파일 편집에 사용할 예제 및 파일 전송 권한을 확인하세요."
---

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

# alpacon edit

로컬 에디터로 원격 파일을 편집합니다.

## 사용법

`alpacon edit [USER@]SERVER:PATH [flags]`

## 핵심 사항

- 원격 경로 형식은 `[USER@]SERVER:/path`
- 에디터를 닫으면 수정한 파일을 원래 경로에 업로드
- 파일 전송 권한은 `alpacon cp`와 같음

## 플래그

| 플래그 | 유형 | 설명 | 기본값 |
| --- | --- | --- | --- |
| `--editor` | `string` | 실행할 에디터 명령 (기본값: ALPACON_EDITOR, VISUAL, EDITOR, 다음 vi) | — |
| `--force` | `bool` | 10 MB 초과 파일을 확인 없이 편집 | `false` |
| `-g, --groupname` | `string` | 그룹 이름 지정 | — |
| `-h, --help` | `bool` | 명령 도움말 표시 | `false` |
| `-u, --username` | `string` | 사용자 이름 지정 | — |
| `--work-session` | `string` | 이 편집을 작업 세션에 연결 ('work-session use' 설정보다 우선) | — |
| `--output` | `string` | 출력 형식: `table` 또는 `json` | `table` |

## 예제

원격 파일 편집

```bash
alpacon edit my-server:/etc/nginx/nginx.conf
```

특정 사용자로 편집

```bash
alpacon edit admin@my-server:/etc/hosts
alpacon edit -u admin my-server:/etc/hosts
```

특정 에디터 사용

```bash
alpacon edit my-server:/etc/nginx/nginx.conf --editor "code --wait"
```

10 MB 초과 파일을 확인 프롬프트 없이 편집

```bash
alpacon edit my-server:/var/log/large.txt --force
```

특정 작업 세션에 연결해 편집

```bash
alpacon edit my-server:/etc/nginx/nginx.conf --work-session SESSION_ID
```

## 상세 설명

로컬 에디터를 사용해 원격 서버의 파일을 편집합니다. 파일을 다운로드해 에디터로 열고, 에디터를 닫으면 원래 경로로 다시 업로드합니다. 파일 전송 및 권한 동작은 [alpacon cp](/reference/cli/cp/)와 동일합니다.

원격 경로는 `alpacon cp`와 같은 `[USER@]SERVER:/path` 형식을 사용합니다.

## 에디터 선택

에디터는 다음 순서로 결정됩니다:

1. `--editor` 플래그
2. `ALPACON_EDITOR` 환경 변수
3. `VISUAL` 환경 변수
4. `EDITOR` 환경 변수
5. `vi` (기본값)

`--editor` 값은 셸을 거치지 않고 명령과 인자로 분리되며, 파일 경로가 마지막 인자로 추가됩니다. 파이프, 리다이렉션, `&&` 같은 셸 문법은 동작하지 않습니다.

GUI 에디터(`code`, `cursor`, `subl` 등)는 창을 연 직후, 파일을 저장하기 전에 즉시 반환됩니다. wait 플래그 없이 사용하면 변경 사항이 업로드되지 않습니다. `--editor "code --wait"`처럼 에디터의 wait 플래그를 사용하세요. wait 플래그 없는 GUI 에디터가 감지되면 CLI가 경고를 출력합니다.

## 동작 방식

- **기존 파일만 편집**: 파일을 먼저 다운로드하므로 `alpacon edit`으로 새 원격 파일을 만들 수 없습니다.
- **변경 시에만 업로드**: 파일을 수정하지 않고 에디터를 닫으면 업로드를 생략하고 `No changes`를 출력합니다.
- **대용량 파일**: 10 MB 초과 파일은 열기 전에 확인 프롬프트를 표시합니다. `--force`로 생략할 수 있습니다. 비대화형 셸(스크립트 등)에서는 프롬프트가 표시되지 않으며 `--force` 없이는 편집이 거부됩니다.
- **업로드 실패**: 변경 사항을 업로드할 수 없으면 편집본을 로컬 임시 경로에 보존하고 해당 경로를 경고로 출력해 작업 내용이 유실되지 않도록 합니다.

## 작업 세션 요구 사항

브라우저 로그인으로 인증한 경우, `alpacon edit`을 실행하려면 `webftp` 기능을 포함한 활성 작업 세션이 필요합니다. 세션을 요청하고 관리하는 방법은 [alpacon work-session](/reference/cli/work-session/)을 참고하세요. 서비스 토큰 인증에는 이 요구 사항이 적용되지 않습니다. 토큰에는 대상 서버를 허용하는 서버 ACL과 경로를 허용하는 파일 ACL이 필요합니다. 파일을 보낼 때는 `upload`, 받을 때는 `download`, `edit`에는 두 권한 모두(또는 `*`)가 필요합니다.

새 개인 API 토큰에는 명령어 실행이나 파일 전송 범위를 부여할 수 없습니다. 해당 범위를 이미 가진 토큰도 2026년 12월 1일(00:00 UTC)부터는 명령 실행이나 REST 파일 전송을 새로 요청할 때 승인된 활성 작업 세션이 필요합니다. 그전까지는 작업 세션 밖에서도 요청이 실행되며 응답마다 경고 헤더가 붙습니다. 자세한 내용은 [토큰의 접근 범위](/use/settings/api-tokens/#토큰의-접근-범위)를 참고하세요. 서버는 기존 토큰 ACL도 검사합니다. 조회와 작업 세션 요청은 기존 인가 규칙을 따릅니다. 자동화와 CI에는 [서비스 토큰](/use/iam/applications/service-tokens/)을 쓰세요.

연결할 세션은 `--work-session` 플래그, `ALPACON_WORK_SESSION` 환경 변수, [alpacon work-session use](/reference/cli/work-session/use/)로 지정한 활성 세션 순으로 결정됩니다. 게이트가 편집을 거부하면 `edit`은 종료 코드 **3**으로 종료합니다. `--output json`으로 실행하면 stderr에서 기계가 읽을 수 있는 진단을 받을 수 있습니다. 에러 코드는 [alpacon work-session](/reference/cli/work-session/#게이트-에러)를 참고하세요.

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