선택 영역에 대한 AI 어시스턴트(Ctrl+K / Ctrl+I)

AI에 묻고 AI로 편집하기

기본 AI. 설정 → AI 어시스턴트 상단의 기본 AI는 Ctrl+K/Ctrl+I, AI 채팅 채팅(세션별로 변경 가능) 및 자동 작업(질문 다시 쓰기, 요약, 오디오 요약, 컨텍스트 생성)에서 사용하는 어시스턴트를 선택합니다. CLI와 API 제공자를 모두 나열합니다. 오디오 전사와 embeddings는 자체 제공자가 있으며, LightNote는 선택한 제공자에 따라 모델을 제안합니다.

편집기에서 Ctrl+K(AI에게 질문)나 Ctrl+I(AI로 편집)를 누르면 — 선택 영역이 있든 없든 — 인라인 채팅 스타일의 떠 있는 팝업이 열립니다: 프롬프트 입력란에는 빈 줄 아래로 선택 영역이 미리 채워지며, 그 위에 지시문을 입력하고 Ctrl+Enter로 전송합니다. 팝업에서는 AI(기본값이 미리 선택됨)와 결과 모드를 선택합니다: diff를 통해 선택 영역을 바꾸기(원본 × 제안, 수락 / 복사 / 거부 포함) 또는 답변을 텍스트로 표시만 하기.

LightNote는 AI CLI를 "원샷" 모드로 실행합니다(터미널을 열지 않음). CLI와 기본 AI는 설정 → AI 어시스턴트에 있습니다.

모델 연결하기

API를 통한 모델. 로컬 CLI 외에도 설정 → AI 어시스턴트에서 OpenAI 호환 API(OpenAI, Groq, DeepSeek, OpenRouter, Gemini, Anthropic, Ollama/LM Studio 같은 로컬 인스턴스 등)를 통해 LLM 모델을 등록할 수 있습니다. 카탈로그에서 제공자를 선택하면(기본 URL 자동 입력) 키를 붙여넣고(이 기기에만 인코딩되어 저장됨) 모델 가져오기…와 테스트를 사용하세요. 등록된 모델은 CLI와 함께 동일한 Ctrl+K 선택기에 나타납니다.

한 단계로 연결하기. 보통은 표를 채울 필요가 없습니다. 설정 → AI 어시스턴트에서 AI 연결…을 클릭하고 제공자를 고른 뒤(목록에는 무료 요금제 있음인 것과 내 컴퓨터에서 실행, 키 불필요인 것이 표시됩니다) 세 단계를 따라 버튼으로 키 발급 페이지를 열고 키를 붙여넣으세요. 주소와 모델은 LightNote가 알아서 채우고 저장하기 전에 연결을 테스트합니다. 잘못된 키는 대화 도중이 아니라 그 자리에서 드러납니다. 위쪽 목록에는 이미 연결된 항목과, 빠진 것이 있는 항목에서 무엇이 빠졌는지(“키를 붙여넣지 않음”, “모델을 선택하지 않음”)가 표시되며, 두 번 클릭하면 해당 제공자로 연결 창이 다시 열립니다.

세부 조정. 주소, 모델, MCP 권한, CLI 명령, 음성 전사, 임베딩은 모두 페이지 아래의 고급에 그대로 있습니다. 연결 창 안의 고급 옵션에서도 연결하기 전에 기본 URL과 모델을 바꿀 수 있습니다. 없앤 것은 없습니다. 처음 시작하는 사람의 앞길에서 비켜 놓았을 뿐입니다. 임베딩에는 선택 항목인 차원 필드도 있습니다. 일부 모델은 더 작은 벡터(1536 대신 512)를 돌려줄 수 있어, 품질 손실은 거의 없이 캐시가 절반이 됩니다. 잘 모르겠다면 (모델 기본값)으로 두세요 — 모든 제공자가 이 매개변수를 받아들이지는 않습니다. 값을 바꾸면 캐시가 무효가 됩니다: 차원이 다른 벡터는 비교할 수 없으므로 캐시는 버려지고 다음 검색에서 다시 만들어지며, 그만큼 호출 비용이 새로 듭니다.

