대화 보기

대화 보기는 에이전트 세션을 채팅 형태로 보여 주며, 메시지, 도구 카드, 버튼으로 응답하는 권한 요청이 표시됩니다. 이 장에서는 터미널 보기와 대화 보기 간 전환, 에이전트가 작업하는 동안 메시지 보내기, 메시지 입력란 아래의 컨트롤, 되돌리기, 백그라운드 작업, 사용 한도, 긴 대화 읽기를 설명합니다.

1. 대화 보기란

모든 에이전트 세션은 에이전트 자체의 터미널 인터페이스를 보여 주는 터미널 보기에서 실행할 수 있습니다. Claude Code, Codex, OpenCode, Pi, OMP의 다섯 가지 에이전트는 대화 보기에서도 실행할 수 있습니다. 다른 에이전트 유형은 항상 터미널 보기를 사용합니다.

대화 보기에서는 VelaTerm이 대화 화면을 직접 그립니다. 사용자의 메시지, 에이전트의 답변과 추론, 도구 호출마다 하나씩 표시되는 카드, 권한 요청과 질문 카드가 표시됩니다. 메시지 입력란 아래의 컨트롤을 사용하면 세션을 다시 시작하지 않고 모델, 추론 강도, 권한 모드를 변경할 수 있습니다.

두 보기는 같은 대화를 이어 갑니다. 세션을 한 보기에서 다른 보기로 옮길 수 있으며, 대화 기록도 그대로 이어집니다.

2. 보기 선택

에이전트별 기본 보기. 설정 ▸ 에이전트 ▸ "기본 보기"에서 해당 에이전트의 새 세션을 어떤 보기로 열지 정합니다. 선택지는 "대화 보기"와 "터미널 보기"이며, 다섯 에이전트 모두 기본값은 "대화 보기"입니다. 기존 세션은 만들 때의 보기를 유지합니다.

세션별 설정. "실행 인자 지정 후 생성…" 대화 상자의 "표시 방식" 옵션을 사용하면 세션 하나만 다른 보기로 시작할 수 있습니다.

기존 세션 전환. 분할 창 헤더에 전환 버튼이 있습니다.

• 터미널 보기에서 로봇 버튼("대화 보기")을 누르면 세션이 대화 보기로 전환됩니다.
• 대화 보기에서 터미널 버튼("터미널 보기")을 누르면 다시 터미널 보기로 전환됩니다. 이 버튼을 가리키는 짧은 안내는 안내를 닫거나 버튼을 사용할 때까지 표시됩니다.

에이전트가 작업 중이면 VelaTerm이 먼저 "보기를 전환하면 에이전트가 다시 시작됩니다. 진행 중인 턴이 중단됩니다. 대화 내용은 그대로 유지됩니다."라고 확인합니다. 계속하려면 "전환"을 선택합니다. 유휴 상태인 세션은 바로 전환됩니다.

3. 메시지 보내기

메시지 입력란에는 "에이전트에게 메시지, /명령·/스킬·@파일도 사용 가능"이라고 표시됩니다. Enter를 누르면 메시지를 보내고, Shift+Enter를 누르면 줄을 바꿉니다. 커서가 텍스트의 맨 앞이나 맨 끝에 있을 때 ↑와 ↓를 누르면 이 대화에서 이전에 보낸 메시지를 불러옵니다.

새 대화에는 "아래 입력창에서 대화를 시작할 수 있습니다."라고 표시됩니다. 에이전트 프로세스는 첫 메시지를 보낼 때 시작됩니다.

에이전트가 작업하는 동안

턴이 진행되는 동안 메시지 입력란에는 "메시지를 입력하세요. 이번 턴이 끝난 뒤 전송됩니다"라고 표시됩니다. 메시지를 보내는 방법은 세 가지입니다.

지시 추가는 다섯 에이전트 모두에서 사용할 수 있습니다. 진행 중인 턴이 없으면 이 키 조합을 눌러도 메시지가 그대로 전송됩니다.

대기열에 있는 메시지는 "전송 대기" 아래에 표시됩니다. 메시지를 클릭하면 편집할 수 있고, 메시지의 "지시 추가" 버튼으로 진행 중인 턴에 추가하거나 ×로 제거할 수 있습니다. 대기열의 메시지는 턴이 끝날 때마다 순서대로 전송됩니다.

