AI 에이전트 세션

이 장에서는 VelaTerm이 AI 코딩 에이전트를 유형별 세션으로 실행하는 방식을 설명합니다. 지원하는 에이전트, 실시간 상태, 대화 자동 재개, 대화 가져오기와 포크, 권한 모드, 실행 설정, 설치 안내, 정보 패널을 다룹니다. 대화 보기는 별도의 장인 대화 보기에서 설명합니다.

1. 지원하는 에이전트

VelaTerm에서 시작할 수 있는 에이전트는 Claude Code("Claude"로 표시), Codex, OpenCode, Copilot, Cursor, Antigravity, Cline, Pi, OMP, Crush, Kimi Code, Kiro, Grok Build, Zoo Code입니다. 각 에이전트의 CLI를 설치하고 로그인해 두어야 합니다.

에이전트마다 지원하는 기능이 다릅니다.

• 에이전트가 보고는 에이전트가 작업을 시작할 때, 사용자의 응답이 필요할 때, 작업을 마칠 때 직접 VelaTerm에 알린다는 뜻이므로 상태가 정확합니다. Codex는 해당 버전이 수명 주기 훅을 지원하면 모든 단계를 보고하고, 이전 버전에서는 턴이 끝날 때만 보고합니다. "응답 필요" 열이 ✗인 에이전트는 질문이나 권한 요청을 보고하지 않으므로, 턴이 끝날 때까지 세션이 "작업 중"으로 표시됩니다.
• 화면에서 판독은 VelaTerm이 에이전트의 터미널 인터페이스를 보고 상태를 인식한다는 뜻입니다.
• Copilot, Cursor, Antigravity, Kimi Code, Kiro, Grok Build는 해당 세션을 처음 시작할 때 VelaTerm이 에이전트의 사용자 설정에 자체 항목을 추가합니다. 이 항목은 에이전트를 VelaTerm 밖에서 실행할 때는 아무런 동작도 하지 않습니다.
• 일반 터미널에서 직접 시작한 에이전트에는 영향이 없습니다. 상태 보고는 VelaTerm이 시작한 에이전트 세션에만 적용됩니다.

2. 에이전트 세션 만들기

• 컨텍스트 메뉴. 프로젝트, 그룹 또는 세션을 마우스 오른쪽 버튼으로 클릭합니다. 메뉴 최상위에는 에이전트 세 개가 표시되며, 처음에는 Claude, Codex, OpenCode이고 이후에는 가장 최근에 만든 세 가지 에이전트 유형이 표시됩니다. "더 많은 에이전트 세션"에는 모든 에이전트, 저장된 프리셋, "실행 인자 지정 후 생성…", "새 에이전트 세션"(검색 가능한 선택기)이 있습니다.
• 새 에이전트 세션 선택기. macOS에서 ⌘N(Windows, Linux 및 일반 브라우저에서는 Ctrl+Alt+N)을 누르면 에이전트와 프리셋을 검색할 수 있는 목록이 열리며, 최근에 선택한 항목에는 "최근 사용" 표시가 붙습니다. 설정 및 단축키 §9를 참조하십시오.
• 하위 세션. 세션의 "새 하위 세션" 하위 메뉴를 사용하면 그 세션 아래에 새 세션이 만들어집니다. 대화 안에서 세션을 시작할 수도 있습니다. 세션 생성 및 Git 협업을 참조하십시오.

실행 인자 지정 후 생성… 항목을 선택하면 대화 상자가 열립니다. 여기에서 에이전트 유형("에이전트 종류"), 선택 사항인 이름("세션 이름 (비우면 자동 명명)"), "실행 인자 (선택)", 이 세션에만 사용할 대체 실행 파일("실행 파일(선택)"), 권한 설정, 두 보기를 모두 지원하는 에이전트의 "표시 방식"("터미널 보기" 또는 "대화 보기"), "Worktree" 옵션을 지정합니다. "프리셋으로 저장"을 사용하면 이 설정을 이름과 함께 저장하며, 아이콘도 선택할 수 있습니다. 프리셋은 메뉴와 선택기에 표시되며, 저장된 실행 파일, 인자, 권한 설정으로 세션을 시작합니다.

Claude, Codex, OpenCode, Pi, OMP 세션은 기본적으로 대화 보기로 열리고, 다른 에이전트는 터미널 보기로 열립니다. 설정 ▸ 에이전트 ▸ "기본 보기"에서 에이전트별로 변경할 수 있습니다.

3. 상태 점: 작업 중인 세션과 응답이 필요한 세션

각 에이전트 세션 옆의 점은 실시간으로 바뀝니다.

에이전트가 사용자를 기다리며 멈추면(질문, 권한 요청 또는 턴 종료) 시스템 알림이 표시되고, 세션이 읽지 않음으로 표시되며, Dock 배지 숫자에 포함됩니다. 해당 세션을 이미 보고 있으면 알림이 표시되지 않습니다. 서명된 macOS 빌드에서는 알림을 클릭하면 해당 세션이 열립니다. 상태 표시줄의 "Notify: On/Off" 항목으로 시스템 알림을 켜거나 끌 수 있으며, 알림을 꺼도 읽지 않음 표시와 배지는 유지됩니다. 배지가 있으면 사이드바 상단에 배지를 모두 지우는 버튼이 표시됩니다.