모든 실패가 같지는 않습니다. 필요한 대처가 정반대이기 때문에 LightNote는 종류를 나누어 다룹니다. 제공자 과부하와 호출 속도 제한은 시간이 지나면 풀립니다. 앱이 스스로 호출을 다시 시도하고 제공자가 요청한 대기 시간도 지키므로, 그래도 안 될 때만 오류가 보입니다. 잔액이나 지출 한도는 아무리 반복해도 해결되지 않습니다. 계속 시도하지 않도록 메시지가 그렇게 알려 줍니다. 대화가 너무 길어졌을 때 필요한 것은 새 세션이지, 다른 모델이 아닙니다. 그리고 모델 자체의 문제—단종, 계정 범위 밖, 요금제 범위 밖, 또는 호출을 받고도 응답하지 않음—만이 모델을 바꿔서 풀리는 경우입니다. 요청된 대기 시간이 기다리기에 너무 길면, 창을 멈춰 두는 대신 메시지가 몇 초를 요청했는지 알려 줍니다.

스스로 모델 바꾸기. 현재 모델이 실패하면 자동으로 모델 변경을 체크하면, LightNote가 바로 그 자리에 표시된 순서대로 해당 제공자의 추천 모델을 시도합니다. 기본으로 꺼져 있는 것은 의도한 것입니다. 시도 하나하나가 사용자 계정에 청구되는 호출이기 때문입니다. 대체 모델이 사용자가 고른 모델보다 비싼 일은 없습니다—목록은 비싼 것부터 싼 것 순으로 게시되고 앱은 그 목록을 내려가기만 합니다. 목록에 없는 사용자 지정 모델은 곧바로 가장 싼 것으로 내려갑니다. 제공자에 저장되는 것은 확정적인 실패일 때뿐입니다. 네트워크 문제였다면 그 변경은 그 호출에만 적용되고 사용자의 선택은 그대로 남습니다. 변경은 결코 조용히 이루어지지 않습니다. 어떤 모델이 응답했는지, 변경이 저장되었는지를 알림이 알려 줍니다.

그리고 실패보다 먼저 오는 알림. 자동 변경은 호출이 실패한 뒤에야 움직이지만, LightNote가 스스로 확인하는 모델 카탈로그는 대개 그보다 먼저 단종을 알고 있습니다. LightNote가 직접 등록한 모델이 카탈로그에서 빠지면 그 사실을 알려 주고, 설정 → AI 어시스턴트에 후속 모델로 넘어가는 버튼이 나타납니다. 후속 모델은 같은 규칙에 따라 결코 더 비싸지 않습니다. 이 알림은 앱이 고르고 사용자가 한 번도 건드리지 않은 모델에만 해당합니다. 직접 입력한 모델은 사용자의 선택이고, LightNote는 거기에 끼어들지 않습니다.

아무도 응답하지 않을 때. LightNote는 무슨 일이 있었는지 알려 주고 모델 바꾸기, 다른 어시스턴트 사용, 해결될 때까지 그 제공자 비활성화 중에서 고르게 합니다. 비활성화한 제공자(고급 탭 표의 활성 열)는 키와 나머지 설정을 잃지 않고 목록에서만 사라집니다. 어시스턴트 목록에서는 각 항목이 로컬인지 클라우드인지 표시합니다. 클라우드를 고르면 보내는 텍스트가 사용자의 컴퓨터를 벗어납니다.

AI 설정. 어떤 AI든 안내에 따라 설정하려면 AI 설정… 버튼을 쓰세요. 설정 → AI 어시스턴트 맨 위에 있습니다(빈 채팅의 AI 연결…과 AI가 하나도 없을 때 Ctrl+K의 알림도 같은 창을 엽니다). 마법사는 무엇을 설정할지 묻고 다섯 가지 경로를 단계별로 안내합니다: 클라우드 AI, Ollama 또는 LM Studio를 쓰는 내 컴퓨터의 AI, LightNote에서 바로 실행하는 내 컴퓨터의 AI, 명령줄 어시스턴트, 의미로 검색. 버튼 옆의 각 기능이 사용하는 AI 표는 채팅, Ctrl+K, 블록 AI, 자동 작업, 의미로 검색을 어떤 AI가 맡는지 보여 줍니다. 자세한 내용은 내 컴퓨터의 AI에 있습니다.

