원격 개발 및 관리

이 가이드에서는 네 가지를 설명합니다. 네트워크의 다른 기기에서 이 VelaTerm을 사용할 수 있도록 여는 방법, SSH나 페어링 링크로 다른 컴퓨터에 연결하는 방법, VelaTerm 계정을 통해 내 기기들과 대화를 공유하는 방법, 원격 컴퓨터와 파일을 주고받는 방법입니다.

1. 진입점

원격 기능은 제목 표시줄 오른쪽에 있습니다.

• 지구본 아이콘은 "원격 접속 (브라우저)" 버튼입니다. 같은 네트워크에 있는 휴대폰, 태블릿 또는 다른 컴퓨터에서 웹 브라우저로 이 VelaTerm을 사용할 수 있게 합니다. 서버가 실행되는 동안에는 아이콘이 강조색으로 표시되고, 도구 설명에 "실행 중 · 포트 N"이 추가됩니다.
• 화살표 아이콘은 "원격 서버에 연결" 버튼입니다. SSH, 페어링 링크 또는 VelaTerm 계정을 통해 이 컴퓨터를 다른 컴퓨터의 클라이언트로 만듭니다.
• 사람 아이콘은 "계정" 버튼이며 "실험 기능" 표시가 붙어 있습니다. 이 컴퓨터로 VelaTerm 계정에 로그인하여, 로그인한 다른 기기와 인터넷을 통해 대화를 공유할 수 있게 합니다.

그 옆의 "공유" 버튼은 "VelaTerm 공유" 창을 엽니다. 이 창은 다른 사람에게 VelaTerm을 추천하기 위한 것이며, 세션을 공유하지는 않습니다.

2. 다른 기기에서 이 컴퓨터 사용하기(원격 접속)

2.1 서버 시작

지구본 버튼을 클릭합니다. "포트"(기본값 8799, 마지막으로 사용한 포트를 기억함), 페어링 링크에 사용할 "IP" 주소("자동 (첫 번째 LAN 주소)" 또는 특정 인터페이스, VPN 인터페이스에는 "VPN" 표시), 접속 비밀번호("접속 비밀번호 설정")를 지정한 다음 "서버 시작"을 클릭합니다.

접속 비밀번호는 연결하는 모든 기기에 필요합니다. 서버가 실행되는 동안 패널에는 앱을 다시 열면 원격 접속이 자동으로 다시 시작되며 "서버 중지"로 이 동작을 끌 수 있다는 안내가 표시됩니다. 이후 앱을 실행할 때 자동 시작에 실패하면 패널에 "자동 시작 실패:"와 그 이유가 표시됩니다.

"기기 간 레이아웃 미러링" 확인란은 기본적으로 선택되어 있습니다. 이 옵션을 켜면 연결된 모든 기기에서 탭, 분할 창, 활성 세션이 동일하게 유지되며, 키보드 포커스는 기기마다 따로 유지됩니다. 기기마다 탭을 따로 배치하려면 이 옵션을 끕니다.

2.2 기기 연결

서버가 실행되면 패널에 상태, "인증서 지문 (SHA-256)", 페어링 링크, QR 코드가 표시됩니다.

기기를 연결하려면 기기의 카메라로 QR 코드를 스캔하거나, 페어링 링크를 기기로 보낸 다음(예: AirDrop 또는 자신에게 보내는 메시지) 브라우저에서 링크를 열고 접속 비밀번호를 입력합니다. 페어링 링크와 비밀번호가 모두 필요하며, 페어링 링크 없이 주소만 열면 "이 서버는 페어링 링크가 필요합니다."라는 메시지가 표시됩니다. 브라우저와 이 컴퓨터 사이의 통신은 종단 간 암호화됩니다.

보안과 관련하여 다음 두 가지를 알아 두어야 합니다.

