터미널 · SSH · SFTP · 파일

Blyck은 명령을 입력하는 창(터미널), 다른 서버에 접속하는 창(SSH), 서버의 파일을 보는 창(SFTP 원격 트리), 내 PC의 파일을 보는 창(파일 트리)을 모두 같은 모양의 칸으로 다룹니다. 화면을 나눠 여러 서버를 한꺼번에 보거나, 내 PC와 서버 사이에 파일을 주고받을 수 있습니다.

무료 / Pro

이 쪽의 기능은 모두 무료입니다. AI를 부르는 부분(터미널 출력 AI 분석 Ctrl+I, 원격 프로젝트 폴더를 AI 채팅에 쓰기)만 Pro입니다. 맥에서는 Ctrl 대신 Cmd도 됩니다.

로컬 터미널

1. 파일 트리 — 키보드로 이동하고(↑↓→← Enter), 맨 아래 줄에 쓸 수 있는 키가 보임
2. Git 표시 — 고친 파일은 M과 노란색으로 보임
3. 내 PC 터미널 — 평소 쓰던 셸을 그대로 씀

내 PC에서 명령을 입력하고 결과를 보는 창입니다.

여는 곳

방법	설명
Ctrl+Shift+T	새 탭에 새 터미널
Ctrl+\ / Ctrl+Shift+-	지금 칸을 좌우 / 위아래로 나누고 새 칸에 터미널
칸 머리줄(맨 위 줄)의 +	같은 칸에 터미널을 하나 더 겹쳐 엶(이 패널에 새 셸 탭)

어떤 셸이 열리나

Blyck이 자동으로 골라 엽니다. 셸을 고르는 설정은 없습니다.

운영체제	고르는 순서
Windows	PowerShell 7 → Windows PowerShell 5.1 → 마지막 수단으로 cmd.exe
macOS · 리눅스	평소 쓰는 셸(보통 zsh 또는 bash). 없으면 /bin/bash

• 다른 셸을 쓰고 싶으면 터미널 안에서 cmd, bash, wsl처럼 직접 입력해 들어갑니다.
• 한글: 한글이 깨지지 않도록 처음부터 UTF-8로 맞춰 시작합니다. 한글 고정폭 글꼴 D2Coding이 들어 있어 따로 설치할 필요도 없습니다. 다만 PowerShell 5.1에서는 ipconfig 같은 일부 프로그램의 한글이 깨질 수 있습니다 — PowerShell 7을 설치하면 해결됩니다(winget install Microsoft.PowerShell).

복사 · 붙여넣기

동작	결과
글자를 끌어 선택 → Ctrl+C	복사
선택 없이 Ctrl+C	실행 중인 명령 멈추기
Ctrl+V	붙여 넣기
마우스 오른쪽 버튼	메뉴(텍스트 복사·붙여넣기·모두 선택 등)

주의

Ctrl+Shift+C는 복사가 아니라 📷 화면 영역 캡처입니다. 글자를 선택만 해서는 복사되지 않습니다.

출력 속 파일 이름 다루기

ls·dir 결과에 보이는 파일·폴더 이름을 마우스로 골라 바로 다룹니다.

• 이름을 한 번 클릭하면 이름 전체가 골라지고, Ctrl+클릭으로 여러 개, Shift+클릭으로 범위를 고릅니다.
• 고른 상태에서 Ctrl+C/Ctrl+X → 다른 폴더로 가서 Ctrl+V. 같은 PC·같은 서버 안이면 복사/이동 명령이 입력만 되고 Enter를 눌러야 실행됩니다. 내 PC ↔ 서버 사이면 바로 파일을 보냅니다.
• F2는 이름 바꾸기, Ctrl+D는 삭제입니다. **로컬은 휴지통으로(복구 가능), SSH는 즉시 삭제(복구 불가)**입니다.
• 폴더 이름을 두 번 클릭하면 그 폴더로 이동해 목록을 보여 주고, 파일 이름을 두 번 클릭하면 편집기로 엽니다.
• edit 파일이름을 입력하면 그 파일을 편집기로 엽니다. SSH 터미널에서는 서버 파일을 SFTP로 열어 줍니다.
• 출력 속 http://·https:// 주소를 누르면 브라우저로 엽니다.

지난 출력 검색 — Ctrl+F

검색 줄이 뜨고, 글자를 칠 때마다 바로 찾습니다. Enter 다음, Shift+Enter 이전, Esc 닫기. 지난 출력은 10,000줄까지 보관합니다.

셸이 끝났을 때