상태 표시줄의 "작업 중", "처리 대기", "확인함" 카운터를 클릭하면 사이드바에 해당 상태의 세션만 표시됩니다. 인터페이스 및 세션 관리 §6을 참조하십시오.

4. 자동 재개: 닫았다가 다시 열어도 대화가 이어짐

핵심 개념을 한 줄로 요약하면 트리의 에이전트 세션 노드 하나는 계속 이어지는 대화 하나입니다.

• 처음 실행할 때 VelaTerm은 에이전트 자체의 대화 ID를 기억합니다.
• 그 후에는 탭을 닫았든 앱을 종료했든 노드를 다시 열면 같은 대화가 이어집니다. VelaTerm은 재개하기 전에 대화가 아직 있는지 확인하며, 대화가 삭제되었으면 오류를 내는 대신 새 대화로 시작합니다.
• 새 대화가 필요하면 새 세션 노드를 만듭니다. 대화 보기에서 /clear를 사용하면 같은 위치에서 세션이 비어 있는 새 세션으로 바뀝니다.

새 세션 메뉴 끝에 있는 세션 재개… 항목은 이미 있는 대화를 트리에 추가합니다. 예를 들어 일반 터미널에서 실행했던 대화를 추가할 수 있습니다. "에이전트 종류"를 선택하고 에이전트의 대화 ID를 붙여 넣은 다음 "재개하고 열기"를 선택합니다. §1의 모든 에이전트 유형을 이 방법으로 재개할 수 있습니다.

프로젝트 컨텍스트 메뉴의 세션 가져오기… 항목은 작업 디렉터리가 프로젝트 디렉터리와 정확히 일치하는 기존 Codex, Claude, OpenCode, Kiro 대화를 나열합니다. 제목, 에이전트 또는 세션 ID로 검색하고("제목, 에이전트 또는 세션 ID로 검색"), 행을 선택한 다음 "가져오기"를 선택합니다. 가져온 대화는 프로젝트 트리에 추가되며, 열면 대화를 이어서 진행할 수 있습니다. 가져오기는 에이전트 자체의 기록을 복사하거나 변경하지 않습니다. 보관된 대화를 포함하여 이미 VelaTerm에 있는 대화에는 "이미 가져옴" 표시가 붙습니다. 하위 디렉터리나 별도 워크트리의 대화는 해당 디렉터리를 별도의 프로젝트로 열었을 때만 표시됩니다. Kiro 기록은 텍스트로만 이루어진 경우에 볼 수 있습니다. 원격 VelaTerm에 연결되어 있으면 원격 컴퓨터의 대화 목록이 표시됩니다.

5. 포크: 대화에서 갈라져 나가기

이미 대화가 있는 Claude, Codex, Pi, OMP 세션을 마우스 오른쪽 버튼으로 클릭하고 "세션 포크"를 선택합니다. 원본 대화의 현재 기록에서 시작하는 같은 수준의 노드가 만들어지며, 원본은 변경되지 않습니다. git 브랜치와 비슷한 방식입니다. 같은 컨텍스트에서 두 가지 접근 방식을 시도할 때 유용합니다.

6. 권한

권한 설정은 에이전트가 사용자에게 묻지 않고 할 수 있는 작업의 범위를 정합니다.

• Claude, Codex, OpenCode에는 이름이 있는 모드가 있습니다. Claude: "계획 모드", "매번 확인", "편집 자동 승인", "자동 판단", "확인 없음". Codex: "읽기 전용", "자동 판단", "전체 접근". OpenCode: "매번 확인", "확인 없음".
• Copilot, Cursor, Antigravity, Cline, OMP, Crush, Kimi Code, Kiro, Grok Build, Zoo Code에는 "모든 권한 확인 건너뛰기" 스위치 하나만 있으며, 이 스위치를 켜면 에이전트 자체의 확인 생략 옵션을 붙여 에이전트를 시작합니다. 대화 보기에서 OMP는 "매번 확인"과 "확인 없음"을 제공합니다.
• Pi는 묻지 않고 도구를 실행하므로 권한 설정이 없습니다.

권한은 다음 위치에서 변경합니다.

• 세션별: 세션의 "편집" 양식("권한" 또는 "모든 권한 확인 건너뛰기" 확인란), 터미널 보기에서는 상태 표시줄의 권한 항목("권한: 확인" / "권한: 건너뛰기" 또는 현재 모드 이름), 대화 보기에서는 메시지 입력란 아래의 권한 설정.
• 새 세션의 기본값: 설정 ▸ 에이전트 ▸ "권한". 상태 표시줄과 대화 보기의 메뉴에서도 "기본값으로 설정"을 선택할 수 있습니다.

