본문으로 건너뛰기
목차 · AI와 확장

AI

선택한 텍스트를 AI로 요약·교정·번역하고, AI 채팅 도구 창에서 문서에 대해 묻습니다. 먼저 AI 제공자를 하나 준비합니다.

설치된 AI CLI 바로 쓰기

이 PC에 Claude Code CLI·Codex CLI·Gemini CLI 가 설치돼 있으면 MDStudio 를 시작할 때 찾아서 AI 채팅에 연결하고 알림을 한 번 보여 줍니다.

  • 여럿이 설치돼 있으면 Claude Code CLI → Codex CLI → Gemini CLI 순서로 하나를 고릅니다.
  • 기본 제공자를 직접 고른 적이 있거나 API 키를 저장한 제공자가 있으면 바꾸지 않습니다.
  • 연결만으로는 아무것도 보내지 않습니다. 질문을 보낼 때만 보내고, 처음 보낼 때 어디로 가는지 확인을 받습니다.
  • 다른 제공자로 바꾸려면 채팅 위 모델 칩을 클릭하거나 설정의 [기본으로 쓰기] 버튼을 클릭합니다. 그 뒤로는 자동으로 바꾸지 않습니다.
  • 자동으로 연결한 CLI 를 지우면 다음 시작 때 설치된 다른 CLI 로 바꾸고, 없으면 연결을 풉니다.
  • 쓸 수 있는 제공자가 없으면 모델 칩에 「AI 설정 필요」가 나오고 AI 채팅 창에 [AI 설정...] 버튼이 나옵니다.

AI 제공자 준비하기

  1. 도구 > 설정 > AI를 클릭합니다.
  2. 「등록한 제공자」 목록에서 제공자를 선택합니다.
  3. 「API 키」 칸에 키를 입력하고 [키 저장] 버튼을 클릭합니다.
  4. [연결 테스트] 버튼을 클릭합니다. 「연결됨」이 나오면 준비된 것입니다.
  5. 늘 쓸 제공자면 [기본으로 쓰기] 버튼을 클릭합니다. 목록에 「기본」 배지가 붙습니다.
  • 키는 운영체제 키 저장소(Windows 자격 증명 관리자)에만 저장됩니다. 키 칸을 비우고 저장하면 지웁니다.
  • 설치된 Claude Code CLI·Codex CLI·Gemini CLI 는 목록 아래쪽에 나오고 키 없이 씁니다. 로그인은 CLI 에서 미리 하고, 나중에 설치했으면 [다시 찾기] 버튼을 클릭합니다.
  • 이 PC의 Ollama 같은 서버는 Ollama / OpenAI compatible 에 「주소」와 「모델」을 넣습니다. 127.0.0.1·localhost 주소는 키가 필요 없습니다.
  • 「작업별 모델」에서 편집 작업과 채팅에 다른 제공자·모델을 지정합니다.

입력하는 즉시 저장됩니다. 기본값은 설정 참고.

선택한 텍스트를 AI로 고치기

  1. 편집기에서 텍스트를 선택합니다.
  2. AI 채팅 도구 창 아래의 [요약]·[교정]·[문체 다듬기] 버튼을 클릭하거나 「AI 함수」 목록에서 작업을 선택합니다.
  3. 답 카드가 나오면 「결과 넣기(미리보기)」 버튼을 클릭합니다.
  4. 미리보기 창에서 [확인] 버튼을 클릭합니다. Ctrl+Z 한 번으로 실행 취소합니다.
작업 결과가 들어가는 자리
요약·제목 추천 선택한 텍스트 뒤
링크 제안 커서 자리
나머지(번역·다듬기·교정 등) 선택한 텍스트를 바꿈
  • 교정·문서 구조 다듬기는 선택한 텍스트가 없으면 문서 전체를 씁니다.
  • 링크 제안은 다른 열린 문서와 같은 폴더의 Markdown 파일만 후보로 씁니다.
  • 명령 팔레트(Ctrl+K)에서 작업 이름으로 실행하면 미리보기 창이 바로 열립니다.