exit를 하면 [셸 종료 — exit {code}] Enter 키로 재시작 · Ctrl+Shift+W로 닫기가 보입니다. Enter를 누르면 마지막 폴더에서 다시 시작합니다.

비밀번호 입력 보호

키보드가 한글 상태로 비밀번호를 치면, 화면에 안 보이는 채로 한글이 들어가 로그인이 계속 실패합니다. Blyck은 password:·비밀번호: 같은 질문 줄에 한글이 들어오면 보내지 않고 “한글 입력 상태라 비밀번호에 넣지 않았습니다…” 알림을 띄웁니다. 한/영 키로 영문으로 바꾼 뒤 처음부터 다시 입력하세요.

터미널에서 AI 부르기

① 선택한 출력 AI 분석 — Ctrl+I (Pro)

1. 에러 메시지나 로그를 마우스로 선택합니다.
2. Ctrl+I를 누르면 터미널 출력 → AI 분석 창이 뜹니다. 기본 요청은 “이 출력을 분석해서 문제·원인·해결책을 설명해줘”입니다.
3. Enter로 보내면 답이 실시간으로 채워집니다. 선택이 너무 길면 마지막 12,000자만 보냅니다.

② /claude 명령 (무료 — 그 셸에 설치된 claude 프로그램을 씀)

입력	하는 일
/claude 질문	답만 합니다(조회 도구만 사용)
/claude? 질문	터미널의 최근 출력 25줄을 함께 보여 주고 묻습니다(에러 분석용)
/claude! 질문	파일 수정·명령 실행까지 허용
/claude!? 질문	위 두 가지를 함께

그 셸에 claude 프로그램이 설치되어 있어야 합니다. SSH 터미널에서는 서버에 있어야 합니다. 사용량은 그 Claude 계정에서 나갑니다.

SSH 접속

1. User·Host·Port — 서버 주소. Host에는 IP·주소·별명을 넣음
2. 비밀번호 — 넣으면 자동 입력되고 SFTP도 함께 연결. 비우면 키/agent 인증
3. 저장 이름 — 넣으면 새 탭 메뉴의 "저장된 접속"에 등록(비밀번호는 이 PC에 암호화)

다른 서버에 접속해 명령을 입력하는 터미널입니다. PC에 설치된 ssh 프로그램을 그대로 쓰므로, 평소 쓰던 ~/.ssh/config 설정과 키가 그대로 적용됩니다.

사용 순서

1. Ctrl+Shift+S(지금 칸에) 또는 Ctrl+Shift+Alt+S(새 탭으로)를 누릅니다.
2. User·Host(필요하면 Port, 기본 22)를 입력합니다. Host에는 ~/.ssh/config의 별명도 됩니다.
3. 키로 로그인하는 서버면 비밀번호를 비워 둡니다. 비밀번호 서버면 넣습니다 — 서버가 비밀번호를 물을 때 Blyck이 한 번 대신 입력합니다.
4. 다음에도 쓸 거라면 저장 이름을 넣습니다.
5. Enter. 칸 위쪽에 ssh 사용자@주소가 보이고 서버 프롬프트가 나타납니다.

1. SSH 칸 — 서버 셸이 그대로 열림
2. tail -f로 작업기 로그를 실시간으로 따라봄
3. Ctrl+F 터미널 출력 검색 — 찾은 곳이 노랗게 칠해지고 "2 / 3"처럼 위치가 보임, ▲▼로 이동

SFTP 함께 연결

SSH에 접속하면 같은 서버에 **파일 전송 통로(SFTP)**가 뒤에서 함께 열립니다. 그래서 SSH 터미널에서 edit, 파일 두 번 클릭, 파일 붙여넣기가 바로 됩니다. 비밀번호를 넣고 접속했으면 ”✓ SFTP 연결됨 — 파일 복사/붙여넣기 즉시 가능” 알림이 뜹니다.

연결이 끊겼을 때 (자동 재연결)

네트워크가 끊기는 등 비정상으로 끝나면 자동으로 다시 접속합니다.

1초 → 2초 → 4초 → 8초 → 16초 → 30초 → 30초 … (모두 10번, 약 3분)

• 기다리는 동안 아무 키나 누르면 재연결을 취소합니다.
• 10번 모두 실패하면 Enter로 다시 시도합니다.
• exit로 정상 종료하면 재연결하지 않습니다.

재연결 때 비밀번호

저장된 접속에 비밀번호가 저장되어 있을 때만 재연결·앱 재시작 때 비밀번호를 자동으로 넣습니다. 접속 창에만 친 비밀번호는 다시 쓰지 않으므로, 그때는 터미널에 직접 입력해야 합니다.

알아 둘 점

