문서

1. 데스크톱 앱 설치

다운로드 페이지에서 Windows / macOS / Linux 클라이언트를 받아 설치하세요. 실행 후 상단에 상주 진입점이 두 개 있습니다. Home(자산과 세션)과 Deck(운영 어시스턴트). 일상 자산은 Home 사이드바에 있습니다. 호스트, 키, 포워딩, 작업, 설정.

• 설정에서 기본 로컬 터미널(어시스턴트와 로컬 셸이 여기서 실행됩니다)과 시스템 언어를 바꿀 수 있습니다.
• 데스크톱 앱은 웹사이트 계정이 필요합니다. Free 계정은 모든 로컬 연결·관리 기능을 유지하고, 클라우드 동기화, 모니터링, AI 실행은 Pro가 필요합니다.

2. 로그인 — 클라우드 모델이 바로 동작합니다

어시스턴트, 명령 제안, 모니터링 탐색은 기본적으로 클라우드 모델을 씁니다. 로그인하면 되고, 모델 키를 설정하지 않아도 됩니다.

1. 로그인 페이지에서 이메일 또는 Google / GitHub로 로그인한 뒤 "이 기기에 권한 부여"를 선택하세요. 데스크톱 앱이 현재 계정을 받습니다.
2. 클라우드 모델 목록은 계정과 함께 전달되며, Deck 입력줄의 모델 선택기에서 바로 고를 수 있습니다.
3. 클라우드 모델 사용량은 구독 쿼터에 잡힙니다. 월간 쿼터를 먼저 쓰고, 그다음 잔액입니다. Free도 매달 제한된 클라우드 쿼터와 제안 횟수를 받습니다(기본 모델만).
4. 현재 상태, 월간 쿼터 사용량, 잔액은 계정 → 구독에서 확인하세요.

Pro를 구독하면 클라우드 동기화, 모니터링, AI 실행, 전체 클라우드 모델 목록이 열립니다. 구매는 데스크톱 앱에서 하고, 갱신은 앱 스토어가 관리합니다. 요금을 보세요.

3. 장치와 키 등록

세션, 어시스턴트, 파일 전송, 포워딩이 하나의 자산 세트를 공유합니다. "누구에게 무엇으로 붙을지"를 먼저 인벤토리에 넣으면, 연결 정보를 다시 짜맞출 필요가 없습니다.

키 만들기(먼저 권장)

1. Home → 키 → 새 키.
2. 공개 키와 개인 키를 붙여 넣으세요. 암호 문구가 있으면 추가하고, 인증서가 필요하면 붙여 넣으세요.
3. OpenSSH 형식만 지원합니다. PuTTY PPK는 먼저 OpenSSH로 변환하세요.

장치 추가

1. Home → 호스트 → 장치 추가(빈 상태도 "아직 장치가 없습니다. 클릭해서 추가"를 안내합니다).
2. 기본 정보: 이름, 호스트, 유형, 그룹. 유형은 명령 제안과 일부 장치 측 상호작용에 영향을 주므로 신중히 고르세요.
3. 필요에 따라 SSH(기본 포트 22, 사용자 이름, 비밀번호 또는 키), Telnet(기본 포트 23), RDP(도메인, 해상도, 보안 계층 등)를 채우세요.
4. SSH에는 세션 재사용, SSH 에이전트, 인증 방식의 추가 옵션이 있습니다. Telnet에는 프롬프트 감지와 명령 에코 검증이 있고, RDP에는 색 깊이, 키보드 레이아웃, 드라이브 리디렉션이 있습니다.
5. 저장하거나, 저장하고 연결로 바로 들어갑니다.

비밀번호, 키 등 민감 자산은 로컬 데이터에 남습니다. 웹사이트 로그인이 이를 클라우드 인벤토리로 올리지 않습니다.

4. 세션 열기

어시스턴트에 넘기기 전에 대상이 닿는지 확인하세요. 호스트 카드를 클릭하고 열 프로토콜을 고르세요.