진행 중인 턴을 멈추려면 Esc를 누르거나 중지 버튼을 클릭합니다. 중지 버튼은 메시지 입력란이 비어 있을 때 보내기 버튼 자리에 표시됩니다("중지 · Esc"). 대화에는 "현재 턴을 중지하는 중…"에 이어 "현재 턴이 중지되었습니다"가 표시됩니다.

4. 메시지 입력란 아래의 컨트롤

메시지 입력란 아래 줄에는 다음 메시지에 적용되는 컨트롤이 있습니다. 표시되는 컨트롤은 에이전트와 모델에 따라 다릅니다.

모델, 사고 강도, 권한 모드 메뉴에는 "기본값으로 설정"이 있으며, 이를 선택하면 현재 선택이 해당 에이전트의 새 대화에 적용되는 기본값이 됩니다. 사고 강도의 기본값은 모델마다 따로 저장됩니다.

설정 ▸ 대화 보기 ▸ "메시지 입력 도구 모음"에서 메시지 입력란 옆에 표시할 컨트롤과 그 순서를 정합니다. 모델, 사고 강도, 협업 모드, 권한 모드는 기본적으로 켜져 있습니다. 꺼져 있거나 공간이 부족한 컨트롤은 더 보기 메뉴로 이동하므로, 지원되는 모든 컨트롤을 언제든지 사용할 수 있습니다. MCP 서버와 백그라운드 작업은 에이전트 프로세스가 실행 중이 아닐 때 비활성화됩니다("에이전트 프로세스가 실행 중이 아닙니다. 메시지를 보내면 시작됩니다.").

Claude와 Codex 대화에서는 에이전트가 처음으로 수치를 보고하면 보내기 버튼 옆에 작은 컨텍스트 미터가 표시됩니다. 컨텍스트가 차거나 사용 한도에 가까워지면 미터의 색이 바뀝니다. 마우스 포인터를 올리면 컨텍스트 사용량("컨텍스트: … 토큰 중 … 사용"), 에이전트가 보고하는 경우 세션 비용, 사용 한도 경고가 표시됩니다.

권한 모드

Codex 세션에서 권한 모드를 바꾸면 다음 턴부터 적용되며, 메뉴에도 그렇게 표시됩니다. 실행 중인 Claude 세션을 "확인 없음"으로 전환하려면 다시 시작해야 합니다. 이때 VelaTerm은 "다시 시작하여 확인을 생략할까요?"라고 묻고, 대화 기록은 유지합니다. "확인 없음"과 "전체 접근"은 모든 확인을 건너뛰므로 주의해서 사용하십시오.

5. 에이전트에 응답하기

에이전트에 사용자의 응답이 필요하면 대화 끝에 카드가 표시되고 세션의 상태 점이 노란색으로 바뀝니다.

• 권한 요청: "<tool> 실행 권한을 요청합니다"라는 문구와 함께 "허용"과 "거부"가 표시됩니다. 일부 요청에서는 "이 세션에서 … 허용"이나 "… 항상 허용" 같은 지속 규칙도 선택할 수 있습니다.
• 질문: "에이전트가 질문했습니다"가 표시됩니다. 답을 고르거나 입력한 다음 "다음" 또는 "제출"을 선택합니다. "닫기"를 선택하면 답하지 않고 넘어갑니다.
• 계획 승인: "계획이 승인을 기다리고 있습니다"라는 문구와 함께 "승인하고 실행"과 "거부"가 표시됩니다.
• MCP 서버 입력: "<server>에서 입력을 요청합니다"라는 문구와 함께 "제출", "거절", "취소"가 표시됩니다.

6. 이미지

메시지 입력란에 이미지를 붙여 넣거나 끌어다 놓습니다. 메시지 하나에 이미지를 최대 4개까지, 각각 최대 5MB까지 첨부할 수 있으며, 첨부되지 않은 이미지가 있으면 메시지 입력란에 그 이유가 표시됩니다. 텍스트 위에 섬네일이 표시되고, 섬네일마다 제거 버튼이 있습니다. 텍스트 없이 이미지만 보낼 수도 있습니다. 대화의 이미지를 마우스 오른쪽 버튼으로 클릭하면 "원본 이미지 보기", "이미지 복사", "이미지 저장"을 선택할 수 있습니다.

7. 명령과 자동 완성

/를 입력하면 명령 목록이 표시되고, @를 입력하면 파일 경로를 삽입할 수 있습니다. Tab이나 Enter를 누르면 강조 표시된 제안이 삽입되고, Esc를 누르면 목록이 닫힙니다. Claude와 Codex의 목록에는 에이전트 자체의 명령과 스킬도 포함됩니다.

