터미널 사용법

이 장에서는 터미널 자체의 기능을 설명합니다. 입력과 출력, 터미널 내 검색, 복사와 붙여넣기, 이미지 붙여넣기, 명령어 자동 완성, 내장 v 명령, vrun으로 시작한 백그라운드 명령, Windows의 셸 선택, 세션 녹화, 렌더러 설정, 단축키를 다룹니다.

1. 기본 사항

터미널 세션은 실제 셸을 실행합니다. macOS와 Linux에서는 시스템 기본 셸($SHELL)을 사용하고, Windows에서는 기본적으로 cmd를 사용하며 다른 셸로 변경할 수 있습니다(§7 참조). 작업 디렉터리는 기본적으로 프로젝트 루트입니다. 세션의 편집 양식에서 "작업 디렉터리 (비우면 프로젝트 루트)"를 변경하거나, 세션이 시작될 때마다 실행되는 "시작 명령 (선택)"(예: pnpm dev)을 지정할 수 있습니다.

여러 에이전트가 한꺼번에 많은 출력을 내보내면 VelaTerm은 사용자의 입력과 화면에 보이는 탭을 우선 처리하고 백그라운드 탭의 출력 속도를 조절합니다. 이 동작은 설정 ▸ 고급 ▸ "포그라운드 우선 출력"(기본값 켬)으로 제어합니다. 탭을 전환한 뒤 전체 화면 프로그램의 화면이 깨져 보이면 분할 창 헤더의 "다시 그리기" 버튼을 클릭하여 화면을 다시 그립니다. 설정 ▸ 고급 ▸ "탭 전환 시 다시 그리기"를 켜면 탭이 표시될 때마다 자동으로 다시 그립니다.

2. 터미널 내 검색(⌘F)

⌘F를 누르면 현재 터미널의 스크롤백을 검색하는 검색 표시줄("터미널에서 검색")이 이전 및 다음 버튼과 함께 열립니다.

여러 세션과 기록을 검색하려면 인터페이스 및 세션 관리에서 설명하는 전체 검색(⌘⇧F)을 사용합니다.

3. 복사와 붙여넣기

• 마우스로 텍스트를 선택한 다음 ⌘C / ⌘V 또는 컨텍스트 메뉴("복사", "붙여넣기", "모두 선택", "화면 지우기", "검색…")를 사용합니다.
• 마우스 입력을 가로채는 프로그램(vim, htop, 대부분의 에이전트 인터페이스)에서는 macOS의 경우 Option, Windows와 Linux의 경우 Shift를 누른 채 드래그하면 일반 텍스트 선택을 강제로 사용할 수 있습니다.
• Claude Code, Codex 같은 에이전트 인터페이스는 자체적으로 텍스트를 복사할 수 있습니다. 에이전트가 방금 텍스트를 복사했고 터미널에서 선택한 내용이 없으면 컨텍스트 메뉴에 "N자 자동 복사됨 · ⌘V 붙여넣기"가 표시됩니다.

4. 이미지 붙여넣기

명령줄 에이전트에 이미지를 전달하려면 터미널에 이미지를 붙여 넣거나 끌어다 놓습니다. 설정 ▸ 터미널 ▸ "이미지 붙여넣기"에는 두 가지 선택지가 있습니다.

• 파일 경로 붙여넣기(기본값): 이미지를 임시 파일로 저장하고 프롬프트에 그 경로를 삽입하므로, 파일을 읽을 수 있는 에이전트라면 어떤 에이전트든 이미지를 열 수 있습니다. Codex에는 image_path: … 형식으로 전달됩니다.
• 기본 이미지 붙여넣기: Claude Code나 Codex가 시스템 클립보드에서 이미지를 직접 읽고 자체 이미지 자리 표시자를 표시합니다. 이 옵션은 로컬 데스크톱 앱에서만 사용할 수 있습니다. 원격 세션에서는 에이전트가 자신이 실행되는 컴퓨터에서 이미지를 읽을 수 있도록 항상 파일 경로를 붙여 넣습니다.