• 연결 유지(KeepAlive)·호스트 키 확인 같은 옵션은 PC의 ~/.ssh/config에서 설정하세요. Blyck이 붙이는 옵션은 포트뿐입니다.
• 처음 접속하는 서버의 “yes/no” 질문은 터미널에 그대로 보입니다. 직접 답하면 됩니다.
• 앱을 다시 켜면 SSH 칸은 저절로 다시 접속합니다.

저장된 접속

자주 쓰는 SSH·SFTP·DB·VNC·WinRM·메일 접속을 이름 붙여 저장해 두고 클릭 한 번으로 접속하는 목록입니다.

• 여는 곳: 위쪽 [새 탭 종류 선택] 메뉴 아래쪽 저장된 접속.
• 만들기: 접속 창에서 저장 이름을 채우고 접속하면 등록됩니다. SQLite 파일은 열면 저절로 저장됩니다.
• 접속: 목록에서 누르거나 Ctrl+Alt+1~9. 비밀번호가 저장되어 있으면 입력 창 없이 바로 접속합니다.
• 고치기: 줄의 ✎. 비밀번호 칸을 비워 두면 기존 비밀번호를 그대로 씁니다.
• 정리: 목록 제목 오른쪽 ＋ 폴더로 폴더를 만들고, 항목을 끌어 폴더에 넣습니다. 폴더를 누르면 메뉴 왼쪽에 폴더 패널이 열립니다(주소까지 보이고 이 폴더에서 찾기로 찾음).
• 지우기: 줄의 ✕(✎와 함께 마우스를 올리면 나옴).

비밀번호는 어떻게 보관되나

비밀번호·키 암호는 운영체제의 암호화 기능으로 잠가서 저장합니다(Windows = DPAPI, macOS = 키체인). 파일(connections.json)에는 잠긴 값만 들어갑니다. 저장 이름을 비우면 비밀번호는 저장되지 않습니다.

다른 PC로 복사하면

OS 암호화는 그 PC, 그 사용자 계정에서만 풀립니다. 파일을 다른 PC로 복사하면 비밀번호를 다시 묻습니다. 비밀번호까지 옮기려면 백업 내보내기에서 🔒 비밀번호로 암호화 를 켜고 내보낸 뒤, 새 PC에서 교체로 가져오세요.

파일 트리 (내 PC)

내 PC의 폴더와 파일을 나무 모양으로 보여 주는 창입니다. 키보드만으로 빠르게 다룹니다.

여는 곳: Ctrl+Shift+E(지금 칸에) / Ctrl+Shift+Alt+E(새 탭으로). 처음에는 홈 폴더에서 시작하고, 다시 켜면 전에 보던 폴더로 돌아옵니다.

키보드

키	하는 일
↑ ↓ / PgUp PgDn / Home End	이동
→ / ←	폴더 펼치기 / 접기
Enter (또는 두 번 클릭)	폴더는 펼치기, 파일은 열기
Backspace	한 단계 위 폴더로
:	아무 경로로 이동(다른 드라이브도)
Space	선택/해제
y / x / p	복사 / 잘라내기 / 붙여넣기 (Ctrl+C/X/V도 됨)
d	삭제(확인 질문)
r 또는 F2	이름 바꾸기
n / N	새 파일 / 새 폴더
R	새로고침
u / g	업로드 / 다운로드(아래)
c	고른 파일 경로를 셸 칸에 입력
a	고른 파일을 @경로로 셸 칸에 입력(셸에서 실행 중인 Claude Code 등에 붙일 때)
Ctrl+Shift+G	Space로 고른 항목들, 없으면 맨 위 경로 폴더 안에서 글자 찾기
/ 또는 Ctrl+F	찾기 칸 — 맨 위 경로 폴더와 그 아래 폴더 전부에서 찾기. 이름(치는 대로) / 내용(파일 안 글자, Enter로 시작)

• 맨 위 경로 = 지금 위치: 맨 위 경로는 트리에서 고른 줄을 따라 바뀝니다. 파일을 고르면 그 파일이 든 폴더(예: D: › 바탕화면 › VNITM_통계), 폴더를 고르면 그 폴더입니다. 트리를 막 열었을 때는 연 폴더입니다. 찾기 칸과 Ctrl+Shift+G는 이 경로부터 찾습니다. 맨 앞 조각(예: D:)을 누르면 경로가 그 폴더로 돌아옵니다.