• 페어링 링크에는 접속 자격 증명이 들어 있으므로 자신의 기기에만 공유하십시오. 링크가 유출되었다고 생각되면 "링크 재생성(모든 기기 연결 해제)"을 클릭합니다. 이전 링크는 즉시 사용할 수 없게 되고, 연결된 모든 기기는 새 링크를 열 때까지 연결이 끊어집니다.
• 처음 접속하면 브라우저에서 인증서를 신뢰할 수 없다는 경고가 표시되는데, 자체 서명 인증서에서는 정상적인 동작입니다. 브라우저에 표시된 지문과 패널의 지문을 비교하십시오. 두 지문이 일치하면 자신의 컴퓨터에 연결된 것입니다.

컴퓨터에 네트워크 인터페이스가 여러 개(유선, Wi-Fi, VPN) 있으면 패널에 기본 주소가 표시되고, 나머지 주소는 "다른 링크 N개" 아래에 나열됩니다. 연결하려는 기기와 같은 네트워크에 있는 주소를 선택합니다.

페어링 링크는 VelaTerm을 다시 시작해도 유효합니다. "링크 재생성(모든 기기 연결 해제)"을 사용할 때만 새 링크로 바뀝니다.

2.3 브라우저 클라이언트로 할 수 있는 작업

연결된 기기의 로그인 페이지와 메인 인터페이스는 다음과 같습니다.

브라우저 클라이언트는 데스크톱 앱과 같은 실시간 세션을 사용합니다. 프로젝트 트리와 터미널 및 대화 출력이 동일하며, 양쪽 모두에서 입력할 수 있습니다. "기기 간 레이아웃 미러링"이 켜져 있으면 호스트의 제목 표시줄에 "N대가 미러링 중"이 표시되며, 이를 클릭하면 "연결된 클라이언트"의 이름, 주소, 연결 시각을 볼 수 있습니다. 클라이언트 이름은 클라이언트가 스스로 보고하는 값이므로, 신원을 증명하는 정보가 아니라 식별용 이름으로만 간주하십시오.

같은 터미널이 여러 기기에서 열려 있으면 터미널 크기는 그중 한 기기를 따릅니다. 다른 기기에는 축소된 사본이 표시되고, 터미널 오른쪽 위에 "⤢ 미러… · 클릭해 이 창에 맞춤" 배지가 표시됩니다. 배지를 클릭하면 터미널 크기가 현재 창에 맞춰집니다.

브라우저 클라이언트에는 브라우저 탭과 기본 이미지 붙여넣기 옵션이 없습니다. 파일 탭에서 파일을 업로드하고 다운로드할 수 있습니다(§5).

2.4 페어링된 기기

실행 중인 패널에서 "페어링된 기기"를 클릭하면 지금까지 연결한 모든 기기와 각 기기의 "마지막 연결" 시각이 표시됩니다.

기기를 차단하려면 "차단"을 클릭한 다음 "차단 확인"을 클릭합니다. 해당 기기는 즉시 연결이 끊어지며, 새 페어링 링크를 열기 전까지 다시 연결할 수 없습니다. 다른 기기에는 영향이 없습니다. 모든 기기의 연결을 한 번에 끊으려면 "링크 재생성(모든 기기 연결 해제)"을 사용합니다.

2.5 서버 중지

패널 아래쪽의 "서버 중지"를 클릭합니다. 브라우저 클라이언트의 연결은 끊어지지만, 실행 중인 세션은 데스크톱 앱에 속하므로 계속 실행됩니다. 서버를 중지하면 자동 시작도 꺼지며, 다음에 서버를 시작할 때 접속 비밀번호를 다시 입력해야 합니다.

3. 다른 컴퓨터에 연결하기

제목 표시줄의 연결 버튼을 클릭합니다. 패널에는 "SSH", "URL", "Remote"의 세 가지 탭이 있습니다.

3.1 SSH: 원격 컴퓨터에는 SSH만 있으면 됨