다음 명령은 VelaTerm이 직접 처리합니다.

8. 되돌리기와 편집

사용자 메시지에는 "여기서부터 되돌리기" 버튼이 있습니다. 복원할 수 있는 범위는 에이전트에 따라 다릅니다.

되돌리면 선택한 메시지와 그 이후의 모든 내용이 제거됩니다. 되돌리기는 에이전트 프로세스가 실행 중이면서 유휴 상태이고, 대기열의 메시지나 응답하지 않은 권한 요청이 없을 때만 사용할 수 있습니다. 파일을 복원할 때는 확정하기 전에 변경될 파일 수가 표시됩니다. 되돌리기는 취소할 수 없습니다.

Claude와 Codex 메시지에는 "편집" 버튼도 있습니다. 텍스트나 이미지를 변경하고 "확인 후 다시 보내기"를 선택한 다음 "삭제 후 다시 보내기"로 확정합니다. 원래 메시지와 그 이후의 모든 내용은 영구적으로 삭제되고, 편집한 메시지가 그 지점에서 전송됩니다. 파일 변경은 복원되지 않습니다.

9. 백그라운드 작업(Claude)

Claude는 하위 에이전트와 명령을 백그라운드에서 실행할 수 있습니다. 백그라운드 작업 컨트롤은 이러한 작업을 상태("실행 중", "완료됨", "실패함", "중지됨")와 함께 나열합니다. "중지"로 작업을 끝내거나, 작업을 별도의 탭에서 열어 경과 시간, 토큰 수, 도구 호출, 프롬프트, 결과를 확인할 수 있습니다. 턴이 진행되는 동안 "진행 중인 작업을 백그라운드로 보내기"를 선택하면 현재 작업을 백그라운드로 보내고 대화를 계속할 수 있습니다.

백그라운드 작업이 실행되는 동안 세션은 "작업 중" 상태를 유지합니다.

10. 사용 한도와 자동 계속

5시간 또는 주간 사용 한도에 도달하여 Claude나 Codex 대화가 멈추면, 한도가 초기화된 뒤 VelaTerm이 작업을 이어서 진행합니다. 이 기능은 기본적으로 켜져 있으며, 끄려면 설정 ▸ 동작 ▸ "한도 초기화 후 자동으로 계속"을 끕니다.

이 설정을 켜면 대화에 작업이 다시 시작되는 시각이 "5시간 사용 한도에 도달했습니다. 14:30에 작업을 자동으로 계속합니다."와 같이 "취소" 버튼과 함께 표시됩니다. 앱을 다시 시작해도 대기 상태는 유지됩니다. 사용자가 직접 메시지를 보내거나, 되돌리거나, 대기를 취소하거나, 설정을 끄거나, 세션을 보관 또는 삭제하거나, 세션을 터미널 보기로 옮기면 아무것도 보내지 않고 대기가 끝납니다. 초기화 시각을 알 수 없거나 계속한 뒤 다시 한도에 도달하면, 대화에 그 사실이 표시되고 자동으로 계속하지 않습니다.

11. 긴 대화 읽기

• 대화의 최근 부분이 먼저 로드됩니다. 위로 스크롤하거나 "이전 메시지 불러오기"를 선택하면 이전 내용을 읽을 수 있습니다.
• 연속된 도구 호출은 한 줄("도구 호출 N개")로 접힙니다. 이 줄을 클릭하면 각 호출을 볼 수 있습니다.
• 답변마다 중간 단계를 숨길 수 있습니다("진행 과정 숨기기" / "진행 과정 보기(N단계)"). 분할 창 헤더에는 "모든 진행 과정 숨기기" / "모든 진행 과정 보기"가 있습니다.
• 분할 창 헤더의 "검색…" 버튼이나 터미널에서 찾기 단축키(⌘F / Ctrl+Alt+F)로 대화 내용을 검색합니다.
• 위로 스크롤한 뒤 "최신 메시지로 이동"을 누르면 대화 끝으로 돌아갑니다.
• 사용자 메시지에는 복사 버튼이 있습니다. 모든 메시지의 텍스트는 선택하여 복사할 수 있습니다.

보관된 대화는 지식 베이스에서 읽기 전용으로 열립니다. 인터페이스 및 세션 관리 §8을 참조하십시오.

