코드 편집기

Blyck의 코드 편집기는 VS Code와 같은 Monaco 엔진(마이크로소프트가 만든 코드 편집 화면 부품)으로 만들었습니다. 파일 트리·터미널에서 연 파일을 그 자리에서 고치고, 저장하고, 실행하고, AI에게 고쳐 달라고 할 수 있습니다.

파일 열기

왼쪽 파일 트리에서 app.py를 열어 오른쪽 코드 편집기로 보는 화면

파일 트리 — Enter로 폴더는 펼치고 접고(▾/▸), 파일은 코드 편집기로 엶(Esc로 트리로 돌아옴)
편집기 머리 한 줄 — 왼쪽은 폴더 › 파일 이름, 오른쪽은 ▶ 실행 ▾ · AI · ⋯ · ×. 맨 아래 상태 줄에 문제 수 · Python 검사 · 줄·칸
Git 표시 — 고친 파일은 왼쪽에 M이 붙고 줄 전체가 노랑으로 보입니다

편집기는 원래 있던 칸(트리·터미널)의 새 서브탭으로 열리고, 원래 화면은 그대로 남아 Esc로 돌아갈 수 있습니다.

방법	하는 법
파일 트리	파일을 두 번 클릭, 또는 줄을 고르고 `Enter` (로컬·SFTP 트리 모두)
터미널 출력	`ls` 등으로 나온 파일 이름을 두 번 클릭
`edit` 명령	터미널에서 `edit 파일이름`. 없는 파일이면 빈 편집기가 열리고 저장할 때 만들어집니다
빈 새 파일	터미널에서 `edit`만 입력(이름 없는 파일)
AI 채팅 코드 블록	코드 블록 아래 [📝 편집기] / [📝 새 편집기]
검색 결과	폴더 검색(`Ctrl+Shift+G`) 결과 줄을 클릭

파일 크기와 종류

파일	동작
글·코드 2MB 이하	자유롭게 편집
2MB ~ 32MB	읽기 전용으로 열림(파일 이름 뒤에 (읽기 전용))
32MB 초과	앞부분 32MB만 읽기 전용으로 표시
그림(12MB까지) · PDF	Blyck 안 보기 화면
오피스·표·압축 파일	컴퓨터의 기본 프로그램

파일 트리에서 n(새 파일)을 누르면 디스크에 빈 파일만 만들어집니다. 만든 파일을 두 번 클릭해서 여세요.

저장과 닫기

고치면 머리 줄의 파일 이름 뒤에 금색 점과 **[저장]**이 나옵니다(저장 안 됨).
Ctrl+S 또는 머리 줄 [저장]. “저장됨 — {파일이름}” 알림이 뜹니다.
Esc(또는 머리 줄 오른쪽 끝 ×)로 닫고 원래 화면으로 돌아갑니다. 저장 안 했으면 먼저 묻습니다.

저장하면 변경 이력에 남습니다(1MB가 넘는 파일은 제외).
앱을 다시 켜면 로컬에 저장된 파일 탭은 다시 열립니다(디스크 내용으로). 원격 파일·이름 없는 파일은 다시 열리지 않습니다.

편집기 머리 줄과 상태 줄

자리	하는 일	보이는 때
폴더 › 파일 이름	어디 있는 어떤 파일인지. 마우스를 올리면 전체 경로	항상
금색 점 · [저장]	저장 안 한 수정이 있음 — 누르면 저장(`Ctrl+S`)	고쳤을 때
▶ 실행 ▾	실행(`Ctrl+F5`, 실행 · 미리보기). ▾에서 디버그(`F5`)	로컬에 저장된 파일(▾는 Python · JavaScript)
+N −N	마지막 커밋과 비교한 바뀐 줄 수 — 누르면 비교 창	Git 저장소의 파일이 바뀌었을 때
미리보기 / 편집	마크다운 미리보기 켜고 끄기	`.md` 파일
AI	인라인 AI(`Ctrl+I`) (Pro)	읽기 전용이 아닐 때
⋯	마지막 커밋과 비교 · 코드 속 SQL에 쓸 DB · 작은 지도 숨기기 · 트리에서 이 파일 보기 · 경로 복사	항상
×	닫고 원래 화면으로(`Esc`)	항상