VelaTerm 구성 요소가 전혀 설치되지 않은 원격 컴퓨터에 사용합니다. 원격 컴퓨터의 운영 체제는 Linux(x86_64 또는 ARM64), macOS(Apple silicon 또는 Intel), Windows(x86_64) 중 하나일 수 있으며, Windows 컴퓨터에서는 Microsoft의 OpenSSH 서버나 Cygwin 또는 MSYS2의 SSH 서버를 사용할 수 있습니다. 연결하면 전체 설정이 자동으로 진행됩니다. VelaTerm이 원격 시스템을 감지하고, 알맞은 VelaTerm 서버를 복사하고, 서버가 독립적으로 계속 실행되도록 시작한 다음, 로컬 포트를 서버로 포워딩하고, 자동으로 로그인되는 원격 창을 엽니다.

user@host[:port]를 입력하고 "연결"을 클릭합니다. 알아 두면 좋은 세부 사항은 다음과 같습니다.

호스트 키 확인. 호스트에 처음 연결하면 "SSH 호스트 키 지문"과 함께 "이 호스트에 처음 연결합니다. 계속하기 전에 지문을 확인하세요."라는 안내가 표시됩니다. 지문을 확인하고 "지문 확인 후 연결"을 클릭하면 키가 known_hosts에 저장되며, 이후에는 다시 묻지 않습니다. 알고 있는 호스트의 키가 바뀌면 "⚠ 이 호스트의 키가 변경되었습니다. 서버 재설치이거나 중간자 공격일 수 있습니다. 확실한 경우에만 계속하세요."라는 빨간색 경고가 표시됩니다. 확인하기 전에 원인을 파악하십시오.

인증. 기존 SSH 설정(ssh-agent, ~/.ssh/config, 키)을 그대로 사용합니다. "SSH 비밀번호" 입력란은 키 인증에 실패했을 때만 표시됩니다. "비밀번호 저장"을 선택하면 비밀번호를 데이터베이스가 아닌 시스템 키체인에 저장하고, 다음 연결 때 사용합니다.

원격 데스크톱 앱 미러링. 이 옵션은 기본적으로 꺼져 있으며 호스트별로 기억됩니다. 원격 컴퓨터에서도 VelaTerm 데스크톱 앱이 실행 중이고 그 화면을 그대로 보고 싶을 때 켭니다. 같은 탭, 분할 창, 활성 세션이 표시되며, 어느 쪽에서 변경하든 양쪽에 모두 반영됩니다. 원격 컴퓨터에서 데스크톱 앱이 실행 중이 아니면 VelaTerm은 데스크톱 앱의 데이터베이스를 직접 열고, 데이터베이스가 없으면 별도의 데이터베이스를 사용합니다. 이 옵션을 사용하지 않으면 원격 서버는 그 컴퓨터에 설치된 데스크톱 앱과 별개인 자체 데이터 디렉터리(~/.velaterm/data, Windows에서는 %USERPROFILE%\.velaterm\data)를 사용합니다.

연결 버튼을 클릭할 때 Option(Windows와 Linux에서는 Alt)을 누르고 있으면, 미러링이 꺼져 있을 때 "원격 데스크톱 앱의 데이터베이스 공유" 옵션이 하나 더 표시됩니다. 이 옵션을 사용하면 원격 서버가 실행 중인 앱에 연결하지 않고 원격 데스크톱 앱의 데이터베이스를 엽니다. 양쪽 모두 같은 VelaTerm 버전을 사용하는 것이 좋습니다.

최근 호스트. 연결한 적이 있는 호스트는 "최근 호스트"에 나열됩니다("모두 보기 (N)"를 누르면 전체 목록 표시). 항목을 클릭하면 양식만 채워지므로, 내용을 확인한 다음 "연결"을 클릭합니다. 열쇠 아이콘은 비밀번호가 저장되어 있다는 뜻이며, ×("이 호스트 삭제")를 누르면 호스트와 저장된 비밀번호가 삭제됩니다.

진행 상황. 처음 연결할 때는 서버(수십 MB)를 복사하므로, 버튼에 "서버 준비 중…", "서버 전송 중…", "서버 시작 중…"이 진행률과 함께 표시됩니다. 이후 연결에서는 원격 컴퓨터에 이미 있는 서버를 재사용하므로 훨씬 빠릅니다.

