AI 채팅

AI 채팅은 Blyck의 중심 기능입니다. Claude Code CLI(Anthropic) 또는 Codex CLI를 앱 안에 직접 임베드하고, 사용자 본인 계정·크레딧으로 모델을 호출합니다. 대화 내용은 Blyck 서버를 거치지 않고 로컬(userData/chats/)에만 저장됩니다.

준비 — AI 준비 마법사

처음 AI 채팅 패널을 열면 AI 준비 마법사가 자동으로 실행됩니다.

CLI 감지 — 시스템에 Claude Code CLI / Codex CLI 설치 여부를 확인합니다.
설치 안내 — 미설치 시 설치 명령과 링크를 안내합니다.
로그인 확인 — claude login / codex login 완료 여부를 확인합니다.

마법사를 통과하면 바로 채팅을 시작할 수 있습니다. 이후에는 마법사가 다시 나타나지 않습니다.

채팅 열기

방법	설명
`Ctrl+Shift+A`	활성 패널을 분할하고 AI 채팅 추가
좌측 메뉴 → AI 채팅	새 탭으로 열기

제공자 · 모델 선택

입력창 왼쪽 드롭다운에서 Claude 또는 Codex를 선택합니다. 채팅별로 독립적으로 지정되고, 채팅 도중에도 전환할 수 있습니다.

항목	내용
프로바이더	Claude (Claude Code CLI) · Codex (OpenAI Codex CLI)
모델 선택	채팅별 독립 지정, 채팅 도중 전환 가능
멀티턴	세션 유지 — 앱을 껐다 켜도 대화 맥락이 이어집니다
응답	토큰 단위 실시간 스트리밍, ■ 정지(또는 `Esc`)로 즉시 중단

채팅은 패널 단위로 여러 개를 동시에 열 수 있습니다. 각 채팅이 독립 세션이라 한쪽이 긴 작업 중이어도 다른 채팅으로 작업할 수 있습니다.

4가지 권한 모드 — Ctrl+1~4

AI에게 줄 권한을 작업 성격에 맞춰 한 키로 전환합니다.

키	모드	AI가 할 수 있는 것
`Ctrl+1`	💬 채팅	읽기만. 분석·질문·코드 리뷰. 어떤 변경도 불가
`Ctrl+2`	📋 계획	읽기 + 문서(.md) 작성. 코드·DB 변경 불가 — 설계 단계용
`Ctrl+3`	⚡ 실행+검토	모든 도구 사용 가능, 매 단계 사용자 승인 후 진행
`Ctrl+4`	🚀 자동	자율 진행. 일반 읽기·쓰기는 자동, 위험 작업만 확인 요청

도구 — AI가 직접 일합니다

AI는 MCP 브리지를 통해 약 40개 도구로 워크벤치를 직접 다룹니다. 도구 실행은 채팅 스레드 안에 도구 카드(아이콘 + 이름 + 소요 시간)로 인라인 표시되고, 카드를 클릭하면 입력값과 결과를 펼쳐볼 수 있습니다.

영역	대표 도구
파일	읽기·쓰기, 디렉터리 목록 (원격 프로젝트면 SFTP 자동 라우팅)
DB	쿼리 실행, 스키마 조회, 컬럼 통계 분석
SSH · WinRM	명령 실행, 출력 수집, 서버 환경 자동 탐지
Git · ChangeSet	status/diff/log/commit, 체크포인트, 변경 되돌리기
실행 · 미리보기	프로그램 실행·관측, 스크린샷, 콘솔 로그, 클릭·입력, 시각 회귀
RAG	워크스페이스 의미 검색 (`workspace_search`)
에디터	코드 직접 주입 (검토 모드면 Apply/Reject 카드)
기타	Python 격리 실행, 화면·VNC 캡처, 사용자에게 질문, 알림

코드 블록 실행 버튼

AI 답변의 코드 블록마다 실행 버튼이 붙습니다.

SQL — ▶ 클릭 시 활성 DB 패널에서 실행
Bash/PowerShell — ▶ 클릭 시 SSH 또는 터미널 패널에서 실행
diff — 🔀 클릭 시 파일에 적용

실행 결과는 다음 메시지 컨텍스트에 자동 첨부됩니다.

Python 격리 실행

