VelaTerm 사용자 매뉴얼
이 문서는 VelaTerm 사용자 매뉴얼입니다. 처음 사용한다면 앞의 네 장을 순서대로 읽고, 나머지 장은 필요할 때 참고하면 됩니다.
읽는 순서
| # | 장 | 다루는 내용 | 대상 독자 |
|---|---|---|---|
| 1 | 시작하기 | 설치, 프로젝트 추가, 첫 터미널과 첫 에이전트 세션, 창 둘러보기 | 모든 신규 사용자. 여기서 시작합니다 |
| 2 | 인터페이스 및 세션 관리 | 창 레이아웃, 프로젝트 트리와 메뉴, 컬렉션, 이모지 표시, 탭과 백그라운드 탭, 분할 창과 바둑판 배열, 상태 필터, 보관, 전체 검색, 작업 공간 저장 | 모든 사용자 |
| 3 | AI 에이전트 세션 | 지원하는 14가지 에이전트와 각 기능, 상태 점과 알림, 재개, 대화 가져오기와 포크, 권한, 프리셋, 설치 안내, 정보 패널 | AI 코딩 에이전트를 사용하는 모든 사용자 |
| 4 | 대화 보기 | 터미널 보기와 대화 보기 간 전환, 에이전트 작업 중 메시지 보내기(대기열, 지시 추가, 중단), 모델·추론 강도·권한 설정, 이미지, 명령, 되돌리기, 백그라운드 작업, 사용 한도 초기화 후 자동으로 계속하기, 로그인 | Claude Code, Codex, OpenCode, Pi, OMP 사용자 |
| 5 | 세션 생성 및 Git 협업 | vspawn으로 하위 세션 시작, 확인 카드, 워크트리, Git 메뉴와 그래픽 병합 | 여러 에이전트로 병렬 작업하는 사용자 |
| 6 | 계획 및 실행 | 계획 세션과 실행 세션으로 이루어진 워크플로, 작업을 여러 개로 나누어 검토하기, 디렉터리 모드, 진행 상황 확인 | 계획과 검토가 필요한 큰 작업 |
| 7 | 세션 명령 | 10가지 내장 명령(vspawn, vspawn-tree, vopen, vrefer, vsearch, vstat, vtell, vrun, vkb, vflow), vask를 포함한 Vela Skills, vela 셸 명령에 대한 참고 자료 | 사용자와 스크립트를 위한 참고 자료 |
| 8 | 터미널 사용법 | 터미널 기본 사항, 터미널 내 검색, 복사와 붙여넣기, 이미지 붙여넣기, 명령어 자동 완성, 내장 명령과 백그라운드 vrun 명령, Windows의 셸 선택, 세션 녹화, 렌더러 옵션, 자주 쓰는 단축키 | 모든 사용자 |
| 9 | 명령어 자동 완성 | 일반 터미널에서 셸 자체의 자동 완성을 바탕으로 표시되는 후보 목록: 설정과 조작 방법, 지원하는 셸, 셸 통합을 불러오는 방식, Windows의 현재 상태, 제한 사항 | macOS 및 Linux의 터미널 사용자 |
| 10 | 문서 및 브라우저 탭 | 문서 탭(파일 열기, Markdown 편집기, 편집과 저장, 새 문서와 PDF 내보내기), 데스크톱 앱의 브라우저 탭, 여러 종류의 탭이 함께 동작하는 방식 | 필요할 때 |
| 11 | 로컬 지식 베이스 | Markdown 폴더를 지식 베이스로 사용하기: 지식 베이스 열기와 만들기, 파일과 폴더 가져오기, 노트 작성과 정리, 검색, 링크, 세션 지식 베이스에서 복사하기, 저장 방식 | 노트 작성과 문서화 |
| 12 | 세션 지식 베이스 | 세션에서 얻은 지식 정리, 정리 기록, 항목 탐색과 관리, 보관된 세션, 코드 그래프와의 연결 | 에이전트 작업에서 얻은 결정과 교훈을 남기려는 사용자 |
| 13 | 코드 그래프 및 지식 베이스 | 프로젝트 코드 인덱싱, 심볼과 심볼 간 관계 보기, 지식 항목 연결과 검토, 세션에서 조회하기, 데이터 저장 위치(실험 기능) | 코드 탐색 |
| 14 | 코드 감사 | Codex 또는 Claude Code를 사용한 프로젝트 보안 감사: 모델과 사고 강도, Codex Security 통합, 감사 범위, 보고서, 내보내기(실험 기능) | 보안 검토 |
| 15 | 설정 및 단축키 | 8가지 설정 범주의 모든 항목, 기본 키 바인딩과 변경 방법, 새 에이전트 세션 선택기 | 참고 자료 |
| 16 | 원격 개발 및 관리 | 다른 기기를 위한 원격 접속, SSH로 다른 컴퓨터에 연결(Windows 호스트 및 원격 데스크톱 앱 미러링 포함), URL 또는 계정으로 연결, VelaTerm 계정을 통한 공유(실험 기능), 파일 전송, 휴대폰에서 VelaTerm 사용, 연결 해제 시 유지되는 항목, 보안 | 원격 및 모바일 사용 |
각 릴리스의 변경 사항은 변경 로그에서 확인할 수 있습니다.
먼저 알아 두면 좋은 네 가지
- 트리의 에이전트 세션 하나는 계속 이어지는 대화 하나입니다. 세션을 닫았다가 다시 열면 대화가 이어집니다. 새 대화가 필요하면 새 세션을 만듭니다.
- 탭은 브라우저처럼 동작합니다. 기본적으로 에이전트 세션을 열면 현재 탭을 재사용하며, 떠나온 탭은 백그라운드에서 계속 실행됩니다. 탭을 닫으면 그 탭의 프로세스가 종료되지만, 이 경우에도 에이전트 대화는 재개할 수 있습니다.
- 하나의 대화를 두 가지 보기로 사용합니다. Claude Code, Codex, OpenCode, Pi, OMP는 대화 보기에서 실행하거나 에이전트 자체의 터미널 인터페이스에서 실행할 수 있습니다. 보기를 전환해도 같은 대화가 이어집니다.
- 보관은 삭제가 아닙니다. 끝난 작업을 보관하면 트리를 깔끔하게 유지할 수 있습니다. 보관된 세션은 지식 베이스에서 계속 읽을 수 있으며, 언제든지 복원하거나 내보낼 수 있습니다.
스크린샷 안내
스크린샷은 데모 데이터를 사용하는 개발 환경에서 영어 인터페이스(제품 기본값)와 다크 테마로 촬영했습니다. 오른쪽 패널의 지식 베이스 탭, 피드백 버튼, 대화 보기 설정 범주처럼 최근 인터페이스 변경 사항이 반영되지 않은 스크린샷도 있습니다. 스크린샷과 본문이 다르면 본문이 현재 버전을 설명합니다. 계정 사용량, 경로 등의 세부 정보는 예시 값입니다.