3.2 URL: 다른 컴퓨터에서 원격 접속이 실행 중인 경우

다른 컴퓨터의 VelaTerm에서 원격 접속이 실행 중이고(§2) 그 페어링 링크를 가지고 있을 때 사용합니다. 웹 브라우저에서 링크를 여는 것과 달리, 전용 창, 시스템 키체인에 저장된 비밀번호를 이용한 자동 로그인, 앱에서 처리하는 지문 확인을 사용할 수 있습니다.

페어링 링크를 붙여 넣고, 다른 컴퓨터에서 설정한 "로그인 비밀번호"를 입력한 다음 "연결"을 클릭합니다. 처음 연결하면 다른 컴퓨터의 TLS 인증서 지문이 표시되므로, 그 컴퓨터의 패널에 표시된 "인증서 지문 (SHA-256)"과 비교합니다. 이후 지문이 바뀌지 않았으면 바로 연결되고, 지문이 바뀌었으면 빨간색 경고가 표시됩니다. 최근에 사용한 페어링 링크는 SSH 호스트처럼 양식 아래에 나열됩니다.

3.3 Remote: 같은 계정에 로그인한 기기

"Remote" 탭에는 VelaTerm 계정(§4)에 로그인한 기기가 나열됩니다. 각 기기에는 "온라인" 또는 "오프라인" 상태와 공유 중인 대상(예: "전체 작업 공간", 프로젝트 또는 대화)이 표시되며, 공유하는 내용이 없으면 "이 기기에서 공유하는 콘텐츠가 없습니다."가 표시됩니다. 기기가 온라인 상태이고 공유 중이면 "공유 콘텐츠 보기 →"를 눌러 새 창에서 공유 콘텐츠를 열 수 있습니다. 로그인하지 않았다면 탭에 "VelaTerm 로그인" 링크가 표시됩니다.

4. VelaTerm 계정을 통한 공유(실험 기능)

계정 공유를 사용하면 한 컴퓨터에서 실행 중인 AI 대화를 인터넷을 통해 다른 기기에서 이어 갈 수 있으며, 포트를 열거나 같은 네트워크에 있을 필요가 없습니다. 공유 콘텐츠는 종단 간 암호화된 상태로 velaterm.com을 거쳐 전달됩니다. 이 기능은 실험 단계입니다.

4.1 로그인

제목 표시줄의 계정 버튼을 클릭합니다. "계정" 대화 상자에 "VelaTerm 로그인"이 표시되며, 이를 클릭하면 웹 브라우저에서 로그인을 계속 진행합니다. VelaTerm이 기다리는 동안 "브라우저에서 로그인을 완료한 후 VelaTerm으로 돌아가세요."라는 안내가 표시됩니다. "로그인 요청 세부 정보"를 펼치면 요청 내용을 웹사이트에 표시된 내용과 비교할 수 있습니다.

로그인하면 대화 상자에 이름과 "계정 ID:", velaterm.com의 계정 페이지를 여는 "계정" 버튼, "로그아웃"이 표시됩니다. 로그아웃하면 이 컴퓨터의 연결이 끊어지고 이 컴퓨터에서 공유하던 모든 항목의 공유가 중지됩니다.

4.2 콘텐츠 공유

"콘텐츠 공유" 아래에서 "공유 범위"로 "전체 작업 공간", "프로젝트", "대화" 중 하나를 선택합니다. 프로젝트나 대화를 선택한 경우 목록에서 대상을 고른 다음 "콘텐츠 공유"를 클릭합니다. 공유한 각 항목은 "공유 중" 아래에 상태("공유 중" 또는 "공유 준비 안 됨") 및 "공유 중지" 버튼과 함께 표시됩니다. 여러 항목을 동시에 공유할 수 있습니다. 공유는 앱을 다시 시작해도 유지되며, 이 컴퓨터에서 VelaTerm이 실행 중이고 온라인 상태일 때만 사용할 수 있습니다.