데이터 분석·알고리즘 검증·정규식 테스트 같은 계산을 채팅별 격리 venv에서 Python으로 직접 실행합니다. 시스템 Python에는 영향이 없고, 패키지 설치(pip)는 확인 다이얼로그를 거칩니다. 채팅을 삭제하면 venv도 함께 정리됩니다.

정적 위험도 분석

AI가 호출하는 SQL·셸 명령은 정적 분석으로 위험도를 자동 분류합니다.

위험도	예시	동작
읽기	`SELECT`, `ls`, `cat`	자동 실행
쓰기	`INSERT/UPDATE`(WHERE 있음), `mv`, `chmod`	확인 다이얼로그
파괴적	`DROP/TRUNCATE`, WHERE 없는 `DELETE`, `rm -rf`	강한 확인 + 영향 미리보기
시스템 경로	`/etc`, `C:\Windows`	차단

DB 연결에 prod 환경 라벨을 붙이면 해당 연결의 위험도가 한 단계 상향됩니다.

도구 승인 게이트 (⚡ 실행+검토 모드)

⚡ 실행+검토 모드에서는 AI가 파일 수정·명령 실행 전에 승인 카드를 표시합니다.

파일 편집 카드

+/- diff 형태로 변경 내용 미리보기
[Apply] [Reject] [이 세션 자동 허용] 선택

명령 확인 카드

명령어·실행 경로·이유 표시
[실행] [거부] [이 세션 자동 허용] 선택

거부 시 사유를 입력하면 AI에게 전달되어 다른 방식을 제안받습니다. 승인하기 전까지 AI는 무기한 대기합니다.

💭 생각 과정

Claude extended thinking 또는 Codex reasoning이 켜진 모델에서는 답변 안에 접이식 ”💭 생각 과정” 카드가 포함됩니다(기본 접힌 상태). 카드를 클릭하면 AI의 내부 추론 전체를 확인할 수 있습니다. Claude·Codex 모두 동일한 UI를 사용합니다.

첨부 — 파일 · 화면 캡처

방법	설명
📎 버튼 또는 `@`	이미지·텍스트·PDF 파일 첨부
`Ctrl+L`	편집기에 열린 파일을 현재 채팅에 첨부
📷 화면 캡처	십자 드래그로 영역 선택 → 마크업 → “AI로 전송” (외부 모니터 포함)
웹 미리보기 ✏️	미리보기 패널 화면을 AI로 전송
화면 녹화	특정 프레임을 AI로 전송

이미지는 임시 파일로 저장된 후 AI가 vision으로 분석합니다.

작업공간 자동 인지 (컨텍스트 칩)

메시지를 전송할 때마다 활성 탭의 패널 상태가 자동으로 수집되어 AI에 전달됩니다.

패널	전달되는 컨텍스트
에디터	보이는 코드 + 선택 영역 + 커서 위치
DB 결과 그리드	실행한 쿼리 + 결과 샘플 + 선택한 셀
DB 트리	활성 연결 + 스키마(테이블·뷰 목록)
SSH 터미널	최근 명령 + 출력 + 선택 영역
SFTP	현재 경로 + 선택 파일
폴더 트리	현재 디렉터리 + Git 상태(브랜치·수정 파일)

그래서 “이 쿼리 결과에서”, “지금 보고 있는 함수를”, “이 서버에서” 같은 표현이 통합니다.

컨텍스트 미리보기 바

입력창 위 “AI가 보고 있어요” 바에 패널 칩이 나열됩니다.

칩을 클릭하면 실제 전달 내용(크기, 마스킹된 필드)을 미리 볼 수 있습니다.
칩의 [×]로 특정 패널을 제외하고, 흐리게 표시된(백그라운드) 패널은 클릭해서 포함시킵니다.
크기는 패널당 4KB · 전체 20KB로 제한되어 자동 요약됩니다.
비밀번호·API 키·토큰·개인 키는 자동 마스킹되어 AI에 전달되지 않습니다. prod 연결은 기본적으로 가려집니다.

멀티세션 & 프로젝트 폴더

멀티세션

여러 채팅이 동시에 열려 있을 때, AI는 다른 채팅의 최근 작업을 workspace_recent·workspace_locks로 자동 인지합니다. 워크스페이스 노트(workspace_note)로 채팅 간 메모를 공유할 수 있습니다. 예를 들어 한 채팅에서 “새벽 2시 운영 점검 중, DDL 금지”라고 적어두면 다른 채팅의 AI도 이를 읽고 조심합니다.

프로젝트 폴더