• SSH / Telnet: 터미널 패널을 엽니다. 첫 연결은 호스트 지문 확인을 요청하고, 지문이 바뀌면 알림이 뜨며 거부, 한 번 신뢰, 영구 신뢰를 고를 수 있습니다.
• SFTP: SSH와 같은 신원을 쓰고 이중 패널 파일 보기를 엽니다.
• RDP: 클립보드와 로컬 드라이브가 공유된 Windows 데스크톱으로 들어갑니다.
• 로컬 셸: 호스트 툴바에서 터미널을 고르세요(이 기기에서 찾은 항목에 따라 Command Prompt / PowerShell / WSL 등).
• 끊긴 뒤에는 다시 연결을 쓰세요. 상단 +는 새 탭을 열어 최근 연결을 다시 봅니다.
• 패널 안에서 터미널 설정(글꼴, 테마)과 찾기를 조절해도 세션이 끊기지 않습니다.

탭을 끌어 순서를 바꾸거나 분할 보기로 합칠 수 있습니다. 두 장치를 나란히 볼 때 합치고, 집중할 때 탭 바로 되돌리세요.

5. 파일 전송과 터널

이중 패널 파일

세션 안에서 SFTP를 열면 로컬과 원격이 나란히 보입니다. 흔한 동작: 열기, 대상 디렉터리로 복사, 새 폴더/파일, 이름 바꾸기, 삭제, 권한 변경, 숨김 파일 표시, 경로 복사. 충돌 시 안내에 따라 건너뛰거나 덮어쓰고, 진행은 패널 하단에 남습니다.

터널과 포워딩

1. Home → 포워딩 → 새 포워드.
2. 유형을 고르세요. 로컬(로컬 포트를 대상 환경으로), 원격(원격 포트를 이쪽으로), 동적(SOCKS5 프록시).
3. 이름, 포트, 바인드 주소, 대상 호스트와 주소를 채운 뒤 포워딩 시작으로 켜고 끕니다. 상태는 유휴, 실행 중, 오류입니다.

파일과 포워딩은 어시스턴트에 의존하지 않으며 단독으로 쓸 수 있습니다.

6. 운영 어시스턴트 사용(Deck)

상단에서 Deck으로 전환하세요. 왼쪽은 새 채팅, 스킬, MCP 서버, 최근 채팅, 장치 참조이고, 가운데는 대화와 도구 실행 영역입니다.

첫 대화

1. 툴바에서 모델이 선택되어 있는지 확인하세요. 클라우드 모델은 로그인 직후 쓸 수 있습니다.
2. 승인 모드는 승인 요청(기본값)으로 두세요. 모든 동작에 허용 또는 건너뛰기를 클릭합니다.
3. 입력줄 왼쪽 +로 장치, 그룹, 스킬, 이미지를 더하거나 장치 참조에서 끌어오세요. 참조는 맥락 칩이 되어 어시스턴트가 범위를 압니다.
4. 자연어로 목표를 설명하세요. CPU, 디스크, 주요 인터페이스 상태 같은 읽기 전용 점검부터 시작하세요.
5. 동작이 확인을 기다리면 허용 또는 건너뛰기를 고르세요. 반복되는 비슷한 명령은 "허용 기억"으로 같은 패턴에 끊기지 않게 합니다.

승인 모드

• 승인 요청: 모든 동작에 허용 또는 건너뛰기를 클릭합니다.
• 내 대신 승인: 위험으로 감지된 동작만 승인을 요청합니다.
• 모두 허용: 단계별 알림은 없지만 위험 명령은 여전히 차단됩니다. 위험 단어 목록은 사용자 지정할 수 있습니다. 흐름을 알기 전에는 이 단계를 쓰지 마세요.

7. 내장 도구

어시스턴트에는 장치 실행, 파일과 문서, 자산 조회, 코드 검색, 웹 접근, 모니터링을 다루는 내장 도구 39개가 있습니다. 변경 동작은 먼저 승인 모드를 거치고, 조회는 바로 실행됩니다.

장치 실행