줄 번호 옆 막대: 마지막 커밋보다 새로 넣은 줄은 초록, 고친 줄은 파랑, 지운 자리는 빨간 삼각형입니다.
맨 아래 상태 줄: 문제 N(누르면 다음 문제로) · 언어 검사 켜짐/준비 중/꺼짐(꺼짐은 눌러서 다시 켬) · 줄·칸 · 공백 · UTF-8 · 줄 끝.

마크다운 미리보기와 마지막 커밋과 비교

**[미리보기]**를 누르면 .md 파일이 꾸며진 화면으로 바뀝니다. 누른 순간의 내용을 보여 줍니다(실시간으로 바뀌지 않음). **[편집]**으로 돌아갑니다.
머리 줄 +N −N 또는 ⋯ → 마지막 커밋과 비교를 누르면 Git diff — 좌: HEAD · 우: 현재 창이 열립니다. 왼쪽은 마지막 커밋, 오른쪽은 지금 편집기 내용(저장 안 한 부분 포함)입니다.

찾기 · 바꾸기

파일 안에서

단축키	하는 일
`Ctrl+F`	이 파일에서 찾기
`Ctrl+H`	찾아 바꾸기
`Ctrl+G`	줄 번호로 이동

폴더 전체 검색 · 바꾸기 (`Ctrl+Shift+G`)

여러 파일 안의 글자를 한꺼번에 찾고 바꿉니다. 로컬 폴더와 원격(SFTP·SSH) 폴더 모두 됩니다.

여는 곳: 파일 트리나 터미널이 선택된 상태에서 Ctrl+Shift+G(편집기 안에서는 안 됨), 또는 명령 팔레트 → 폴더 내 텍스트 검색.

찾는 곳: 파일 트리에서 누르면 Space로 고른 항목들, 없으면 트리 맨 위 경로 폴더(고른 파일이 든 폴더 · 고른 폴더). 터미널에서 누르면 터미널의 지금 폴더입니다.

찾을 글자를 쓰고 Enter. 결과가 파일:줄 내용으로 나옵니다. 줄을 누르면 그 줄이 편집기로 열립니다.
바꾸려면 둘째 칸에 새 글자를 씁니다. 줄마다 바뀐 뒤 모습이 미리 보입니다.
체크 상자로 바꿀 줄을 고르고 [선택 적용] 또는 [전체 적용].
확인 창에서 “{n}개 파일 · 약 {n}곳을 바꿉니다”를 보고 [치환].

검색은 대소문자를 가리지 않는 글자 그대로 찾기입니다. 정규식 같은 선택 사항은 없습니다.
결과는 찾는 대로 나오고, 그 사이에도 줄을 눌러 열 수 있습니다. ■ 멈춤으로 그만두면 찾은 것은 남습니다. 결과는 최대 500건, 로컬·원격 모두 5분이 지나면 그때까지 찾은 것만 보여 줍니다. 찾는 동안에는 바꾸기 단추가 눌리지 않습니다.
Blyck에 들어 있는 빠른 찾기 도구(ripgrep)로 찾고, 지금 폴더 바로 아래 파일이 먼저 나옵니다. node_modules, .git, dist, build 같은 폴더와 50MB 넘는 파일·바이너리 파일은 건너뛰고, 메모장 “유니코드”(UTF-16)로 저장한 글 파일도 찾습니다. 원격은 서버의 rg(없으면 grep)로 같은 규칙대로 찾고, 멈추면 서버에서 돌던 찾기도 끕니다.

언어 지능 (LSP)

Python 파일을 처음 열 때 뜨는 '언어 지능 켜기' 확인 창