AI 채팅 패널 상단에서 프로젝트 폴더를 지정합니다.

대표 폴더 — 기준 폴더. Git 체크포인트, 원격 검색의 기준이 됩니다.
추가 폴더 N개 — 프론트엔드 + 백엔드처럼 복수의 폴더를 동시에 지정할 수 있습니다.
원격 SFTP 폴더 — 원격 폴더를 프로젝트 폴더로 지정하면 파일 도구가 SFTP로 자동 라우팅됩니다.

백그라운드 작업

큰 분석·리포트·리팩토링은 AI가 백그라운드 작업으로 분리해 실행할 수 있습니다(동시 최대 5개). 메인 채팅은 그대로 사용할 수 있고, 완료되면 결과를 가져옵니다. 빠른 위임이 필요할 때는 서브에이전트(ai_subchat)에게 하위 분석을 맡기고 결과를 받아 이어갑니다.

채팅 관리 · 메시지 액션

채팅 목록 — 제목·마지막 활동 시간·메시지 수·토큰 사용량과 함께 나열되고, 검색으로 과거 채팅을 찾습니다.
제목 변경 — 채팅 제목을 더블클릭해서 이름을 바꿉니다.
메시지 복사 — 각 메시지의 📋 버튼으로 전체 내용을 복사합니다.
코드블록 액션 — 코드블록마다 복사 / ▶ 실행 버튼이 붙습니다.

비용 · 이력

각 답변 헤더에 모델 · 소요 시간 · 토큰 수가 표시되고, 채팅별 누적 토큰/비용(USD)이 집계됩니다.
채팅 이력은 로컬(userData/chats/)에 저장됩니다. 민감 정보는 마스킹된 형태로만 저장됩니다.

통합검색 (RAG) 연계

AI는 답변 전에 워크스페이스를 의미 기반으로 검색(workspace_search)해 프로젝트 코드·DB 스키마·과거 채팅을 참고하고, 인용한 파일을 “참고:“로 표시합니다. 클릭하면 원본 위치로 이동해 AI 답변의 근거를 직접 확인할 수 있습니다. 임베딩은 로컬에서 처리되므로 코드가 외부로 나가지 않습니다.

통합검색 직접 사용(단축키 Ctrl+K, 소스 필터, 리랭킹 설정 등)은 RAG 통합검색 문서를 참고하세요.

변경은 모두 되돌릴 수 있습니다

AI가 수정한 파일·DB·SSH 변경은 ChangeSet에 자동 기록됩니다. 채팅 하단의 📦 ChangeSet 칩 또는 Ctrl+Shift+H에서 “이 작업” 필터로 AI가 한 일을 확인하고 항목별로 되돌리세요.

FAQ

“AI 준비 필요” 메시지가 반복해서 뜹니다 마법사에서 CLI 설치 → claude login (또는 codex login) 순으로 진행하세요. 설치 후 Blyck을 재시작해야 CLI가 인식됩니다.

응답이 오지 않거나 중간에 멈춥니다 자동 재시도가 최대 3회 실행됩니다. 인증이 만료된 경우 재로그인 후 새 채팅을 여세요. ■ 정지 후 메시지를 더 구체화해 재전송하는 것도 효과적입니다.

중지 후 재요청하면 빈 응답이 옵니다 도구 실행 도중 중지한 경우 발생합니다. 새 채팅을 열어 계속하세요.

승인 카드 없이 파일이 바뀌었습니다 🚀 자동 모드(Ctrl+4)로 설정되어 있을 때 발생합니다. Ctrl+3(⚡ 실행+검토)로 전환하면 매 단계 승인 카드가 표시됩니다.

특정 패널 정보를 AI에 보내고 싶지 않습니다 컨텍스트 미리보기 바에서 해당 패널 칩의 [×]를 클릭하면 그 패널이 이번 메시지에서 제외됩니다.

비밀번호가 AI에 노출될 수 있나요? 비밀번호·API 키·토큰·개인 키는 자동 마스킹되어 AI에 전달되지 않습니다. prod 연결은 기본적으로 컨텍스트에서 제외됩니다.

RAG 검색 결과가 없거나 엉뚱합니다 모델 로드·다운로드 대기 또는 인덱싱 진행 중일 수 있습니다. 소스 필터를 조정하거나 .termeditignore로 노이즈가 되는 경로를 제외하세요. 자세한 내용은 RAG 통합검색 참고.