• 로컬 명령: 이 기기에서 명령을 실행합니다. 긴 작업은 백그라운드로 가고, 언제든 프로세스를 나열하거나 출력을 읽거나 종료할 수 있습니다.
• SSH / 일괄 SSH: 등록된 하나 또는 여러 장치에서 명령을 실행하며, 일괄 모드에서는 동시에 실행합니다.
• Telnet: 네트워크 장치 같은 Telnet 대상에서 명령을 실행합니다.

파일과 문서

• SFTP 전송: 이 기기와 장치 사이에서 올리고 받습니다.
• 파일 읽기 / 편집: 로컬과 원격 텍스트 파일을 읽고 정확한 치환을 적용합니다.
• 문서 처리: PDF를 읽고, Excel과 Word를 읽고 쓰며, 점검 보고서를 바로 만듭니다.

자산과 맥락

• 장치 / 그룹 / 스킬 찾기: 인벤토리 자산을 언제든 맥락으로 조회합니다.
• 채팅 기록과 작업 목록: 지난 대화를 살펴보고 다단계 작업을 체크리스트로 유지합니다.

코드와 참고

• 코드 도구: 저장소 구조 맵, 내용 검색, 심볼 정의와 참조.
• 탐색 서브에이전트: 큰 디렉터리나 긴 문서를 읽기 전용으로 병렬 탐색하고, 요약을 메인 채팅으로 돌려줍니다.
• 웹 검색 / 페이지 가져오기: 외부 참고를 검색하고 페이지 내용을 가져옵니다. 웹 검색은 계정에 포함됩니다.

모니터링과 스킬

• 지표 읽기/쓰기: 장치 모니터링 지표를 읽고, 확인 후 지표를 추가하거나 수정합니다.
• 스킬 추출: 현재 절차를 새 스킬로 쓰거나 기존 스킬을 업데이트합니다(확인 필요).

전형 시나리오

• 점검: 여러 장치에서 CPU, 디스크, 주요 인터페이스 상태를 확인하고 읽을 수 있는 결론을 냅니다.
• 변경: 설정 파일을 고치고 서비스를 다시 시작하며, 단계마다 확인합니다.
• 전송: 원격 로그를 묶어 가져오고, 분석한 뒤 보고서를 출력합니다.
• 장애 대응: 웹 검색과 문서 읽기를 결합해 오류 원인을 찾습니다.

8. 스킬

스킬은 재사용 가능한 Markdown 프롬프트(이름 + 한 줄 설명 + 본문)이며, 로컬 스킬 라이브러리에 저장되고 클라우드 백업에 포함됩니다.

• 만들기: Deck → 스킬에서 직접 쓰거나, 지난 대화에서 AI로 추출하거나, 확인 후 어시스턴트가 새 스킬을 저장하게 합니다.
• 사용: 입력줄에서 "+ → 스킬", 또는 직접 인용합니다. 한 번 인용되면 해당 턴 동안 활성 상태라 후속 질문은 다시 인용하지 않아도 됩니다.
• 진화: 어시스턴트는 사용 중에 스킬 내용을 다듬을 수 있으며, 변경도 확인이 필요합니다.

9. MCP 서버

어시스턴트는 MCP(Model Context Protocol) 서버에 연결해 외부 도구를 같은 대화로 가져올 수 있습니다.

• 전송: stdio(로컬 명령으로 기동)와 Streamable HTTP(원격 URL).
• 구성: Deck → MCP 서버 → 추가. 명령, 인수, 환경 변수를 채우거나 JSON 구성을 붙여 가져와 주세요.
• 활성화: 켜면 해당 도구가 어시스턴트 도구 세트에 합류합니다. 이름 충돌 시 내장 도구가 이깁니다. 목록은 각 서버의 상태와 도구 수를 보여줍니다.
• 안전: 모든 MCP 도구 호출은 내장 도구와 같은 승인 모드를 거칩니다.

서버가 준비되지 않으면(프로세스가 시작되지 않았거나 URL에 닿지 않으면) 호출은 아무것도 하지 않습니다. 먼저 목록에서 상태를 확인하세요.

10. 터미널 명령 제안