언어 지능은 자동완성·설명 보기·오류 빨간 줄·정의로 이동을 해 주는 기능입니다. 언어마다 언어 서버(LSP — 코드 분석 전용 작은 프로그램)를 한 번 내려받아 씁니다. 무료입니다.

언어	언어 서버	설치에 필요한 것
TypeScript / JavaScript	편집기 내장(설치 없음)	없음
Python	Pyright	컴퓨터에 `npm`(Node.js)
Go	gopls	Go 설치
C#	csharp-ls	.NET SDK 설치
Rust	rust-analyzer	없음(인터넷에서 받음)
C / C++	clangd	없음(인터넷에서 받음)
Lua	lua-language-server	없음(인터넷에서 받음)
Shell · JSON · YAML	Bash · JSON · YAML 언어 서버	컴퓨터에 `npm`

처음 한 번

지원 언어 파일을 엽니다(로컬에 저장된 파일).
언어 지능 켜기 창이 뜨면 **[다운로드]**를 누릅니다. 뒤에서 설치되고, 끝나면 바로 켜집니다.
다음부터는 묻지 않습니다. 컴퓨터에 이미 언어 서버가 있으면 그것을 씁니다.

되는 것과 안 되는 것

됨: 자동완성, 마우스를 올리면 설명, 오류 빨간 물결 밑줄, 정의로 이동(F12 또는 Ctrl+클릭 — 다른 파일이면 새 탭으로), 함수 인자 힌트(서버가 지원할 때).
안 됨(내려받은 언어 서버): 이름 한꺼번에 바꾸기, 자동 정렬, 참조 찾기, 빠른 수정. TypeScript/JavaScript는 편집기 내장 기능으로 이것들도 됩니다.
JavaScript는 문법 오류만 보여 줍니다.
이름 없는 파일에는 언어 지능이 없습니다. 먼저 저장하세요.

원격 파일 편집 (SFTP)

서버 파일을 내려받지 않고 바로 고칩니다. SFTP 트리에서 파일을 두 번 클릭하거나, SSH 터미널에서 edit 파일이름을 입력합니다. 이름표에 **(원격)**이 붙고, Ctrl+S를 누르면 바로 서버 파일을 덮어씁니다.

항목	원격 파일에서
크기	로컬과 같음(2MB까지 편집)
▶ 실행 · 디버그 · 마지막 커밋과 비교	안 됨(로컬만)
언어 지능	Python(서버에 python3·pip3 필요) + TypeScript/JavaScript
변경 이력	1MB 이하만 기록
다른 곳에서 바뀐 것	Blyck AI가 고친 것은 바로, 그 밖에는 편집기를 다시 누르거나 저장할 때 확인하고 먼저 물음

저장할 때 “저장 실패: 연결 없음”이 뜨면 SFTP 연결이 끊긴 것입니다. 다시 연결한 뒤 저장하세요(편집기 내용은 남아 있습니다).

인라인 AI — `Ctrl+I` (Pro)

편집기 ⋯ → "마지막 커밋과 비교"로 연 'Git diff — 좌: HEAD · 우: 현재' 창 — 마지막 커밋과 지금 내용을 나란히 비교

왼쪽(HEAD) — 마지막 커밋의 내용, 바뀐 줄은 빨강
오른쪽(현재) — 지금 편집기 내용(저장 안 한 부분 포함), 바뀐 줄은 초록

편집기 안에서 바로 AI에게 “이 부분 고쳐 줘 / 설명해 줘”라고 시킵니다. 바뀐 줄을 그 자리에서 초록/빨강으로 보여 주고, 적용할지는 사용자가 정합니다.