AI 대화만 공유됩니다. 일반 터미널과 브라우저 페이지는 공유되지 않으며, 공유 콘텐츠를 보는 기기에서는 터미널, 파일, 설정, 새 탭을 열 수 없습니다.

4.3 다른 기기에서 공유 콘텐츠 열기

같은 계정에 로그인한 다른 기기에서 연결 버튼의 "Remote" 탭(§3.3)을 열고 "공유 콘텐츠 보기 →"를 클릭합니다. 공유된 대화를 읽을 수 있습니다. 메시지를 보내고, 에이전트를 중단하고, 권한 요청에 응답할 수도 있지만, 이는 공유하는 컴퓨터에서 대화 보기로 표시되는 세션에서만 가능합니다. 다른 세션에서는 호스트가 먼저 세션을 대화 보기로 전환해야 한다는 안내가 창에 표시됩니다.

AI 에이전트는 공유하는 컴퓨터의 사용자 권한으로 동작하므로, 그 컴퓨터에서 명령을 실행하고 파일을 변경할 수 있다는 점에 유의하십시오. 공유된 대화를 이어 갈 수 있는 사람은 누구나 에이전트에게 지시할 수 있으므로, 자신이 관리하는 기기와만 공유하고 더 이상 접근이 필요 없으면 "공유 중지"를 사용하십시오.

5. 파일 전송

브라우저 클라이언트와 URL 및 SSH 원격 창에서는 오른쪽 패널의 파일 탭을 사용하여, 사용 중인 기기와 세션을 실행하는 컴퓨터 사이에서 파일을 옮길 수 있습니다. 로컬 데스크톱 앱에서는 이 기능이 필요하지 않으므로 해당 동작이 표시되지 않습니다.

• 업로드: 폴더나 폴더 안의 파일을 마우스 오른쪽 버튼으로 클릭하고 "파일 업로드…"를 선택하거나, 파일 탭 헤더의 업로드 버튼("이 폴더에 파일 업로드")을 클릭하거나, 파일 트리로 파일을 끌어다 놓습니다. 폴더는 업로드할 수 없습니다.
• 다운로드: 파일을 마우스 오른쪽 버튼으로 클릭하고 "다운로드"를 선택합니다. 웹 브라우저에서는 브라우저 자체의 다운로드 관리자를 통해 파일을 내려받습니다. URL 또는 SSH 원격 창에서는 저장 대화 상자에서 파일을 저장할 위치를 묻습니다(기본값은 다운로드 폴더).

업로드와 원격 창의 다운로드는 "전송" 목록에 크기, 속도, 남은 시간과 함께 표시됩니다. 취소 버튼을 클릭하면 해당 항목이 중지되고, "지우기"를 클릭하면 완료된 항목이 목록에서 제거됩니다. 업로드 중에 연결이 끊어지면 항목에 "다시 연결하는 중…"이 표시되고 VelaTerm이 약 1분 동안 계속 재시도합니다. 중단된 업로드는 대상 위치에 불완전한 파일을 남기지 않으며, 같은 파일을 다시 업로드하면 중단된 지점부터 이어서 업로드합니다.

6. 휴대폰에서 VelaTerm 사용하기

휴대폰 브라우저에서 페어링 링크(§2.2)를 엽니다. 예를 들어 원격 접속 패널의 QR 코드를 스캔하면 됩니다. 휴대폰에서는 VelaTerm이 작은 터치스크린에 맞게 설계된 레이아웃으로 전환됩니다. 레이아웃은 페이지를 불러올 때 결정되며, 화면의 짧은 쪽이 768픽셀보다 작은 터치 기기에서 사용됩니다. 주소에 ?view=mobile 또는 ?view=desktop을 추가하여 레이아웃을 직접 선택하거나(태블릿에서도 ?view=mobile 사용 가능), "추가 작업"(•••) 메뉴에서 "데스크톱 버전으로 전환"을 선택할 수 있으며, 선택한 레이아웃은 기억됩니다.

모바일 레이아웃은 두 단계로 구성됩니다.