12. 로그인과 로그아웃(Claude 및 Codex)

계정 컨트롤("Claude 계정" 또는 "Codex 계정")은 기본적으로 도구 모음에서 꺼져 있습니다. 더 보기에서 열거나, 설정 ▸ 대화 보기 ▸ "메시지 입력 도구 모음"에서 켤 수 있습니다. 이 컨트롤에는 "다시 로그인"과 "로그아웃"이 있습니다. 계정 변경은 현재 턴이 끝날 때까지 기다렸다가 적용되며, Claude는 백그라운드 작업과 권한 요청이 끝날 때까지도 기다립니다.

Codex. Codex 요청에서 로그인이 더 이상 유효하지 않다고 보고하면 대화에 "다시 로그인"이 표시됩니다. 인증 페이지를 열고 대화에 표시된 코드를 입력합니다. 로그인이 완료되면 화면이 업데이트되며 같은 대화를 계속할 수 있습니다. ChatGPT 계정 또는 워크스페이스에서 기기 코드 로그인이 활성화되어 있어야 하며, 사용하는 Codex CLI가 이 방식을 지원해야 합니다. "취소"를 선택하면 진행 중인 로그인이 중지됩니다.

Claude. "다시 로그인"을 선택하면 인증 링크가 표시됩니다. 해당 페이지에서 로그인하고, 페이지에 표시된 전체 코드(# 뒤의 부분 포함)를 "인증 코드"에 붙여 넣은 다음 "코드 제출"을 선택합니다. 코드는 채팅 메시지로 전송되지 않습니다. 계정 인증을 지원하는 Claude CLI 버전이 필요합니다.

로그아웃을 선택하면 확인 창이 표시됩니다. 로그아웃하면 연결된 컴퓨터의 계정 인증 정보가 삭제되므로, 같은 인증 정보를 사용하는 다른 세션도 영향을 받습니다. 대화 기록은 유지됩니다. 로그아웃한 뒤에는 대화에 "로그인"이 표시되며, 이를 선택하면 계속할 수 있습니다. Claude에서 로그아웃해도 구성된 API 키는 변경되지 않습니다.

13. !로 셸 명령 실행하기

! 뒤에 명령을 입력하면(예: ! az login --tenant <id>) 명령을 에이전트에 보내지 않고 세션의 셸에서 실행합니다. 다섯 에이전트 모두에서 사용할 수 있습니다.

• 명령은 에이전트의 작업 디렉터리에서 에이전트와 같은 환경으로 실행됩니다. ! 뒤의 텍스트는 입력한 그대로 셸에 전달됩니다.
• "셸 명령" 행에 명령, 실시간 출력, "취소" 버튼이 표시됩니다. 명령이 끝나면 행에 종료 코드 또는 "취소됨"이 표시됩니다. 출력이 길면 마지막 부분만 보관되며, 행에 그 사실이 표시됩니다.
• 명령이 끝나면 에이전트가 명령과 출력을 전달받아 이에 대응할 수 있습니다.
• 대화마다 셸 명령은 한 번에 하나만 실행됩니다. 셸 명령에는 이미지를 첨부할 수 없으며 대화형 입력도 받지 않습니다. 시간 제한이 없으므로, 브라우저 로그인을 기다리는 명령은 완료되거나 사용자가 취소할 때까지 계속 실행됩니다.

14. 에이전트 프로세스가 중지되는 경우

• 대화 탭을 닫으면 에이전트 프로세스가 해제됩니다. 유휴 상태인 에이전트는 즉시 중지되고, 작업 중인 에이전트는 현재 턴을 마친 뒤 중지됩니다. 다음 메시지를 보내면 에이전트가 다시 시작되어 같은 대화를 이어 갑니다.
• 세션 컨텍스트 메뉴에서 "프로세스 종료"를 선택하고 확인하면 실행 중인 에이전트가 종료됩니다. 대화 기록은 유지됩니다.
• 에이전트가 스스로 종료되면 대화에 "에이전트가 종료되었습니다(코드 N)"가 표시됩니다.
• 에이전트가 설치되어 있지 않으면 분할 창에 "<Agent>이(가) 설치되어 있지 않습니다"와 함께 "지금 설치", "설치 문서", "직접 설치"가 표시됩니다. "지금 설치"를 선택하면 세션이 터미널 보기로 전환되고 그곳에서 설치가 진행됩니다. AI 에이전트 세션 §7을 참조하십시오.