고칠 코드를 고릅니다. 아무것도 안 고르면 파일 전체가 대상입니다.
Ctrl+I(또는 머리 줄 AI)를 누르면 커서 근처에 작은 상자가 뜹니다. 위 줄은 ✦ 입력칸 · ↑(보내기) · ×, 아래 줄은 같이 보내는 칩(고른 줄 또는 파일 전체 · 마지막 실행 오류 · 빨간 줄)과 오른쪽 끝 모델 이름입니다. 빼고 싶은 칩은 **×**로 뺍니다.
할 일을 쓰고 Enter(Shift+Enter는 줄 바꿈). 예: “예외 처리 추가”, “이 코드 설명”. 모델은 모델 이름을 눌러 바꿉니다. 보내는 동안 ↑ 자리에 ■ 멈춤이 나와, 그만두고 쓴 글을 고쳐 다시 보낼 수 있습니다.
바뀐 줄만 그 자리에서 비교해 보여 주고, 바로 아래 작은 카드에 왜 바꿨는지 한 줄과 바뀐 줄 수(+N −N)가 붙습니다 → 적용 Tab · 버리기 Esc · 채팅에서 이어서(요청 · 원래 코드 · 고친 코드 · 이유 · 같이 보낸 것을 전부 채팅 입력칸에). 설명을 부탁했으면 코드를 바꾸지 않고 카드로 답하고, 아래 이어서 묻기… 칸에 쓰면 앞 질문과 답을 같이 보내 다시 묻습니다.
오류 줄 끝에는 ⚠ 이유가 옅게 보이고, 커서를 그 오류에 두거나 마우스를 올리면 그 줄에만 AI로 고치기가 나옵니다(오류 줄이 많아도 단추가 줄마다 늘어서지 않음). ▶ 실행 결과 줄에도 있습니다. 누르면 “이 오류 고쳐줘”가 채워진 채로 열려, 오류를 복사해 붙일 필요가 없습니다.

입력 칸이 열려 있는 동안 편집기는 잠깐 읽기 전용이 됩니다(원본 보호).
AI가 준비되지 않았으면 버튼이 흐리게 보이고, 누르면 AI 준비 마법사로 안내합니다.
DB의 SQL 편집기에서도 씁니다. 그때는 표 정보와 방금 난 오류를 같이 보내고, 고친 SQL은 실행하지 않고 문법만 확인합니다(DB).

코드 안 SQL 자동완성 (DB 링크)

SQL 편집기에서 'p.'을 치자 products 테이블의 컬럼이 형식과 함께 자동완성 목록으로 뜬 모습

별칭(p) 뒤 점을 치면 그 테이블의 컬럼만 — 이름 · 형식 · 테이블 이름이 함께 보입니다

Python·Java 같은 코드 안에 쓴 SQL에도 실제 DB의 테이블·컬럼 이름으로 자동완성을 해 줍니다. 무료입니다.

먼저 DB 트리에서 DB에 연결합니다.
편집기 머리 줄 ⋯ → 코드 속 SQL에 쓸 DB에서 연결을 고릅니다.
코드에서 SQL을 쓰면 후보가 나옵니다 — FROM·JOIN·UPDATE·INTO 뒤에서는 테이블·뷰, 테이블. 뒤에서는 컬럼.

▶ 실행 (SQL 위의 작은 버튼)

따옴표 없이 쓴 SQL 문장 위에 ▶ 실행이 보입니다. 누르면 새 SQL 편집기 탭에서 실행되고 결과 표가 나옵니다.

SQL 종류	동작
조회(`SELECT`·`WITH`)	바로 실행
`INSERT`·`MERGE`, `WHERE` 있는 `UPDATE`·`DELETE`	SQL 실행 확인 창 → [▶ 실행]
`WHERE` 없는 `UPDATE`·`DELETE`	같은 창, 빨간 강한 경고

DB 링크는 기억되지 않습니다. 편집기를 다시 열면 다시 고르세요.
문자열 안의 SQL(cur.execute("SELECT …"))에는 자동완성만 되고 ▶ 실행은 붙지 않습니다. .sql 파일은 DB의 SQL 편집기를 쓰세요.

그 밖의 연결 기능