• 찾기 칸: 결과에서 Enter(또는 두 번 누르기)로 파일은 열고 폴더는 그 안으로 들어갑니다. 내용은 Blyck에 들어 있는 ripgrep으로 찾아 찾는 대로 결과가 나오고, 그 사이에도 줄을 눌러 편집기에서 그 줄로 열 수 있습니다. 머리 줄의 ■ 멈춤으로 그만두면 찾은 것은 남습니다(500건 · 5분까지, 50MB 넘는 파일은 건너뜀, 지금 폴더 바로 아래 파일 먼저). Esc로 지우고 트리로 돌아옵니다. 이름은 node_modules · .git 등을 건너뛰고 1,000개가 되면 멈춥니다. SFTP 원격 트리에서도 됩니다(서버에서 찾음).

• 숨김 파일(.git 등)도 항상 보입니다(회색).

• 마우스 오른쪽 버튼 메뉴에서도 복사·잘라내기·이름 변경·삭제·새 파일·새 폴더·새로고침을 씁니다.

• 로컬 파일 삭제는 휴지통으로 갑니다(복구 가능).

파일 열기

파일	열리는 방식
글·코드 파일 2MB 이하	코드 편집기에서 편집
글 파일 2MB ~ 32MB	편집기에서 읽기 전용
32MB 초과 또는 바이너리	트리 칸 안의 글자 보기 창(읽기 전용)
이미지(12MB까지)	이미지 보기(휠 확대·끌어서 이동)
PDF	내장 PDF 보기
오피스 · 압축 파일	PC의 기본 프로그램

Git 표시 (로컬 트리만)

트리를 연 폴더(트리 맨 위 폴더)가 Git 저장소 안이면 파일 왼쪽에 상태 기호가 붙습니다.

기호	뜻
?	새 파일(아직 Git이 모름)
M	고침
+	추가됨(스테이징)
-	지워짐
R	이름 바뀜
!	충돌

참고

트리에는 끌어다 놓기가 없습니다. 탐색기에서 파일을 끌어 놓아도 올라가지 않습니다. 파일 옮기기는 복사·붙여넣기나 u/g 키를 쓰세요.

SFTP 원격 트리와 원격 파일 편집

1. 내 PC 파일 트리
2. Space로 고른 파일(* 표시) — u를 누르면 서버 트리에서 커서가 있는 폴더로 업로드
3. SFTP 원격 트리 — 맨 윗줄 [사용자@주소:포트] 경로. 같은 키로 다루고, 서버 → 내 PC는 g로 다운로드

서버의 폴더와 파일을 내 PC 파일 트리와 똑같은 모양·키로 보여 줍니다. 맨 위 경로가 고른 줄을 따라 바뀌고 찾기가 그 경로부터인 것도 같습니다.

• 경로 앞 **📁▾**를 누르면 그 서버의 갈 곳이 나옵니다: 디스크마다 한 줄(/ · /data 등, 남은 공간 막대 — 90%가 넘으면 노란색)과 자주 쓰는 곳(홈 · 로그 /var/log · 설정 /etc · 프로그램 /opt · 임시 /tmp — 서버에 있는 폴더만). 윈도우 서버는 C: D:. 디스크를 못 읽는 서버는 /와 홈만 나옵니다.

연결하기

1. Ctrl+Shift+F(지금 칸에) / Ctrl+Shift+Alt+F(새 탭으로)를 누릅니다.
2. User·Host(필수), Port, 비밀번호(키 인증이면 비움), 키 경로(비우면 ~/.ssh 기본 키), 키 암호, 저장 이름을 넣습니다.
3. Enter. 비밀번호 → 키 → ssh-agent 순서로 시도하며, 15초 안에 접속되지 않으면 실패합니다.

원격 파일 고치기

1. 원격 트리에서 파일을 Enter 또는 두 번 클릭합니다.
2. 고친 뒤 Ctrl+S를 누르면 바로 서버에 저장됩니다.
3. 저장한 내용은 변경 이력에 남아 되돌릴 수 있습니다(1MB가 넘는 파일은 남지 않음).

• 오피스·압축 파일은 PC에 임시 사본을 받아 엽니다. 고쳐도 서버에 자동으로 올라가지 않습니다.
• 원격 파일 삭제는 영구 삭제입니다(휴지통 없음, 복구 불가).
• 연결이 끊기면 경로가 빨간색이 되고 “SFTP 연결 끊김” 알림이 뜹니다. 저절로 다시 붙지 않으니 트리를 다시 여세요.

파일 옮기기 (업로드 · 다운로드)

방법 ① u / g 키

방향	방법
업로드 (내 PC → 서버)	원격 트리에서 받을 폴더에 커서를 둔 뒤, 로컬 트리에서 Space로 골라 u
다운로드 (서버 → 내 PC)	로컬 트리에서 받을 폴더에 커서를 둔 뒤, 원격 트리에서 Space로 골라 g

