적용 범위
진입점
- 패널 토글: 데스크톱 앱에서는 상단 바 맨 오른쪽, 웹 앱에서는 세션 페이지 오른쪽 위에 있으며, 단축키는
⌥⌘\(Windows:Ctrl+Alt+\)입니다. 패널이 숨겨져 있지만 탭이 열려 있으면 토글에 작은 점이 표시됩니다. - 상단 바 버튼: Cloud server, Files (세션이 프로젝트에 속한 경우).
- 탭 바의 +: New tab 메뉴. 열 수 있는 탭과 이 세션의 하위 에이전트가 나열됩니다. 현재 세션이 지원하지 않는 항목은 회색으로 비활성화됩니다.
- 채팅 안: 결과 카드의 View diff, 파일 경로, 미리보기 카드와 웹 링크, 하위 에이전트 행.
- 작업 요약 카드: Changes, 하위 에이전트, 백그라운드 프로세스, 출처를 클릭합니다.
탭 종류
어떤 프로젝트에도 속하지 않은 세션에는 Changes, Files, 웹 미리보기가 없습니다. 내 기기의 클라이언트가 제어하는 세션에는 Cloud server 와 사이드 채팅이 없습니다.
탭 열기와 닫기
- 같은 탭은 두 번 열리지 않습니다. 다시 열면 해당 탭으로 전환됩니다.
- 탭의 × 를 클릭하면 닫힙니다. 마지막 탭을 닫으면 패널이 숨겨집니다.
- 패널 숨기기는 숨기기만 합니다. 탭, 스크롤 위치, 입력한 내용이 유지되며, 패널을 다시 표시하면 마지막으로 본 탭으로 돌아갑니다.
- 세션마다 탭이 따로 저장됩니다. 세션을 전환하면 해당 세션의 탭이 표시됩니다.
- 패널에 탭이 없으면 Changes, Files, Browser, Cloud server 바로가기가 있는 빈 상태가 표시됩니다.
너비와 전체 화면
- 패널의 왼쪽 가장자리를 드래그해 크기를 조절하고, 더블클릭하면 기본 너비로 돌아갑니다.
- 탭 바 오른쪽의 Full screen 을 클릭하거나 왼쪽 가장자리를 끝까지 왼쪽으로 드래그하면 패널이 세션 페이지 전체를 차지합니다.
- 전체 화면 종료: Exit full screen 을 클릭하거나,
Esc를 누르거나, 왼쪽 가장자리를 오른쪽으로 드래그하거나, 패널을 숨깁니다.
⇧⌘F, Windows: Ctrl+Shift+F)는 클라우드 서버 데스크톱 자체의 전체 화면 보기입니다. 클라우드 서버 데스크톱을 참고하세요.
탭
변경 사항
Changes 탭에는 이 세션에서 변경된 파일이 나열됩니다.- 상단에서 All / Last turn 을 전환할 수 있으며, 파일 수와 추가 및 삭제된 줄 수가 표시됩니다.
- 파일을 클릭하면 diff가 펼쳐집니다.
- 하단에는 브랜치와 푸시 여부가 표시되며, PR이 있으면 PR #N 이 표시됩니다.
- 아직 변경 사항이 없으면 No changes in this chat yet 이 표시됩니다.
파일
Files 탭은 왼쪽에 파일 트리, 오른쪽에 파일 내용이 있습니다.- Filter files 상자에 입력해 필터링합니다. 이 세션에서 변경된 파일에는 표시가 붙습니다.
- Markdown 같은 파일은 Preview 와 Source 사이를 전환할 수 있습니다. 큰 파일은 처음 1 MiB만 표시됩니다. 바이너리 파일과 민감한 파일의 내용은 표시되지 않습니다.
- 이 세션에서 변경된 파일을 열면 View changes 를 클릭해 Changes 탭으로 전환할 수 있습니다.
- 데스크톱 앱에서는 제목 오른쪽에 Open in project 가 있습니다. 프로젝트 상세 페이지의 파일 브라우저로 이동합니다.
브라우저(웹 미리보기)
Browser 탭에서는localhost:5173 의 개발 서버처럼 에이전트가 시작한 웹 페이지를 Cloud 안에서 바로 볼 수 있습니다.
- 각 페이지는 별도의 탭이며 탭마다 뒤로 / 앞으로 기록이 있습니다. 에이전트가 페이지를 시작하거나 채팅에서 미리보기 카드나 링크를 클릭하면 패널에 열립니다.
- + › Browser 는 빈 탭을 새로 엽니다. 주소 표시줄에 주소를 입력하거나, 포트 번호만 입력하면 해당 로컬 포트가 열립니다.
- 도구 모음에는 Back, Forward, Refresh, Annotate, 주소 표시줄, More (⋯)가 있습니다. More 메뉴에는 Open in default browser, Copy address, Full-screen preview, 탭 닫기 옵션이 있습니다.
⌘(Windows:Ctrl)를 누른 채 미리보기 카드나 링크를 클릭하면 기본 브라우저에서 바로 열립니다.- 개발 서버가 처음 준비되었을 때 이 세션을 보고 있고 패널을 사용하지 않는 중이면 미리보기가 패널에 자동으로 열립니다. 그렇지 않으면 응답에 미리보기 카드만 표시됩니다.
데스크톱 앱의 브라우저 탭에서는 외부 사이트를 열 수 있습니다. 웹 앱에서는 미리보기 전용이며, 채팅의 외부 링크는 새 브라우저 탭에서 열립니다.
주석 달기: 도구 모음의 Annotate 를 클릭한 뒤 페이지의 요소를 클릭해 댓글을 작성합니다. 주석은 첨부 파일로 메시지 입력창에 들어가며, 다음 메시지와 함께 AI에게 전송됩니다. 입력창을 참고하세요.
클라우드 서버
Cloud server 탭에는 에이전트가 조작하는 클라우드 서버 데스크톱의 실시간 화면이 표시됩니다. 클라우드 서버가 없으면 Get a cloud server 진입점이 표시됩니다. 클라우드 서버가 실행 중이 아니면 Cloud server unavailable 과 현재 상태가 표시됩니다. 보기, 제어 가져오기, 전체 화면은 클라우드 서버 데스크톱을 참고하세요.사이드 채팅
사이드 채팅 은 현재 세션에 딸린 임시 짧은 채팅입니다. 메인 세션을 중단하지 않고 질문을 먼저 논의할 때 사용합니다.- 사이드 채팅의 내용은 메인 세션에 기록되지 않습니다. 세션에 따라 사이드 채팅은 Can read project files (파일을 읽고 코드를 검색할 수 있으며, 파일 편집, 명령 실행, 인터넷 접근은 불가) 또는 Chat only 입니다.
- 사이드 채팅은 임시이며 앱을 닫으면 사라집니다. 패널을 숨기거나 세션을 전환하면 숨겨지기만 하며, 돌아와서 이어서 사용할 수 있습니다.
- 메인 세션이 실행 중일 때도 사이드 채팅을 사용할 수 있습니다. 사이드 채팅 응답을 중지해도 메인 세션은 중지되지 않습니다.
- 세션마다 사이드 채팅은 하나입니다.
⌥⌘S로 열거나 숨깁니다. - 열 수 없을 때는 이유를 알려 주는 메시지가 표시됩니다. 예: Your cloud server isn’t running. Start it to use side chat.
하위 에이전트
하위 에이전트 는 메인 에이전트가 작업의 일부를 병렬로 처리하도록 보내는 보조 에이전트입니다. 하위 에이전트 탭은 읽기 전용이며, 받은 작업, 각 활동 단계, 변경 사항을 표시합니다. 하위 에이전트를 참고하세요.작업 요약 카드
실행 계획이 있거나 하위 에이전트가 보내지면 상단 바에 Task summary 가 표시됩니다. 이 카드는 변경 사항, 계획, 하위 에이전트, 백그라운드 프로세스, 출처를 요약하며, 패널 탭을 여는 진입점이기도 합니다. 에이전트 출력 › 작업 요약 카드를 참고하세요.분할 보기에서
분할 보기에서는 오른쪽 패널이 표시되지 않습니다. 분할 보기를 참고하세요.FAQ
Changes에는 왜 상단 바 버튼이 따로 없나요?
작업 요약 카드, 결과 카드의 View diff, 탭 바의 + 메뉴에서 Changes 를 열거나⌃⇧G (Windows: Ctrl+Shift+G)를 누르세요.