Ctrl+L: 지금 파일을 같은 탭의 터미널에서 돌고 있는 Claude Code에 @파일경로로 붙여 줍니다. 터미널에 글자를 넣는 기능입니다. 머리 줄의 단추는 없앴습니다 — AI 채팅은 열린 파일 · 고른 줄 · 커서를 이미 자동으로 봅니다.
코드 의미 검색 미리보기: 언어 지능이 없는 파일에서 3글자 이상 단어에 마우스를 올리면 통합 검색에서 관련 결과를 최대 3개 보여 줍니다. 무료입니다.
AI 채팅이 편집기를 봄: AI 채팅은 열린 편집기의 파일 경로·보이는 줄·고른 부분을 자동으로 함께 봅니다(AI 채팅).

편집기 설정

글자 크기: Ctrl+= / Ctrl+- / Ctrl+0(기본 14, 범위 10~40). 편집기와 DB SQL 편집기가 같은 값을 쓰고, 기억됩니다.
편집기 설정 화면은 따로 없습니다. 어두운 테마, 미니맵 켜짐, 탭 크기 2칸, 긴 줄 자동 줄바꿈 꺼짐으로 고정입니다.

편집기 단축키

맥에서는 Ctrl 대신 Cmd를 쓰세요.

단축키	하는 일
`Ctrl+S`	저장(원격이면 서버에 저장)
`Ctrl+I`	인라인 AI (Pro)
`Ctrl+F5` / `F5`	실행 / 디버그로 실행(멈춰 있을 때는 계속) — 디버그는 Python · JavaScript
`F9`	그 줄에 빨간 점(중단점) 켜고 끄기
`F10` / `F11` / `Shift+F11` / `Shift+F5`	다음 줄 / 함수 안으로 / 함수 밖으로 / 디버그 중지
`Ctrl+L`	터미널의 Claude에 이 파일 첨부
`Esc`	편집기 닫고 원래 화면으로
`Ctrl+Shift+W`	지금 탭 닫기
`Ctrl+F` / `Ctrl+H` / `Ctrl+G`	파일 안 찾기 / 바꾸기 / 줄 이동
`Ctrl+Shift+G`	폴더 전체 검색·바꾸기(트리·터미널에서)
`Ctrl+K`	통합 검색
`Ctrl+Shift+H`	변경 이력(ChangeSet)
Ctrl+` / `Ctrl+PgUp` · `Ctrl+PgDn`	탭 고르기 창 / 이전·다음 탭
`Ctrl+=` / `Ctrl+-` / `Ctrl+0`	글자 크게 / 작게 / 기본

자주 묻는 질문

Q. 자동완성·빨간 줄이 안 나와요. 지원하는 확장자인지, 저장된 파일인지 확인하세요. 설치 창에서 [취소]했다면 앱을 다시 켜고 [다운로드]를 누르세요.

Q. “언어 서버 설치 실패: npm install 실패”가 떠요. 컴퓨터에 Node.js(npm)가 없습니다. Node.js를 설치하고 파일을 다시 여세요. Go·.NET 언어 서버는 Go·.NET SDK가 필요합니다.

Q. ▶ 실행 버튼이 안 보여요. 원격 파일이나 이름 없는 파일에는 없습니다. 로컬에 저장한 파일에서만 보입니다.

Q. Ctrl+Shift+G를 누르면 ”…에서만 검색 가능”이라고 나와요. 편집기 안에서 눌렀습니다. 파일 트리나 터미널 탭을 고른 뒤 누르세요.

Q. AI가 고친 파일을 내가 동시에 고치고 있었어요. 편집기가 덮어쓰지 않고 금색 알림 줄로 먼저 묻습니다. 비교해서 고르기로 두 쪽을 합치거나 한쪽을 고르세요. 이미 덮어쓴 것은 ChangeSet에서 되돌릴 수 있습니다.

Q. DB 고르는 칸에 연결이 없어요. DB 트리에서 먼저 연결하세요. 목록은 누를 때마다 새로 읽습니다.

Q. 인라인 AI로 고친 것을 되돌리고 싶어요. Ctrl+Shift+H로 ChangeSet을 열고 되돌리세요(변경 이력 · Git).