설정 및 단축키
설정은 제목 표시줄의 톱니바퀴 버튼으로 엽니다. macOS에서는 앱 메뉴의 "Settings…"(⌘,)로도 열 수 있고, Windows와 Linux에서는 Alt 키를 누른 뒤 파일 ▸ 설정…을 선택합니다. 설정 창에는 일반, 외관, 터미널, 대화 보기, 동작, 고급, 에이전트, 단축키의 8가지 범주가 있습니다. 이 장에서는 각 항목을 설명하고, 마지막에 기본 키 바인딩을 정리합니다. 설정은 데스크톱 앱과 이 앱에 연결된 브라우저 클라이언트가 함께 사용합니다.
1. 일반
| 항목 | 설명 |
|---|---|
| 언어 | 인터페이스 언어입니다. "자동 (시스템)"은 시스템 언어를 따르며, 11개 언어를 사용할 수 있습니다 |
| 알림음 | 알림 소리입니다(기본값 켬) |
| System notifications | 시스템 알림을 켜거나 끕니다(기본값 켬). 시스템에서 아직 알림을 허용하지 않았다면 "Allow notifications"로 권한을 요청하고, 알림이 차단되어 있으면 사용 중인 시스템에 맞는 설정 방법이 표시됩니다 |
| 셸 명령 | macOS 데스크톱 앱 전용입니다. "‘vela’ 명령 설치"를 선택하면 VelaTerm에서 프로젝트를 여는 vela <project-path> 명령이 셸에 추가되고, "‘vela’ 명령 제거"를 선택하면 제거됩니다 |
| Vela Skills | "Install"(설치한 뒤에는 "Reinstall")을 선택하면 /vspawn, $vspawn 등 Claude Code와 Codex용 VelaTerm 스킬이 설치됩니다. Codex에 스킬이 표시되지 않으면 Codex 세션을 새로 시작합니다. 세션 명령 §2 참조 |
2. 외관
| 항목 | 설명 |
|---|---|
| 강조색 | 강조 색상: "테마 따름" 또는 네 가지 색상 중 하나 |
| 밀도 | "조밀", "보통"(기본값), "여유" |
| 분할 창 | 분할 창 스타일: "플랫"(기본값) 또는 "카드" |
| 구분선 | "미세"(기본값) 또는 "표시" |
| 사이드바 | "표준"(기본값) 또는 "조밀" |
| Interface font | 인터페이스 글꼴 |
| Interface size | 인터페이스 글꼴 크기. "Auto"는 밀도 설정을 따름 |
라이트 테마와 다크 테마는 여기가 아니라 제목 표시줄에서 전환합니다(시스템 따름, 다크, 라이트). 터미널 보기에서 실행 중인 Claude 세션은 다시 시작하지 않아도 테마 변경이 반영됩니다.
3. 터미널
| 항목 | 설명 |
|---|---|
| 이미지 붙여넣기 | "파일 경로 붙여넣기"(기본값)는 붙여 넣은 이미지를 임시 파일로 저장하고 그 경로를 삽입합니다. "기본 이미지 붙여넣기"는 Claude Code나 Codex가 클립보드에서 이미지를 직접 읽게 하며, 로컬 데스크톱 앱에서만 사용할 수 있습니다 |
| 명령어 자동 완성 | "자동 표시", "Tab으로 표시", "끄기" 중에서 선택합니다. 변경 사항은 열려 있는 터미널에도 즉시 적용되며, 지원되지 않는 환경에서는 표시되지 않습니다. 명령어 자동 완성 참조 |
| 기본 셸 | 새 터미널에 사용할 셸입니다. 여러 셸을 사용할 수 있는 Windows에서만 표시되며, macOS와 Linux는 항상 시스템 셸을 사용합니다 |
| Terminal font | 터미널 글꼴 |
| Terminal size | 터미널 글꼴 크기(기본값 13). 작업 중에는 ⌘+ / ⌘- / ⌘0으로 변경할 수 있습니다 |
| 터미널 줄 높이 | 터미널의 줄 간격(기본값 1.2×) |
4. 대화 보기
이 설정은 에이전트 세션의 대화 보기에 적용됩니다. 대화 보기를 참조하십시오.
| 항목 | 설명 |
|---|---|
| 대화 글꼴, 대화 글꼴 크기, 대화 줄 높이 | 터미널 설정과 별도로 적용되는 대화 화면의 글꼴 설정(기본 크기 13.5, 줄 높이 1.2×) |
| 메시지 입력 도구 모음 | 메시지 입력란 옆에 표시할 컨트롤과 그 순서를 정합니다. 대상은 모델, 사고 강도, 협업 모드, 권한 모드, 고속 모드, 속도, 말투, MCP 서버, 백그라운드 작업, 계정, Codex 초기화 이용권입니다. 컨트롤마다 켜기/끄기 스위치가 있으며, 화살표로 켜져 있는 컨트롤의 순서를 바꿉니다. 모델, 사고 강도, 협업 모드, 권한 모드는 기본적으로 켜져 있습니다 |
현재 에이전트나 모델이 지원하지 않는 컨트롤은 표시되지 않습니다. 지원되는 컨트롤은 해당 기능을 일시적으로 사용할 수 없을 때도 계속 표시됩니다. 에이전트 프로세스가 중지된 동안의 MCP 서버와 백그라운드 작업이 그 예입니다.
꺼 둔 컨트롤과 메시지 입력란 옆에 공간이 부족한 컨트롤은 더 보기 메뉴에 있으므로, 여기에서 먼저 켜지 않아도 지원되는 모든 컨트롤을 사용할 수 있습니다. 지원되는 컨트롤이 모두 켜져 있고 공간도 충분하면 더 보기 메뉴는 표시되지 않습니다. 컨트롤을 껐다가 다시 켜면 줄의 맨 끝으로 이동합니다. 모바일에서는 꺼져 있는 컨트롤이 두 번째 줄에 표시됩니다.
5. 동작
| 항목 | 설명 |
|---|---|
| 탭 | "단일"(기본값)은 에이전트 세션을 열 때 현재 탭을 재사용하고 이전 탭을 백그라운드에서 계속 실행합니다. "다중"은 세션마다 별도의 탭으로 엽니다 |
| 상태 필터 동적 추가 | 사이드바의 상태 필터가 활성화되어 있을 때 새로 조건에 맞게 된 세션을 필터에 추가합니다(기본값 켬) |
| Background limit | 단일 모드에서 표시되며, 백그라운드 탭의 최대 개수를 정합니다(8, 16, 32, 64 중 선택, 기본값 32). 한도를 넘으면 가장 오래된 비활성 백그라운드 탭이 종료됩니다 |
| Confirm before spawn | 하위 세션을 시작하기 전에 확인 카드를 표시합니다(기본값 켬). 세션 생성 및 Git 협업 §4 참조 |
| Usage auto-refresh | 정보 패널의 계정 사용량을 최신 상태로 유지합니다(기본값 켬) |
| Usage refresh | 새로 고침 간격: 30초, 1분, 2분, 5분(기본값 5분) |
| 한도 초기화 후 자동으로 계속 | 5시간 또는 주간 사용 한도가 초기화된 뒤 Claude나 Codex 작업을 자동으로 계속합니다(기본값 켬) |
| 붙여넣은 이미지 자동 정리 | 앱을 종료할 때 붙여 넣은 이미지의 임시 파일을 삭제하고, 시작할 때 24시간이 지난 파일을 삭제합니다(기본값 켬). "지금 정리"를 누르면 즉시 삭제합니다 |
세션 참조 컨텍스트는 vrefer --ask(및 vask 스킬)가 다른 세션의 대화를 답변하는 에이전트에 전달하는 방식을 정합니다. "전체 기록 사용"(기본값)은 대화 전체를 전달합니다. "먼저 요약"은 여기에서 선택한 "요약 에이전트", 모델, 추론 강도로 대화를 먼저 압축합니다. 세션 명령 §5를 참조하십시오.
6. 고급
| 항목 | 설명 |
|---|---|
| 터미널 렌더러 | "DOM"(기본값) 또는 "WebGL". 변경할 특별한 이유가 없으면 기본값을 유지하십시오 |
| 탭 전환 시 다시 그리기 | 탭으로 돌아올 때 터미널 전체를 다시 그립니다(기본값 끔). 탭을 전환한 뒤 터미널 인터페이스가 가끔 깨져 보이면 켜십시오 |
| 포그라운드 우선 출력 | 다른 탭의 에이전트가 많은 출력을 내보내는 동안에도 입력 반응 속도를 유지합니다(기본값 켬) |
| 세션 로그 기록 | 에이전트 세션의 터미널 출력을 로그 파일에 저장합니다(기본값 끔). 켜면 보관된 세션을 재생할 수 있고, 전체 검색에서 터미널 출력도 검색합니다. 일반 터미널 세션은 녹화하지 않습니다 |
7. 에이전트
"새 세션 기본값"은 선택한 에이전트로 새로 만드는 세션에 적용됩니다. 개별 세션에 지정한 설정이 우선하지만, 실행 파일 경로는 예외로 항상 해당 에이전트 유형 전체에 적용됩니다.
| 항목 | 설명 |
|---|---|
| 에이전트 종류 | 기본값을 편집할 에이전트 |
| 실행 파일 경로(선택) | 에이전트 실행 파일의 전체 경로입니다. 비워 두면 PATH에서 명령을 찾습니다. 원클릭 설치에 성공하면 자동으로 입력됩니다 |
| 실행 인자 (선택) | 기본 명령줄 인자입니다(예: --model opus) |
| 권한 | 새 세션의 기본 권한입니다. Claude, Codex, OpenCode는 이름이 있는 모드를 제공하고, 그 밖의 에이전트 대부분은 "기본"과 "YOLO"(모든 권한 확인 건너뛰기)를 제공하며, Pi에는 권한 확인이 없습니다. AI 에이전트 세션 §6 참조 |
| 기본 보기 | Claude, Codex, OpenCode, Pi, OMP의 새 세션을 "대화 보기"(기본값)와 "터미널 보기" 중 어느 보기로 열지 정합니다. 기존 세션은 원래 보기를 유지합니다 |
8. 단축키
동작의 키 조합을 클릭한 다음 새 조합을 누릅니다. Escape를 누르면 취소됩니다. 키 조합은 ⌘(macOS 데스크톱 앱) 또는 Ctrl과 문자 키로 구성되며, Shift와 Option/Alt를 함께 사용할 수 있습니다. 이미 사용 중인 조합이면 그 조합을 사용하는 동작이 메시지에 표시됩니다. "기본값 복원"을 누르면 모든 키 바인딩이 초기화됩니다.
| 동작 | macOS 데스크톱 앱 | Windows, Linux |
|---|---|---|
| 프로젝트 열기 | ⌘O | Ctrl+Alt+O |
| 새 터미널 | ⌘T | Ctrl+Alt+T |
| 새 에이전트 세션 | ⌘N | Ctrl+Alt+N |
| 새 브라우저 탭(데스크톱 앱 전용) | ⌘⇧B | Ctrl+Alt+B |
| 오른쪽 분할 | ⌘D | Ctrl+Alt+D |
| 아래쪽 분할 | ⌘⇧D | Ctrl+Alt+E |
| 창/탭 닫기 | ⌘W | Ctrl+Alt+W |
| 터미널에서 찾기 | ⌘F | Ctrl+Alt+F |
| 모든 세션 검색 | ⌘⇧F | Ctrl+Alt+G |
| 문서 저장 | ⌘S | Ctrl+S |
일반 브라우저. 일반 브라우저에서 VelaTerm을 사용하는 경우(URL 원격 접속) 브라우저 자체가 여러 ⌘ 및 Ctrl 조합을 사용하므로, 모든 시스템에서 위의 Windows 및 Linux 키 바인딩이 적용되며 설정 페이지에도 그렇게 표시됩니다. 단, macOS의 브라우저에서는 오른쪽 분할과 아래쪽 분할이 ⌘D와 ⌘⇧D로 유지됩니다. 데스크톱 앱의 원격 연결 창은 데스크톱 키 바인딩을 사용합니다.
고정 키는 변경할 수 없습니다. ⌘1–9는 탭을 전환하고, ⌘+ / ⌘- / ⌘0은 터미널 글꼴 크기를 변경하거나 초기화합니다(Windows, Linux 및 브라우저에서는 Ctrl).
9. 새 에이전트 세션 선택기
"새 에이전트 세션"을 누르면 에이전트 유형과 저장된 프리셋을 검색할 수 있는 목록("에이전트 및 프리셋 검색")이 열립니다. 최근에 사용한 항목이 먼저 표시되며 "최근 사용" 표시가 붙습니다.
선택기에는 세션이 만들어질 위치가 표시됩니다. 저장된 세션이 활성화되어 있으면 "같은 수준"을 선택하여 그 옆에 새 세션을 만들거나, "하위 세션"을 선택하여 그 아래에 만들 수 있습니다. 검색 입력란에 포커스가 있을 때는 다음 키를 사용할 수 있습니다.
- Tab으로 "같은 수준"과 "하위 세션"을 전환합니다.
- ↑와 ↓로 결과를 선택하고, Enter로 세션을 만듭니다.
- Shift+Tab을 누르면 포커스가 이전 컨트롤로 이동하고, Escape를 누르면 선택기가 닫힙니다.
결과를 클릭한 다음 "생성"을 선택할 수도 있습니다. 사용할 수 있는 프로젝트가 없으면 먼저 프로젝트를 선택하거나 "프로젝트 열기"를 사용합니다.
선택기에는 고유한 주소가 있으며, 이 주소에 대상, 위치, 검색어, 선택 항목이 저장됩니다. 링크를 복사하거나, 새로 고치거나, 뒤로 및 앞으로 이동하면 세션을 만들지 않고 선택기가 복원됩니다. 생성에 실패하면 선택기가 열린 상태로 유지되므로 다시 시도할 수 있습니다.
10. 기타 키
| 위치 | 키 | 동작 |
|---|---|---|
| 대화 보기 | Enter / Shift+Enter | 보내기 / 줄 바꿈 |
| 대화 보기(에이전트 작업 중) | ⌥Enter (Alt+Enter) | 진행 중인 턴에 메시지 추가 |
| 대화 보기(에이전트 작업 중) | ⌘Enter (Ctrl+Enter) | 턴을 멈추고 이 메시지 보내기 |
| 대화 보기(에이전트 작업 중) | Esc | 턴 중지 |
| 하위 세션 생성 확인 카드 | ⌘Enter (Ctrl+Enter) | 세션 시작 |
| 탭 바 | 마우스 가운데 버튼 클릭 | 탭 닫기 |
| 사이드바 | ⌘/Ctrl+클릭, Shift+클릭 | 여러 세션 선택 또는 범위 선택 |