설정 → AI 기능에서 명령 제안을 켜면, 로컬 또는 원격 터미널에서 입력하는 동안 커서 옆에 후보가 나타납니다. 제안 모델은 클라우드에서 구성되고, 로컬에서는 후보 수만 고릅니다.

• 미리보기와 목록이 나란히 있습니다. Tab으로 수락, 화살표로 전환, 패널을 닫고 계속 입력합니다.
• 패널은 자연어 의도를 받습니다. Enter를 눌러 후보를 생성하세요.
• 후보는 현재 세션과 장치 유형을 따르며, 그 순간의 명령 체계에 맞습니다.
• 제안이 나타나지 않으면: 스위치가 켜져 있는지, 로그인했는지, 현재 패널이 제안을 지원하는 세션 유형인지 확인하세요.

11. 모니터링과 탐색

경로: Home → 작업. 탭 두 개: 모니터와 탐색.

모니터

1. 새 작업을 클릭하고, 관찰할 호스트를 선택한 뒤 확인하세요.
2. 장치 카드에서 지표를 보고, 세부 정보를 열어 이름, 프로토콜, 간격, 파싱, 알림, AI 에스컬레이션을 설정하세요.
3. AI 에스컬레이션 옵션: 끔, 분석만(L1), 확인 후 복구(L2). L2도 어시스턴트 확인을 거치며 설정을 조용히 바꾸지 않습니다.
4. "지금 수집"으로 단일 지표가 기대한 값을 내는지 확인하세요.

탐색

1. 설정 → AI 기능에서 탐색 모델을 고르세요. 클라우드 모델은 로그인 후 쓸 수 있습니다.
2. 모니터로 돌아와 장치에서 지표 자동 탐색을 시작하세요. 과정은 탐색 중으로 표시됩니다.
3. 탐색 탭에서 탐색 요약과 후보를 검토하세요. 각각은 대기 또는 채택입니다. 선택하고 채택을 눌러야 일상 수집에 들어갑니다.

탐색은 후보만 제안하고 스스로 수집을 시작하지 않습니다. 루틴에 넣을지는 당신이 결정합니다.

12. 프로토콜 사양

SSH, Telnet, RDP, SFTP, 로컬 셸의 구현 세부 — 인증 매트릭스, 옵션 협상, 채널 기능, 신뢰 모델, 시스템 요구 사항 — 는 기술 사양 페이지에 모아 두었고 데스크톱 앱과 동기화됩니다.

13. 사용자 모델(고급, 선택)

기본으로는 필요 없습니다. 클라우드 모델은 로그인하면 동작합니다. 직접 모델 서비스를 쓸 때만 구성하세요.

1. Home → 설정 → 모델 → 모델 추가를 여세요.
2. 벤더 템플릿(OpenAI, Anthropic, DeepSeek, Ollama, OpenRouter, Moonshot, Qwen, Zhipu) 또는 사용자 지정 기본 URL을 고르세요.
3. API 키와 모델 이름을 입력하고 저장하면 Deck 입력줄에서 선택할 수 있습니다.

사용자 모델 키는 이 기기에만 저장됩니다.

14. 안전과 기본값

• 어시스턴트 기본값은 승인 요청입니다. 읽기 전용 작업으로 도구 호출 리듬에 익숙해진 뒤에 경계를 넓히세요.
• "허용 기억"은 비슷한 명령에만 적용되며, 전역 음소거가 아닙니다.
• "모두 허용"도 위험 단어 목록의 명령은 차단하며, 목록은 사용자 지정할 수 있습니다.
• 호스트 지문은 첫 연결에서 확인해야 합니다. 바뀌면 예상된 변경인지 확인한 뒤 신뢰 방식을 고르세요.
• 장치 비밀번호, 키 재료, 사용자 모델 키는 로컬 신뢰 경계 안에 있습니다. Termini를 실행하는 컴퓨터를 보호하세요.
• 자동 알림 복구(L2)는 다른 어시스턴트 쓰기 동작과 같이 확인 정책을 따릅니다.

더 넓은 설명은 기능 페이지를 보세요. 설치 후 위 2 → 3 → 4 → 6 단계로 첫 루프를 마치세요.