설정 ▸ 동작 ▸ "붙여넣은 이미지 자동 정리"를 켜면 앱을 종료할 때 이러한 임시 파일을 삭제하고, 앱을 시작할 때 24시간이 지난 남은 파일을 정리합니다. "지금 정리"를 누르면 즉시 삭제합니다. 문서에 삽입한 이미지에는 영향을 주지 않습니다.

5. 명령어 자동 완성

macOS와 Linux의 일반 터미널 세션에서는 VelaTerm이 셸 자체의 자동 완성 정의를 바탕으로 후보 목록을 표시할 수 있습니다. 설정 ▸ 터미널 ▸ "명령어 자동 완성"에서 "자동 표시"(기본값), "Tab으로 표시", "끄기" 중 하나를 선택합니다. 화살표 키로 후보를 선택하고 Tab을 눌러 삽입하며, Enter는 항상 입력한 그대로 명령을 실행합니다. 선택 위치를 더 이상 옮길 수 없으면 위쪽 및 아래쪽 화살표 키가 셸로 전달되므로, 첫 번째 후보에서 위쪽 화살표 키를 누르면 이전 명령을 불러옵니다. Windows에서는 이 목록을 사용할 수 없습니다. 자세한 내용은 명령어 자동 완성에서 설명합니다.

6. 내장 명령

VelaTerm이 시작한 모든 세션의 PATH에는 짧은 명령 모음이 있습니다. 별도로 설치할 필요가 없으며, 일반 터미널과 에이전트 세션 모두에서 사용할 수 있습니다.

명령에 --help를 붙여 실행하면 옵션을 확인할 수 있으며, 각 명령은 세션 명령에서 자세히 설명합니다. 이 명령 대부분은 Claude Code(/vopen)와 Codex($vopen) 안에서 스킬로도 제공됩니다. vrun과 vflow에는 스킬이 없고, vask는 스킬로만 제공됩니다. 스킬은 설정 ▸ 일반의 "Vela Skills" 버튼으로 설치합니다.

vopen은 파일 유형에 따라 보기를 선택합니다.

vopen README.md          # Markdown → Markdown editor
vopen src/main.rs        # source code → code editor with syntax highlighting
vopen diagram.png        # image → image viewer
vopen https://crates.io  # web address → browser tab (desktop app only)

상대 경로는 현재 디렉터리를 기준으로 해석되며, 여러 파일을 한 번에 열 수 있습니다. 문서 탭은 문서 및 브라우저 탭에서, vspawn은 세션 생성 및 Git 협업에서, vkb는 코드 그래프 및 지식 베이스와 로컬 지식 베이스에서 설명합니다.

6.1 백그라운드 명령(vrun)

vrun <label> <command...>는 명령을 시작하고 완료될 때까지 기다린 다음, 종료 코드, 경과 시간, 로그의 끝부분을 출력합니다. 따라서 에이전트가 오래 걸리는 빌드나 테스트를 vrun으로 시작하면 결과가 나오는 즉시 알 수 있습니다. 세션을 닫아도 명령은 중지되지 않습니다. vrun --status <label>은 이전에 시작한 명령의 상태를 보고하고, -t <seconds>는 대기 시간을 지정합니다(기본값 1800초). 대기 시간이 초과되면 vrun은 코드 124로 종료되며, 명령은 계속 실행됩니다.

이러한 명령이 실행되는 동안 터미널 위에 "백그라운드 명령" 행이 표시됩니다. 각 항목에는 레이블과 "실행 중 (…)", 명령의 출력을 여는 "로그" 버튼, "중지" 버튼이 표시되며, "중지 확인"을 클릭하면 명령이 종료됩니다. 실행 중인 명령이 없으면 이 행은 사라집니다.