• 세션 목록: 검색 상자("세션 / 그룹 검색…")와 상태 필터("작업 중", "처리 대기", "확인함")가 있는 프로젝트 트리입니다. 세션은 데스크톱 앱이나 컴퓨터의 브라우저에서 만들며, 만든 세션은 여기에 자동으로 표시됩니다.
• 세션 페이지: 세션을 탭하여 열고, "‹ 뒤로"를 눌러 목록으로 돌아갑니다. 대화 보기를 사용하는 세션은 전체 대화를 표시합니다. 터미널 보기로 실행되는 Claude Code, Codex, OpenCode, Pi, OMP 세션은 대화 내용과 함께 터미널에 입력을 보내는 메시지 입력란을 표시합니다. 그 밖의 세션은 터미널과 키 막대를 표시합니다. 키 막대에는 Esc, Tab, Ctrl(^C, ^D, ^R, ^W 같은 Ctrl 조합 행을 엶), 화살표 키, ^C, 키보드 버튼, 이미지를 보내는 카메라 버튼이 있습니다. 스와이프하여 스크롤하고, 탭하여 키보드를 표시하며, 길게 눌러 단어를 선택한 다음 "복사"할 수 있습니다.

모바일 레이아웃에는 브라우저 탭, 문서 탭, 분할 창이 표시되지 않고 키보드 단축키도 없으며, "기기 간 레이아웃 미러링"을 따르지 않고 자체 화면 구성을 유지합니다. Kiro 세션은 기록을 읽기 전용 보기로 제공합니다.

iOS용 VelaTerm은 App Store에서, Android용 VelaTerm은 Google Play에서 이용할 수 있습니다.

7. 연결 해제, 창 닫기, 유지되는 항목

7.1 세 가지 상태 계층

연결이 끊어진 뒤에도 모든 것이 그대로 남아 있는지는 계층에 따라 다릅니다.

주의가 필요한 것은 세 번째 계층뿐입니다. 원격 서버 프로세스가 실행되는 동안에는 실행 중인 세션도 계속 실행됩니다.

7.2 원격 창 닫기

SSH: 원격 서버는 이 연결로 시작되었으므로, 창을 닫으면 세 가지 선택지가 있는 "Disconnect remote" 대화 상자가 열립니다. "Stop server"는 원격 컴퓨터의 서버를 종료하고 실행 중인 세션을 끝냅니다. "Keep running"은 이 창의 연결만 끊으며, 다음에 그 컴퓨터에 연결하면 모든 세션이 그대로 있는 서버를 재사용합니다. "Cancel"은 창을 열어 둡니다. 자리를 비운 동안에도 에이전트가 계속 작업하게 하려면 "Keep running"을 선택합니다.

원격 데스크톱 앱에 연결된 SSH: "원격 데스크톱 앱 미러링"으로 창이 실행 중인 데스크톱 앱에 연결된 경우, 창을 닫으면 연결만 끊어지고 데스크톱 앱은 계속 실행됩니다.

URL: 이미 실행 중이던 VelaTerm에 손님으로 접속한 것입니다. 창을 닫으면 사용자가 나가는 것일 뿐이며, 상대 쪽은 계속 실행되고 다시 돌아오면 모든 것이 그대로 있습니다.

7.3 연결 끊김

네트워크 연결이 끊어지면 원격 창 위쪽에 "연결이 끊어졌습니다. 다시 연결하는 중…"이라는 빨간색 막대가 표시되고 VelaTerm이 자동으로 재시도합니다. 실행 중인 세션에는 영향이 없습니다. SSH 모드에서는 원격 서버가 SSH 연결과 관계없이 독립적으로 실행됩니다.

SSH 창에서는 VelaTerm이 SSH 터널도 자동으로 다시 구축합니다("SSH 연결이 끊어져 터널을 다시 구축하는 중…"). 재시도를 멈추면 막대에 SSH 연결이 끊어졌으니 다시 시도하라는 안내가 표시되며, 이때 "지금 다시 연결"을 클릭합니다. 원격 서버 자체가 중지된 경우에는 창에서 다시 연결해도 해결되지 않으므로, 메인 창으로 돌아가 다시 연결합니다. 이렇게 연결하면 원격 서버가 아직 실행 중인지 확인하여, 실행 중이면 모든 세션과 함께 재사용하고 실행 중이 아닐 때만 새 서버를 시작합니다.