일부 변경 사항은 에이전트를 다시 시작해야 적용됩니다. 이 경우 VelaTerm은 "지금 다시 시작"과 "나중에"를 제시합니다. 다시 시작하면 대화는 재개되지만 실행 중인 작업은 중단됩니다. "확인 없음", "전체 접근", "모든 권한 확인 건너뛰기"는 모든 확인을 건너뛰므로 주의해서 사용하십시오.

7. 실행 설정과 설치 안내

실행 인자. 세션의 "편집" 양식에 있는 "실행 인자 (선택)"로 해당 세션에 명령줄 인자를 추가합니다. 에이전트 유형별 기본값은 설정 ▸ 에이전트에서 지정합니다.

실행 파일 경로. 에이전트가 PATH 밖에 설치되어 있으면 설정 ▸ 에이전트에서 "실행 파일 경로(선택)"를 지정합니다. 비워 두면 PATH에서 명령을 찾습니다.

설치되지 않았다면? 설치되지 않은 에이전트를 시작하면 세션에 "<Agent>이(가) 설치되어 있지 않습니다"라는 카드가 표시되며, 사용 중인 시스템에 권장되는 설치 명령이 함께 표시됩니다.

• "지금 설치"는 세션에서 설치 명령을 실행합니다. 설치된 프로그램을 찾으면 그 경로를 설정에 저장하고, "지금 재시작"과 "나중에"를 선택할 수 있는 대화 상자를 표시합니다.
• "다시 시작"은 세션을 다시 시작합니다. 예를 들어 에이전트를 직접 설치한 뒤에 사용합니다.
• 에이전트가 이미 PATH 밖에 설치되어 있으면 "실행 파일 경로"에 전체 경로를 입력하고 "이 경로 사용"을 선택하거나, "찾아보기…"를 사용합니다.
• "설치 문서"는 에이전트의 설치 문서를 열고, "직접 설치"는 카드를 닫습니다.

설치한 뒤에도 에이전트마다 별도로 로그인하거나 API 키를 설정해야 합니다.

8. 정보 패널: 사용량, 컨텍스트, 리소스

에이전트 세션을 열면 오른쪽 패널의 정보 탭에 다음 내용이 표시됩니다.

• 에이전트: 에이전트 유형, 세션 이름, 작업 디렉터리, Git 브랜치, 시작 시각, 실행 시간. Kiro 세션에서는 대화 기록을 읽기 전용으로 볼 수 있는 링크도 표시됩니다.
• 사용량(Claude, Codex, Grok Build): 계정 할당량 사용률(예: 5시간 및 7일 기간)과 각 기간의 초기화 시각. ↻ 버튼을 누르면 즉시 새로 고칩니다. 자동 새로 고침 여부와 간격은 설정 ▸ 동작("Usage auto-refresh", "Usage refresh")에서 지정합니다. 새로 고침에 실패하면 마지막 값이 "stale" 표시와 함께 계속 표시됩니다.
• 이번 턴(Claude, Codex, Grok Build, OpenCode, Pi, OMP, Kiro): 모델, 컨텍스트 창 사용량, 현재 턴의 토큰 수와 사용한 도구.
• 리소스: 세션 프로세스의 CPU 및 메모리 사용량. "system" 옵션을 켜면 컴퓨터 전체의 수치도 표시됩니다.

9. 대화 기록, 내보내기, 보관

• 마우스 오른쪽 버튼 → "세션 내보내기…"(Claude 및 Codex, 대화가 있는 경우)는 추론 과정과 모든 도구 호출의 입력 및 결과를 포함한 전체 대화를 Markdown 파일로 저장합니다.
• 세션 메뉴의 "세션 지식 베이스로 정리"는 에이전트를 사용하여 대화에서 재사용할 수 있는 지식을 추출합니다. 세션 지식 베이스를 참조하십시오.
• 보관된 세션은 지식 베이스의 "보관된 세션" 보기에서 읽을 수 있습니다. Claude, Codex, OpenCode, Pi, OMP, Grok Build, Kiro의 대화는 메시지 형태로 표시되고, 다른 에이전트는 터미널 녹화가 있으면 녹화를 표시합니다. 보관된 세션을 복원해도 대화 ID가 유지되므로 평소처럼 재개됩니다. 인터페이스 및 세션 관리 §8을 참조하십시오.

10. 기타 동작

• 자동 이름 지정: 이름을 지정하지 않은 세션은 첫 메시지를 바탕으로 이름이 정해집니다.
• 테마 변경: 라이트 테마와 다크 테마를 전환하면 터미널 보기에서 실행 중인 Claude 세션에도 다시 시작하지 않고 바로 반영됩니다.
• Vela Skills: 설정 ▸ 일반 ▸ "Vela Skills"에서 Claude Code와 Codex용 스킬을 설치합니다. 이 스킬로 하위 세션을 시작하고, 파일을 열고, 다른 세션의 대화를 읽거나 다른 세션에 메시지를 보낼 수 있습니다. 세션 명령을 참조하십시오.
• Windows: Claude Code와 Codex는 완전히 지원되며(PowerShell에서 실행), 다른 에이전트는 가능한 범위에서 지원합니다.