로컬 트리와 원격 트리를 둘 다 열어 두어야 합니다(같은 탭에 나란히 두면 편합니다).

방법 ② 복사 · 붙여넣기

한 트리에서 y(복사) → 다른 트리로 가서 p. 로컬 → 서버는 업로드, 서버 → 로컬은 다운로드, 서버 → 다른 서버도 됩니다.

알아 둘 점

• 폴더는 안의 내용까지 통째로 옮깁니다.
• 같은 이름 파일은 묻지 않고 덮어씁니다.
• 다른 곳 사이에서 잘라내기로 붙이면 원본이 지워지지 않습니다. 옮긴 뒤 원본은 직접 지우세요.
• 시작·끝 알림만 있고 파일마다의 진행률 표시는 없습니다.

원격 프로젝트 폴더 (AI 채팅용) (Pro)

AI 채팅이 작업할 폴더를 내 PC가 아니라 서버의 폴더로 정합니다. 정하면 AI의 파일 읽기·쓰기·목록 보기가 그 서버로 갑니다.

1. AI 채팅 칸의 폴더 칩을 누릅니다. 처음(점선 ＋ 폴더)이면 바로 고르는 메뉴가 뜨고, 이미 폴더가 있으면 칩 아래 목록에서 폴더 관리… → 변경을 누릅니다.
2. 저장된 SSH·SFTP 접속(📡)을 고르거나 **➕ 원격(SSH/SFTP) 연결…**로 새로 입력합니다.
3. 폴더를 눌러 들어가 원하는 폴더에서 이 폴더 선택.
4. 칩이 파란 서버 아이콘과 서버 · 폴더이름으로 바뀝니다. 코드 검색용 색인도 서버 폴더를 SFTP로 읽어 만듭니다.

• AI 프로그램은 내 PC에서 돌고, 파일 작업은 SFTP로, 명령은 그 서버의 SSH로 보냅니다.
• 원격 파일의 변경도 변경 이력에 남아 되돌릴 수 있습니다.
• 추가 폴더도 원격 폴더로 고를 수 있습니다.

AI와 함께 (Pro)

AI 채팅은 열려 있는 SSH 칸을 알아봅니다. 말로 시키면 AI가 서버에서 명령을 실행하고 결과를 모아 답합니다.

▸ 이 서버 디스크 남은 공간 봐 줘
▸ 이 서버 어떤 리눅스인지 조사해 줘

읽기 명령(ls·cat·grep 등)은 바로 실행하고, 무언가를 바꾸는 명령은 승인 카드로, 위험한 명령은 ⚠ 강한 카드로 먼저 묻습니다. 자세한 내용은 AI 채팅을 보세요.

자주 묻는 질문

Q. SSH 접속이 안 돼요. Host·Port(기본 22)·사용자명·방화벽을 확인하세요. 같은 PC의 일반 터미널에서 ssh 사용자@주소가 되는지 먼저 보세요.

Q. 키 로그인이 안 돼요. ~/.ssh에 키가 있는지, 서버의 ~/.ssh/authorized_keys에 공개키가 등록됐는지 확인하세요.

Q. 자동 재연결 뒤 비밀번호를 또 물어요. 비밀번호가 저장된 접속에 없습니다. 접속 창에 저장 이름과 비밀번호를 함께 넣어 저장하세요.

Q. 별명(Host 이름)으로 접속했는데 edit·붙여넣기가 안 돼요. 함께 여는 SFTP는 ~/.ssh/config를 읽지 않습니다. 접속 창에 실제 주소와 User를 넣거나 SFTP 원격 트리를 실제 주소로 따로 여세요.

Q. 한글이 깨져요. Windows는 PowerShell 7을 설치하세요. SSH 서버라면 서버에서 locale로 확인하고 LANG을 *.UTF-8로 맞추세요.

Q. 비밀번호가 계속 틀렸대요. 한글 상태로 입력됐을 수 있습니다. 한/영 키로 영문으로 바꾼 뒤 다시 입력하세요.

Q. u/g를 눌러도 안 돼요. 로컬·원격 트리를 둘 다 열고, 업로드는 로컬 트리에서 u, 다운로드는 원격 트리에서 g를 누르세요.

Q. 저장된 접속을 다른 PC로 옮겼더니 비밀번호를 다시 물어요. 보안상 의도된 동작입니다. 비밀번호는 그 PC·그 계정에서만 풀립니다. 백업 내보내기의 비밀번호 암호화를 쓰세요.