7. 셸 선택(Windows 전용)

Windows의 터미널 세션에서는 감지된 모든 셸, 즉 PowerShell, pwsh, cmd, Git Bash와 설치된 모든 WSL 배포판을 사용할 수 있습니다. "새 터미널" 하위 메뉴, 세션 편집 양식의 "셸 (비우면 시스템 기본값)", 마우스 오른쪽 버튼 메뉴의 "셸"에서 선택합니다. 실행 중인 세션은 새 셸로 즉시 다시 시작됩니다. 설정 ▸ 터미널 ▸ "기본 셸"은 셸을 따로 선택하지 않은 새 터미널에 사용할 셸을 지정합니다.

WSL 항목은 WSL이 설치된 배포판을 보고할 때만 WSL: <distribution> 형식으로 표시됩니다. 항목을 선택하면 해당 배포판이 시작되고, 세션의 Windows 프로젝트 디렉터리가 배포판 안의 경로로 매핑됩니다. WSL은 일반 터미널 세션에서만 사용할 수 있으며, 에이전트 세션은 계속 Windows 호스트 셸을 사용합니다. WSL 터미널에서는 내장 v 명령을 사용할 수 없습니다.

함께 제공되는 Git Bash 안내: full 설치 프로그램에는 완전한 Git Bash(git, ssh, perl 포함)가 들어 있습니다. min 설치 프로그램에는 핵심 구성 요소만 들어 있으며, 없는 명령을 실행하면 전체 버전을 내려받을지 묻습니다. 전체 버전은 마우스 오른쪽 버튼 메뉴의 "전체 Git Bash 다운로드" 항목에서도 내려받을 수 있습니다. 에이전트 세션은 PowerShell을 사용하므로 영향을 받지 않습니다.

macOS와 Linux에는 셸 선택 기능이 없으며, 세션은 시스템 기본 셸을 사용합니다.

8. 세션 녹화

설정 ▸ 고급 ▸ "세션 로그 기록"은 기본적으로 꺼져 있습니다. 이 설정을 켜면 VelaTerm은 터미널 보기에서 실행되는 에이전트 세션의 터미널 출력을 세션당 최대 50MB까지 로컬 로그 파일에 저장합니다. 일반 터미널 세션은 녹화하지 않습니다.

녹화가 있으면 보관된 세션을 화면에 표시되었던 그대로 재생할 수 있고, 화면의 텍스트도 검색할 수 있습니다. VelaTerm은 에이전트 자체의 대화 기록을 읽을 수 없을 때만 녹화를 사용하며, 그 밖의 경우에는 대화 기록을 사용하여 내용을 표시하고 검색합니다. 녹화 파일은 해당 세션과 함께 삭제됩니다.

9. 렌더러

설정 ▸ 고급 ▸ "터미널 렌더러"에서는 DOM(기본값)과 WebGL 중에서 선택할 수 있습니다. 데스크톱 앱에서는 DOM을 권장합니다. 이전 버전에서 제공하던 Canvas 렌더러 옵션은 더 이상 없으며, Canvas로 저장된 설정은 이제 DOM을 사용합니다.

10. 자주 쓰는 단축키

다음 표는 macOS 데스크톱 앱의 기본값입니다. Windows와 Linux 앱에서는 대부분의 동작에 ⌘ 대신 Ctrl+Alt를 사용합니다(아래쪽 분할은 Ctrl+Alt+E, 모든 세션 검색은 Ctrl+Alt+G이며, 저장은 그대로 Ctrl+S입니다). 브라우저 클라이언트는 브라우저 자체의 단축키와 겹치지 않는 Ctrl 기반 기본값을 사용합니다. 설정 ▸ 단축키에서 사용 중인 시스템의 정확한 키 바인딩을 확인할 수 있으며, 탭 전환과 글꼴 크기를 제외한 모든 동작의 키를 그곳에서 변경할 수 있습니다.