AI 채팅으로 묻기

  1. 오른쪽 도구 창의 AI 채팅 탭에서 묻습니다. 닫았다면 보기 > 도구 창 > AI 채팅(Ctrl+Alt+I)을 클릭해 다시 엽니다.
  2. 입력란 위 칩에서 「보낼 자료」를 선택합니다. 「보내지 않음」·「선택한 텍스트」·「현재 문서」·「열린 문서 모두」 중 하나입니다. 처음에는 「자료 보내지 않음」이라 질문만 보냅니다.
  3. 질문을 입력하고 Enter 를 누릅니다. 줄 바꿈은 Shift+Enter 입니다.
  • 같은 채팅의 앞선 질문과 답도 함께 보냅니다. 새로 시작하려면 /새채팅 을 입력합니다.
  • 답 카드에는 「문서에 넣기」(커서 자리), 「선택한 텍스트 바꾸기」(미리보기), 「답 복사」, 「부적절한 응답 신고」 버튼이 있습니다.
  • 입력란에 / 를 입력하면 명령 목록이 열립니다. 답을 받는 중에는 [중지] 버튼으로 멈춥니다.

오른쪽에 AI 채팅 도구 창이 열린 화면

에이전트 모드 쓰기

AI가 MDStudio 도구로 문서를 직접 읽고, 허용하면 고칩니다.

  1. 「보낼 내용」 메뉴에서 「에이전트 모드」를 선택합니다. 입력란 위에 「에이전트 모드」 칩이 나옵니다.
  2. 질문을 보내면 「에이전트 모드 허용」 카드가 뜹니다.
  3. 범위와 「문서 수정 도구도 허용」을 정하고 [시작] 버튼을 클릭합니다.
  • 처음에는 읽기 도구만 줍니다. 채팅은 5분 뒤 끝납니다. 칩을 클릭하면 꺼집니다.
  • 수정 도구를 허용하면 호출마다 「AI 에이전트의 문서 변경」 창이 뜹니다. [확인] 버튼을 클릭해야 바뀌고, 2분 안에 답하지 않으면 거절됩니다.
  • 「수정한 것을 모아 답이 끝난 뒤 한 번에 검토」를 켜면 답이 끝난 뒤 「편집 제안 검토」 창에서 남길 것만 체크하고 [확인] 버튼을 클릭합니다.

채팅 기록 보기

  • 「답이 끝날 때마다 채팅 기록에 저장」이 켜져 있으면 답마다 저장됩니다. 질문·답과 붙인 자료 이름만 저장하고 문서 본문은 저장하지 않습니다.
  • 「보낼 내용」 메뉴의 「채팅 목록」은 현재 문서의 채팅을 보입니다. 「모든 문서」를 체크하면 전부 보입니다.
  • 보존 기간이 지난 채팅은 지워지고, [채팅 기록 지우기] 버튼은 모두 지웁니다.

보내는 내용과 개인정보

  • 문서 내용은 직접 선택한 것만 보냅니다. AI 작업은 그 대상, 채팅은 「보낼 자료」, 에이전트 모드는 허용한 범위입니다.
  • 제공자로 처음 보낼 때 받는 곳을 알리는 창이 뜹니다. 이 PC의 로컬 서버는 묻지 않습니다.
  • 보낸 문서는 지시가 아닌 자료라고 AI에게 함께 알립니다.
  • 「개인정보」의 [전송 동의 초기화] 버튼은 받은 동의를 지우고, [저장된 키·토큰 모두 삭제] 버튼은 AI 키·MCP 연결 토큰·플러그인 비밀값을 지웁니다.

주의: 채팅 기록 지우기와 키·토큰 삭제는 되돌릴 수 없습니다.

관련 페이지