원격 컴퓨터가 절전 모드로 전환되거나, 로그아웃되거나, 재부팅되면 SSH 모드의 서버와 실행 중인 세션이 종료됩니다. 프로젝트 트리는 디스크에 저장되므로 영향을 받지 않습니다.

7.4 빠른 참조

8. 보안 요약

• 비밀번호(SSH 비밀번호와 원격 로그인 비밀번호)는 "비밀번호 저장"을 선택한 경우에만 시스템 키체인에 저장되며, 데이터베이스에는 저장되지 않습니다. 원격 접속 비밀번호는 서버가 자동으로 다시 시작될 수 있도록 해시로만 저장됩니다.
• LAN 브라우저 접속은 자체 서명 인증서를 사용하는 TLS로 보호됩니다. 페어링 링크에는 종단 간 암호화 자격 증명이 들어 있으며, 서버는 페어링 링크가 없는 연결을 거부합니다.
• SSH 호스트 키와 원격 TLS 인증서는 처음 사용할 때 신뢰합니다. 이미 알고 있고 변경되지 않은 대상은 바로 연결되고, 새 대상은 한 번 확인을 요청하며, 지문이 바뀐 경우에는 빨간색 경고가 표시됩니다. 확인하기 전에 원인을 조사하십시오.
• 개별 기기는 언제든지 차단할 수 있고(§2.4), 페어링 링크는 필요할 때마다 다시 생성할 수 있습니다.
• 계정 공유는 AI 대화로 제한되지만, 해당 대화의 에이전트는 공유하는 컴퓨터에서 사용자의 권한으로 동작합니다(§4.3).

제목 표시줄에 "⚠ vX ≠ vY" 배지가 표시되면 인터페이스와 인터페이스가 연결된 VelaTerm 서비스의 버전이 서로 다르다는 뜻이며, 일부 기능이 함께 동작하지 않을 수 있습니다. 두 쪽이 같은 버전을 실행하도록 VelaTerm을 업데이트하십시오.

9. 자주 묻는 질문

창은 연결되어 있지만 사이드바가 비어 있거나 빨간색 막대가 사라지지 않습니다. 원격 서버가 중지되었을 가능성이 높습니다. 메인 창으로 돌아가 다시 연결하십시오(§7.3).

포트 8799에서 서버가 시작되지 않습니다. 다른 프로그램이 이 포트를 사용하고 있습니다. 패널에서 다른 포트를 선택한 다음 다시 시작하십시오.

브라우저에 인증서를 신뢰할 수 없다는 메시지가 표시됩니다. 자체 서명 인증서에서는 정상적인 동작입니다. 지문을 확인한 다음 계속하십시오(§2.2).

자리를 비운 동안에도 원격 컴퓨터의 에이전트가 계속 작업하게 하고 싶습니다. SSH 모드에서 창을 닫을 때 "Keep running"을 선택하십시오. 세션이 원격 컴퓨터에서 계속 실행되므로, 나중에 다시 연결하여 이어서 작업할 수 있습니다.

휴대폰에서 터미널이 아주 작게 보입니다. 다른 기기의 크기를 따르는 축소된 사본이기 때문입니다. 터미널 오른쪽 위 배지의 "이 창에 맞춤"을 탭하면 휴대폰 화면에 맞게 크기가 조정됩니다.

내 컴퓨터에 "공유 콘텐츠 보기"가 표시되지 않습니다. 이 버튼은 해당 컴퓨터가 온라인 상태이고, 같은 계정에 로그인되어 있으며, 무언가를 공유하고 있을 때만 표시됩니다. 그 컴퓨터에서 VelaTerm을 열고 "계정" 대화 상자에서 "공유 중" 항목을 확인하십시오.