키 없이: 로컬 LLM

아직 연결된 AI가 없다면. 어시스턴트를 연결하지 않은 상태에서 Ctrl+K를 누르면 LightNote가 상황을 설명하고 바로 연결할 수 있도록 안내합니다. 연결하는 즉시 요청한 작업이 이어서 실행되므로 단축키를 다시 누를 필요가 없습니다.

로컬 LLM(키 불필요). 로컬 제공자 — Ollama, LM Studio, llama.cpp — 는 API 키가 필요 없습니다. 추가에서 하나를 고르고(서버 실행 여부가 목록에 표시됩니다), 모델 가져오기…로 이미 받아 둔 모델 중에서 선택하세요. Ollama가 설치돼 있지 않으면 LightNote가 설치를 도와줍니다. 첫 실행 때 이미 등록돼 있으므로 모델만 고르면 됩니다. 로컬 모델은 응답이 훨씬 오래 걸릴 수 있어(특히 모델을 불러오는 첫 생성 시), LightNote는 클라우드 서비스보다 훨씬 오래 기다립니다. 사용자의 텍스트는 기기 밖으로 나가지 않습니다.

별도 프로그램 없이 모델 실행. Ollama와 LM Studio 외에도 LightNote는 llama.cpp 공식 프로그램으로 모델을 직접 다운로드해 실행할 수 있습니다. AI 설정 마법사는 디스크와 메모리를 얼마나 차지하는지 미리 보여 주고 내 컴퓨터에서 속도를 측정합니다. 내 컴퓨터의 AI를 참고하세요.

적용, 프롬프트, 동작의 위치

블록 단위로 수락. 결과가 diff로 표시되면 전부 수락할 필요가 없습니다. 변경된 각 블록에는 포함 여부를 정하는 체크박스가 있고, 최종 텍스트는 남긴 블록만으로 다시 구성됩니다. 프롬프트에는 파일의 자동 컨텍스트(경로, 언어, 선택 주변 줄)도 담겨, 아무것도 붙여넣지 않아도 AI가 더 정확하게 답합니다.

프롬프트 라이브러리. AI → 프롬프트 라이브러리…는 재사용할 프롬프트를 작업 공간의 Prompts/ 폴더 안 .md 파일로 보관합니다 — 개방형 형식이고, Git으로 버전 관리할 수 있으며, 당신의 두 번째 뇌의 일부가 됩니다. 선택 창에는 검색, 미리 보기, 새 프롬프트 만들기 버튼이 있습니다. 하나를 고르면 {selection}, {file}, {folder}, {name}, {language} 항목이 현재 편집기의 맥락으로 채워지고(직접 만든 변수는 그대로 남습니다), 본문이 Ctrl+K 입력란에 들어가거나 활성 AI 터미널로 전송됩니다(제출하지는 않습니다).

코드 편집기에서만이 아닙니다. AI 동작(Ctrl+K / Ctrl+I 및 컨텍스트 메뉴)은 Markdown 편집기, 작업의 내장 노트, 데이터베이스의 SQL 쿼리 편집기에서도 사용할 수 있습니다. 각 경우 팝업이 커서 위에 열리고 결과를 그 자리에 적용합니다.

모든 AI 동작은 AI 메뉴에 있습니다(☰ 버튼과 활동 표시줄의 지팡이 버튼): AI에 질문(Ctrl+K), AI로 편집(Ctrl+I), AI 세션, AI 채팅, 프롬프트 라이브러리, 작업 공간 컨텍스트 파일 생성, 이 폴더에서 AI 활성화, AI 도우미 설정.

입력하는 동안 창이 닫히지 않습니다. 편집기를 클릭해도 닫히지 않으므로 코드를 다시 읽거나 다른 부분을 선택해도 이미 입력한 지시가 사라지지 않습니다. 창을 닫는 것은 Esc, 창 자체의 ✕, 그리고 결과 동작(적용/취소)입니다. 탭을 바꾸면 쓰던 내용을 간직한 채 잠시 들어갑니다. 같은 파일로 돌아와 Ctrl+K를 누르면 지시가 그대로 다시 나타납니다.